From c587e277524d7aa4393fdbf1e8eadd7e12fc8d86 Mon Sep 17 00:00:00 2001 From: awstools Date: Wed, 31 Jan 2024 20:15:52 +0000 Subject: [PATCH] feat(client-ssm): This release adds an optional Duration parameter to StateManager Associations. This allows customers to specify how long an apply-only-on-cron association execution should run. Once the specified Duration is out all the ongoing cancellable commands or automations are cancelled. --- .../commands/CreateAssociationBatchCommand.ts | 3 + .../src/commands/CreateAssociationCommand.ts | 2 + .../commands/DescribeAssociationCommand.ts | 1 + .../DescribeAvailablePatchesCommand.ts | 4 ++ .../ListAssociationVersionsCommand.ts | 1 + .../src/commands/ListAssociationsCommand.ts | 1 + .../src/commands/UpdateAssociationCommand.ts | 2 + .../UpdateAssociationStatusCommand.ts | 1 + clients/client-ssm/src/models/models_0.ts | 60 +++++++++++++++- clients/client-ssm/src/models/models_1.ts | 35 +++++++--- clients/client-ssm/src/models/models_2.ts | 24 ++++++- .../client-ssm/src/protocols/Aws_json1_1.ts | 3 + codegen/sdk-codegen/aws-models/ssm.json | 69 +++++++++++++++---- 13 files changed, 181 insertions(+), 25 deletions(-) diff --git a/clients/client-ssm/src/commands/CreateAssociationBatchCommand.ts b/clients/client-ssm/src/commands/CreateAssociationBatchCommand.ts index bb964c87e9f6..f2a945487c93 100644 --- a/clients/client-ssm/src/commands/CreateAssociationBatchCommand.ts +++ b/clients/client-ssm/src/commands/CreateAssociationBatchCommand.ts @@ -105,6 +105,7 @@ export interface CreateAssociationBatchCommandOutput extends CreateAssociationBa * }, * ], * ScheduleOffset: Number("int"), + * Duration: Number("int"), * TargetMaps: [ // TargetMaps * { // TargetMap * "": [ // TargetMapValueList @@ -203,6 +204,7 @@ export interface CreateAssociationBatchCommandOutput extends CreateAssociationBa * // }, * // ], * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList @@ -278,6 +280,7 @@ export interface CreateAssociationBatchCommandOutput extends CreateAssociationBa * // }, * // ], * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ * // { * // "": [ diff --git a/clients/client-ssm/src/commands/CreateAssociationCommand.ts b/clients/client-ssm/src/commands/CreateAssociationCommand.ts index 22abc3815371..01a6d369d26e 100644 --- a/clients/client-ssm/src/commands/CreateAssociationCommand.ts +++ b/clients/client-ssm/src/commands/CreateAssociationCommand.ts @@ -106,6 +106,7 @@ export interface CreateAssociationCommandOutput extends CreateAssociationResult, * }, * ], * ScheduleOffset: Number("int"), + * Duration: Number("int"), * TargetMaps: [ // TargetMaps * { // TargetMap * "": [ // TargetMapValueList @@ -207,6 +208,7 @@ export interface CreateAssociationCommandOutput extends CreateAssociationResult, * // }, * // ], * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList diff --git a/clients/client-ssm/src/commands/DescribeAssociationCommand.ts b/clients/client-ssm/src/commands/DescribeAssociationCommand.ts index 769119a53c06..2c38622e787a 100644 --- a/clients/client-ssm/src/commands/DescribeAssociationCommand.ts +++ b/clients/client-ssm/src/commands/DescribeAssociationCommand.ts @@ -126,6 +126,7 @@ export interface DescribeAssociationCommandOutput extends DescribeAssociationRes * // }, * // ], * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList diff --git a/clients/client-ssm/src/commands/DescribeAvailablePatchesCommand.ts b/clients/client-ssm/src/commands/DescribeAvailablePatchesCommand.ts index 5d15c18e75ab..0d600d3359e4 100644 --- a/clients/client-ssm/src/commands/DescribeAvailablePatchesCommand.ts +++ b/clients/client-ssm/src/commands/DescribeAvailablePatchesCommand.ts @@ -29,6 +29,10 @@ export interface DescribeAvailablePatchesCommandOutput extends DescribeAvailable /** * @public *

Lists all patches eligible to be included in a patch baseline.

+ * + *

Currently, DescribeAvailablePatches supports only the Amazon Linux 1, Amazon + * Linux 2, and Windows Server operating systems.

+ * * @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-ssm/src/commands/ListAssociationVersionsCommand.ts b/clients/client-ssm/src/commands/ListAssociationVersionsCommand.ts index 49e57a799041..74e09fc92a55 100644 --- a/clients/client-ssm/src/commands/ListAssociationVersionsCommand.ts +++ b/clients/client-ssm/src/commands/ListAssociationVersionsCommand.ts @@ -106,6 +106,7 @@ export interface ListAssociationVersionsCommandOutput extends ListAssociationVer * // }, * // ], * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList diff --git a/clients/client-ssm/src/commands/ListAssociationsCommand.ts b/clients/client-ssm/src/commands/ListAssociationsCommand.ts index 94a8f51e3ce4..9dc3e576afbf 100644 --- a/clients/client-ssm/src/commands/ListAssociationsCommand.ts +++ b/clients/client-ssm/src/commands/ListAssociationsCommand.ts @@ -76,6 +76,7 @@ export interface ListAssociationsCommandOutput extends ListAssociationsResult, _ * // ScheduleExpression: "STRING_VALUE", * // AssociationName: "STRING_VALUE", * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList diff --git a/clients/client-ssm/src/commands/UpdateAssociationCommand.ts b/clients/client-ssm/src/commands/UpdateAssociationCommand.ts index 7bf62ab45b1b..a2c718913457 100644 --- a/clients/client-ssm/src/commands/UpdateAssociationCommand.ts +++ b/clients/client-ssm/src/commands/UpdateAssociationCommand.ts @@ -117,6 +117,7 @@ export interface UpdateAssociationCommandOutput extends UpdateAssociationResult, * }, * ], * ScheduleOffset: Number("int"), + * Duration: Number("int"), * TargetMaps: [ // TargetMaps * { // TargetMap * "": [ // TargetMapValueList @@ -212,6 +213,7 @@ export interface UpdateAssociationCommandOutput extends UpdateAssociationResult, * // }, * // ], * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList diff --git a/clients/client-ssm/src/commands/UpdateAssociationStatusCommand.ts b/clients/client-ssm/src/commands/UpdateAssociationStatusCommand.ts index f27fc7a5974c..59426f1b1930 100644 --- a/clients/client-ssm/src/commands/UpdateAssociationStatusCommand.ts +++ b/clients/client-ssm/src/commands/UpdateAssociationStatusCommand.ts @@ -133,6 +133,7 @@ export interface UpdateAssociationStatusCommandOutput extends UpdateAssociationS * // }, * // ], * // ScheduleOffset: Number("int"), + * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList diff --git a/clients/client-ssm/src/models/models_0.ts b/clients/client-ssm/src/models/models_0.ts index 383250e6dfae..6b745318f691 100644 --- a/clients/client-ssm/src/models/models_0.ts +++ b/clients/client-ssm/src/models/models_0.ts @@ -1329,6 +1329,28 @@ export interface CreateAssociationRequest { */ ScheduleOffset?: number; + /** + * @public + *

The number of hours the association can run before it is canceled. Duration applies to + * associations that are currently running, and any pending and in progress commands on all targets. + * If a target was taken offline for the association to run, it is made available again immediately, + * without a reboot.

+ *

The Duration parameter applies only when both these conditions are true:

+ *
    + *
  • + *

    The association for which you specify a duration is cancelable according to the parameters + * of the SSM command document or Automation runbook associated with this execution.

    + *
    • + *
  • + *

    The command specifies the + * ApplyOnlyAtCronInterval + * parameter, which means that the association doesn't + * run immediately after it is created, but only according to the specified schedule.

    + *
    • + *
+ */ + Duration?: number; + /** * @public *

A key-value mapping of document parameters to target resources. Both Targets and TargetMaps @@ -1613,6 +1635,14 @@ export interface AssociationDescription { */ ScheduleOffset?: number; + /** + * @public + *

The number of hours that an association can run on specified targets. After the resulting + * cutoff time passes, associations that are currently running are cancelled, and no pending + * executions are started on remaining targets.

+ */ + Duration?: number; + /** * @public *

A key-value mapping of document parameters to target resources. Both Targets and TargetMaps @@ -1993,6 +2023,28 @@ export interface CreateAssociationBatchRequestEntry { */ ScheduleOffset?: number; + /** + * @public + *

The number of hours the association can run before it is canceled. Duration applies to + * associations that are currently running, and any pending and in progress commands on all targets. + * If a target was taken offline for the association to run, it is made available again immediately, + * without a reboot.

+ *

The Duration parameter applies only when both these conditions are true:

+ *
    + *
  • + *

    The association for which you specify a duration is cancelable according to the parameters + * of the SSM command document or Automation runbook associated with this execution.

    + *
    • + *
  • + *

    The command specifies the + * ApplyOnlyAtCronInterval + * parameter, which means that the association doesn't + * run immediately after it is created, but only according to the specified schedule.

    + *
    • + *
+ */ + Duration?: number; + /** * @public *

A key-value mapping of document parameters to target resources. Both Targets and TargetMaps @@ -2217,7 +2269,7 @@ export interface DocumentRequires { /** * @public *

An optional field specifying the version of the artifact associated with the document. For - * example, "Release 12, Update 6". This value is unique across all versions of a document, and + * example, 12.6. This value is unique across all versions of a document, and * can't be changed.

*/ VersionName?: string; @@ -6810,7 +6862,7 @@ export interface DescribeDocumentRequest { /** * @public *

An optional field specifying the version of the artifact associated with the document. For - * example, "Release 12, Update 6". This value is unique across all versions of a document, and + * example, 12.6. This value is unique across all versions of a document, and * can't be changed.

*/ VersionName?: string; @@ -7794,6 +7846,10 @@ export interface PatchComplianceData { * @public *

The IDs of one or more Common Vulnerabilities and Exposure (CVE) issues that are resolved by * the patch.

+ * + *

Currently, CVE ID values are reported only for patches with a status of + * Missing or Failed.

+ * */ CVEIds?: string; } diff --git a/clients/client-ssm/src/models/models_1.ts b/clients/client-ssm/src/models/models_1.ts index cf2ed49b4e08..d01eb88fc9fd 100644 --- a/clients/client-ssm/src/models/models_1.ts +++ b/clients/client-ssm/src/models/models_1.ts @@ -739,7 +739,8 @@ export interface ParameterMetadata { /** * @public - *

The ID of the query key used for this parameter.

+ *

The alias of the Key Management Service (KMS) key used to encrypt the + * parameter. Applies to SecureString parameters only.

*/ KeyId?: string; @@ -2262,8 +2263,7 @@ export interface GetConnectionStatusResponse { /** * @public - *

The status of the connection to the managed node. For example, 'Connected' or 'Not - * Connected'.

+ *

The status of the connection to the managed node.

*/ Status?: ConnectionStatus; } @@ -2461,7 +2461,7 @@ export interface GetDocumentRequest { /** * @public *

An optional field specifying the version of the artifact associated with the document. For - * example, "Release 12, Update 6". This value is unique across all versions of a document and can't + * example, 12.6. This value is unique across all versions of a document and can't * be changed.

*/ VersionName?: string; @@ -2554,8 +2554,7 @@ export interface GetDocumentResult { /** * @public - *

The version of the artifact associated with the document. For example, "Release 12, Update - * 6". This value is unique across all versions of a document, and can't be changed.

+ *

The version of the artifact associated with the document. For example, 12.6. This value is unique across all versions of a document, and can't be changed.

*/ VersionName?: string; @@ -4434,7 +4433,8 @@ export interface ParameterHistory { /** * @public - *

The ID of the query key used for this parameter.

+ *

The alias of the Key Management Service (KMS) key used to encrypt the + * parameter. Applies to SecureString parameters only

*/ KeyId?: string; @@ -5254,6 +5254,14 @@ export interface Association { */ ScheduleOffset?: number; + /** + * @public + *

The number of hours that an association can run on specified targets. After the resulting + * cutoff time passes, associations that are currently running are cancelled, and no pending + * executions are started on remaining targets.

+ */ + Duration?: number; + /** * @public *

A key-value mapping of document parameters to target resources. Both Targets and TargetMaps @@ -5453,6 +5461,14 @@ export interface AssociationVersionInfo { */ ScheduleOffset?: number; + /** + * @public + *

The number of hours that an association can run on specified targets. After the resulting + * cutoff time passes, associations that are currently running are cancelled, and no pending + * executions are started on remaining targets.

+ */ + Duration?: number; + /** * @public *

A key-value mapping of document parameters to target resources. Both Targets and TargetMaps @@ -7225,7 +7241,7 @@ export interface DocumentIdentifier { /** * @public *

An optional field specifying the version of the artifact associated with the document. For - * example, "Release 12, Update 6". This value is unique across all versions of a document, and + * example, 12.6. This value is unique across all versions of a document, and * can't be changed.

*/ VersionName?: string; @@ -7364,8 +7380,7 @@ export interface DocumentVersionInfo { /** * @public - *

The version of the artifact associated with the document. For example, "Release 12, Update - * 6". This value is unique across all versions of a document, and can't be changed.

+ *

The version of the artifact associated with the document. For example, 12.6. This value is unique across all versions of a document, and can't be changed.

*/ VersionName?: string; diff --git a/clients/client-ssm/src/models/models_2.ts b/clients/client-ssm/src/models/models_2.ts index 78ef87680a9e..6bc03f631286 100644 --- a/clients/client-ssm/src/models/models_2.ts +++ b/clients/client-ssm/src/models/models_2.ts @@ -335,6 +335,28 @@ export interface UpdateAssociationRequest { */ ScheduleOffset?: number; + /** + * @public + *

The number of hours the association can run before it is canceled. Duration applies to + * associations that are currently running, and any pending and in progress commands on all targets. + * If a target was taken offline for the association to run, it is made available again immediately, + * without a reboot.

+ *

The Duration parameter applies only when both these conditions are true:

+ *
    + *
  • + *

    The association for which you specify a duration is cancelable according to the parameters + * of the SSM command document or Automation runbook associated with this execution.

    + *
    • + *
  • + *

    The command specifies the + * ApplyOnlyAtCronInterval + * parameter, which means that the association doesn't + * run immediately after it is updated, but only according to the specified schedule.

    + *
    • + *
+ */ + Duration?: number; + /** * @public *

A key-value mapping of document parameters to target resources. Both Targets and TargetMaps @@ -517,7 +539,7 @@ export interface UpdateDocumentRequest { /** * @public *

An optional field specifying the version of the artifact you are updating with the document. - * For example, "Release 12, Update 6". This value is unique across all versions of a document, and + * For example, 12.6. This value is unique across all versions of a document, and * can't be changed.

*/ VersionName?: string; diff --git a/clients/client-ssm/src/protocols/Aws_json1_1.ts b/clients/client-ssm/src/protocols/Aws_json1_1.ts index b6fc4c8c66d6..0e625ba2c626 100644 --- a/clients/client-ssm/src/protocols/Aws_json1_1.ts +++ b/clients/client-ssm/src/protocols/Aws_json1_1.ts @@ -13198,6 +13198,7 @@ const de_Association = (output: any, context: __SerdeContext): Association => { AssociationName: __expectString, AssociationVersion: __expectString, DocumentVersion: __expectString, + Duration: __expectInt32, InstanceId: __expectString, LastExecutionDate: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))), Name: __expectString, @@ -13226,6 +13227,7 @@ const de_AssociationDescription = (output: any, context: __SerdeContext): Associ ComplianceSeverity: __expectString, Date: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))), DocumentVersion: __expectString, + Duration: __expectInt32, InstanceId: __expectString, LastExecutionDate: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))), LastSuccessfulExecutionDate: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))), @@ -13365,6 +13367,7 @@ const de_AssociationVersionInfo = (output: any, context: __SerdeContext): Associ ComplianceSeverity: __expectString, CreatedDate: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))), DocumentVersion: __expectString, + Duration: __expectInt32, MaxConcurrency: __expectString, MaxErrors: __expectString, Name: __expectString, diff --git a/codegen/sdk-codegen/aws-models/ssm.json b/codegen/sdk-codegen/aws-models/ssm.json index eefe52273f19..ac3fe4e15829 100644 --- a/codegen/sdk-codegen/aws-models/ssm.json +++ b/codegen/sdk-codegen/aws-models/ssm.json @@ -2031,6 +2031,12 @@ "smithy.api#documentation": "

Number of days to wait after the scheduled day to run an association.

" } }, + "Duration": { + "target": "com.amazonaws.ssm#Duration", + "traits": { + "smithy.api#documentation": "

The number of hours that an association can run on specified targets. After the resulting\n cutoff time passes, associations that are currently running are cancelled, and no pending\n executions are started on remaining targets.

" + } + }, "TargetMaps": { "target": "com.amazonaws.ssm#TargetMaps", "traits": { @@ -2243,6 +2249,12 @@ "smithy.api#documentation": "

Number of days to wait after the scheduled day to run an association.

" } }, + "Duration": { + "target": "com.amazonaws.ssm#Duration", + "traits": { + "smithy.api#documentation": "

The number of hours that an association can run on specified targets. After the resulting\n cutoff time passes, associations that are currently running are cancelled, and no pending\n executions are started on remaining targets.

" + } + }, "TargetMaps": { "target": "com.amazonaws.ssm#TargetMaps", "traits": { @@ -3007,6 +3019,12 @@ "smithy.api#documentation": "

Number of days to wait after the scheduled day to run an association.

" } }, + "Duration": { + "target": "com.amazonaws.ssm#Duration", + "traits": { + "smithy.api#documentation": "

The number of hours that an association can run on specified targets. After the resulting\n cutoff time passes, associations that are currently running are cancelled, and no pending\n executions are started on remaining targets.

" + } + }, "TargetMaps": { "target": "com.amazonaws.ssm#TargetMaps", "traits": { @@ -5924,6 +5942,12 @@ "smithy.api#documentation": "

Number of days to wait after the scheduled day to run an association.

" } }, + "Duration": { + "target": "com.amazonaws.ssm#Duration", + "traits": { + "smithy.api#documentation": "

The number of hours the association can run before it is canceled. Duration applies to\n associations that are currently running, and any pending and in progress commands on all targets.\n If a target was taken offline for the association to run, it is made available again immediately,\n without a reboot.

\n

The Duration parameter applies only when both these conditions are true:

\n
    \n
  • \n

    The association for which you specify a duration is cancelable according to the parameters\n of the SSM command document or Automation runbook associated with this execution.

    \n
    • \n
  • \n

    The command specifies the \n ApplyOnlyAtCronInterval\n parameter, which means that the association doesn't\n run immediately after it is created, but only according to the specified schedule.

    \n
    • \n
" + } + }, "TargetMaps": { "target": "com.amazonaws.ssm#TargetMaps", "traits": { @@ -6065,6 +6089,12 @@ "smithy.api#documentation": "

Number of days to wait after the scheduled day to run an association. For example, if you\n specified a cron schedule of cron(0 0 ? * THU#2 *), you could specify an offset of 3\n to run the association each Sunday after the second Thursday of the month. For more information\n about cron schedules for associations, see Reference: Cron\n and rate expressions for Systems Manager in the Amazon Web Services Systems Manager User Guide.

\n \n

To use offsets, you must specify the ApplyOnlyAtCronInterval parameter. This\n option tells the system not to run an association immediately after you create it.

\n " } }, + "Duration": { + "target": "com.amazonaws.ssm#Duration", + "traits": { + "smithy.api#documentation": "

The number of hours the association can run before it is canceled. Duration applies to\n associations that are currently running, and any pending and in progress commands on all targets.\n If a target was taken offline for the association to run, it is made available again immediately,\n without a reboot.

\n

The Duration parameter applies only when both these conditions are true:

\n
    \n
  • \n

    The association for which you specify a duration is cancelable according to the parameters\n of the SSM command document or Automation runbook associated with this execution.

    \n
    • \n
  • \n

    The command specifies the \n ApplyOnlyAtCronInterval\n parameter, which means that the association doesn't\n run immediately after it is created, but only according to the specified schedule.

    \n
    • \n
" + } + }, "TargetMaps": { "target": "com.amazonaws.ssm#TargetMaps", "traits": { @@ -8253,7 +8283,7 @@ } ], "traits": { - "smithy.api#documentation": "

Lists all patches eligible to be included in a patch baseline.

", + "smithy.api#documentation": "

Lists all patches eligible to be included in a patch baseline.

\n \n

Currently, DescribeAvailablePatches supports only the Amazon Linux 1, Amazon\n Linux 2, and Windows Server operating systems.

\n ", "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -8439,7 +8469,7 @@ "VersionName": { "target": "com.amazonaws.ssm#DocumentVersionName", "traits": { - "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, \"Release 12, Update 6\". This value is unique across all versions of a document, and\n can't be changed.

" + "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, 12.6. This value is unique across all versions of a document, and\n can't be changed.

" } } }, @@ -10784,7 +10814,7 @@ "VersionName": { "target": "com.amazonaws.ssm#DocumentVersionName", "traits": { - "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, \"Release 12, Update 6\". This value is unique across all versions of a document, and\n can't be changed.

" + "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, 12.6. This value is unique across all versions of a document, and\n can't be changed.

" } }, "PlatformTypes": { @@ -11095,7 +11125,7 @@ "VersionName": { "target": "com.amazonaws.ssm#DocumentVersionName", "traits": { - "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, \"Release 12, Update 6\". This value is unique across all versions of a document, and\n can't be changed.

" + "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, 12.6. This value is unique across all versions of a document, and\n can't be changed.

" } } }, @@ -11436,7 +11466,7 @@ "VersionName": { "target": "com.amazonaws.ssm#DocumentVersionName", "traits": { - "smithy.api#documentation": "

The version of the artifact associated with the document. For example, \"Release 12, Update\n 6\". This value is unique across all versions of a document, and can't be changed.

" + "smithy.api#documentation": "

The version of the artifact associated with the document. For example, 12.6. This value is unique across all versions of a document, and can't be changed.

" } }, "CreatedDate": { @@ -11586,6 +11616,15 @@ "smithy.api#error": "client" } }, + "com.amazonaws.ssm#Duration": { + "type": "integer", + "traits": { + "smithy.api#range": { + "min": 1, + "max": 24 + } + } + }, "com.amazonaws.ssm#EffectiveInstanceAssociationMaxResults": { "type": "integer", "traits": { @@ -12201,7 +12240,7 @@ "Status": { "target": "com.amazonaws.ssm#ConnectionStatus", "traits": { - "smithy.api#documentation": "

The status of the connection to the managed node. For example, 'Connected' or 'Not\n Connected'.

" + "smithy.api#documentation": "

The status of the connection to the managed node.

" } } }, @@ -12379,7 +12418,7 @@ "VersionName": { "target": "com.amazonaws.ssm#DocumentVersionName", "traits": { - "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, \"Release 12, Update 6\". This value is unique across all versions of a document and can't\n be changed.

" + "smithy.api#documentation": "

An optional field specifying the version of the artifact associated with the document. For\n example, 12.6. This value is unique across all versions of a document and can't\n be changed.

" } }, "DocumentVersion": { @@ -12423,7 +12462,7 @@ "VersionName": { "target": "com.amazonaws.ssm#DocumentVersionName", "traits": { - "smithy.api#documentation": "

The version of the artifact associated with the document. For example, \"Release 12, Update\n 6\". This value is unique across all versions of a document, and can't be changed.

" + "smithy.api#documentation": "

The version of the artifact associated with the document. For example, 12.6. This value is unique across all versions of a document, and can't be changed.

" } }, "DocumentVersion": { @@ -21808,7 +21847,7 @@ "KeyId": { "target": "com.amazonaws.ssm#ParameterKeyId", "traits": { - "smithy.api#documentation": "

The ID of the query key used for this parameter.

" + "smithy.api#documentation": "

The alias of the Key Management Service (KMS) key used to encrypt the\n parameter. Applies to SecureString parameters only

" } }, "LastModifiedDate": { @@ -21996,7 +22035,7 @@ "KeyId": { "target": "com.amazonaws.ssm#ParameterKeyId", "traits": { - "smithy.api#documentation": "

The ID of the query key used for this parameter.

" + "smithy.api#documentation": "

The alias of the Key Management Service (KMS) key used to encrypt the\n parameter. Applies to SecureString parameters only.

" } }, "LastModifiedDate": { @@ -22709,7 +22748,7 @@ "CVEIds": { "target": "com.amazonaws.ssm#PatchCVEIds", "traits": { - "smithy.api#documentation": "

The IDs of one or more Common Vulnerabilities and Exposure (CVE) issues that are resolved by\n the patch.

" + "smithy.api#documentation": "

The IDs of one or more Common Vulnerabilities and Exposure (CVE) issues that are resolved by\n the patch.

\n \n

Currently, CVE ID values are reported only for patches with a status of\n Missing or Failed.

\n " } } }, @@ -28268,6 +28307,12 @@ "smithy.api#documentation": "

Number of days to wait after the scheduled day to run an association. For example, if you\n specified a cron schedule of cron(0 0 ? * THU#2 *), you could specify an offset of 3\n to run the association each Sunday after the second Thursday of the month. For more information\n about cron schedules for associations, see Reference: Cron\n and rate expressions for Systems Manager in the Amazon Web Services Systems Manager User Guide.

\n \n

To use offsets, you must specify the ApplyOnlyAtCronInterval parameter. This\n option tells the system not to run an association immediately after you create it.

\n " } }, + "Duration": { + "target": "com.amazonaws.ssm#Duration", + "traits": { + "smithy.api#documentation": "

The number of hours the association can run before it is canceled. Duration applies to\n associations that are currently running, and any pending and in progress commands on all targets.\n If a target was taken offline for the association to run, it is made available again immediately,\n without a reboot.

\n

The Duration parameter applies only when both these conditions are true:

\n
    \n
  • \n

    The association for which you specify a duration is cancelable according to the parameters\n of the SSM command document or Automation runbook associated with this execution.

    \n
    • \n
  • \n

    The command specifies the \n ApplyOnlyAtCronInterval\n parameter, which means that the association doesn't\n run immediately after it is updated, but only according to the specified schedule.

    \n
    • \n
" + } + }, "TargetMaps": { "target": "com.amazonaws.ssm#TargetMaps", "traits": { @@ -28570,7 +28615,7 @@ "VersionName": { "target": "com.amazonaws.ssm#DocumentVersionName", "traits": { - "smithy.api#documentation": "

An optional field specifying the version of the artifact you are updating with the document.\n For example, \"Release 12, Update 6\". This value is unique across all versions of a document, and\n can't be changed.

" + "smithy.api#documentation": "

An optional field specifying the version of the artifact you are updating with the document.\n For example, 12.6. This value is unique across all versions of a document, and\n can't be changed.

" } }, "DocumentVersion": {