feat(client-workspaces-instances): Added billing configuration support for WorkSpaces Instances with monthly and hourly billing modes, including new filtering capabilities for instance type searches.

Author: awstools

clients/client-workspaces-instances/src/commands/CreateWorkspaceInstanceCommand.ts

@@ -225,6 +225,9 @@ export interface CreateWorkspaceInstanceCommandOutput extends CreateWorkspaceIns
  *     ],
  *     UserData: "STRING_VALUE",
  *   },
+ *   BillingConfiguration: { // BillingConfiguration
+ *     BillingMode: "MONTHLY" || "HOURLY", // required
+ *   },
  * };
  * const command = new CreateWorkspaceInstanceCommand(input);
  * const response = await client.send(command);

clients/client-workspaces-instances/src/commands/DeleteWorkspaceInstanceCommand.ts

@@ -31,7 +31,7 @@ export interface DeleteWorkspaceInstanceCommandInput extends DeleteWorkspaceInst
 export interface DeleteWorkspaceInstanceCommandOutput extends DeleteWorkspaceInstanceResponse, __MetadataBearer {}
 
 /**
- * <p>Deletes the specified WorkSpace</p>
+ * <p>Deletes the specified WorkSpace</p> <important> <p>Usage of this API will result in deletion of the resource in question.</p> </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-workspaces-instances/src/commands/GetWorkspaceInstanceCommand.ts

@@ -64,6 +64,9 @@ export interface GetWorkspaceInstanceCommandOutput extends GetWorkspaceInstanceR
  * //   EC2ManagedInstance: { // EC2ManagedInstance
  * //     InstanceId: "STRING_VALUE",
  * //   },
+ * //   BillingConfiguration: { // BillingConfiguration
+ * //     BillingMode: "MONTHLY" || "HOURLY", // required
+ * //   },
  * // };
  *
  * ```

clients/client-workspaces-instances/src/commands/ListInstanceTypesCommand.ts

@@ -43,13 +43,25 @@ export interface ListInstanceTypesCommandOutput extends ListInstanceTypesRespons
  * const input = { // ListInstanceTypesRequest
  *   MaxResults: Number("int"),
  *   NextToken: "STRING_VALUE",
+ *   InstanceConfigurationFilter: { // InstanceConfigurationFilter
+ *     BillingMode: "MONTHLY" || "HOURLY", // required
+ *     PlatformType: "Windows" || "Windows BYOL" || "Linux/UNIX" || "Ubuntu Pro Linux" || "Red Hat Enterprise Linux" || "Red Hat BYOL Linux" || "SUSE Linux", // required
+ *     Tenancy: "SHARED" || "DEDICATED", // required
+ *   },
  * };
  * const command = new ListInstanceTypesCommand(input);
  * const response = await client.send(command);
  * // { // ListInstanceTypesResponse
  * //   InstanceTypes: [ // InstanceTypes // required
  * //     { // InstanceTypeInfo
  * //       InstanceType: "STRING_VALUE",
+ * //       SupportedInstanceConfigurations: [ // SupportedInstanceConfigurations
+ * //         { // SupportedInstanceConfiguration
+ * //           BillingMode: "MONTHLY" || "HOURLY",
+ * //           PlatformType: "Windows" || "Windows BYOL" || "Linux/UNIX" || "Ubuntu Pro Linux" || "Red Hat Enterprise Linux" || "Red Hat BYOL Linux" || "SUSE Linux",
+ * //           Tenancy: "SHARED" || "DEDICATED",
+ * //         },
+ * //       ],
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",

clients/client-workspaces-instances/src/models/enums.ts

@@ -56,6 +56,19 @@ export const BandwidthWeightingEnum = {
  */
 export type BandwidthWeightingEnum = (typeof BandwidthWeightingEnum)[keyof typeof BandwidthWeightingEnum];
 
+/**
+ * @public
+ * @enum
+ */
+export const BillingMode = {
+  HOURLY: "HOURLY",
+  MONTHLY: "MONTHLY",
+} as const;
+/**
+ * @public
+ */
+export type BillingMode = (typeof BillingMode)[keyof typeof BillingMode];
+
 /**
  * @public
  * @enum
@@ -279,3 +292,35 @@ export const ProvisionStateEnum = {
  * @public
  */
 export type ProvisionStateEnum = (typeof ProvisionStateEnum)[keyof typeof ProvisionStateEnum];
+
+/**
+ * @public
+ * @enum
+ */
+export const PlatformTypeEnum = {
+  LINUX_BYOL: "Red Hat BYOL Linux",
+  LINUX_UNIX: "Linux/UNIX",
+  RHEL: "Red Hat Enterprise Linux",
+  SUSE: "SUSE Linux",
+  UBUNTU_PRO: "Ubuntu Pro Linux",
+  WINDOWS: "Windows",
+  WINDOWS_BYOL: "Windows BYOL",
+} as const;
+/**
+ * @public
+ */
+export type PlatformTypeEnum = (typeof PlatformTypeEnum)[keyof typeof PlatformTypeEnum];
+
+/**
+ * @public
+ * @enum
+ */
+export const InstanceConfigurationTenancyEnum = {
+  DEDICATED: "DEDICATED",
+  SHARED: "SHARED",
+} as const;
+/**
+ * @public
+ */
+export type InstanceConfigurationTenancyEnum =
+  (typeof InstanceConfigurationTenancyEnum)[keyof typeof InstanceConfigurationTenancyEnum];

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

@@ -3,17 +3,20 @@ import {
   AmdSevSnpEnum,
   AutoRecoveryEnum,
   BandwidthWeightingEnum,
+  BillingMode,
   CapacityReservationPreferenceEnum,
   CpuCreditsEnum,
   DisassociateModeEnum,
   HostnameTypeEnum,
   HttpEndpointEnum,
   HttpProtocolIpv6Enum,
   HttpTokensEnum,
+  InstanceConfigurationTenancyEnum,
   InstanceInterruptionBehaviorEnum,
   InstanceMetadataTagsEnum,
   InterfaceTypeEnum,
   MarketTypeEnum,
+  PlatformTypeEnum,
   ProvisionStateEnum,
   ResourceTypeEnum,
   SpotInstanceTypeEnum,
@@ -75,6 +78,18 @@ export interface ValidationExceptionField {
   Message: string | undefined;
 }
 
+/**
+ * <p>Defines billing configuration settings for WorkSpace Instances, containing the billing mode selection.</p>
+ * @public
+ */
+export interface BillingConfiguration {
+  /**
+   * <p>Specifies the billing mode for WorkSpace Instances. MONTHLY provides fixed monthly rates for predictable budgeting, while HOURLY enables pay-per-second billing for actual usage.</p>
+   * @public
+   */
+  BillingMode: BillingMode | undefined;
+}
+
 /**
  * <p>Defines configuration for an Elastic Block Store volume.</p>
  * @public
@@ -1057,6 +1072,12 @@ export interface CreateWorkspaceInstanceRequest {
    * @public
    */
   ManagedInstance: ManagedInstanceRequest | undefined;
+
+  /**
+   * <p>Optional billing configuration for the WorkSpace Instance. Allows customers to specify their preferred billing mode when creating a new instance. Defaults to hourly billing if not specified.</p>
+   * @public
+   */
+  BillingConfiguration?: BillingConfiguration | undefined;
 }
 
 /**
@@ -1243,6 +1264,36 @@ export interface GetWorkspaceInstanceResponse {
    * @public
    */
   EC2ManagedInstance?: EC2ManagedInstance | undefined;
+
+  /**
+   * <p>Returns the current billing configuration for the WorkSpace Instance, indicating the active billing mode.</p>
+   * @public
+   */
+  BillingConfiguration?: BillingConfiguration | undefined;
+}
+
+/**
+ * <p>Defines filtering criteria for WorkSpace Instance type searches. Combines multiple filter conditions including billing mode, platform type, and tenancy to help customers find instance types that meet their specific requirements.</p>
+ * @public
+ */
+export interface InstanceConfigurationFilter {
+  /**
+   * <p>Filters WorkSpace Instance types based on supported billing modes. Allows customers to search for instance types that support their preferred billing model, such as HOURLY or MONTHLY billing.</p>
+   * @public
+   */
+  BillingMode: BillingMode | undefined;
+
+  /**
+   * <p>Filters WorkSpace Instance types by operating system platform. Allows customers to find instances that support their desired OS, such as Windows, Linux/UNIX, Ubuntu Pro, RHEL, or SUSE.</p>
+   * @public
+   */
+  PlatformType: PlatformTypeEnum | undefined;
+
+  /**
+   * <p>Filters WorkSpace Instance types by tenancy model. Allows customers to find instances that match their tenancy requirements, such as SHARED or DEDICATED.</p>
+   * @public
+   */
+  Tenancy: InstanceConfigurationTenancyEnum | undefined;
 }
 
 /**
@@ -1261,6 +1312,36 @@ export interface ListInstanceTypesRequest {
    * @public
    */
   NextToken?: string | undefined;
+
+  /**
+   * <p>Optional filter to narrow instance type results based on configuration requirements. Only returns instance types that support the specified combination of tenancy, platform type, and billing mode.</p>
+   * @public
+   */
+  InstanceConfigurationFilter?: InstanceConfigurationFilter | undefined;
+}
+
+/**
+ * <p>Represents a single valid configuration combination that an instance type supports, combining tenancy, platform type, and billing mode into one complete configuration specification.</p>
+ * @public
+ */
+export interface SupportedInstanceConfiguration {
+  /**
+   * <p>Specifies the billing mode supported in this configuration combination.</p>
+   * @public
+   */
+  BillingMode?: BillingMode | undefined;
+
+  /**
+   * <p>Specifies the operating system platform supported in this configuration combination.</p>
+   * @public
+   */
+  PlatformType?: PlatformTypeEnum | undefined;
+
+  /**
+   * <p>Specifies the tenancy model supported in this configuration combination.</p>
+   * @public
+   */
+  Tenancy?: InstanceConfigurationTenancyEnum | undefined;
 }
 
 /**
@@ -1273,6 +1354,12 @@ export interface InstanceTypeInfo {
    * @public
    */
   InstanceType?: string | undefined;
+
+  /**
+   * <p>Lists all valid combinations of tenancy, platform type, and billing mode supported for the specific WorkSpace Instance type. Contains the complete set of configuration options available for this instance type.</p>
+   * @public
+   */
+  SupportedInstanceConfigurations?: SupportedInstanceConfiguration[] | undefined;
 }
 
 /**

clients/client-workspaces-instances/src/schemas/schemas_0.ts

@@ -9,9 +9,11 @@ const _AVR = "AssociateVolumeRequest";
 const _AVRs = "AssociateVolumeResponse";
 const _AZ = "AvailabilityZone";
 const _Af = "Affinity";
+const _BC = "BillingConfiguration";
 const _BDM = "BlockDeviceMappings";
 const _BDMR = "BlockDeviceMappingRequest";
 const _BDMl = "BlockDurationMinutes";
+const _BM = "BillingMode";
 const _BW = "BandwidthWeighting";
 const _C = "Configured";
 const _CC = "CoreCount";
@@ -95,6 +97,7 @@ const _IA = "Ipv4Address";
 const _IAC = "Ipv6AddressCount";
 const _IAp = "Ipv6Address";
 const _IApv = "Ipv6Addresses";
+const _ICF = "InstanceConfigurationFilter";
 const _II = "InstanceId";
 const _IIA = "InstanceIpv6Address";
 const _IIB = "InstanceInterruptionBehavior";
@@ -167,6 +170,7 @@ const _PIAr = "PrivateIpAddresses";
 const _PN = "PartitionNumber";
 const _PS = "ProvisionState";
 const _PSr = "ProvisionStates";
+const _PT = "PlatformType";
 const _Pr = "Primary";
 const _QC = "QuotaCode";
 const _R = "Regions";
@@ -185,6 +189,8 @@ const _SC = "ServiceCode";
 const _SG = "SecurityGroups";
 const _SGI = "SecurityGroupIds";
 const _SI = "SnapshotId";
+const _SIC = "SupportedInstanceConfigurations";
+const _SICu = "SupportedInstanceConfiguration";
 const _SIGB = "SizeInGB";
 const _SIT = "SpotInstanceType";
 const _SIu = "SubnetId";
@@ -278,6 +284,11 @@ export var AssociateVolumeResponse$: StaticStructureSchema = [3, n0, _AVRs,
   [],
   []
 ];
+export var BillingConfiguration$: StaticStructureSchema = [3, n0, _BC,
+  0,
+  [_BM],
+  [0], 1
+];
 export var BlockDeviceMappingRequest$: StaticStructureSchema = [3, n0, _BDMR,
   0,
   [_DN, _E, _ND, _VN],
@@ -321,8 +332,8 @@ export var CreateVolumeResponse$: StaticStructureSchema = [3, n0, _CVRr,
 ];
 export var CreateWorkspaceInstanceRequest$: StaticStructureSchema = [3, n0, _CWIR,
   0,
-  [_MI, _CT, _Ta],
-  [[() => ManagedInstanceRequest$, 0], [() => ClientToken, 4], () => TagList], 1
+  [_MI, _CT, _Ta, _BC],
+  [[() => ManagedInstanceRequest$, 0], [() => ClientToken, 4], () => TagList, () => BillingConfiguration$], 1
 ];
 export var CreateWorkspaceInstanceResponse$: StaticStructureSchema = [3, n0, _CWIRr,
   0,
@@ -401,8 +412,8 @@ export var GetWorkspaceInstanceRequest$: StaticStructureSchema = [3, n0, _GWIR,
 ];
 export var GetWorkspaceInstanceResponse$: StaticStructureSchema = [3, n0, _GWIRe,
   0,
-  [_WIE, _ECIEn, _PS, _WII, _ECMI],
-  [() => WorkspaceInstanceErrors, () => EC2InstanceErrors, 0, 0, () => EC2ManagedInstance$]
+  [_WIE, _ECIEn, _PS, _WII, _ECMI, _BC],
+  [() => WorkspaceInstanceErrors, () => EC2InstanceErrors, 0, 0, () => EC2ManagedInstance$, () => BillingConfiguration$]
 ];
 export var HibernationOptionsRequest$: StaticStructureSchema = [3, n0, _HOR,
   0,
@@ -414,6 +425,11 @@ export var IamInstanceProfileSpecification$: StaticStructureSchema = [3, n0, _II
   [_A, _N],
   [0, 0]
 ];
+export var InstanceConfigurationFilter$: StaticStructureSchema = [3, n0, _ICF,
+  0,
+  [_BM, _PT, _Te],
+  [0, 0, 0], 3
+];
 export var InstanceIpv6Address$: StaticStructureSchema = [3, n0, _IIA,
   0,
   [_IAp, _IPI],
@@ -446,8 +462,8 @@ export var InstanceNetworkPerformanceOptionsRequest$: StaticStructureSchema = [3
 ];
 export var InstanceTypeInfo$: StaticStructureSchema = [3, n0, _ITI,
   0,
-  [_ITn],
-  [0]
+  [_ITn, _SIC],
+  [0, () => SupportedInstanceConfigurations]
 ];
 export var InternalServerException$: StaticErrorSchema = [-3, n0, _ISE,
   { [_e]: _s, [_hE]: 500 },
@@ -472,8 +488,8 @@ export var LicenseConfigurationRequest$: StaticStructureSchema = [3, n0, _LCR,
 ];
 export var ListInstanceTypesRequest$: StaticStructureSchema = [3, n0, _LITR,
   0,
-  [_MR, _NT],
-  [1, [() => NextToken, 0]]
+  [_MR, _NT, _ICF],
+  [1, [() => NextToken, 0], () => InstanceConfigurationFilter$]
 ];
 export var ListInstanceTypesResponse$: StaticStructureSchema = [3, n0, _LITRi,
   0,
@@ -557,6 +573,11 @@ export var SpotMarketOptions$: StaticStructureSchema = [3, n0, _SMO,
   [_BDMl, _IIB, _MP, _SIT, _VUU],
   [1, 0, 0, 0, 4]
 ];
+export var SupportedInstanceConfiguration$: StaticStructureSchema = [3, n0, _SICu,
+  0,
+  [_BM, _PT, _Te],
+  [0, 0, 0]
+];
 export var Tag$: StaticStructureSchema = [3, n0, _Tag,
   0,
   [_K, _V],
@@ -653,6 +674,9 @@ var RegionList: StaticListSchema = [1, n0, _RL,
 ];
 var SecurityGroupIds = 64 | 0;
 var SecurityGroupNames = 64 | 0;
+var SupportedInstanceConfigurations: StaticListSchema = [1, n0, _SIC,
+  0, () => SupportedInstanceConfiguration$
+];
 var TagKeyList = 64 | 0;
 var TagList: StaticListSchema = [1, n0, _TL,
   0, () => Tag$