@aws-sdk/client-cost-optimization-hub 3.816.0 → 3.819.0

package/README.md

@@ -6,14 +6,7 @@
 
 AWS SDK for JavaScript CostOptimizationHub Client for Node.js, Browser and React Native.
 
-<p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate,
-and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p>
-<p>The Cost Optimization Hub API provides the following endpoint:</p>
-<ul>
-<li>
-<p> https://cost-optimization-hub.us-east-1.amazonaws.com </p>
-</li>
-</ul>
+<p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate, and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p> <p>The Cost Optimization Hub API provides the following endpoint:</p> <ul> <li> <p> https://cost-optimization-hub.us-east-1.amazonaws.com </p> </li> </ul>
 
 ## Installing
 

package/dist-cjs/index.js

@@ -38,12 +38,14 @@ __export(index_exports, {
   ListRecommendationsCommand: () => ListRecommendationsCommand,
   MemberAccountDiscountVisibility: () => MemberAccountDiscountVisibility,
   Order: () => Order,
+  PaymentOption: () => PaymentOption,
   ResourceDetails: () => ResourceDetails,
   ResourceNotFoundException: () => ResourceNotFoundException,
   ResourceType: () => ResourceType,
   SavingsEstimationMode: () => SavingsEstimationMode,
   Source: () => Source,
   SummaryMetrics: () => SummaryMetrics,
+  Term: () => Term,
   ThrottlingException: () => ThrottlingException,
   UpdateEnrollmentStatusCommand: () => UpdateEnrollmentStatusCommand,
   UpdatePreferencesCommand: () => UpdatePreferencesCommand,
@@ -266,6 +268,15 @@ var MemberAccountDiscountVisibility = {
   ALL: "All",
   NONE: "None"
 };
+var PaymentOption = {
+  ALL_UPFRONT: "AllUpfront",
+  NO_UPFRONT: "NoUpfront",
+  PARTIAL_UPFRONT: "PartialUpfront"
+};
+var Term = {
+  ONE_YEAR: "OneYear",
+  THREE_YEARS: "ThreeYears"
+};
 var SavingsEstimationMode = {
   AFTER_DISCOUNTS: "AfterDiscounts",
   BEFORE_DISCOUNTS: "BeforeDiscounts"
@@ -1236,6 +1247,8 @@ var paginateListRecommendations = (0, import_core.createPaginator)(CostOptimizat
   ActionType,
   AllocationStrategy,
   MemberAccountDiscountVisibility,
+  PaymentOption,
+  Term,
   SavingsEstimationMode,
   InternalServerException,
   ThrottlingException,

package/dist-cjs/runtimeConfig.js

@@ -23,7 +23,10 @@ const getRuntimeConfig = (config) => {
     const defaultConfigProvider = () => defaultsMode().then(smithy_client_1.loadConfigsForDefaultMode);
     const clientSharedValues = (0, runtimeConfig_shared_1.getRuntimeConfig)(config);
     (0, core_1.emitWarningIfUnsupportedVersion)(process.version);
-    const loaderConfig = { profile: config?.profile, logger: clientSharedValues.logger };
+    const loaderConfig = {
+        profile: config?.profile,
+        logger: clientSharedValues.logger,
+    };
     return {
         ...clientSharedValues,
         ...config,

package/dist-es/models/models_0.js

@@ -33,6 +33,15 @@ export const MemberAccountDiscountVisibility = {
     ALL: "All",
     NONE: "None",
 };
+export const PaymentOption = {
+    ALL_UPFRONT: "AllUpfront",
+    NO_UPFRONT: "NoUpfront",
+    PARTIAL_UPFRONT: "PartialUpfront",
+};
+export const Term = {
+    ONE_YEAR: "OneYear",
+    THREE_YEARS: "ThreeYears",
+};
 export const SavingsEstimationMode = {
     AFTER_DISCOUNTS: "AfterDiscounts",
     BEFORE_DISCOUNTS: "BeforeDiscounts",

package/dist-es/runtimeConfig.js

@@ -19,7 +19,10 @@ export const getRuntimeConfig = (config) => {
     const defaultConfigProvider = () => defaultsMode().then(loadConfigsForDefaultMode);
     const clientSharedValues = getSharedRuntimeConfig(config);
     awsCheckVersion(process.version);
-    const loaderConfig = { profile: config?.profile, logger: clientSharedValues.logger };
+    const loaderConfig = {
+        profile: config?.profile,
+        logger: clientSharedValues.logger,
+    };
     return {
         ...clientSharedValues,
         ...config,

package/dist-types/CostOptimizationHub.d.ts

@@ -56,14 +56,7 @@ export interface CostOptimizationHub {
     updatePreferences(args: UpdatePreferencesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdatePreferencesCommandOutput) => void): void;
 }
 /**
- * <p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate,
- *       and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p>
- *          <p>The Cost Optimization Hub API provides the following endpoint:</p>
- *          <ul>
- *             <li>
- *                <p> https://cost-optimization-hub.us-east-1.amazonaws.com </p>
- *             </li>
- *          </ul>
+ * <p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate, and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p> <p>The Cost Optimization Hub API provides the following endpoint:</p> <ul> <li> <p> https://cost-optimization-hub.us-east-1.amazonaws.com </p> </li> </ul>
  * @public
  */
 export declare class CostOptimizationHub extends CostOptimizationHubClient implements CostOptimizationHub {

package/dist-types/CostOptimizationHubClient.d.ts

@@ -176,14 +176,7 @@ export type CostOptimizationHubClientResolvedConfigType = __SmithyResolvedConfig
 export interface CostOptimizationHubClientResolvedConfig extends CostOptimizationHubClientResolvedConfigType {
 }
 /**
- * <p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate,
- *       and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p>
- *          <p>The Cost Optimization Hub API provides the following endpoint:</p>
- *          <ul>
- *             <li>
- *                <p> https://cost-optimization-hub.us-east-1.amazonaws.com </p>
- *             </li>
- *          </ul>
+ * <p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate, and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p> <p>The Cost Optimization Hub API provides the following endpoint:</p> <ul> <li> <p> https://cost-optimization-hub.us-east-1.amazonaws.com </p> </li> </ul>
  * @public
  */
 export declare class CostOptimizationHubClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, CostOptimizationHubClientResolvedConfig> {

package/dist-types/commands/GetPreferencesCommand.d.ts

@@ -27,10 +27,7 @@ declare const GetPreferencesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a set of preferences for an account in order to add account-specific preferences
- *       into the service. These preferences impact how the savings associated with recommendations are
- *       presented—estimated savings after discounts or estimated savings before discounts, for
- *       example.</p>
+ * <p>Returns a set of preferences for an account in order to add account-specific preferences into the service. These preferences impact how the savings associated with recommendations are presented—estimated savings after discounts or estimated savings before discounts, for example.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -43,6 +40,10 @@ declare const GetPreferencesCommand_base: {
  * // { // GetPreferencesResponse
  * //   savingsEstimationMode: "BeforeDiscounts" || "AfterDiscounts",
  * //   memberAccountDiscountVisibility: "All" || "None",
+ * //   preferredCommitment: { // PreferredCommitment
+ * //     term: "OneYear" || "ThreeYears",
+ * //     paymentOption: "AllUpfront" || "PartialUpfront" || "NoUpfront",
+ * //   },
  * // };
  *
  * ```
@@ -57,15 +58,13 @@ declare const GetPreferencesCommand_base: {
  *  <p>You are not authorized to use this operation with the given parameters.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ *  <p>An error on the server occurred during the processing of your request. Try again later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  *
  * @throws {@link CostOptimizationHubServiceException}
  * <p>Base exception class for all service exceptions from CostOptimizationHub service.</p>

package/dist-types/commands/GetRecommendationCommand.d.ts

@@ -27,11 +27,7 @@ declare const GetRecommendationCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns both the current and recommended resource configuration and the estimated cost
- *       impact for a recommendation.</p>
- *          <p>The <code>recommendationId</code> is only valid for up to a maximum of 24 hours as
- *       recommendations are refreshed daily. To retrieve the <code>recommendationId</code>, use the
- *         <code>ListRecommendations</code> API.</p>
+ * <p>Returns both the current and recommended resource configuration and the estimated cost impact for a recommendation.</p> <p>The <code>recommendationId</code> is only valid for up to a maximum of 24 hours as recommendations are refreshed daily. To retrieve the <code>recommendationId</code>, use the <code>ListRecommendations</code> API.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -724,8 +720,7 @@ declare const GetRecommendationCommand_base: {
  *  <p>You are not authorized to use this operation with the given parameters.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ *  <p>An error on the server occurred during the processing of your request. Try again later.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
  *  <p>The specified Amazon Resource Name (ARN) in the request doesn't exist.</p>
@@ -734,8 +729,7 @@ declare const GetRecommendationCommand_base: {
  *  <p>The request was denied due to request throttling.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  *
  * @throws {@link CostOptimizationHubServiceException}
  * <p>Base exception class for all service exceptions from CostOptimizationHub service.</p>

package/dist-types/commands/ListEnrollmentStatusesCommand.d.ts

@@ -27,8 +27,7 @@ declare const ListEnrollmentStatusesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Retrieves the enrollment status for an account. It can also return the list of accounts
- *       that are enrolled under the organization.</p>
+ * <p>Retrieves the enrollment status for an account. It can also return the list of accounts that are enrolled under the organization.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -68,15 +67,13 @@ declare const ListEnrollmentStatusesCommand_base: {
  *  <p>You are not authorized to use this operation with the given parameters.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ *  <p>An error on the server occurred during the processing of your request. Try again later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  *
  * @throws {@link CostOptimizationHubServiceException}
  * <p>Base exception class for all service exceptions from CostOptimizationHub service.</p>

package/dist-types/commands/ListRecommendationSummariesCommand.d.ts

@@ -27,12 +27,7 @@ declare const ListRecommendationSummariesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a concise representation of savings estimates for resources. Also returns de-duped
- *       savings across different types of recommendations.</p>
- *          <note>
- *             <p>The following filters are not supported for this API: <code>recommendationIds</code>,
- *           <code>resourceArns</code>, and <code>resourceIds</code>.</p>
- *          </note>
+ * <p>Returns a concise representation of savings estimates for resources. Also returns de-duped savings across different types of recommendations.</p> <note> <p>The following filters are not supported for this API: <code>recommendationIds</code>, <code>resourceArns</code>, and <code>resourceIds</code>.</p> </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -112,15 +107,13 @@ declare const ListRecommendationSummariesCommand_base: {
  *  <p>You are not authorized to use this operation with the given parameters.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ *  <p>An error on the server occurred during the processing of your request. Try again later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  *
  * @throws {@link CostOptimizationHubServiceException}
  * <p>Base exception class for all service exceptions from CostOptimizationHub service.</p>

package/dist-types/commands/ListRecommendationsCommand.d.ts

@@ -125,15 +125,13 @@ declare const ListRecommendationsCommand_base: {
  *  <p>You are not authorized to use this operation with the given parameters.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ *  <p>An error on the server occurred during the processing of your request. Try again later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  *
  * @throws {@link CostOptimizationHubServiceException}
  * <p>Base exception class for all service exceptions from CostOptimizationHub service.</p>

package/dist-types/commands/UpdateEnrollmentStatusCommand.d.ts

@@ -27,13 +27,7 @@ declare const UpdateEnrollmentStatusCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Updates the enrollment (opt in and opt out) status of an account to the Cost Optimization
- *       Hub service.</p>
- *          <p>If the account is a management account or delegated administrator of an organization, this
- *       action can also be used to enroll member accounts of the organization.</p>
- *          <p>You must have the appropriate permissions to opt in to Cost Optimization Hub and to view
- *       its recommendations. When you opt in, Cost Optimization Hub automatically creates a
- *       service-linked role in your account to access its data.</p>
+ * <p>Updates the enrollment (opt in and opt out) status of an account to the Cost Optimization Hub service.</p> <p>If the account is a management account or delegated administrator of an organization, this action can also be used to enroll member accounts of the organization.</p> <p>You must have the appropriate permissions to opt in to Cost Optimization Hub and to view its recommendations. When you opt in, Cost Optimization Hub automatically creates a service-linked role in your account to access its data.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -62,15 +56,13 @@ declare const UpdateEnrollmentStatusCommand_base: {
  *  <p>You are not authorized to use this operation with the given parameters.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ *  <p>An error on the server occurred during the processing of your request. Try again later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  *
  * @throws {@link CostOptimizationHubServiceException}
  * <p>Base exception class for all service exceptions from CostOptimizationHub service.</p>

package/dist-types/commands/UpdatePreferencesCommand.d.ts

@@ -27,9 +27,7 @@ declare const UpdatePreferencesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Updates a set of preferences for an account in order to add account-specific preferences
- *       into the service. These preferences impact how the savings associated with recommendations are
- *       presented.</p>
+ * <p>Updates a set of preferences for an account in order to add account-specific preferences into the service. These preferences impact how the savings associated with recommendations are presented.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -39,12 +37,20 @@ declare const UpdatePreferencesCommand_base: {
  * const input = { // UpdatePreferencesRequest
  *   savingsEstimationMode: "BeforeDiscounts" || "AfterDiscounts",
  *   memberAccountDiscountVisibility: "All" || "None",
+ *   preferredCommitment: { // PreferredCommitment
+ *     term: "OneYear" || "ThreeYears",
+ *     paymentOption: "AllUpfront" || "PartialUpfront" || "NoUpfront",
+ *   },
  * };
  * const command = new UpdatePreferencesCommand(input);
  * const response = await client.send(command);
  * // { // UpdatePreferencesResponse
  * //   savingsEstimationMode: "BeforeDiscounts" || "AfterDiscounts",
  * //   memberAccountDiscountVisibility: "All" || "None",
+ * //   preferredCommitment: { // PreferredCommitment
+ * //     term: "OneYear" || "ThreeYears",
+ * //     paymentOption: "AllUpfront" || "PartialUpfront" || "NoUpfront",
+ * //   },
  * // };
  *
  * ```
@@ -59,15 +65,13 @@ declare const UpdatePreferencesCommand_base: {
  *  <p>You are not authorized to use this operation with the given parameters.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ *  <p>An error on the server occurred during the processing of your request. Try again later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  *
  * @throws {@link CostOptimizationHubServiceException}
  * <p>Base exception class for all service exceptions from CostOptimizationHub service.</p>

package/dist-types/index.d.ts

@@ -1,12 +1,5 @@
 /**
- * <p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate,
- *       and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p>
- *          <p>The Cost Optimization Hub API provides the following endpoint:</p>
- *          <ul>
- *             <li>
- *                <p> https://cost-optimization-hub.us-east-1.amazonaws.com </p>
- *             </li>
- *          </ul>
+ * <p>You can use the Cost Optimization Hub API to programmatically identify, filter, aggregate, and quantify savings for your cost optimization recommendations across multiple Amazon Web Services Regions and Amazon Web Services accounts in your organization.</p> <p>The Cost Optimization Hub API provides the following endpoint:</p> <ul> <li> <p> https://cost-optimization-hub.us-east-1.amazonaws.com </p> </li> </ul>
  *
  * @packageDocumentation
  */

package/dist-types/models/models_0.d.ts

@@ -25,8 +25,7 @@ export declare const EnrollmentStatus: {
  */
 export type EnrollmentStatus = (typeof EnrollmentStatus)[keyof typeof EnrollmentStatus];
 /**
- * <p>Describes the enrollment status of an organization's member accounts in Cost Optimization
- *       Hub.</p>
+ * <p>Describes the enrollment status of an organization's member accounts in Cost Optimization Hub.</p>
  * @public
  */
 export interface AccountEnrollmentStatus {
@@ -82,8 +81,7 @@ export declare const AllocationStrategy: {
  */
 export type AllocationStrategy = (typeof AllocationStrategy)[keyof typeof AllocationStrategy];
 /**
- * <p>Describes the Amazon Elastic Block Store performance configuration of the current and
- *       recommended resource configuration for a recommendation.</p>
+ * <p>Describes the Amazon Elastic Block Store performance configuration of the current and recommended resource configuration for a recommendation.</p>
  * @public
  */
 export interface BlockStoragePerformanceConfiguration {
@@ -99,8 +97,7 @@ export interface BlockStoragePerformanceConfiguration {
     throughput?: number | undefined;
 }
 /**
- * <p>Describes the performance configuration for compute services such as Amazon EC2, Lambda,
- *       and ECS.</p>
+ * <p>Describes the performance configuration for compute services such as Amazon EC2, Lambda, and ECS.</p>
  * @public
  */
 export interface ComputeConfiguration {
@@ -120,8 +117,7 @@ export interface ComputeConfiguration {
      */
     architecture?: string | undefined;
     /**
-     * <p>The platform of the resource. The platform is the specific combination of operating
-     *       system, license model, and software on an instance.</p>
+     * <p>The platform of the resource. The platform is the specific combination of operating system, license model, and software on an instance.</p>
      * @public
      */
     platform?: string | undefined;
@@ -132,10 +128,7 @@ export interface ComputeConfiguration {
  */
 export interface ComputeSavingsPlansConfiguration {
     /**
-     * <p>The account scope for which you want recommendations. Amazon Web Services calculates
-     *       recommendations including the management account and member accounts if the value is set to
-     *         <code>PAYER</code>. If the value is <code>LINKED</code>, recommendations are calculated for
-     *       individual member accounts only.</p>
+     * <p>The account scope for which you want recommendations. Amazon Web Services calculates recommendations including the management account and member accounts if the value is set to <code>PAYER</code>. If the value is <code>LINKED</code>, recommendations are calculated for individual member accounts only.</p>
      * @public
      */
     accountScope?: string | undefined;
@@ -225,6 +218,47 @@ export declare const MemberAccountDiscountVisibility: {
  * @public
  */
 export type MemberAccountDiscountVisibility = (typeof MemberAccountDiscountVisibility)[keyof typeof MemberAccountDiscountVisibility];
+/**
+ * @public
+ * @enum
+ */
+export declare const PaymentOption: {
+    readonly ALL_UPFRONT: "AllUpfront";
+    readonly NO_UPFRONT: "NoUpfront";
+    readonly PARTIAL_UPFRONT: "PartialUpfront";
+};
+/**
+ * @public
+ */
+export type PaymentOption = (typeof PaymentOption)[keyof typeof PaymentOption];
+/**
+ * @public
+ * @enum
+ */
+export declare const Term: {
+    readonly ONE_YEAR: "OneYear";
+    readonly THREE_YEARS: "ThreeYears";
+};
+/**
+ * @public
+ */
+export type Term = (typeof Term)[keyof typeof Term];
+/**
+ * <p>The preferred configuration for Reserved Instances and Savings Plans commitment-based discounts, consisting of a payment option and a commitment duration.</p>
+ * @public
+ */
+export interface PreferredCommitment {
+    /**
+     * <p>The preferred length of the commitment period. If the value is null, it will default to <code>ThreeYears</code> (highest savings) where applicable.</p>
+     * @public
+     */
+    term?: Term | undefined;
+    /**
+     * <p>The preferred upfront payment structure for commitments. If the value is null, it will default to <code>AllUpfront</code> (highest savings) where applicable.</p>
+     * @public
+     */
+    paymentOption?: PaymentOption | undefined;
+}
 /**
  * @public
  * @enum
@@ -251,10 +285,14 @@ export interface GetPreferencesResponse {
      * @public
      */
     memberAccountDiscountVisibility?: MemberAccountDiscountVisibility | undefined;
+    /**
+     * <p>Retrieves the current preferences for how Reserved Instances and Savings Plans cost-saving opportunities are prioritized in terms of payment option and term length.</p>
+     * @public
+     */
+    preferredCommitment?: PreferredCommitment | undefined;
 }
 /**
- * <p>An error on the server occurred during the processing of your request. Try again
- *       later.</p>
+ * <p>An error on the server occurred during the processing of your request. Try again later.</p>
  * @public
  */
 export declare class InternalServerException extends __BaseException {
@@ -278,8 +316,7 @@ export declare class ThrottlingException extends __BaseException {
     constructor(opts: __ExceptionOptionType<ThrottlingException, __BaseException>);
 }
 /**
- * <p>The input failed to meet the constraints specified by the Amazon Web Services service in a
- *       specified field.</p>
+ * <p>The input failed to meet the constraints specified by the Amazon Web Services service in a specified field.</p>
  * @public
  */
 export interface ValidationExceptionDetail {
@@ -307,8 +344,7 @@ export declare const ValidationExceptionReason: {
  */
 export type ValidationExceptionReason = (typeof ValidationExceptionReason)[keyof typeof ValidationExceptionReason];
 /**
- * <p>The input fails to satisfy the constraints specified by an Amazon Web Services
- *       service.</p>
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
  * @public
  */
 export declare class ValidationException extends __BaseException {
@@ -380,8 +416,7 @@ export interface DynamoDbReservedCapacityConfiguration {
      */
     monthlyRecurringCost?: string | undefined;
     /**
-     * <p>The number of reserved capacity units that Amazon Web Services recommends that you
-     *       purchase.</p>
+     * <p>The number of reserved capacity units that Amazon Web Services recommends that you purchase.</p>
      * @public
      */
     numberOfCapacityUnitsToPurchase?: string | undefined;
@@ -397,8 +432,7 @@ export interface DynamoDbReservedCapacityConfiguration {
  */
 export interface ReservedInstancesPricing {
     /**
-     * <p>The remaining On-Demand cost estimated to not be covered by the recommended reserved
-     *       instance, over the length of the lookback period.</p>
+     * <p>The remaining On-Demand cost estimated to not be covered by the recommended reserved instance, over the length of the lookback period.</p>
      * @public
      */
     estimatedOnDemandCost?: number | undefined;
@@ -408,14 +442,12 @@ export interface ReservedInstancesPricing {
      */
     monthlyReservationEligibleCost?: number | undefined;
     /**
-     * <p>The savings percentage relative to the total On-Demand costs that are associated with this
-     *       instance.</p>
+     * <p>The savings percentage relative to the total On-Demand costs that are associated with this instance.</p>
      * @public
      */
     savingsPercentage?: number | undefined;
     /**
-     * <p>The estimated cost of your recurring monthly fees for the recommended reserved instance
-     *       across the month.</p>
+     * <p>The estimated cost of your recurring monthly fees for the recommended reserved instance across the month.</p>
      * @public
      */
     estimatedMonthlyAmortizedReservationCost?: number | undefined;
@@ -485,8 +517,7 @@ export interface EbsVolumeConfiguration {
     attachmentState?: string | undefined;
 }
 /**
- * <p>Estimated discount details of the current and recommended resource configuration for a
- *       recommendation.</p>
+ * <p>Estimated discount details of the current and recommended resource configuration for a recommendation.</p>
  * @public
  */
 export interface EstimatedDiscounts {
@@ -501,8 +532,7 @@ export interface EstimatedDiscounts {
      */
     reservedInstancesDiscount?: number | undefined;
     /**
-     * <p>Estimated other discounts include all discounts that are not itemized. Itemized discounts
-     *       include <code>reservedInstanceDiscount</code> and <code>savingsPlansDiscount</code>.</p>
+     * <p>Estimated other discounts include all discounts that are not itemized. Itemized discounts include <code>reservedInstanceDiscount</code> and <code>savingsPlansDiscount</code>.</p>
      * @public
      */
     otherDiscount?: number | undefined;
@@ -513,8 +543,7 @@ export interface EstimatedDiscounts {
  */
 export interface ResourcePricing {
     /**
-     * <p>The savings estimate using Amazon Web Services public pricing without incorporating any
-     *       discounts.</p>
+     * <p>The savings estimate using Amazon Web Services public pricing without incorporating any discounts.</p>
      * @public
      */
     estimatedCostBeforeDiscounts?: number | undefined;
@@ -529,8 +558,7 @@ export interface ResourcePricing {
      */
     estimatedDiscounts?: EstimatedDiscounts | undefined;
     /**
-     * <p>The savings estimate incorporating all discounts with Amazon Web Services, such as Reserved
-     *       Instances and Savings Plans.</p>
+     * <p>The savings estimate incorporating all discounts with Amazon Web Services, such as Reserved Instances and Savings Plans.</p>
      * @public
      */
     estimatedCostAfterDiscounts?: number | undefined;
@@ -583,8 +611,7 @@ export interface ResourceCostCalculation {
     pricing?: ResourcePricing | undefined;
 }
 /**
- * <p>Describes the Amazon Elastic Block Store volume configuration of the current and recommended
- *       resource configuration for a recommendation.</p>
+ * <p>Describes the Amazon Elastic Block Store volume configuration of the current and recommended resource configuration for a recommendation.</p>
  * @public
  */
 export interface EbsVolume {
@@ -639,8 +666,7 @@ export type Ec2AutoScalingGroupType = (typeof Ec2AutoScalingGroupType)[keyof typ
  */
 export interface Ec2AutoScalingGroupConfiguration {
     /**
-     * <p>Details about the instance for the EC2 Auto Scaling group with a single instance
-     *       type.</p>
+     * <p>Details about the instance for the EC2 Auto Scaling group with a single instance type.</p>
      * @public
      */
     instance?: InstanceConfiguration | undefined;
@@ -650,14 +676,12 @@ export interface Ec2AutoScalingGroupConfiguration {
      */
     mixedInstances?: MixedInstanceConfiguration[] | undefined;
     /**
-     * <p>The type of EC2 Auto Scaling group, showing whether it consists of a single instance type
-     *       or mixed instance types.</p>
+     * <p>The type of EC2 Auto Scaling group, showing whether it consists of a single instance type or mixed instance types.</p>
      * @public
      */
     type?: Ec2AutoScalingGroupType | undefined;
     /**
-     * <p>The strategy used for allocating instances, based on a predefined priority order or based
-     *       on the lowest available price.</p>
+     * <p>The strategy used for allocating instances, based on a predefined priority order or based on the lowest available price.</p>
      * @public
      */
     allocationStrategy?: AllocationStrategy | undefined;
@@ -690,8 +714,7 @@ export interface Ec2InstanceConfiguration {
     instance?: InstanceConfiguration | undefined;
 }
 /**
- * <p>Describes the EC2 instance configuration of the current and recommended resource
- *       configuration for a recommendation.</p>
+ * <p>Describes the EC2 instance configuration of the current and recommended resource configuration for a recommendation.</p>
  * @public
  */
 export interface Ec2Instance {
@@ -799,8 +822,7 @@ export interface Ec2ReservedInstancesConfiguration {
      */
     monthlyRecurringCost?: string | undefined;
     /**
-     * <p>The number of normalized units that Amazon Web Services recommends that you
-     *       purchase.</p>
+     * <p>The number of normalized units that Amazon Web Services recommends that you purchase.</p>
      * @public
      */
     normalizedUnitsToPurchase?: string | undefined;
@@ -830,8 +852,7 @@ export interface Ec2ReservedInstancesConfiguration {
      */
     currentGeneration?: string | undefined;
     /**
-     * <p>The platform of the recommended reservation. The platform is the specific combination of
-     *       operating system, license model, and software on an instance.</p>
+     * <p>The platform of the recommended reservation. The platform is the specific combination of operating system, license model, and software on an instance.</p>
      * @public
      */
     platform?: string | undefined;
@@ -930,8 +951,7 @@ export interface ElastiCacheReservedInstancesConfiguration {
      */
     monthlyRecurringCost?: string | undefined;
     /**
-     * <p>The number of normalized units that Amazon Web Services recommends that you
-     *       purchase.</p>
+     * <p>The number of normalized units that Amazon Web Services recommends that you purchase.</p>
      * @public
      */
     normalizedUnitsToPurchase?: string | undefined;
@@ -1005,11 +1025,7 @@ export interface LambdaFunction {
     costCalculation?: ResourceCostCalculation | undefined;
 }
 /**
- * <p>The MemoryDB reserved instances configuration used for recommendations.</p>
- *          <note>
- *             <p>MemoryDB reserved instances are referred to as "MemoryDB reserved nodes" in
- *         customer-facing documentation.</p>
- *          </note>
+ * <p>The MemoryDB reserved instances configuration used for recommendations.</p> <note> <p>While the API reference uses "MemoryDB reserved instances", the user guide and other documentation refer to them as "MemoryDB reserved nodes", as the terms are used interchangeably.</p> </note>
  * @public
  */
 export interface MemoryDbReservedInstancesConfiguration {
@@ -1049,8 +1065,7 @@ export interface MemoryDbReservedInstancesConfiguration {
      */
     monthlyRecurringCost?: string | undefined;
     /**
-     * <p>The number of normalized units that Amazon Web Services recommends that you
-     *       purchase.</p>
+     * <p>The number of normalized units that Amazon Web Services recommends that you purchase.</p>
      * @public
      */
     normalizedUnitsToPurchase?: string | undefined;
@@ -1081,11 +1096,7 @@ export interface MemoryDbReservedInstancesConfiguration {
     currentGeneration?: string | undefined;
 }
 /**
- * <p>The MemoryDB reserved instances recommendation details.</p>
- *          <note>
- *             <p>MemoryDB reserved instances are referred to as "MemoryDB reserved nodes" in
- *         customer-facing documentation.</p>
- *          </note>
+ * <p>The MemoryDB reserved instances recommendation details.</p> <note> <p>While the API reference uses "MemoryDB reserved instances", the user guide and other documentation refer to them as "MemoryDB reserved nodes", as the terms are used interchangeably.</p> </note>
  * @public
  */
 export interface MemoryDbReservedInstances {
@@ -1141,8 +1152,7 @@ export interface OpenSearchReservedInstancesConfiguration {
      */
     monthlyRecurringCost?: string | undefined;
     /**
-     * <p>The number of normalized units that Amazon Web Services recommends that you
-     *       purchase.</p>
+     * <p>The number of normalized units that Amazon Web Services recommends that you purchase.</p>
      * @public
      */
     normalizedUnitsToPurchase?: string | undefined;
@@ -1237,8 +1247,7 @@ export interface RdsDbInstanceStorageConfiguration {
      */
     allocatedStorageInGb?: number | undefined;
     /**
-     * <p>The amount of Provisioned IOPS (input/output operations per second) to be initially
-     *       allocated for the DB instance.</p>
+     * <p>The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.</p>
      * @public
      */
     iops?: number | undefined;
@@ -1305,8 +1314,7 @@ export interface RdsReservedInstancesConfiguration {
      */
     monthlyRecurringCost?: string | undefined;
     /**
-     * <p>The number of normalized units that Amazon Web Services recommends that you
-     *       purchase.</p>
+     * <p>The number of normalized units that Amazon Web Services recommends that you purchase.</p>
      * @public
      */
     normalizedUnitsToPurchase?: string | undefined;
@@ -1351,8 +1359,7 @@ export interface RdsReservedInstancesConfiguration {
      */
     databaseEngine?: string | undefined;
     /**
-     * <p>Determines whether the recommendation is for a reservation in a single Availability Zone
-     *       or a reservation with a backup in a second Availability Zone.</p>
+     * <p>Determines whether the recommendation is for a reservation in a single Availability Zone or a reservation with a backup in a second Availability Zone.</p>
      * @public
      */
     deploymentOption?: string | undefined;
@@ -1414,8 +1421,7 @@ export interface RedshiftReservedInstancesConfiguration {
      */
     monthlyRecurringCost?: string | undefined;
     /**
-     * <p>The number of normalized units that Amazon Web Services recommends that you
-     *       purchase.</p>
+     * <p>The number of normalized units that Amazon Web Services recommends that you purchase.</p>
      * @public
      */
     normalizedUnitsToPurchase?: string | undefined;
@@ -1801,8 +1807,7 @@ export declare namespace ResourceDetails {
         $unknown?: never;
     }
     /**
-     * <p>The SageMaker AI
-     *       Savings Plans recommendation details.</p>
+     * <p>The SageMaker AI Savings Plans recommendation details.</p>
      * @public
      */
     interface SageMakerSavingsPlansMember {
@@ -1874,8 +1879,7 @@ export declare namespace ResourceDetails {
         $unknown?: never;
     }
     /**
-     * <p>The DynamoDB reserved capacity recommendation
-     *       details.</p>
+     * <p>The DynamoDB reserved capacity recommendation details.</p>
      * @public
      */
     interface DynamoDbReservedCapacityMember {
@@ -1899,8 +1903,7 @@ export declare namespace ResourceDetails {
         $unknown?: never;
     }
     /**
-     * <p>The MemoryDB reserved instances recommendation
-     *       details.</p>
+     * <p>The MemoryDB reserved instances recommendation details.</p>
      * @public
      */
     interface MemoryDbReservedInstancesMember {
@@ -2048,8 +2051,7 @@ export interface GetRecommendationResponse {
      */
     recommendationId?: string | undefined;
     /**
-     * <p>The unique identifier for the resource. This is the same as the Amazon Resource Name
-     *       (ARN), if available.</p>
+     * <p>The unique identifier for the resource. This is the same as the Amazon Resource Name (ARN), if available.</p>
      * @public
      */
     resourceId?: string | undefined;
@@ -2079,14 +2081,12 @@ export interface GetRecommendationResponse {
      */
     costCalculationLookbackPeriodInDays?: number | undefined;
     /**
-     * <p>The estimated savings percentage relative to the total cost over the cost calculation
-     *       lookback period.</p>
+     * <p>The estimated savings percentage relative to the total cost over the cost calculation lookback period.</p>
      * @public
      */
     estimatedSavingsPercentage?: number | undefined;
     /**
-     * <p>The estimated savings amount over the lookback period used to calculate cost impact for a
-     *       recommendation.</p>
+     * <p>The estimated savings amount over the lookback period used to calculate cost impact for a recommendation.</p>
      * @public
      */
     estimatedSavingsOverCostCalculationLookbackPeriod?: number | undefined;
@@ -2208,14 +2208,12 @@ export interface ListEnrollmentStatusesRequest {
  */
 export interface ListEnrollmentStatusesResponse {
     /**
-     * <p>The enrollment status of a specific account ID, including creation and last updated
-     *       timestamps.</p>
+     * <p>The enrollment status of a specific account ID, including creation and last updated timestamps.</p>
      * @public
      */
     items?: AccountEnrollmentStatus[] | undefined;
     /**
-     * <p>The enrollment status of all member accounts in the organization if the account is the
-     *       management account or delegated administrator.</p>
+     * <p>The enrollment status of all member accounts in the organization if the account is the management account or delegated administrator.</p>
      * @public
      */
     includeMemberAccounts?: boolean | undefined;
@@ -2226,8 +2224,7 @@ export interface ListEnrollmentStatusesResponse {
     nextToken?: string | undefined;
 }
 /**
- * <p>Describes a filter that returns a more specific list of recommendations. Filters
- *       recommendations by different dimensions.</p>
+ * <p>Describes a filter that returns a more specific list of recommendations. Filters recommendations by different dimensions.</p>
  * @public
  */
 export interface Filter {
@@ -2330,8 +2327,7 @@ export interface ListRecommendationsRequest {
      */
     orderBy?: OrderBy | undefined;
     /**
-     * <p>List of all recommendations for a resource, or a single recommendation if de-duped by
-     *         <code>resourceId</code>.</p>
+     * <p>List of all recommendations for a resource, or a single recommendation if de-duped by <code>resourceId</code>.</p>
      * @public
      */
     includeAllRecommendations?: boolean | undefined;
@@ -2392,8 +2388,7 @@ export interface Recommendation {
      */
     estimatedMonthlySavings?: number | undefined;
     /**
-     * <p>The estimated savings percentage relative to the total cost over the cost calculation
-     *       lookback period.</p>
+     * <p>The estimated savings percentage relative to the total cost over the cost calculation lookback period.</p>
      * @public
      */
     estimatedSavingsPercentage?: number | undefined;
@@ -2489,8 +2484,7 @@ export type SummaryMetrics = (typeof SummaryMetrics)[keyof typeof SummaryMetrics
  */
 export interface ListRecommendationSummariesRequest {
     /**
-     * <p>Describes a filter that returns a more specific list of recommendations. Filters
-     *       recommendations by different dimensions.</p>
+     * <p>Describes a filter that returns a more specific list of recommendations. Filters recommendations by different dimensions.</p>
      * @public
      */
     filter?: Filter | undefined;
@@ -2505,8 +2499,7 @@ export interface ListRecommendationSummariesRequest {
      */
     maxResults?: number | undefined;
     /**
-     * <p>Additional metrics to be returned for the request. The only valid value is
-     *         <code>savingsPercentage</code>.</p>
+     * <p>Additional metrics to be returned for the request. The only valid value is <code>savingsPercentage</code>.</p>
      * @public
      */
     metrics?: SummaryMetrics[] | undefined;
@@ -2517,8 +2510,7 @@ export interface ListRecommendationSummariesRequest {
     nextToken?: string | undefined;
 }
 /**
- * <p>The summary of rightsizing recommendations, including de-duped savings from all types of
- *       recommendations.</p>
+ * <p>The summary of rightsizing recommendations, including de-duped savings from all types of recommendations.</p>
  * @public
  */
 export interface RecommendationSummary {
@@ -2539,18 +2531,12 @@ export interface RecommendationSummary {
     recommendationCount?: number | undefined;
 }
 /**
- * <p>The results or descriptions for the additional metrics, based on whether the metrics were
- *       or were not requested.</p>
+ * <p>The results or descriptions for the additional metrics, based on whether the metrics were or were not requested.</p>
  * @public
  */
 export interface SummaryMetricsResult {
     /**
-     * <p>The savings percentage based on your Amazon Web Services spend over the past 30
-     *       days.</p>
-     *          <note>
-     *             <p>Savings percentage is only supported when filtering by Region, account ID, or
-     *         tags.</p>
-     *          </note>
+     * <p>The savings percentage based on your Amazon Web Services spend over the past 30 days.</p> <note> <p>Savings percentage is only supported when filtering by Region, account ID, or tags.</p> </note>
      * @public
      */
     savingsPercentage?: string | undefined;
@@ -2580,8 +2566,7 @@ export interface ListRecommendationSummariesResponse {
      */
     currencyCode?: string | undefined;
     /**
-     * <p>The results or descriptions for the additional metrics, based on whether the metrics were
-     *       or were not requested.</p>
+     * <p>The results or descriptions for the additional metrics, based on whether the metrics were or were not requested.</p>
      * @public
      */
     metrics?: SummaryMetricsResult | undefined;
@@ -2601,8 +2586,7 @@ export interface UpdateEnrollmentStatusRequest {
      */
     status: EnrollmentStatus | undefined;
     /**
-     * <p>Indicates whether to enroll member accounts of the organization if the account is the
-     *       management account or delegated administrator.</p>
+     * <p>Indicates whether to enroll member accounts of the organization if the account is the management account or delegated administrator.</p>
      * @public
      */
     includeMemberAccounts?: boolean | undefined;
@@ -2631,6 +2615,11 @@ export interface UpdatePreferencesRequest {
      * @public
      */
     memberAccountDiscountVisibility?: MemberAccountDiscountVisibility | undefined;
+    /**
+     * <p>Sets the preferences for how Reserved Instances and Savings Plans cost-saving opportunities are prioritized in terms of payment option and term length.</p>
+     * @public
+     */
+    preferredCommitment?: PreferredCommitment | undefined;
 }
 /**
  * @public
@@ -2646,4 +2635,9 @@ export interface UpdatePreferencesResponse {
      * @public
      */
     memberAccountDiscountVisibility?: MemberAccountDiscountVisibility | undefined;
+    /**
+     * <p>Shows the updated preferences for how Reserved Instances and Savings Plans cost-saving opportunities are prioritized in terms of payment option and term length.</p>
+     * @public
+     */
+    preferredCommitment?: PreferredCommitment | undefined;
 }

package/dist-types/ts3.4/models/models_0.d.ts

@@ -72,6 +72,21 @@ export declare const MemberAccountDiscountVisibility: {
 };
 export type MemberAccountDiscountVisibility =
   (typeof MemberAccountDiscountVisibility)[keyof typeof MemberAccountDiscountVisibility];
+export declare const PaymentOption: {
+  readonly ALL_UPFRONT: "AllUpfront";
+  readonly NO_UPFRONT: "NoUpfront";
+  readonly PARTIAL_UPFRONT: "PartialUpfront";
+};
+export type PaymentOption = (typeof PaymentOption)[keyof typeof PaymentOption];
+export declare const Term: {
+  readonly ONE_YEAR: "OneYear";
+  readonly THREE_YEARS: "ThreeYears";
+};
+export type Term = (typeof Term)[keyof typeof Term];
+export interface PreferredCommitment {
+  term?: Term | undefined;
+  paymentOption?: PaymentOption | undefined;
+}
 export declare const SavingsEstimationMode: {
   readonly AFTER_DISCOUNTS: "AfterDiscounts";
   readonly BEFORE_DISCOUNTS: "BeforeDiscounts";
@@ -81,6 +96,7 @@ export type SavingsEstimationMode =
 export interface GetPreferencesResponse {
   savingsEstimationMode?: SavingsEstimationMode | undefined;
   memberAccountDiscountVisibility?: MemberAccountDiscountVisibility | undefined;
+  preferredCommitment?: PreferredCommitment | undefined;
 }
 export declare class InternalServerException extends __BaseException {
   readonly name: "InternalServerException";
@@ -960,8 +976,10 @@ export interface UpdateEnrollmentStatusResponse {
 export interface UpdatePreferencesRequest {
   savingsEstimationMode?: SavingsEstimationMode | undefined;
   memberAccountDiscountVisibility?: MemberAccountDiscountVisibility | undefined;
+  preferredCommitment?: PreferredCommitment | undefined;
 }
 export interface UpdatePreferencesResponse {
   savingsEstimationMode?: SavingsEstimationMode | undefined;
   memberAccountDiscountVisibility?: MemberAccountDiscountVisibility | undefined;
+  preferredCommitment?: PreferredCommitment | undefined;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-cost-optimization-hub",
   "description": "AWS SDK for JavaScript Cost Optimization Hub Client for Node.js, Browser and React Native",
-  "version": "3.816.0",
+  "version": "3.819.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-cost-optimization-hub",
@@ -21,7 +21,7 @@
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
     "@aws-sdk/core": "3.816.0",
-    "@aws-sdk/credential-provider-node": "3.816.0",
+    "@aws-sdk/credential-provider-node": "3.817.0",
     "@aws-sdk/middleware-host-header": "3.804.0",
     "@aws-sdk/middleware-logger": "3.804.0",
     "@aws-sdk/middleware-recursion-detection": "3.804.0",