feat(client-ssm): Introduces AccessType, a new filter value for the DescribeSessions API.

awstools · awstools · commit daee31fbf935 · 2025-06-30T18:36:45.000Z
diff --git a/clients/client-ssm/README.md b/clients/client-ssm/README.md
@@ -9,7 +9,8 @@ AWS SDK for JavaScript SSM Client for Node.js, Browser and React Native.
 <p>Amazon Web Services Systems Manager is the operations hub for your Amazon Web Services applications and resources and a secure
 end-to-end management solution for hybrid cloud environments that enables safe and secure
 operations at scale.</p>
-<p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html">Setting up Amazon Web Services Systems Manager</a>.</p>
+<p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-console.html">Setting up
+Amazon Web Services Systems Manager</a>.</p>
 <p class="title">
 <b>Related resources</b>
 </p>
diff --git a/clients/client-ssm/src/SSM.ts b/clients/client-ssm/src/SSM.ts
@@ -3253,7 +3253,8 @@ export interface SSM {
  * <p>Amazon Web Services Systems Manager is the operations hub for your Amazon Web Services applications and resources and a secure
  *    end-to-end management solution for hybrid cloud environments that enables safe and secure
  *    operations at scale.</p>
- *          <p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html">Setting up Amazon Web Services Systems Manager</a>.</p>
+ *          <p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-console.html">Setting up
+ *     Amazon Web Services Systems Manager</a>.</p>
  *          <p class="title">
  *             <b>Related resources</b>
  *          </p>
diff --git a/clients/client-ssm/src/SSMClient.ts b/clients/client-ssm/src/SSMClient.ts
@@ -991,7 +991,8 @@ export interface SSMClientResolvedConfig extends SSMClientResolvedConfigType {}
  * <p>Amazon Web Services Systems Manager is the operations hub for your Amazon Web Services applications and resources and a secure
  *    end-to-end management solution for hybrid cloud environments that enables safe and secure
  *    operations at scale.</p>
- *          <p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html">Setting up Amazon Web Services Systems Manager</a>.</p>
+ *          <p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-console.html">Setting up
+ *     Amazon Web Services Systems Manager</a>.</p>
  *          <p class="title">
  *             <b>Related resources</b>
  *          </p>
diff --git a/clients/client-ssm/src/commands/CreateDocumentCommand.ts b/clients/client-ssm/src/commands/CreateDocumentCommand.ts
@@ -168,6 +168,9 @@ export interface CreateDocumentCommandOutput extends CreateDocumentResult, __Met
  * @throws {@link MaxDocumentSizeExceeded} (client fault)
  *  <p>The size limit of a document is 64 KB.</p>
  *
+ * @throws {@link TooManyUpdates} (client fault)
+ *  <p>There are concurrent updates for a resource that supports one update at a time.</p>
+ *
  * @throws {@link SSMServiceException}
  * <p>Base exception class for all service exceptions from SSM service.</p>
  *
diff --git a/clients/client-ssm/src/commands/DeleteDocumentCommand.ts b/clients/client-ssm/src/commands/DeleteDocumentCommand.ts
@@ -68,6 +68,9 @@ export interface DeleteDocumentCommandOutput extends DeleteDocumentResult, __Met
  *  <p>You attempted to delete a document while it is still shared. You must stop sharing the
  *    document before you can delete it.</p>
  *
+ * @throws {@link TooManyUpdates} (client fault)
+ *  <p>There are concurrent updates for a resource that supports one update at a time.</p>
+ *
  * @throws {@link SSMServiceException}
  * <p>Base exception class for all service exceptions from SSM service.</p>
  *
diff --git a/clients/client-ssm/src/commands/DescribeMaintenanceWindowsCommand.ts b/clients/client-ssm/src/commands/DescribeMaintenanceWindowsCommand.ts
@@ -5,11 +5,11 @@ import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { commonParams } from "../endpoint/EndpointParameters";
+import { DescribeMaintenanceWindowsRequest } from "../models/models_0";
 import {
-  DescribeMaintenanceWindowsRequest,
   DescribeMaintenanceWindowsResult,
   DescribeMaintenanceWindowsResultFilterSensitiveLog,
-} from "../models/models_0";
+} from "../models/models_1";
 import { de_DescribeMaintenanceWindowsCommand, se_DescribeMaintenanceWindowsCommand } from "../protocols/Aws_json1_1";
 import { ServiceInputTypes, ServiceOutputTypes, SSMClientResolvedConfig } from "../SSMClient";
 
diff --git a/clients/client-ssm/src/commands/DescribeSessionsCommand.ts b/clients/client-ssm/src/commands/DescribeSessionsCommand.ts
@@ -42,7 +42,7 @@ export interface DescribeSessionsCommandOutput extends DescribeSessionsResponse,
  *   NextToken: "STRING_VALUE",
  *   Filters: [ // SessionFilterList
  *     { // SessionFilter
- *       key: "InvokedAfter" || "InvokedBefore" || "Target" || "Owner" || "Status" || "SessionId", // required
+ *       key: "InvokedAfter" || "InvokedBefore" || "Target" || "Owner" || "Status" || "SessionId" || "AccessType", // required
  *       value: "STRING_VALUE", // required
  *     },
  *   ],
@@ -66,6 +66,7 @@ export interface DescribeSessionsCommandOutput extends DescribeSessionsResponse,
  * //         CloudWatchOutputUrl: "STRING_VALUE",
  * //       },
  * //       MaxSessionDuration: "STRING_VALUE",
+ * //       AccessType: "Standard" || "JustInTime",
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",
diff --git a/clients/client-ssm/src/commands/GetAccessTokenCommand.ts b/clients/client-ssm/src/commands/GetAccessTokenCommand.ts
@@ -72,7 +72,8 @@ export interface GetAccessTokenCommandOutput extends GetAccessTokenResponse, __M
  *  <p>The specified parameter to be shared could not be found.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  <p>The request or operation couldn't be performed because the service is throttling requests.</p>
+ *  <p>The request or operation couldn't be performed because the service is throttling
+ *    requests.</p>
  *
  * @throws {@link ValidationException} (client fault)
  *  <p>The request isn't valid. Verify that you entered valid contents for the command and try
diff --git a/clients/client-ssm/src/commands/RegisterPatchBaselineForPatchGroupCommand.ts b/clients/client-ssm/src/commands/RegisterPatchBaselineForPatchGroupCommand.ts
@@ -5,10 +5,8 @@ import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { commonParams } from "../endpoint/EndpointParameters";
-import {
-  RegisterPatchBaselineForPatchGroupRequest,
-  RegisterPatchBaselineForPatchGroupResult,
-} from "../models/models_1";
+import { RegisterPatchBaselineForPatchGroupRequest } from "../models/models_1";
+import { RegisterPatchBaselineForPatchGroupResult } from "../models/models_2";
 import {
   de_RegisterPatchBaselineForPatchGroupCommand,
   se_RegisterPatchBaselineForPatchGroupCommand,
diff --git a/clients/client-ssm/src/commands/StartAccessRequestCommand.ts b/clients/client-ssm/src/commands/StartAccessRequestCommand.ts
@@ -76,10 +76,12 @@ export interface StartAccessRequestCommandOutput extends StartAccessRequestRespo
  *  <p>The specified parameter to be shared could not be found.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  <p>The request exceeds the service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your Amazon Web Services account.</p>
+ *  <p>The request exceeds the service quota. Service quotas, also referred to as limits, are the
+ *    maximum number of service resources or operations for your Amazon Web Services account.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  <p>The request or operation couldn't be performed because the service is throttling requests.</p>
+ *  <p>The request or operation couldn't be performed because the service is throttling
+ *    requests.</p>
  *
  * @throws {@link ValidationException} (client fault)
  *  <p>The request isn't valid. Verify that you entered valid contents for the command and try
diff --git a/clients/client-ssm/src/commands/UpdateDocumentMetadataCommand.ts b/clients/client-ssm/src/commands/UpdateDocumentMetadataCommand.ts
@@ -74,6 +74,9 @@ export interface UpdateDocumentMetadataCommandOutput extends UpdateDocumentMetad
  * @throws {@link InvalidDocumentVersion} (client fault)
  *  <p>The document version isn't valid or doesn't exist.</p>
  *
+ * @throws {@link TooManyUpdates} (client fault)
+ *  <p>There are concurrent updates for a resource that supports one update at a time.</p>
+ *
  * @throws {@link SSMServiceException}
  * <p>Base exception class for all service exceptions from SSM service.</p>
  *
diff --git a/clients/client-ssm/src/index.ts b/clients/client-ssm/src/index.ts
@@ -4,7 +4,8 @@
  * <p>Amazon Web Services Systems Manager is the operations hub for your Amazon Web Services applications and resources and a secure
  *    end-to-end management solution for hybrid cloud environments that enables safe and secure
  *    operations at scale.</p>
- *          <p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html">Setting up Amazon Web Services Systems Manager</a>.</p>
+ *          <p>This reference is intended to be used with the <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/">Amazon Web Services Systems Manager User Guide</a>. To get started, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-console.html">Setting up
+ *     Amazon Web Services Systems Manager</a>.</p>
  *          <p class="title">
  *             <b>Related resources</b>
  *          </p>
diff --git a/clients/client-ssm/src/models/models_0.ts b/clients/client-ssm/src/models/models_0.ts
@@ -42,6 +42,20 @@ export const AccessRequestStatus = {
  */
 export type AccessRequestStatus = (typeof AccessRequestStatus)[keyof typeof AccessRequestStatus];
 
+/**
+ * @public
+ * @enum
+ */
+export const AccessType = {
+  JUSTINTIME: "JustInTime",
+  STANDARD: "Standard",
+} as const;
+
+/**
+ * @public
+ */
+export type AccessType = (typeof AccessType)[keyof typeof AccessType];
+
 /**
  * <p>Information includes the Amazon Web Services account ID where the current document is shared and the
  *    version shared with that account.</p>
@@ -7115,6 +7129,10 @@ export interface DescribeAvailablePatchesResult {
 export interface DescribeDocumentRequest {
   /**
    * <p>The name of the SSM document.</p>
+   *          <note>
+   *             <p>If you're calling a shared SSM document from a different Amazon Web Services account,
+   *      <code>Name</code> is the full Amazon Resource Name (ARN) of the document.</p>
+   *          </note>
    * @public
    */
   Name: string | undefined;
@@ -7164,7 +7182,7 @@ export type DocumentPermissionType = (typeof DocumentPermissionType)[keyof typeo
  */
 export interface DescribeDocumentPermissionRequest {
   /**
-   * <p>The name of the document for which you are the owner.</p>
+   * <p>The name of the document for which you are the owner. </p>
    * @public
    */
   Name: string | undefined;
@@ -7197,7 +7215,7 @@ export interface DescribeDocumentPermissionRequest {
 export interface DescribeDocumentPermissionResponse {
   /**
    * <p>The account IDs that have permission to use this document. The ID can be either an
-   *    Amazon Web Services account or <i>All</i>.</p>
+   *    Amazon Web Services account number or <code>all</code>.</p>
    * @public
    */
   AccountIds?: string[] | undefined;
@@ -7598,7 +7616,7 @@ export interface InstanceInformationStringFilter {
   /**
    * <p>The filter key name to describe your managed nodes.</p>
    *          <p>Valid filter key values: ActivationIds | AgentVersion | AssociationStatus | IamRole |
-   *    InstanceIds | PingStatus | PlatformTypes | ResourceType | SourceIds | SourceTypes | "tag-key" |
+   *    InstanceIds | PingStatus | PlatformType | ResourceType | SourceIds | SourceTypes | "tag-key" |
    *     "tag:<code>\{keyname\}</code>
    *          </p>
    *          <ul>
@@ -9626,24 +9644,6 @@ export interface MaintenanceWindowIdentity {
   NextExecutionTime?: string | undefined;
 }
 
-/**
- * @public
- */
-export interface DescribeMaintenanceWindowsResult {
-  /**
-   * <p>Information about the maintenance windows.</p>
-   * @public
-   */
-  WindowIdentities?: MaintenanceWindowIdentity[] | undefined;
-
-  /**
-   * <p>The token to use when requesting the next set of items. If there are no additional items to
-   *    return, the string is empty.</p>
-   * @public
-   */
-  NextToken?: string | undefined;
-}
-
 /**
  * @internal
  */
@@ -9837,13 +9837,3 @@ export const MaintenanceWindowIdentityFilterSensitiveLog = (obj: MaintenanceWind
   ...obj,
   ...(obj.Description && { Description: SENSITIVE_STRING }),
 });
-
-/**
- * @internal
- */
-export const DescribeMaintenanceWindowsResultFilterSensitiveLog = (obj: DescribeMaintenanceWindowsResult): any => ({
-  ...obj,
-  ...(obj.WindowIdentities && {
-    WindowIdentities: obj.WindowIdentities.map((item) => MaintenanceWindowIdentityFilterSensitiveLog(item)),
-  }),
-});
diff --git a/clients/client-ssm/src/models/models_1.ts b/clients/client-ssm/src/models/models_1.ts
@@ -3,6 +3,7 @@ import { ExceptionOptionType as __ExceptionOptionType, SENSITIVE_STRING } from "
 
 import {
   AccessRequestStatus,
+  AccessType,
   AlarmConfiguration,
   AlarmStateInformation,
   AssociationComplianceSeverity,
@@ -20,6 +21,8 @@ import {
   InstanceAssociationOutputLocation,
   MaintenanceWindowExecutionStatus,
   MaintenanceWindowFilter,
+  MaintenanceWindowIdentity,
+  MaintenanceWindowIdentityFilterSensitiveLog,
   MaintenanceWindowTaskType,
   MetadataValue,
   OperatingSystem,
@@ -50,6 +53,24 @@ import {
 
 import { SSMServiceException as __BaseException } from "./SSMServiceException";
 
+/**
+ * @public
+ */
+export interface DescribeMaintenanceWindowsResult {
+  /**
+   * <p>Information about the maintenance windows.</p>
+   * @public
+   */
+  WindowIdentities?: MaintenanceWindowIdentity[] | undefined;
+
+  /**
+   * <p>The token to use when requesting the next set of items. If there are no additional items to
+   *    return, the string is empty.</p>
+   * @public
+   */
+  NextToken?: string | undefined;
+}
+
 /**
  * @public
  * @enum
@@ -1657,6 +1678,7 @@ export interface DescribePatchPropertiesResult {
  * @enum
  */
 export const SessionFilterKey = {
+  ACCESS_TYPE: "AccessType",
   INVOKED_AFTER: "InvokedAfter",
   INVOKED_BEFORE: "InvokedBefore",
   OWNER: "Owner",
@@ -1883,6 +1905,14 @@ export interface Session {
    * @public
    */
   MaxSessionDuration?: string | undefined;
+
+  /**
+   * <p>
+   *             <code>Standard</code> access type is the default for Session Manager sessions.
+   *     <code>JustInTime</code> is the access type for <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-just-in-time-node-access.html">Just-in-time node access</a>. </p>
+   * @public
+   */
+  AccessType?: AccessType | undefined;
 }
 
 /**
@@ -1962,7 +1992,8 @@ export interface GetAccessTokenRequest {
 }
 
 /**
- * <p>The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.</p>
+ * <p>The temporary security credentials, which include an access key ID, a secret access key, and
+ *    a security (or session) token.</p>
  * @public
  */
 export interface Credentials {
@@ -1996,7 +2027,8 @@ export interface Credentials {
  */
 export interface GetAccessTokenResponse {
   /**
-   * <p>The temporary security credentials which can be used to start just-in-time node access sessions.</p>
+   * <p>The temporary security credentials which can be used to start just-in-time node access
+   *    sessions.</p>
    * @public
    */
   Credentials?: Credentials | undefined;
@@ -2009,7 +2041,8 @@ export interface GetAccessTokenResponse {
 }
 
 /**
- * <p>The request or operation couldn't be performed because the service is throttling requests.</p>
+ * <p>The request or operation couldn't be performed because the service is throttling
+ *    requests.</p>
  * @public
  */
 export class ThrottlingException extends __BaseException {
@@ -10645,21 +10678,14 @@ export interface RegisterPatchBaselineForPatchGroupRequest {
 }
 
 /**
- * @public
+ * @internal
  */
-export interface RegisterPatchBaselineForPatchGroupResult {
-  /**
-   * <p>The ID of the patch baseline the patch group was registered with.</p>
-   * @public
-   */
-  BaselineId?: string | undefined;
-
-  /**
-   * <p>The name of the patch group registered with the patch baseline.</p>
-   * @public
-   */
-  PatchGroup?: string | undefined;
-}
+export const DescribeMaintenanceWindowsResultFilterSensitiveLog = (obj: DescribeMaintenanceWindowsResult): any => ({
+  ...obj,
+  ...(obj.WindowIdentities && {
+    WindowIdentities: obj.WindowIdentities.map((item) => MaintenanceWindowIdentityFilterSensitiveLog(item)),
+  }),
+});
 
 /**
  * @internal
diff --git a/clients/client-ssm/src/models/models_2.ts b/clients/client-ssm/src/models/models_2.ts
@@ -62,6 +62,23 @@ import {
 
 import { SSMServiceException as __BaseException } from "./SSMServiceException";
 
+/**
+ * @public
+ */
+export interface RegisterPatchBaselineForPatchGroupResult {
+  /**
+   * <p>The ID of the patch baseline the patch group was registered with.</p>
+   * @public
+   */
+  BaselineId?: string | undefined;
+
+  /**
+   * <p>The name of the patch group registered with the patch baseline.</p>
+   * @public
+   */
+  PatchGroup?: string | undefined;
+}
+
 /**
  * @public
  */
@@ -908,7 +925,8 @@ export interface SendCommandResult {
 }
 
 /**
- * <p>The request exceeds the service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your Amazon Web Services account.</p>
+ * <p>The request exceeds the service quota. Service quotas, also referred to as limits, are the
+ *    maximum number of service resources or operations for your Amazon Web Services account.</p>
  * @public
  */
 export class ServiceQuotaExceededException extends __BaseException {
diff --git a/clients/client-ssm/src/protocols/Aws_json1_1.ts b/clients/client-ssm/src/protocols/Aws_json1_1.ts
diff --git a/codegen/sdk-codegen/aws-models/ssm.json b/codegen/sdk-codegen/aws-models/ssm.json

Original file line number	Diff line number	Diff line change
`@@ -168,6 +168,9 @@ export interface CreateDocumentCommandOutput extends CreateDocumentResult, __Met`
`168`	`168`	`* @throws {@link MaxDocumentSizeExceeded} (client fault)`
`169`	`169`	`* <p>The size limit of a document is 64 KB.</p>`
`170`	`170`	`*`
	`171`	`+ * @throws {@link TooManyUpdates} (client fault)`
	`172`	`+ * <p>There are concurrent updates for a resource that supports one update at a time.</p>`
	`173`	`+ *`
`171`	`174`	`* @throws {@link SSMServiceException}`
`172`	`175`	`* <p>Base exception class for all service exceptions from SSM service.</p>`
`173`	`176`	`*`
Original file line number	Diff line number	Diff line change
`@@ -68,6 +68,9 @@ export interface DeleteDocumentCommandOutput extends DeleteDocumentResult, __Met`
`68`	`68`	`* <p>You attempted to delete a document while it is still shared. You must stop sharing the`
`69`	`69`	`* document before you can delete it.</p>`
`70`	`70`	`*`
	`71`	`+ * @throws {@link TooManyUpdates} (client fault)`
	`72`	`+ * <p>There are concurrent updates for a resource that supports one update at a time.</p>`
	`73`	`+ *`
`71`	`74`	`* @throws {@link SSMServiceException}`
`72`	`75`	`* <p>Base exception class for all service exceptions from SSM service.</p>`
`73`	`76`	`*`
Original file line number	Diff line number	Diff line change
`@@ -72,7 +72,8 @@ export interface GetAccessTokenCommandOutput extends GetAccessTokenResponse, __M`
`72`	`72`	`* <p>The specified parameter to be shared could not be found.</p>`
`73`	`73`	`*`
`74`	`74`	`* @throws {@link ThrottlingException} (client fault)`
`75`		`- * <p>The request or operation couldn't be performed because the service is throttling requests.</p>`
	`75`	`+ * <p>The request or operation couldn't be performed because the service is throttling`
	`76`	`+ * requests.</p>`
`76`	`77`	`*`
`77`	`78`	`* @throws {@link ValidationException} (client fault)`
`78`	`79`	`* <p>The request isn't valid. Verify that you entered valid contents for the command and try`
Original file line number	Diff line number	Diff line change
`@@ -76,10 +76,12 @@ export interface StartAccessRequestCommandOutput extends StartAccessRequestRespo`
`76`	`76`	`* <p>The specified parameter to be shared could not be found.</p>`
`77`	`77`	`*`
`78`	`78`	`* @throws {@link ServiceQuotaExceededException} (client fault)`
`79`		`- * <p>The request exceeds the service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your Amazon Web Services account.</p>`
	`79`	`+ * <p>The request exceeds the service quota. Service quotas, also referred to as limits, are the`
	`80`	`+ * maximum number of service resources or operations for your Amazon Web Services account.</p>`
`80`	`81`	`*`
`81`	`82`	`* @throws {@link ThrottlingException} (client fault)`
`82`		`- * <p>The request or operation couldn't be performed because the service is throttling requests.</p>`
	`83`	`+ * <p>The request or operation couldn't be performed because the service is throttling`
	`84`	`+ * requests.</p>`
`83`	`85`	`*`
`84`	`86`	`* @throws {@link ValidationException} (client fault)`
`85`	`87`	`* <p>The request isn't valid. Verify that you entered valid contents for the command and try`