@aws-sdk/client-ssm 3.624.0 → 3.629.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.
@@ -34,8 +34,9 @@ declare const DescribeInstanceInformationCommand_base: {
34
34
  * nodes. If you don't specify node IDs, it returns information for all your managed nodes. If you
35
35
  * specify a node ID that isn't valid or a node that you don't own, you receive an error.</p>
36
36
  * <note>
37
- * <p>The <code>IamRole</code> field returned for this API operation is the Identity and Access Management (IAM) role assigned to on-premises managed nodes. This operation does not
38
- * return the IAM role for EC2 instances.</p>
37
+ * <p>The <code>IamRole</code> field returned for this API operation is the role assigned to an
38
+ * Amazon EC2 instance configured with a Systems Manager Quick Setup host management configuration or
39
+ * the role assigned to an on-premises managed node.</p>
39
40
  * </note>
40
41
  * @example
41
42
  * Use a bare-bones client and the command you need to make an API call.
@@ -27,7 +27,8 @@ declare const DescribeInstancePropertiesCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>An API operation used by the Systems Manager console to display information about Systems Manager managed nodes.</p>
30
+ * <p>An API operation used by the Systems Manager console to display information about Systems Manager managed
31
+ * nodes.</p>
31
32
  * @example
32
33
  * Use a bare-bones client and the command you need to make an API call.
33
34
  * ```javascript
@@ -45,6 +45,12 @@ declare const DescribePatchPropertiesCommand_base: {
45
45
  * <code>SEVERITY</code>
46
46
  * </p>
47
47
  * </dd>
48
+ * <dt>AMAZON_LINUX_2023</dt>
49
+ * <dd>
50
+ * <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> |
51
+ * <code>SEVERITY</code>
52
+ * </p>
53
+ * </dd>
48
54
  * <dt>CENTOS</dt>
49
55
  * <dd>
50
56
  * <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> |
@@ -27,7 +27,12 @@ declare const GetCommandInvocationCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns detailed information about command execution for an invocation or plugin.</p>
30
+ * <p>Returns detailed information about command execution for an invocation or plugin. The Run
31
+ * Command API follows an eventual consistency model, due to the distributed nature of the system
32
+ * supporting the API. This means that the result of an API command you run that affects your
33
+ * resources might not be immediately visible to all subsequent commands you run. You should keep
34
+ * this in mind when you carry out an API command that immediately follows a previous API
35
+ * command.</p>
31
36
  * <p>
32
37
  * <code>GetCommandInvocation</code> only gives the execution status of a plugin in a document.
33
38
  * To get the command execution status on a specific managed node, use <a>ListCommandInvocations</a>. To get the command execution status across managed nodes,
@@ -3041,16 +3041,25 @@ export interface PatchRule {
3041
3041
  /**
3042
3042
  * <p>The number of days after the release date of each patch matched by the rule that the patch
3043
3043
  * is marked as approved in the patch baseline. For example, a value of <code>7</code> means that
3044
- * patches are approved seven days after they are released. Not supported on Debian Server or Ubuntu
3045
- * Server.</p>
3044
+ * patches are approved seven days after they are released.</p>
3045
+ * <note>
3046
+ * <p>This parameter is marked as not required, but your request must include a value
3047
+ * for either <code>ApproveAfterDays</code> or <code>ApproveUntilDate</code>.</p>
3048
+ * </note>
3049
+ * <p> Not supported for Debian Server or Ubuntu Server.</p>
3046
3050
  * @public
3047
3051
  */
3048
3052
  ApproveAfterDays?: number;
3049
3053
  /**
3050
3054
  * <p>The cutoff date for auto approval of released patches. Any patches released on or before
3051
- * this date are installed automatically. Not supported on Debian Server or Ubuntu Server.</p>
3055
+ * this date are installed automatically.</p>
3052
3056
  * <p>Enter dates in the format <code>YYYY-MM-DD</code>. For example,
3053
3057
  * <code>2021-12-31</code>.</p>
3058
+ * <note>
3059
+ * <p>This parameter is marked as not required, but your request must include a value
3060
+ * for either <code>ApproveUntilDate</code> or <code>ApproveAfterDays</code>.</p>
3061
+ * </note>
3062
+ * <p>Not supported for Debian Server or Ubuntu Server.</p>
3054
3063
  * @public
3055
3064
  */
3056
3065
  ApproveUntilDate?: string;
@@ -3208,26 +3217,31 @@ export interface CreatePatchBaselineRequest {
3208
3217
  /**
3209
3218
  * <p>The action for Patch Manager to take on patches included in the
3210
3219
  * <code>RejectedPackages</code> list.</p>
3211
- * <ul>
3212
- * <li>
3220
+ * <dl>
3221
+ * <dt>ALLOW_AS_DEPENDENCY</dt>
3222
+ * <dd>
3213
3223
  * <p>
3214
- * <b>
3215
- * <code>ALLOW_AS_DEPENDENCY</code>
3216
- * </b>: A package in the
3217
- * <code>Rejected</code> patches list is installed only if it is a dependency of another package.
3218
- * It is considered compliant with the patch baseline, and its status is reported as
3219
- * <code>InstalledOther</code>. This is the default action if no option is specified.</p>
3220
- * </li>
3221
- * <li>
3224
+ * <b>Linux and macOS</b>: A package in the rejected patches list
3225
+ * is installed only if it is a dependency of another package. It is considered compliant with
3226
+ * the patch baseline, and its status is reported as <code>INSTALLED_OTHER</code>. This is the
3227
+ * default action if no option is specified.</p>
3222
3228
  * <p>
3223
- * <b>BLOCK</b>: Packages in the <b>Rejected
3224
- * patches</b> list, and packages that include them as dependencies, aren't installed by
3225
- * Patch Manager under any circumstances. If a package was installed before it was added to the
3226
- * <b>Rejected patches</b> list, or is installed outside of Patch
3227
- * Manager afterward, it's considered noncompliant with the patch baseline and its status is
3228
- * reported as <i>InstalledRejected</i>.</p>
3229
- * </li>
3230
- * </ul>
3229
+ * <b>Windows Server</b>: Windows Server doesn't support the
3230
+ * concept of package dependencies. If a package in the rejected patches list and already
3231
+ * installed on the node, its status is reported as <code>INSTALLED_OTHER</code>. Any package not
3232
+ * already installed on the node is skipped. This is the default action if no option is
3233
+ * specified.</p>
3234
+ * </dd>
3235
+ * <dt>BLOCK</dt>
3236
+ * <dd>
3237
+ * <p>
3238
+ * <b>All OSs</b>: Packages in the rejected patches list, and
3239
+ * packages that include them as dependencies, aren't installed by Patch Manager under any
3240
+ * circumstances. If a package was installed before it was added to the rejected patches list, or
3241
+ * is installed outside of Patch Manager afterward, it's considered noncompliant with the patch
3242
+ * baseline and its status is reported as <code>INSTALLED_REJECTED</code>.</p>
3243
+ * </dd>
3244
+ * </dl>
3231
3245
  * @public
3232
3246
  */
3233
3247
  RejectedPatchesAction?: PatchAction;
@@ -6422,10 +6436,15 @@ export interface InstanceInformation {
6422
6436
  */
6423
6437
  ActivationId?: string;
6424
6438
  /**
6425
- * <p>The Identity and Access Management (IAM) role assigned to the on-premises Systems Manager
6426
- * managed node. This call doesn't return the IAM role for Amazon Elastic Compute Cloud
6427
- * (Amazon EC2) instances. To retrieve the IAM role for an EC2 instance, use
6428
- * the Amazon EC2 <code>DescribeInstances</code> operation. For information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html">DescribeInstances</a> in the <i>Amazon EC2 API Reference</i> or <a href="https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html">describe-instances</a> in the <i>Amazon Web Services CLI Command Reference</i>.</p>
6439
+ * <p>The role assigned to an Amazon EC2 instance configured with a Systems Manager
6440
+ * Quick Setup host management configuration or the role assigned to an on-premises managed
6441
+ * node.</p>
6442
+ * <p> This call doesn't return the IAM role for <i>unmanaged</i>
6443
+ * Amazon EC2 instances (instances not configured for Systems Manager). To retrieve the
6444
+ * role for an unmanaged instance, use the Amazon EC2 <code>DescribeInstances</code> operation. For
6445
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html">DescribeInstances</a> in the
6446
+ * <i>Amazon EC2 API Reference</i> or <a href="https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html">describe-instances</a> in the
6447
+ * <i>Amazon Web Services CLI Command Reference</i>.</p>
6429
6448
  * @public
6430
6449
  */
6431
6450
  IamRole?: string;
@@ -7145,7 +7164,8 @@ export declare const InstancePropertyFilterKey: {
7145
7164
  */
7146
7165
  export type InstancePropertyFilterKey = (typeof InstancePropertyFilterKey)[keyof typeof InstancePropertyFilterKey];
7147
7166
  /**
7148
- * <p>Describes a filter for a specific list of managed nodes. You can filter node information by using tags. You specify tags by using a key-value mapping.</p>
7167
+ * <p>Describes a filter for a specific list of managed nodes. You can filter node information by
7168
+ * using tags. You specify tags by using a key-value mapping.</p>
7149
7169
  * @public
7150
7170
  */
7151
7171
  export interface InstancePropertyFilter {
@@ -7176,7 +7196,7 @@ export interface DescribeInstancePropertiesRequest {
7176
7196
  FiltersWithOperator?: InstancePropertyStringFilter[];
7177
7197
  /**
7178
7198
  * <p>The maximum number of items to return for the call. The call also returns a token that you
7179
- * can specify in a subsequent call to get the next set of results.</p>
7199
+ * can specify in a subsequent call to get the next set of results.</p>
7180
7200
  * @public
7181
7201
  */
7182
7202
  MaxResults?: number;
@@ -7192,7 +7212,8 @@ export interface DescribeInstancePropertiesRequest {
7192
7212
  */
7193
7213
  export interface InstanceProperty {
7194
7214
  /**
7195
- * <p>The value of the EC2 <code>Name</code> tag associated with the node. If a <code>Name</code> tag hasn't been applied to the node, this value is blank.</p>
7215
+ * <p>The value of the EC2 <code>Name</code> tag associated with the node. If a <code>Name</code>
7216
+ * tag hasn't been applied to the node, this value is blank.</p>
7196
7217
  * @public
7197
7218
  */
7198
7219
  Name?: string;
@@ -7207,12 +7228,14 @@ export interface InstanceProperty {
7207
7228
  */
7208
7229
  InstanceType?: string;
7209
7230
  /**
7210
- * <p>The instance profile attached to the node. If an instance profile isn't attached to the node, this value is blank.</p>
7231
+ * <p>The instance profile attached to the node. If an instance profile isn't attached to the
7232
+ * node, this value is blank.</p>
7211
7233
  * @public
7212
7234
  */
7213
7235
  InstanceRole?: string;
7214
7236
  /**
7215
- * <p>The name of the key pair associated with the node. If a key pair isnt't associated with the node, this value is blank.</p>
7237
+ * <p>The name of the key pair associated with the node. If a key pair isnt't associated with the
7238
+ * node, this value is blank.</p>
7216
7239
  * @public
7217
7240
  */
7218
7241
  KeyName?: string;
@@ -7222,12 +7245,13 @@ export interface InstanceProperty {
7222
7245
  */
7223
7246
  InstanceState?: string;
7224
7247
  /**
7225
- * <p>The CPU architecture of the node. For example, x86_64.</p>
7248
+ * <p>The CPU architecture of the node. For example, <code>x86_64</code>.</p>
7226
7249
  * @public
7227
7250
  */
7228
7251
  Architecture?: string;
7229
7252
  /**
7230
- * <p>The public IPv4 address assigned to the node. If a public IPv4 address isn't assigned to the node, this value is blank.</p>
7253
+ * <p>The public IPv4 address assigned to the node. If a public IPv4 address isn't assigned to the
7254
+ * node, this value is blank.</p>
7231
7255
  * @public
7232
7256
  */
7233
7257
  IPAddress?: string;
@@ -7267,12 +7291,14 @@ export interface InstanceProperty {
7267
7291
  */
7268
7292
  PlatformVersion?: string;
7269
7293
  /**
7270
- * <p>The activation ID created by Systems Manager when the server or virtual machine (VM) was registered</p>
7294
+ * <p>The activation ID created by Systems Manager when the server or virtual machine (VM) was
7295
+ * registered</p>
7271
7296
  * @public
7272
7297
  */
7273
7298
  ActivationId?: string;
7274
7299
  /**
7275
- * <p>The IAM role used in the hybrid activation to register the node with Systems Manager.</p>
7300
+ * <p>The IAM role used in the hybrid activation to register the node with
7301
+ * Systems Manager.</p>
7276
7302
  * @public
7277
7303
  */
7278
7304
  IamRole?: string;
@@ -7333,7 +7359,7 @@ export interface DescribeInstancePropertiesResult {
7333
7359
  InstanceProperties?: InstanceProperty[];
7334
7360
  /**
7335
7361
  * <p>The token for the next set of properties to return. Use this token to get the next set of
7336
- * results.</p>
7362
+ * results.</p>
7337
7363
  * @public
7338
7364
  */
7339
7365
  NextToken?: string;
@@ -319,8 +319,16 @@ export interface MaintenanceWindowTask {
319
319
  */
320
320
  LoggingInfo?: LoggingInfo;
321
321
  /**
322
- * <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) service role to use to publish Amazon Simple Notification Service
323
- * (Amazon SNS) notifications for maintenance window Run Command tasks.</p>
322
+ * <p>The Amazon Resource Name (ARN) of the IAM service role for
323
+ * Amazon Web Services Systems Manager to assume when running a maintenance window task. If you do not specify a
324
+ * service role ARN, Systems Manager uses a service-linked role in your account. If no
325
+ * appropriate service-linked role for Systems Manager exists in your account, it is created when
326
+ * you run <code>RegisterTaskWithMaintenanceWindow</code>.</p>
327
+ * <p>However, for an improved security posture, we strongly recommend creating a custom
328
+ * policy and custom service role for running your maintenance window tasks. The policy
329
+ * can be crafted to provide only the permissions needed for your particular
330
+ * maintenance window tasks. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html">Setting up maintenance windows</a> in the in the
331
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
324
332
  * @public
325
333
  */
326
334
  ServiceRoleArn?: string;
@@ -1047,8 +1055,9 @@ export interface PatchBaselineIdentity {
1047
1055
  */
1048
1056
  BaselineDescription?: string;
1049
1057
  /**
1050
- * <p>Whether this is the default baseline. Amazon Web Services Systems Manager supports creating multiple default patch
1051
- * baselines. For example, you can create a default patch baseline for each operating system.</p>
1058
+ * <p>Indicates whether this is the default baseline. Amazon Web Services Systems Manager supports creating multiple default
1059
+ * patch baselines. For example, you can create a default patch baseline for each operating
1060
+ * system.</p>
1052
1061
  * @public
1053
1062
  */
1054
1063
  DefaultBaseline?: boolean;
@@ -3392,8 +3401,16 @@ export interface MaintenanceWindowRunCommandParameters {
3392
3401
  */
3393
3402
  Parameters?: Record<string, string[]>;
3394
3403
  /**
3395
- * <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) service role to use to publish Amazon Simple Notification Service
3396
- * (Amazon SNS) notifications for maintenance window Run Command tasks.</p>
3404
+ * <p>The Amazon Resource Name (ARN) of the IAM service role for
3405
+ * Amazon Web Services Systems Manager to assume when running a maintenance window task. If you do not specify a
3406
+ * service role ARN, Systems Manager uses a service-linked role in your account. If no
3407
+ * appropriate service-linked role for Systems Manager exists in your account, it is created when
3408
+ * you run <code>RegisterTaskWithMaintenanceWindow</code>.</p>
3409
+ * <p>However, for an improved security posture, we strongly recommend creating a custom
3410
+ * policy and custom service role for running your maintenance window tasks. The policy
3411
+ * can be crafted to provide only the permissions needed for your particular
3412
+ * maintenance window tasks. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html">Setting up maintenance windows</a> in the in the
3413
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
3397
3414
  * @public
3398
3415
  */
3399
3416
  ServiceRoleArn?: string;
@@ -3489,8 +3506,16 @@ export interface GetMaintenanceWindowTaskResult {
3489
3506
  */
3490
3507
  TaskArn?: string;
3491
3508
  /**
3492
- * <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) service role to use to publish Amazon Simple Notification Service
3493
- * (Amazon SNS) notifications for maintenance window Run Command tasks.</p>
3509
+ * <p>The Amazon Resource Name (ARN) of the IAM service role for
3510
+ * Amazon Web Services Systems Manager to assume when running a maintenance window task. If you do not specify a
3511
+ * service role ARN, Systems Manager uses a service-linked role in your account. If no
3512
+ * appropriate service-linked role for Systems Manager exists in your account, it is created when
3513
+ * you run <code>RegisterTaskWithMaintenanceWindow</code>.</p>
3514
+ * <p>However, for an improved security posture, we strongly recommend creating a custom
3515
+ * policy and custom service role for running your maintenance window tasks. The policy
3516
+ * can be crafted to provide only the permissions needed for your particular
3517
+ * maintenance window tasks. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html">Setting up maintenance windows</a> in the in the
3518
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
3494
3519
  * @public
3495
3520
  */
3496
3521
  ServiceRoleArn?: string;
@@ -1255,8 +1255,16 @@ export interface UpdateMaintenanceWindowTaskResult {
1255
1255
  */
1256
1256
  TaskArn?: string;
1257
1257
  /**
1258
- * <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) service role to use to publish Amazon Simple Notification Service
1259
- * (Amazon SNS) notifications for maintenance window Run Command tasks.</p>
1258
+ * <p>The Amazon Resource Name (ARN) of the IAM service role for
1259
+ * Amazon Web Services Systems Manager to assume when running a maintenance window task. If you do not specify a
1260
+ * service role ARN, Systems Manager uses a service-linked role in your account. If no
1261
+ * appropriate service-linked role for Systems Manager exists in your account, it is created when
1262
+ * you run <code>RegisterTaskWithMaintenanceWindow</code>.</p>
1263
+ * <p>However, for an improved security posture, we strongly recommend creating a custom
1264
+ * policy and custom service role for running your maintenance window tasks. The policy
1265
+ * can be crafted to provide only the permissions needed for your particular
1266
+ * maintenance window tasks. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html">Setting up maintenance windows</a> in the in the
1267
+ * <i>Amazon Web Services Systems Manager User Guide</i>.</p>
1260
1268
  * @public
1261
1269
  */
1262
1270
  ServiceRoleArn?: string;
@@ -1571,26 +1579,31 @@ export interface UpdatePatchBaselineRequest {
1571
1579
  /**
1572
1580
  * <p>The action for Patch Manager to take on patches included in the
1573
1581
  * <code>RejectedPackages</code> list.</p>
1574
- * <ul>
1575
- * <li>
1582
+ * <dl>
1583
+ * <dt>ALLOW_AS_DEPENDENCY</dt>
1584
+ * <dd>
1576
1585
  * <p>
1577
- * <b>
1578
- * <code>ALLOW_AS_DEPENDENCY</code>
1579
- * </b>: A package in the
1580
- * <code>Rejected</code> patches list is installed only if it is a dependency of another package.
1581
- * It is considered compliant with the patch baseline, and its status is reported as
1582
- * <code>InstalledOther</code>. This is the default action if no option is specified.</p>
1583
- * </li>
1584
- * <li>
1586
+ * <b>Linux and macOS</b>: A package in the rejected patches list
1587
+ * is installed only if it is a dependency of another package. It is considered compliant with
1588
+ * the patch baseline, and its status is reported as <code>INSTALLED_OTHER</code>. This is the
1589
+ * default action if no option is specified.</p>
1585
1590
  * <p>
1586
- * <b>BLOCK</b>: Packages in the <b>Rejected
1587
- * patches</b> list, and packages that include them as dependencies, aren't installed by
1588
- * Patch Manager under any circumstances. If a package was installed before it was added to the
1589
- * <b>Rejected patches</b> list, or is installed outside of Patch
1590
- * Manager afterward, it's considered noncompliant with the patch baseline and its status is
1591
- * reported as <i>InstalledRejected</i>.</p>
1592
- * </li>
1593
- * </ul>
1591
+ * <b>Windows Server</b>: Windows Server doesn't support the
1592
+ * concept of package dependencies. If a package in the rejected patches list and already
1593
+ * installed on the node, its status is reported as <code>INSTALLED_OTHER</code>. Any package not
1594
+ * already installed on the node is skipped. This is the default action if no option is
1595
+ * specified.</p>
1596
+ * </dd>
1597
+ * <dt>BLOCK</dt>
1598
+ * <dd>
1599
+ * <p>
1600
+ * <b>All OSs</b>: Packages in the rejected patches list, and
1601
+ * packages that include them as dependencies, aren't installed by Patch Manager under any
1602
+ * circumstances. If a package was installed before it was added to the rejected patches list, or
1603
+ * is installed outside of Patch Manager afterward, it's considered noncompliant with the patch
1604
+ * baseline and its status is reported as <code>INSTALLED_REJECTED</code>.</p>
1605
+ * </dd>
1606
+ * </dl>
1594
1607
  * @public
1595
1608
  */
1596
1609
  RejectedPatchesAction?: PatchAction;
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.624.0",
4
+ "version": "3.629.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,10 +20,10 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
- "@aws-sdk/client-sso-oidc": "3.624.0",
24
- "@aws-sdk/client-sts": "3.624.0",
25
- "@aws-sdk/core": "3.624.0",
26
- "@aws-sdk/credential-provider-node": "3.624.0",
23
+ "@aws-sdk/client-sso-oidc": "3.629.0",
24
+ "@aws-sdk/client-sts": "3.629.0",
25
+ "@aws-sdk/core": "3.629.0",
26
+ "@aws-sdk/credential-provider-node": "3.629.0",
27
27
  "@aws-sdk/middleware-host-header": "3.620.0",
28
28
  "@aws-sdk/middleware-logger": "3.609.0",
29
29
  "@aws-sdk/middleware-recursion-detection": "3.620.0",