@aws-sdk/client-ssm 3.47.2 → 3.48.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -60,8 +60,7 @@ export interface Activation {
60
60
  */
61
61
  DefaultInstanceName?: string;
62
62
  /**
63
- * <p>The Identity and Access Management (IAM) role to assign to the managed
64
- * node.</p>
63
+ * <p>The Identity and Access Management (IAM) role to assign to the managed node.</p>
65
64
  */
66
65
  IamRole?: string;
67
66
  /**
@@ -185,8 +184,8 @@ export interface InvalidResourceId extends __SmithyException, $MetadataBearer {
185
184
  $fault: "client";
186
185
  }
187
186
  /**
188
- * <p>The resource type isn't valid. For example, if you are attempting to tag an EC2 instance, the
189
- * instance must be a registered managed node.</p>
187
+ * <p>The resource type isn't valid. For example, if you are attempting to tag an EC2 instance,
188
+ * the instance must be a registered managed node.</p>
190
189
  */
191
190
  export interface InvalidResourceType extends __SmithyException, $MetadataBearer {
192
191
  name: "InvalidResourceType";
@@ -309,8 +308,8 @@ export interface CancelCommandRequest {
309
308
  */
310
309
  CommandId: string | undefined;
311
310
  /**
312
- * <p>(Optional) A list of managed node IDs on which you want to cancel the command. If not provided,
313
- * the command is canceled on every node on which it was requested.</p>
311
+ * <p>(Optional) A list of managed node IDs on which you want to cancel the command. If not
312
+ * provided, the command is canceled on every node on which it was requested.</p>
314
313
  */
315
314
  InstanceIds?: string[];
316
315
  }
@@ -483,9 +482,9 @@ export interface CreateActivationRequest {
483
482
  * automatically applied to the on-premises servers or VMs.</p>
484
483
  * </important>
485
484
  * <p>You can't add tags to or delete tags from an existing activation. You can tag your
486
- * on-premises servers, edge devices, and VMs after they connect to Systems Manager for the first time and are assigned a
487
- * managed node ID. This means they are listed in the Amazon Web Services Systems Manager console with an ID that is
488
- * prefixed with "mi-". For information about how to add tags to your managed nodes, see <a>AddTagsToResource</a>. For information about how to remove tags from your managed nodes,
485
+ * on-premises servers, edge devices, and VMs after they connect to Systems Manager for the first time and are
486
+ * assigned a managed node ID. This means they are listed in the Amazon Web Services Systems Manager console with an ID that
487
+ * is prefixed with "mi-". For information about how to add tags to your managed nodes, see <a>AddTagsToResource</a>. For information about how to remove tags from your managed nodes,
489
488
  * see <a>RemoveTagsFromResource</a>.</p>
490
489
  */
491
490
  Tags?: Tag[];
@@ -769,17 +768,20 @@ export interface CreateAssociationRequest {
769
768
  /**
770
769
  * <p>The document version you want to associate with the target(s). Can be a specific version or
771
770
  * the default version.</p>
771
+ * <important>
772
+ * <p>State Manager doesn't support running associations that use a new version of a document if that document is shared from another account. State Manager always runs the <code>default</code> version of a document if shared from another account, even though the Systems Manager console shows that a new version was processed. If you want to run an association using a new version of a document shared form another account, you must set the document version to <code>default</code>.</p>
773
+ * </important>
772
774
  */
773
775
  DocumentVersion?: string;
774
776
  /**
775
777
  * <p>The managed node ID.</p>
776
778
  * <note>
777
779
  * <p>
778
- * <code>InstanceId</code> has been deprecated. To specify a managed node ID for an association,
779
- * use the <code>Targets</code> parameter. Requests that include the
780
- * parameter <code>InstanceID</code> with Systems Manager documents (SSM documents) that use schema version
781
- * 2.0 or later will fail. In addition, if you use the parameter
782
- * <code>InstanceId</code>, you can't use the parameters <code>AssociationName</code>,
780
+ * <code>InstanceId</code> has been deprecated. To specify a managed node ID for an
781
+ * association, use the <code>Targets</code> parameter. Requests that
782
+ * include the parameter <code>InstanceID</code> with Systems Manager documents (SSM documents) that use
783
+ * schema version 2.0 or later will fail. In addition, if you use the
784
+ * parameter <code>InstanceId</code>, you can't use the parameters <code>AssociationName</code>,
783
785
  * <code>DocumentVersion</code>, <code>MaxErrors</code>, <code>MaxConcurrency</code>,
784
786
  * <code>OutputLocation</code>, or <code>ScheduleExpression</code>. To use these parameters, you
785
787
  * must use the <code>Targets</code> parameter.</p>
@@ -839,8 +841,8 @@ export interface CreateAssociationRequest {
839
841
  * value is 100%, which means all targets run the association at the same time.</p>
840
842
  * <p>If a new managed node starts and attempts to run an association while Systems Manager is running
841
843
  * <code>MaxConcurrency</code> associations, the association is allowed to run. During the next
842
- * association interval, the new managed node will process its association within the limit specified
843
- * for <code>MaxConcurrency</code>.</p>
844
+ * association interval, the new managed node will process its association within the limit
845
+ * specified for <code>MaxConcurrency</code>.</p>
844
846
  */
845
847
  MaxConcurrency?: string;
846
848
  /**
@@ -1041,8 +1043,8 @@ export interface AssociationDescription {
1041
1043
  * value is 100%, which means all targets run the association at the same time.</p>
1042
1044
  * <p>If a new managed node starts and attempts to run an association while Systems Manager is running
1043
1045
  * <code>MaxConcurrency</code> associations, the association is allowed to run. During the next
1044
- * association interval, the new managed node will process its association within the limit specified
1045
- * for <code>MaxConcurrency</code>.</p>
1046
+ * association interval, the new managed node will process its association within the limit
1047
+ * specified for <code>MaxConcurrency</code>.</p>
1046
1048
  */
1047
1049
  MaxConcurrency?: string;
1048
1050
  /**
@@ -1145,8 +1147,8 @@ export interface InvalidTarget extends __SmithyException, $MetadataBearer {
1145
1147
  Message?: string;
1146
1148
  }
1147
1149
  /**
1148
- * <p>The document doesn't support the platform type of the given managed node ID(s). For example, you
1149
- * sent an document for a Windows managed node to a Linux node.</p>
1150
+ * <p>The document doesn't support the platform type of the given managed node ID(s). For example,
1151
+ * you sent an document for a Windows managed node to a Linux node.</p>
1150
1152
  */
1151
1153
  export interface UnsupportedPlatformType extends __SmithyException, $MetadataBearer {
1152
1154
  name: "UnsupportedPlatformType";
@@ -1158,8 +1160,8 @@ export interface UnsupportedPlatformType extends __SmithyException, $MetadataBea
1158
1160
  */
1159
1161
  export interface CreateAssociationBatchRequestEntry {
1160
1162
  /**
1161
- * <p>The name of the SSM document that contains the configuration information for the managed node.
1162
- * You can specify Command or Automation runbooks.</p>
1163
+ * <p>The name of the SSM document that contains the configuration information for the managed
1164
+ * node. You can specify Command or Automation runbooks.</p>
1163
1165
  * <p>You can specify Amazon Web Services-predefined documents, documents you created, or a document that is
1164
1166
  * shared with you from another account.</p>
1165
1167
  * <p>For SSM documents that are shared with you from other Amazon Web Services accounts, you must specify the
@@ -1181,11 +1183,11 @@ export interface CreateAssociationBatchRequestEntry {
1181
1183
  * <p>The managed node ID.</p>
1182
1184
  * <note>
1183
1185
  * <p>
1184
- * <code>InstanceId</code> has been deprecated. To specify a managed node ID for an association,
1185
- * use the <code>Targets</code> parameter. Requests that include the
1186
- * parameter <code>InstanceID</code> with Systems Manager documents (SSM documents) that use schema version
1187
- * 2.0 or later will fail. In addition, if you use the parameter
1188
- * <code>InstanceId</code>, you can't use the parameters <code>AssociationName</code>,
1186
+ * <code>InstanceId</code> has been deprecated. To specify a managed node ID for an
1187
+ * association, use the <code>Targets</code> parameter. Requests that
1188
+ * include the parameter <code>InstanceID</code> with Systems Manager documents (SSM documents) that use
1189
+ * schema version 2.0 or later will fail. In addition, if you use the
1190
+ * parameter <code>InstanceId</code>, you can't use the parameters <code>AssociationName</code>,
1189
1191
  * <code>DocumentVersion</code>, <code>MaxErrors</code>, <code>MaxConcurrency</code>,
1190
1192
  * <code>OutputLocation</code>, or <code>ScheduleExpression</code>. To use these parameters, you
1191
1193
  * must use the <code>Targets</code> parameter.</p>
@@ -1244,8 +1246,8 @@ export interface CreateAssociationBatchRequestEntry {
1244
1246
  * value is 100%, which means all targets run the association at the same time.</p>
1245
1247
  * <p>If a new managed node starts and attempts to run an association while Systems Manager is running
1246
1248
  * <code>MaxConcurrency</code> associations, the association is allowed to run. During the next
1247
- * association interval, the new managed node will process its association within the limit specified
1248
- * for <code>MaxConcurrency</code>.</p>
1249
+ * association interval, the new managed node will process its association within the limit
1250
+ * specified for <code>MaxConcurrency</code>.</p>
1249
1251
  */
1250
1252
  MaxConcurrency?: string;
1251
1253
  /**
@@ -1659,7 +1661,7 @@ export declare enum DocumentStatus {
1659
1661
  Updating = "Updating"
1660
1662
  }
1661
1663
  /**
1662
- * <p>Describes a Amazon Web Services Systems Manager document (SSM document). </p>
1664
+ * <p>Describes an Amazon Web Services Systems Manager document (SSM document). </p>
1663
1665
  */
1664
1666
  export interface DocumentDescription {
1665
1667
  /**
@@ -1725,7 +1727,7 @@ export interface DocumentDescription {
1725
1727
  */
1726
1728
  Parameters?: DocumentParameter[];
1727
1729
  /**
1728
- * <p>The list of OS platforms compatible with this SSM document. </p>
1730
+ * <p>The list of operating system (OS) platforms compatible with this SSM document. </p>
1729
1731
  */
1730
1732
  PlatformTypes?: (PlatformType | string)[];
1731
1733
  /**
@@ -1788,6 +1790,14 @@ export interface DocumentDescription {
1788
1790
  * <p>The current status of the review.</p>
1789
1791
  */
1790
1792
  ReviewStatus?: ReviewStatus | string;
1793
+ /**
1794
+ * <p>The classification of a document to help you identify and categorize its use.</p>
1795
+ */
1796
+ Category?: string[];
1797
+ /**
1798
+ * <p>The value that identifies a document's category.</p>
1799
+ */
1800
+ CategoryEnum?: string[];
1791
1801
  }
1792
1802
  export declare namespace DocumentDescription {
1793
1803
  /**
@@ -1906,8 +1916,8 @@ export interface CreateMaintenanceWindowRequest {
1906
1916
  Cutoff: number | undefined;
1907
1917
  /**
1908
1918
  * <p>Enables a maintenance window task to run on managed nodes, even if you haven't registered
1909
- * those nodes as targets. If enabled, then you must specify the unregistered managed nodes (by
1910
- * node ID) when you register a task with the maintenance window.</p>
1919
+ * those nodes as targets. If enabled, then you must specify the unregistered managed nodes (by node
1920
+ * ID) when you register a task with the maintenance window.</p>
1911
1921
  * <p>If you don't enable this option, then you must specify previously-registered targets when
1912
1922
  * you register a task with the maintenance window.</p>
1913
1923
  */
@@ -2838,14 +2848,14 @@ export interface DeleteAssociationRequest {
2838
2848
  * <p>The managed node ID.</p>
2839
2849
  * <note>
2840
2850
  * <p>
2841
- * <code>InstanceId</code> has been deprecated. To specify a managed node ID for an association,
2842
- * use the <code>Targets</code> parameter. Requests that include the
2843
- * parameter <code>InstanceID</code> with Systems Manager documents (SSM documents) that use schema version
2844
- * 2.0 or later will fail. In addition, if you use the parameter
2845
- * <code>InstanceId</code>, you can't use the parameters <code>AssociationName</code>,
2846
- * <code>DocumentVersion</code>, <code>MaxErrors</code>, <code>MaxConcurrency</code>,
2847
- * <code>OutputLocation</code>, or <code>ScheduleExpression</code>. To use these parameters, you
2848
- * must use the <code>Targets</code> parameter.</p>
2851
+ * <code>InstanceId</code> has been deprecated. To specify a managed node ID for an
2852
+ * association, use the <code>Targets</code> parameter. Requests that include the parameter
2853
+ * <code>InstanceID</code> with Systems Manager documents (SSM documents) that use schema version 2.0 or
2854
+ * later will fail. In addition, if you use the parameter <code>InstanceId</code>, you can't use
2855
+ * the parameters <code>AssociationName</code>, <code>DocumentVersion</code>,
2856
+ * <code>MaxErrors</code>, <code>MaxConcurrency</code>, <code>OutputLocation</code>, or
2857
+ * <code>ScheduleExpression</code>. To use these parameters, you must use the <code>Targets</code>
2858
+ * parameter.</p>
2849
2859
  * </note>
2850
2860
  */
2851
2861
  InstanceId?: string;
@@ -3464,8 +3474,8 @@ export interface DescribeAssociationRequest {
3464
3474
  /**
3465
3475
  * <p>Specify the association version to retrieve. To view the latest version, either specify
3466
3476
  * <code>$LATEST</code> for this parameter, or omit this parameter. To view a list of all
3467
- * associations for a managed node, use <a>ListAssociations</a>. To get a list of versions
3468
- * for a specific association, use <a>ListAssociationVersions</a>. </p>
3477
+ * associations for a managed node, use <a>ListAssociations</a>. To get a list of
3478
+ * versions for a specific association, use <a>ListAssociationVersions</a>. </p>
3469
3479
  */
3470
3480
  AssociationVersion?: string;
3471
3481
  }
@@ -5173,8 +5183,8 @@ export declare namespace InstanceInformationFilter {
5173
5183
  export interface DescribeInstanceInformationRequest {
5174
5184
  /**
5175
5185
  * <p>This is a legacy method. We recommend that you don't use this method. Instead, use the
5176
- * <code>Filters</code> data type. <code>Filters</code> enables you to return node information
5177
- * by filtering based on tags applied to managed nodes.</p>
5186
+ * <code>Filters</code> data type. <code>Filters</code> enables you to return node information by
5187
+ * filtering based on tags applied to managed nodes.</p>
5178
5188
  * <note>
5179
5189
  * <p>Attempting to use <code>InstanceInformationFilterList</code> and <code>Filters</code> leads
5180
5190
  * to an exception error. </p>
@@ -5456,8 +5466,8 @@ export declare enum PatchComplianceDataState {
5456
5466
  NotApplicable = "NOT_APPLICABLE"
5457
5467
  }
5458
5468
  /**
5459
- * <p>Information about the state of a patch on a particular managed node as it relates to the patch
5460
- * baseline used to patch the node.</p>
5469
+ * <p>Information about the state of a patch on a particular managed node as it relates to the
5470
+ * patch baseline used to patch the node.</p>
5461
5471
  */
5462
5472
  export interface PatchComplianceData {
5463
5473
  /**
@@ -5614,8 +5624,8 @@ export interface InstancePatchState {
5614
5624
  */
5615
5625
  InstalledCount?: number;
5616
5626
  /**
5617
- * <p>The number of patches not specified in the patch baseline that are installed on the
5618
- * managed node.</p>
5627
+ * <p>The number of patches not specified in the patch baseline that are installed on the managed
5628
+ * node.</p>
5619
5629
  */
5620
5630
  InstalledOtherCount?: number;
5621
5631
  /**
@@ -5650,8 +5660,8 @@ export interface InstancePatchState {
5650
5660
  */
5651
5661
  UnreportedNotApplicableCount?: number;
5652
5662
  /**
5653
- * <p>The number of patches from the patch baseline that aren't applicable for the managed node and
5654
- * therefore aren't installed on the node. This number may be truncated if the list of patch
5663
+ * <p>The number of patches from the patch baseline that aren't applicable for the managed node
5664
+ * and therefore aren't installed on the node. This number may be truncated if the list of patch
5655
5665
  * names is very large. The number of patches beyond this limit are reported in
5656
5666
  * <code>UnreportedNotApplicableCount</code>.</p>
5657
5667
  */
@@ -5679,8 +5689,8 @@ export interface InstancePatchState {
5679
5689
  */
5680
5690
  Operation: PatchOperationType | string | undefined;
5681
5691
  /**
5682
- * <p>The time of the last attempt to patch the managed node with <code>NoReboot</code> specified as
5683
- * the reboot option.</p>
5692
+ * <p>The time of the last attempt to patch the managed node with <code>NoReboot</code> specified
5693
+ * as the reboot option.</p>
5684
5694
  */
5685
5695
  LastNoRebootInstallOperationTime?: Date;
5686
5696
  /**
@@ -5692,8 +5702,8 @@ export interface InstancePatchState {
5692
5702
  * <ul>
5693
5703
  * <li>
5694
5704
  * <p>
5695
- * <code>RebootIfNeeded</code>: Patch Manager tries to reboot the managed node if it installed
5696
- * any patches, or if any patches are detected with a status of
5705
+ * <code>RebootIfNeeded</code>: Patch Manager tries to reboot the managed node if it
5706
+ * installed any patches, or if any patches are detected with a status of
5697
5707
  * <code>InstalledPendingReboot</code>.</p>
5698
5708
  * </li>
5699
5709
  * <li>
@@ -5709,15 +5719,15 @@ export interface InstancePatchState {
5709
5719
  /**
5710
5720
  * <p>The number of managed nodes where patches that are specified as <code>Critical</code> for
5711
5721
  * compliance reporting in the patch baseline aren't installed. These patches might be missing, have
5712
- * failed installation, were rejected, or were installed but awaiting a required managed node reboot.
5713
- * The status of these managed nodes is <code>NON_COMPLIANT</code>.</p>
5722
+ * failed installation, were rejected, or were installed but awaiting a required managed node
5723
+ * reboot. The status of these managed nodes is <code>NON_COMPLIANT</code>.</p>
5714
5724
  */
5715
5725
  CriticalNonCompliantCount?: number;
5716
5726
  /**
5717
5727
  * <p>The number of managed nodes where patches that are specified as <code>Security</code> in a
5718
5728
  * patch advisory aren't installed. These patches might be missing, have failed installation, were
5719
- * rejected, or were installed but awaiting a required managed node reboot. The status of these managed
5720
- * nodes is <code>NON_COMPLIANT</code>.</p>
5729
+ * rejected, or were installed but awaiting a required managed node reboot. The status of these
5730
+ * managed nodes is <code>NON_COMPLIANT</code>.</p>
5721
5731
  */
5722
5732
  SecurityNonCompliantCount?: number;
5723
5733
  /**
@@ -6725,8 +6735,8 @@ export declare enum MaintenanceWindowTaskCutoffBehavior {
6725
6735
  ContinueTask = "CONTINUE_TASK"
6726
6736
  }
6727
6737
  /**
6728
- * <p>Information about an Amazon Simple Storage Service (Amazon S3) bucket to write
6729
- * managed node-level logs to.</p>
6738
+ * <p>Information about an Amazon Simple Storage Service (Amazon S3) bucket to write managed
6739
+ * node-level logs to.</p>
6730
6740
  * <note>
6731
6741
  * <p>
6732
6742
  * <code>LoggingInfo</code> has been deprecated. To specify an Amazon Simple Storage Service (Amazon S3) bucket to contain logs, instead use the