feat(client-workspaces): This release adds support for creating and m…

…anaging directories that use AWS IAM Identity Center as user identity source. Such directories can be used to create non-Active Directory domain joined WorkSpaces Personal.Updated RegisterWorkspaceDirectory and DescribeWorkspaceDirectories APIs.

clients/client-workspaces/src/commands/DescribeWorkspaceDirectoriesCommand.ts

@@ -49,6 +49,14 @@ export interface DescribeWorkspaceDirectoriesCommandOutput
  *   ],
  *   Limit: Number("int"),
  *   NextToken: "STRING_VALUE",
+ *   Filters: [ // DescribeWorkspaceDirectoriesFilterList
+ *     { // DescribeWorkspaceDirectoriesFilter
+ *       Name: "USER_IDENTITY_TYPE" || "WORKSPACE_TYPE", // required
+ *       Values: [ // DescribeWorkspaceDirectoriesFilterValues // required
+ *         "STRING_VALUE",
+ *       ],
+ *     },
+ *   ],
  * };
  * const command = new DescribeWorkspaceDirectoriesCommand(input);
  * const response = await client.send(command);
@@ -67,7 +75,7 @@ export interface DescribeWorkspaceDirectoriesCommandOutput
  * //       ],
  * //       CustomerUserName: "STRING_VALUE",
  * //       IamRoleId: "STRING_VALUE",
- * //       DirectoryType: "SIMPLE_AD" || "AD_CONNECTOR" || "CUSTOMER_MANAGED",
+ * //       DirectoryType: "SIMPLE_AD" || "AD_CONNECTOR" || "CUSTOMER_MANAGED" || "AWS_IAM_IDENTITY_CENTER",
  * //       WorkspaceSecurityGroupId: "STRING_VALUE",
  * //       State: "REGISTERING" || "REGISTERED" || "DEREGISTERING" || "DEREGISTERED" || "ERROR",
  * //       WorkspaceCreationProperties: { // DefaultWorkspaceCreationProperties
@@ -109,10 +117,18 @@ export interface DescribeWorkspaceDirectoriesCommandOutput
  * //         Status: "DISABLED" || "ENABLED",
  * //         CertificateAuthorityArn: "STRING_VALUE",
  * //       },
+ * //       MicrosoftEntraConfig: { // MicrosoftEntraConfig
+ * //         TenantId: "STRING_VALUE",
+ * //         ApplicationConfigSecretArn: "STRING_VALUE",
+ * //       },
  * //       WorkspaceDirectoryName: "STRING_VALUE",
  * //       WorkspaceDirectoryDescription: "STRING_VALUE",
- * //       UserIdentityType: "CUSTOMER_MANAGED" || "AWS_DIRECTORY_SERVICE",
+ * //       UserIdentityType: "CUSTOMER_MANAGED" || "AWS_DIRECTORY_SERVICE" || "AWS_IAM_IDENTITY_CENTER",
  * //       WorkspaceType: "PERSONAL" || "POOLS",
+ * //       IDCConfig: { // IDCConfig
+ * //         InstanceArn: "STRING_VALUE",
+ * //         ApplicationArn: "STRING_VALUE",
+ * //       },
  * //       ActiveDirectoryConfig: { // ActiveDirectoryConfig
  * //         DomainName: "STRING_VALUE", // required
  * //         ServiceAccountSecretArn: "STRING_VALUE", // required

clients/client-workspaces/src/commands/RegisterWorkspaceDirectoryCommand.ts

@@ -55,7 +55,12 @@ export interface RegisterWorkspaceDirectoryCommandOutput extends RegisterWorkspa
  *   ],
  *   WorkspaceDirectoryName: "STRING_VALUE",
  *   WorkspaceDirectoryDescription: "STRING_VALUE",
- *   UserIdentityType: "CUSTOMER_MANAGED" || "AWS_DIRECTORY_SERVICE",
+ *   UserIdentityType: "CUSTOMER_MANAGED" || "AWS_DIRECTORY_SERVICE" || "AWS_IAM_IDENTITY_CENTER",
+ *   IdcInstanceArn: "STRING_VALUE",
+ *   MicrosoftEntraConfig: { // MicrosoftEntraConfig
+ *     TenantId: "STRING_VALUE",
+ *     ApplicationConfigSecretArn: "STRING_VALUE",
+ *   },
  *   WorkspaceType: "PERSONAL" || "POOLS",
  *   ActiveDirectoryConfig: { // ActiveDirectoryConfig
  *     DomainName: "STRING_VALUE", // required

clients/client-workspaces/src/commands/RestoreWorkspaceCommand.ts

@@ -5,7 +5,7 @@ import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { commonParams } from "../endpoint/EndpointParameters";
-import { RestoreWorkspaceRequest, RestoreWorkspaceResult } from "../models/models_0";
+import { RestoreWorkspaceRequest, RestoreWorkspaceResult } from "../models/models_1";
 import { de_RestoreWorkspaceCommand, se_RestoreWorkspaceCommand } from "../protocols/Aws_json1_1";
 import { ServiceInputTypes, ServiceOutputTypes, WorkSpacesClientResolvedConfig } from "../WorkSpacesClient";
 

clients/client-workspaces/src/commands/RevokeIpRulesCommand.ts

@@ -5,7 +5,7 @@ import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { commonParams } from "../endpoint/EndpointParameters";
-import { RevokeIpRulesRequest, RevokeIpRulesResult } from "../models/models_0";
+import { RevokeIpRulesRequest, RevokeIpRulesResult } from "../models/models_1";
 import { de_RevokeIpRulesCommand, se_RevokeIpRulesCommand } from "../protocols/Aws_json1_1";
 import { ServiceInputTypes, ServiceOutputTypes, WorkSpacesClientResolvedConfig } from "../WorkSpacesClient";
 

clients/client-workspaces/src/models/models_0.ts

@@ -4372,6 +4372,39 @@ export interface DescribeWorkspaceBundlesResult {
   NextToken?: string;
 }
 
+/**
+ * @public
+ * @enum
+ */
+export const DescribeWorkspaceDirectoriesFilterName = {
+  USER_IDENTITY_TYPE: "USER_IDENTITY_TYPE",
+  WORKSPACE_TYPE: "WORKSPACE_TYPE",
+} as const;
+
+/**
+ * @public
+ */
+export type DescribeWorkspaceDirectoriesFilterName =
+  (typeof DescribeWorkspaceDirectoriesFilterName)[keyof typeof DescribeWorkspaceDirectoriesFilterName];
+
+/**
+ * <p>Describes the filter conditions for the WorkSpaces to return.</p>
+ * @public
+ */
+export interface DescribeWorkspaceDirectoriesFilter {
+  /**
+   * <p>The name of the WorkSpaces to filter.</p>
+   * @public
+   */
+  Name: DescribeWorkspaceDirectoriesFilterName | undefined;
+
+  /**
+   * <p>The values for filtering WorkSpaces</p>
+   * @public
+   */
+  Values: string[] | undefined;
+}
+
 /**
  * @public
  */
@@ -4401,6 +4434,12 @@ export interface DescribeWorkspaceDirectoriesRequest {
    * @public
    */
   NextToken?: string;
+
+  /**
+   * <p>The filter condition for the WorkSpaces.</p>
+   * @public
+   */
+  Filters?: DescribeWorkspaceDirectoriesFilter[];
 }
 
 /**
@@ -4409,6 +4448,7 @@ export interface DescribeWorkspaceDirectoriesRequest {
  */
 export const WorkspaceDirectoryType = {
   AD_CONNECTOR: "AD_CONNECTOR",
+  AWS_IAM_IDENTITY_CENTER: "AWS_IAM_IDENTITY_CENTER",
   CUSTOMER_MANAGED: "CUSTOMER_MANAGED",
   SIMPLE_AD: "SIMPLE_AD",
 } as const;
@@ -4418,6 +4458,42 @@ export const WorkspaceDirectoryType = {
  */
 export type WorkspaceDirectoryType = (typeof WorkspaceDirectoryType)[keyof typeof WorkspaceDirectoryType];
 
+/**
+ * <p>Specifies the configurations of the identity center.</p>
+ * @public
+ */
+export interface IDCConfig {
+  /**
+   * <p>The Amazon Resource Name (ARN) of the identity center instance.</p>
+   * @public
+   */
+  InstanceArn?: string;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the application.</p>
+   * @public
+   */
+  ApplicationArn?: string;
+}
+
+/**
+ * <p>Specifies the configurations of the Microsoft Entra.</p>
+ * @public
+ */
+export interface MicrosoftEntraConfig {
+  /**
+   * <p>The identifier of the tenant.</p>
+   * @public
+   */
+  TenantId?: string;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the application config.</p>
+   * @public
+   */
+  ApplicationConfigSecretArn?: string;
+}
+
 /**
  * @public
  * @enum
@@ -4692,6 +4768,7 @@ export type Tenancy = (typeof Tenancy)[keyof typeof Tenancy];
  */
 export const UserIdentityType = {
   AWS_DIRECTORY_SERVICE: "AWS_DIRECTORY_SERVICE",
+  AWS_IAM_IDENTITY_CENTER: "AWS_IAM_IDENTITY_CENTER",
   CUSTOMER_MANAGED: "CUSTOMER_MANAGED",
 } as const;
 
@@ -4895,6 +4972,12 @@ export interface WorkspaceDirectory {
    */
   CertificateBasedAuthProperties?: CertificateBasedAuthProperties;
 
+  /**
+   * <p>Specifies details about Microsoft Entra configurations.</p>
+   * @public
+   */
+  MicrosoftEntraConfig?: MicrosoftEntraConfig;
+
   /**
    * <p>The name fo the WorkSpace directory.</p>
    * @public
@@ -4919,6 +5002,12 @@ export interface WorkspaceDirectory {
    */
   WorkspaceType?: WorkspaceType;
 
+  /**
+   * <p>Specifies details about identity center configurations.</p>
+   * @public
+   */
+  IDCConfig?: IDCConfig;
+
   /**
    * <p>Information about the Active Directory config.</p>
    * @public
@@ -6733,6 +6822,18 @@ export interface RegisterWorkspaceDirectoryRequest {
    */
   UserIdentityType?: UserIdentityType;
 
+  /**
+   * <p>The Amazon Resource Name (ARN) of the identity center instance.</p>
+   * @public
+   */
+  IdcInstanceArn?: string;
+
+  /**
+   * <p>The details about Microsoft Entra config.</p>
+   * @public
+   */
+  MicrosoftEntraConfig?: MicrosoftEntraConfig;
+
   /**
    * <p>Indicates whether the directory's WorkSpace type is personal or pools.</p>
    * @public
@@ -6834,41 +6935,3 @@ export interface RejectAccountLinkInvitationResult {
    */
   AccountLink?: AccountLink;
 }
-
-/**
- * @public
- */
-export interface RestoreWorkspaceRequest {
-  /**
-   * <p>The identifier of the WorkSpace.</p>
-   * @public
-   */
-  WorkspaceId: string | undefined;
-}
-
-/**
- * @public
- */
-export interface RestoreWorkspaceResult {}
-
-/**
- * @public
- */
-export interface RevokeIpRulesRequest {
-  /**
-   * <p>The identifier of the group.</p>
-   * @public
-   */
-  GroupId: string | undefined;
-
-  /**
-   * <p>The rules to remove from the group.</p>
-   * @public
-   */
-  UserRules: string[] | undefined;
-}
-
-/**
- * @public
- */
-export interface RevokeIpRulesResult {}

clients/client-workspaces/src/models/models_1.ts

@@ -9,6 +9,44 @@ import {
   WorkspacesPool,
 } from "./models_0";
 
+/**
+ * @public
+ */
+export interface RestoreWorkspaceRequest {
+  /**
+   * <p>The identifier of the WorkSpace.</p>
+   * @public
+   */
+  WorkspaceId: string | undefined;
+}
+
+/**
+ * @public
+ */
+export interface RestoreWorkspaceResult {}
+
+/**
+ * @public
+ */
+export interface RevokeIpRulesRequest {
+  /**
+   * <p>The identifier of the group.</p>
+   * @public
+   */
+  GroupId: string | undefined;
+
+  /**
+   * <p>The rules to remove from the group.</p>
+   * @public
+   */
+  UserRules: string[] | undefined;
+}
+
+/**
+ * @public
+ */
+export interface RevokeIpRulesResult {}
+
 /**
  * <p>Information used to start a WorkSpace.</p>
  * @public

clients/client-workspaces/src/protocols/Aws_json1_1.ts

@@ -383,6 +383,7 @@ import {
   DescribeWorkspaceAssociationsResult,
   DescribeWorkspaceBundlesRequest,
   DescribeWorkspaceBundlesResult,
+  DescribeWorkspaceDirectoriesFilter,
   DescribeWorkspaceDirectoriesRequest,
   DescribeWorkspaceImagePermissionsRequest,
   DescribeWorkspaceImagesRequest,
@@ -415,6 +416,7 @@ import {
   IpRuleItem,
   ListAccountLinksRequest,
   ListAvailableManagementCidrRangesRequest,
+  MicrosoftEntraConfig,
   MigrateWorkspaceRequest,
   ModifyAccountRequest,
   ModifyCertificateBasedAuthPropertiesRequest,
@@ -444,8 +446,6 @@ import {
   ResourceLimitExceededException,
   ResourceNotFoundException,
   ResourceUnavailableException,
-  RestoreWorkspaceRequest,
-  RevokeIpRulesRequest,
   RootStorage,
   SamlProperties,
   SelfservicePermissions,
@@ -478,6 +478,8 @@ import {
   WorkspacesPoolSession,
 } from "../models/models_0";
 import {
+  RestoreWorkspaceRequest,
+  RevokeIpRulesRequest,
   StartRequest,
   StartWorkspacesPoolRequest,
   StartWorkspacesRequest,
@@ -3966,6 +3968,12 @@ const se_DefaultImportClientBrandingAttributes = (
 
 // se_DescribeWorkspaceBundlesRequest omitted.
 
+// se_DescribeWorkspaceDirectoriesFilter omitted.
+
+// se_DescribeWorkspaceDirectoriesFilterList omitted.
+
+// se_DescribeWorkspaceDirectoriesFilterValues omitted.
+
 // se_DescribeWorkspaceDirectoriesRequest omitted.
 
 // se_DescribeWorkspaceImagePermissionsRequest omitted.
@@ -4051,6 +4059,8 @@ const se_IosImportClientBrandingAttributes = (
 
 // se_LoginMessage omitted.
 
+// se_MicrosoftEntraConfig omitted.
+
 // se_MigrateWorkspaceRequest omitted.
 
 // se_ModifyAccountRequest omitted.
@@ -4674,6 +4684,8 @@ const de_DisassociateWorkspaceApplicationResult = (
 
 // de_GetAccountLinkResult omitted.
 
+// de_IDCConfig omitted.
+
 // de_ImagePermission omitted.
 
 // de_ImagePermissions omitted.
@@ -4731,6 +4743,8 @@ const de_ImageResourceAssociationList = (output: any, context: __SerdeContext):
 
 // de_LoginMessage omitted.
 
+// de_MicrosoftEntraConfig omitted.
+
 // de_MigrateWorkspaceResult omitted.
 
 // de_ModificationState omitted.