@aws-sdk/client-ssm 3.750.0 → 3.759.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.
@@ -55,6 +55,11 @@ declare const DeleteParameterCommand_base: {
55
55
  *
56
56
  * @throws {@link ParameterNotFound} (client fault)
57
57
  * <p>The parameter couldn't be found. Verify the name and try again.</p>
58
+ * <note>
59
+ * <p>For the <code>DeleteParameter</code> and <code>GetParameter</code> actions, if the
60
+ * specified parameter doesn't exist, the <code>ParameterNotFound</code> exception is
61
+ * <i>not</i> recorded in CloudTrail event logs.</p>
62
+ * </note>
58
63
  *
59
64
  * @throws {@link SSMServiceException}
60
65
  * <p>Base exception class for all service exceptions from SSM service.</p>
@@ -27,9 +27,13 @@ declare const DeregisterManagedInstanceCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Removes the server or virtual machine from the list of registered servers. You can
31
- * reregister the node again at any time. If you don't plan to use Run Command on the server, we
32
- * suggest uninstalling SSM Agent first.</p>
30
+ * <p>Removes the server or virtual machine from the list of registered servers.</p>
31
+ * <p>If you want to reregister an on-premises server, edge device, or VM, you must use a
32
+ * different Activation Code and Activation ID than used to register the machine previously. The
33
+ * Activation Code and Activation ID must not have already been used on the maximum number of
34
+ * activations specified when they were created. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/fleet-manager-deregister-hybrid-nodes.html">Deregistering
35
+ * managed nodes in a hybrid and multicloud environment</a> in the
36
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
33
37
  * @example
34
38
  * Use a bare-bones client and the command you need to make an API call.
35
39
  * ```javascript
@@ -73,6 +73,11 @@ declare const GetParameterCommand_base: {
73
73
  *
74
74
  * @throws {@link ParameterNotFound} (client fault)
75
75
  * <p>The parameter couldn't be found. Verify the name and try again.</p>
76
+ * <note>
77
+ * <p>For the <code>DeleteParameter</code> and <code>GetParameter</code> actions, if the
78
+ * specified parameter doesn't exist, the <code>ParameterNotFound</code> exception is
79
+ * <i>not</i> recorded in CloudTrail event logs.</p>
80
+ * </note>
76
81
  *
77
82
  * @throws {@link ParameterVersionNotFound} (client fault)
78
83
  * <p>The specified parameter version wasn't found. Verify the parameter name and version, and try
@@ -96,6 +96,11 @@ declare const GetParameterHistoryCommand_base: {
96
96
  *
97
97
  * @throws {@link ParameterNotFound} (client fault)
98
98
  * <p>The parameter couldn't be found. Verify the name and try again.</p>
99
+ * <note>
100
+ * <p>For the <code>DeleteParameter</code> and <code>GetParameter</code> actions, if the
101
+ * specified parameter doesn't exist, the <code>ParameterNotFound</code> exception is
102
+ * <i>not</i> recorded in CloudTrail event logs.</p>
103
+ * </note>
99
104
  *
100
105
  * @throws {@link SSMServiceException}
101
106
  * <p>Base exception class for all service exceptions from SSM service.</p>
@@ -99,6 +99,11 @@ declare const LabelParameterVersionCommand_base: {
99
99
  *
100
100
  * @throws {@link ParameterNotFound} (client fault)
101
101
  * <p>The parameter couldn't be found. Verify the name and try again.</p>
102
+ * <note>
103
+ * <p>For the <code>DeleteParameter</code> and <code>GetParameter</code> actions, if the
104
+ * specified parameter doesn't exist, the <code>ParameterNotFound</code> exception is
105
+ * <i>not</i> recorded in CloudTrail event logs.</p>
106
+ * </note>
102
107
  *
103
108
  * @throws {@link ParameterVersionLabelLimitExceeded} (client fault)
104
109
  * <p>A parameter version can have a maximum of ten labels.</p>
@@ -27,7 +27,7 @@ declare const PutParameterCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Add a parameter to the system.</p>
30
+ * <p>Create or update a parameter in Parameter Store.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -65,6 +65,11 @@ declare const UnlabelParameterVersionCommand_base: {
65
65
  *
66
66
  * @throws {@link ParameterNotFound} (client fault)
67
67
  * <p>The parameter couldn't be found. Verify the name and try again.</p>
68
+ * <note>
69
+ * <p>For the <code>DeleteParameter</code> and <code>GetParameter</code> actions, if the
70
+ * specified parameter doesn't exist, the <code>ParameterNotFound</code> exception is
71
+ * <i>not</i> recorded in CloudTrail event logs.</p>
72
+ * </note>
68
73
  *
69
74
  * @throws {@link ParameterVersionNotFound} (client fault)
70
75
  * <p>The specified parameter version wasn't found. Verify the parameter name and version, and try
@@ -1101,17 +1101,21 @@ export interface CreateAssociationRequest {
1101
1101
  SyncCompliance?: AssociationSyncCompliance | undefined;
1102
1102
  /**
1103
1103
  * <p>By default, when you create a new association, the system runs it immediately after it is
1104
- * created and then according to the schedule you specified. Specify this option if you don't want
1105
- * an association to run immediately after you create it. This parameter isn't supported for rate
1106
- * expressions.</p>
1104
+ * created and then according to the schedule you specified and when target changes are detected.
1105
+ * Specify <code>true</code> for <code>ApplyOnlyAtCronInterval</code>if you want the association to
1106
+ * run only according to the schedule you specified.</p>
1107
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling">Understanding when associations are applied to resources</a> and <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates">>About
1108
+ * target updates with Automation runbooks</a> in the
1109
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1110
+ * <p>This parameter isn't supported for rate expressions.</p>
1107
1111
  * @public
1108
1112
  */
1109
1113
  ApplyOnlyAtCronInterval?: boolean | undefined;
1110
1114
  /**
1111
- * <p>The names or Amazon Resource Names (ARNs) of the Change Calendar type documents you want to
1115
+ * <p>The names of Amazon Resource Names (ARNs) of the Change Calendar type documents you want to
1112
1116
  * gate your associations under. The associations only run when that change calendar is open. For
1113
1117
  * more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar">Amazon Web Services Systems Manager Change
1114
- * Calendar</a>.</p>
1118
+ * Calendar</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1115
1119
  * @public
1116
1120
  */
1117
1121
  CalendarNames?: string[] | undefined;
@@ -1387,7 +1391,7 @@ export interface AssociationDescription {
1387
1391
  * <p>The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your
1388
1392
  * associations are gated under. The associations only run when that change calendar is open. For
1389
1393
  * more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar">Amazon Web Services Systems Manager Change
1390
- * Calendar</a>.</p>
1394
+ * Calendar</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1391
1395
  * @public
1392
1396
  */
1393
1397
  CalendarNames?: string[] | undefined;
@@ -1671,10 +1675,14 @@ export interface CreateAssociationBatchRequestEntry {
1671
1675
  */
1672
1676
  SyncCompliance?: AssociationSyncCompliance | undefined;
1673
1677
  /**
1674
- * <p>By default, when you create a new associations, the system runs it immediately after it is
1675
- * created and then according to the schedule you specified. Specify this option if you don't want
1676
- * an association to run immediately after you create it. This parameter isn't supported for rate
1677
- * expressions.</p>
1678
+ * <p>By default, when you create a new association, the system runs it immediately after it is
1679
+ * created and then according to the schedule you specified and when target changes are detected.
1680
+ * Specify <code>true</code> for <code>ApplyOnlyAtCronInterval</code> if you want the association to
1681
+ * run only according to the schedule you specified.</p>
1682
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling">Understanding when associations are applied to resources</a> and <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates">>About
1683
+ * target updates with Automation runbooks</a> in the
1684
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1685
+ * <p>This parameter isn't supported for rate expressions.</p>
1678
1686
  * @public
1679
1687
  */
1680
1688
  ApplyOnlyAtCronInterval?: boolean | undefined;
@@ -1682,7 +1690,7 @@ export interface CreateAssociationBatchRequestEntry {
1682
1690
  * <p>The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your
1683
1691
  * associations are gated under. The associations only run when that Change Calendar is open. For
1684
1692
  * more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar">Amazon Web Services Systems Manager Change
1685
- * Calendar</a>.</p>
1693
+ * Calendar</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1686
1694
  * @public
1687
1695
  */
1688
1696
  CalendarNames?: string[] | undefined;
@@ -3949,6 +3957,11 @@ export interface DeleteParameterResult {
3949
3957
  }
3950
3958
  /**
3951
3959
  * <p>The parameter couldn't be found. Verify the name and try again.</p>
3960
+ * <note>
3961
+ * <p>For the <code>DeleteParameter</code> and <code>GetParameter</code> actions, if the
3962
+ * specified parameter doesn't exist, the <code>ParameterNotFound</code> exception is
3963
+ * <i>not</i> recorded in CloudTrail event logs.</p>
3964
+ * </note>
3952
3965
  * @public
3953
3966
  */
3954
3967
  export declare class ParameterNotFound extends __BaseException {
@@ -1851,7 +1851,7 @@ export interface GetAutomationExecutionResult {
1851
1851
  */
1852
1852
  export interface GetCalendarStateRequest {
1853
1853
  /**
1854
- * <p>The names or Amazon Resource Names (ARNs) of the Systems Manager documents (SSM documents) that
1854
+ * <p>The names of Amazon Resource Names (ARNs) of the Systems Manager documents (SSM documents) that
1855
1855
  * represent the calendar entries for which you want to get the state.</p>
1856
1856
  * @public
1857
1857
  */
@@ -5176,7 +5176,7 @@ export interface AssociationVersionInfo {
5176
5176
  */
5177
5177
  SyncCompliance?: AssociationSyncCompliance | undefined;
5178
5178
  /**
5179
- * <p>By default, when you create a new associations, the system runs it immediately after it is
5179
+ * <p>By default, when you create new associations, the system runs it immediately after it is
5180
5180
  * created and then according to the schedule you specified. Specify this option if you don't want
5181
5181
  * an association to run immediately after you create it. This parameter isn't supported for rate
5182
5182
  * expressions.</p>
@@ -5187,7 +5187,7 @@ export interface AssociationVersionInfo {
5187
5187
  * <p>The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your
5188
5188
  * associations are gated under. The associations for this version only run when that Change
5189
5189
  * Calendar is open. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar">Amazon Web Services Systems Manager Change
5190
- * Calendar</a>.</p>
5190
+ * Calendar</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
5191
5191
  * @public
5192
5192
  */
5193
5193
  CalendarNames?: string[] | undefined;
@@ -7128,9 +7128,10 @@ export interface NodeFilter {
7128
7128
  */
7129
7129
  export interface ListNodesRequest {
7130
7130
  /**
7131
- * <p>The name of the resource data sync to retrieve information about. Required for
7132
- * cross-account/cross-Region configurations. Optional for single account/single-Region
7133
- * configurations.</p>
7131
+ * <p>The name of the Amazon Web Services managed resource data sync to retrieve information about.</p>
7132
+ * <p>For cross-account/cross-Region configurations, this parameter is required, and the name of
7133
+ * the supported resource data sync is <code>AWS-QuickSetup-ManagedNode</code>.</p>
7134
+ * <p>For single account/single-Region configurations, the parameter is not required.</p>
7134
7135
  * @public
7135
7136
  */
7136
7137
  SyncName?: string | undefined;
@@ -8080,7 +8081,7 @@ export interface ModifyDocumentPermissionRequest {
8080
8081
  PermissionType: DocumentPermissionType | undefined;
8081
8082
  /**
8082
8083
  * <p>The Amazon Web Services users that should have access to the document. The account IDs can either be a
8083
- * group of account IDs or <i>All</i>.</p>
8084
+ * group of account IDs or <i>All</i>. </p>
8084
8085
  * @public
8085
8086
  */
8086
8087
  AccountIdsToAdd?: string[] | undefined;
@@ -8088,7 +8089,7 @@ export interface ModifyDocumentPermissionRequest {
8088
8089
  * <p>The Amazon Web Services users that should no longer have access to the document. The Amazon Web Services user
8089
8090
  * can either be a group of account IDs or <i>All</i>. This action has a higher
8090
8091
  * priority than <code>AccountIdsToAdd</code>. If you specify an ID to add and the same ID to
8091
- * remove, the system removes access to the document.</p>
8092
+ * remove, the system removes access to the document. </p>
8092
8093
  * @public
8093
8094
  */
8094
8095
  AccountIdsToRemove?: string[] | undefined;
@@ -8582,7 +8583,7 @@ export declare class PoliciesLimitExceededException extends __BaseException {
8582
8583
  */
8583
8584
  export interface PutParameterRequest {
8584
8585
  /**
8585
- * <p>The fully qualified name of the parameter that you want to add to the system.</p>
8586
+ * <p>The fully qualified name of the parameter that you want to create or update.</p>
8586
8587
  * <note>
8587
8588
  * <p>You can't enter the Amazon Resource Name (ARN) for a parameter, only the parameter name
8588
8589
  * itself.</p>
@@ -8649,7 +8650,7 @@ export interface PutParameterRequest {
8649
8650
  */
8650
8651
  Value: string | undefined;
8651
8652
  /**
8652
- * <p>The type of parameter that you want to add to the system.</p>
8653
+ * <p>The type of parameter that you want to create.</p>
8653
8654
  * <note>
8654
8655
  * <p>
8655
8656
  * <code>SecureString</code> isn't currently supported for CloudFormation templates.</p>
@@ -8668,7 +8669,7 @@ export interface PutParameterRequest {
8668
8669
  * <p>The Key Management Service (KMS) ID that you want to use to encrypt a
8669
8670
  * parameter. Use a custom key for better security. Required for parameters that use the <code>SecureString</code> data type.</p>
8670
8671
  * <p>If you don't specify a key ID, the system uses the default key associated with your
8671
- * Amazon Web Services account which is not as secure as using a custom key.</p>
8672
+ * Amazon Web Services account, which is not as secure as using a custom key.</p>
8672
8673
  * <ul>
8673
8674
  * <li>
8674
8675
  * <p>To use a custom KMS key, choose the <code>SecureString</code>
@@ -1156,20 +1156,25 @@ export interface UpdateAssociationRequest {
1156
1156
  SyncCompliance?: AssociationSyncCompliance | undefined;
1157
1157
  /**
1158
1158
  * <p>By default, when you update an association, the system runs it immediately after it is
1159
- * updated and then according to the schedule you specified. Specify this option if you don't want
1160
- * an association to run immediately after you update it. This parameter isn't supported for rate
1161
- * expressions.</p>
1159
+ * updated and then according to the schedule you specified. Specify <code>true</code> for
1160
+ * <code>ApplyOnlyAtCronInterval</code> if you want the association to run only according to the
1161
+ * schedule you specified.</p>
1162
1162
  * <p>If you chose this option when you created an association and later you edit that association
1163
- * or you make changes to the SSM document on which that association is based (by using the
1164
- * Documents page in the console), State Manager applies the association at the next specified cron
1165
- * interval. For example, if you chose the <code>Latest</code> version of an SSM document when you
1166
- * created an association and you edit the association by choosing a different document version on
1167
- * the Documents page, State Manager applies the association at the next specified cron interval if
1168
- * you previously selected this option. If this option wasn't selected, State Manager immediately
1169
- * runs the association.</p>
1170
- * <p>You can reset this option. To do so, specify the <code>no-apply-only-at-cron-interval</code>
1171
- * parameter when you update the association from the command line. This parameter forces the
1172
- * association to run immediately after updating it and according to the interval specified.</p>
1163
+ * or you make changes to the Automation runbook or SSM document on which that association is based,
1164
+ * State Manager applies the association at the next specified cron interval. For example, if you
1165
+ * chose the <code>Latest</code> version of an SSM document when you created an association and you
1166
+ * edit the association by choosing a different document version on the Documents page, State
1167
+ * Manager applies the association at the next specified cron interval if you previously set
1168
+ * <code>ApplyOnlyAtCronInterval</code> to <code>true</code>. If this option wasn't selected, State
1169
+ * Manager immediately runs the association.</p>
1170
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling">Understanding when associations are applied to resources</a> and <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates">About
1171
+ * target updates with Automation runbooks</a> in the
1172
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1173
+ * <p>This parameter isn't supported for rate expressions.</p>
1174
+ * <p>You can reset this parameter. To do so, specify the
1175
+ * <code>no-apply-only-at-cron-interval</code> parameter when you update the association from the
1176
+ * command line. This parameter forces the association to run immediately after updating it and
1177
+ * according to the interval specified.</p>
1173
1178
  * @public
1174
1179
  */
1175
1180
  ApplyOnlyAtCronInterval?: boolean | undefined;
@@ -1177,7 +1182,7 @@ export interface UpdateAssociationRequest {
1177
1182
  * <p>The names or Amazon Resource Names (ARNs) of the Change Calendar type documents you want to
1178
1183
  * gate your associations under. The associations only run when that change calendar is open. For
1179
1184
  * more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar">Amazon Web Services Systems Manager Change
1180
- * Calendar</a>.</p>
1185
+ * Calendar</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1181
1186
  * @public
1182
1187
  */
1183
1188
  CalendarNames?: string[] | undefined;
@@ -2720,9 +2725,10 @@ export interface GetOpsSummaryRequest {
2720
2725
  */
2721
2726
  export interface ListNodesSummaryRequest {
2722
2727
  /**
2723
- * <p>The name of the resource data sync to retrieve information about. Required for
2724
- * cross-account/cross-Region configuration. Optional for single account/single-Region
2725
- * configurations.</p>
2728
+ * <p>The name of the Amazon Web Services managed resource data sync to retrieve information about.</p>
2729
+ * <p>For cross-account/cross-Region configurations, this parameter is required, and the name of
2730
+ * the supported resource data sync is <code>AWS-QuickSetup-ManagedNode</code>.</p>
2731
+ * <p>For single account/single-Region configurations, the parameter is not required.</p>
2726
2732
  * @public
2727
2733
  */
2728
2734
  SyncName?: string | undefined;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-ssm",
3
3
  "description": "AWS SDK for JavaScript Ssm Client for Node.js, Browser and React Native",
4
- "version": "3.750.0",
4
+ "version": "3.759.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-ssm",
@@ -20,38 +20,38 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
- "@aws-sdk/core": "3.750.0",
24
- "@aws-sdk/credential-provider-node": "3.750.0",
23
+ "@aws-sdk/core": "3.758.0",
24
+ "@aws-sdk/credential-provider-node": "3.758.0",
25
25
  "@aws-sdk/middleware-host-header": "3.734.0",
26
26
  "@aws-sdk/middleware-logger": "3.734.0",
27
27
  "@aws-sdk/middleware-recursion-detection": "3.734.0",
28
- "@aws-sdk/middleware-user-agent": "3.750.0",
28
+ "@aws-sdk/middleware-user-agent": "3.758.0",
29
29
  "@aws-sdk/region-config-resolver": "3.734.0",
30
30
  "@aws-sdk/types": "3.734.0",
31
31
  "@aws-sdk/util-endpoints": "3.743.0",
32
32
  "@aws-sdk/util-user-agent-browser": "3.734.0",
33
- "@aws-sdk/util-user-agent-node": "3.750.0",
33
+ "@aws-sdk/util-user-agent-node": "3.758.0",
34
34
  "@smithy/config-resolver": "^4.0.1",
35
- "@smithy/core": "^3.1.4",
35
+ "@smithy/core": "^3.1.5",
36
36
  "@smithy/fetch-http-handler": "^5.0.1",
37
37
  "@smithy/hash-node": "^4.0.1",
38
38
  "@smithy/invalid-dependency": "^4.0.1",
39
39
  "@smithy/middleware-content-length": "^4.0.1",
40
- "@smithy/middleware-endpoint": "^4.0.5",
41
- "@smithy/middleware-retry": "^4.0.6",
40
+ "@smithy/middleware-endpoint": "^4.0.6",
41
+ "@smithy/middleware-retry": "^4.0.7",
42
42
  "@smithy/middleware-serde": "^4.0.2",
43
43
  "@smithy/middleware-stack": "^4.0.1",
44
44
  "@smithy/node-config-provider": "^4.0.1",
45
- "@smithy/node-http-handler": "^4.0.2",
45
+ "@smithy/node-http-handler": "^4.0.3",
46
46
  "@smithy/protocol-http": "^5.0.1",
47
- "@smithy/smithy-client": "^4.1.5",
47
+ "@smithy/smithy-client": "^4.1.6",
48
48
  "@smithy/types": "^4.1.0",
49
49
  "@smithy/url-parser": "^4.0.1",
50
50
  "@smithy/util-base64": "^4.0.0",
51
51
  "@smithy/util-body-length-browser": "^4.0.0",
52
52
  "@smithy/util-body-length-node": "^4.0.0",
53
- "@smithy/util-defaults-mode-browser": "^4.0.6",
54
- "@smithy/util-defaults-mode-node": "^4.0.6",
53
+ "@smithy/util-defaults-mode-browser": "^4.0.7",
54
+ "@smithy/util-defaults-mode-node": "^4.0.7",
55
55
  "@smithy/util-endpoints": "^3.0.1",
56
56
  "@smithy/util-middleware": "^4.0.1",
57
57
  "@smithy/util-retry": "^4.0.1",