@aws-sdk/client-savingsplans 3.533.0 → 3.538.0

package/README.md

@@ -6,10 +6,10 @@
 
 AWS SDK for JavaScript Savingsplans Client for Node.js, Browser and React Native.
 
-<p>Savings Plans are a pricing model that offer significant savings on AWS usage (for
-example, on Amazon EC2 instances). You commit to a consistent amount of usage, in USD
-per hour, for a term of 1 or 3 years, and receive a lower price for that usage. For
-more information, see the <a href="https://docs.aws.amazon.com/savingsplans/latest/userguide/">AWS Savings Plans User Guide</a>.</p>
+<p>Savings Plans are a pricing model that offer significant savings on Amazon Web Services usage (for example, on Amazon EC2 instances). You commit to a consistent
+amount of usage per hour, in the specified currency, for a term of one or three years, and
+receive a lower price for that usage. For more information, see the <a href="https://docs.aws.amazon.com/savingsplans/latest/userguide/">Amazon Web Services
+Savings Plans User Guide</a>.</p>
 
 ## Installing
 
@@ -261,6 +261,14 @@ ListTagsForResource
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/savingsplans/command/ListTagsForResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-savingsplans/Interface/ListTagsForResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-savingsplans/Interface/ListTagsForResourceCommandOutput/)
 
+</details>
+<details>
+<summary>
+ReturnSavingsPlan
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/savingsplans/command/ReturnSavingsPlanCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-savingsplans/Interface/ReturnSavingsPlanCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-savingsplans/Interface/ReturnSavingsPlanCommandOutput/)
+
 </details>
 <details>
 <summary>

package/dist-cjs/index.js

@@ -31,6 +31,7 @@ __export(src_exports, {
   InternalServerException: () => InternalServerException,
   ListTagsForResourceCommand: () => ListTagsForResourceCommand,
   ResourceNotFoundException: () => ResourceNotFoundException,
+  ReturnSavingsPlanCommand: () => ReturnSavingsPlanCommand,
   SavingsPlanOfferingFilterAttribute: () => SavingsPlanOfferingFilterAttribute,
   SavingsPlanOfferingPropertyKey: () => SavingsPlanOfferingPropertyKey,
   SavingsPlanPaymentOption: () => SavingsPlanPaymentOption,
@@ -349,9 +350,11 @@ var SavingsPlanState = {
   ACTIVE: "active",
   PAYMENT_FAILED: "payment-failed",
   PAYMENT_PENDING: "payment-pending",
+  PENDING_RETURN: "pending-return",
   QUEUED: "queued",
   QUEUED_DELETED: "queued-deleted",
-  RETIRED: "retired"
+  RETIRED: "retired",
+  RETURNED: "returned"
 };
 var SavingsPlanPaymentOption = {
   ALL_UPFRONT: "All Upfront",
@@ -520,6 +523,22 @@ var se_ListTagsForResourceCommand = /* @__PURE__ */ __name(async (input, context
   b.m("POST").h(headers).b(body);
   return b.build();
 }, "se_ListTagsForResourceCommand");
+var se_ReturnSavingsPlanCommand = /* @__PURE__ */ __name(async (input, context) => {
+  const b = (0, import_core.requestBuilder)(input, context);
+  const headers = {
+    "content-type": "application/json"
+  };
+  b.bp("/ReturnSavingsPlan");
+  let body;
+  body = JSON.stringify(
+    (0, import_smithy_client.take)(input, {
+      clientToken: [true, (_) => _ ?? (0, import_uuid.v4)()],
+      savingsPlanId: []
+    })
+  );
+  b.m("POST").h(headers).b(body);
+  return b.build();
+}, "se_ReturnSavingsPlanCommand");
 var se_TagResourceCommand = /* @__PURE__ */ __name(async (input, context) => {
   const b = (0, import_core.requestBuilder)(input, context);
   const headers = {
@@ -651,6 +670,20 @@ var de_ListTagsForResourceCommand = /* @__PURE__ */ __name(async (output, contex
   Object.assign(contents, doc);
   return contents;
 }, "de_ListTagsForResourceCommand");
+var de_ReturnSavingsPlanCommand = /* @__PURE__ */ __name(async (output, context) => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_CommandError(output, context);
+  }
+  const contents = (0, import_smithy_client.map)({
+    $metadata: deserializeMetadata(output)
+  });
+  const data = (0, import_smithy_client.expectNonNull)((0, import_smithy_client.expectObject)(await (0, import_core2.parseJsonBody)(output.body, context)), "body");
+  const doc = (0, import_smithy_client.take)(data, {
+    savingsPlanId: import_smithy_client.expectString
+  });
+  Object.assign(contents, doc);
+  return contents;
+}, "de_ReturnSavingsPlanCommand");
 var de_TagResourceCommand = /* @__PURE__ */ __name(async (output, context) => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
     return de_CommandError(output, context);
@@ -874,6 +907,23 @@ var _ListTagsForResourceCommand = class _ListTagsForResourceCommand extends impo
 __name(_ListTagsForResourceCommand, "ListTagsForResourceCommand");
 var ListTagsForResourceCommand = _ListTagsForResourceCommand;
 
+// src/commands/ReturnSavingsPlanCommand.ts
+
+
+
+
+var _ReturnSavingsPlanCommand = class _ReturnSavingsPlanCommand extends import_smithy_client.Command.classBuilder().ep({
+  ...commonParams
+}).m(function(Command, cs, config, o) {
+  return [
+    (0, import_middleware_serde.getSerdePlugin)(config, this.serialize, this.deserialize),
+    (0, import_middleware_endpoint.getEndpointPlugin)(config, Command.getEndpointParameterInstructions())
+  ];
+}).s("AWSSavingsPlan", "ReturnSavingsPlan", {}).n("SavingsplansClient", "ReturnSavingsPlanCommand").f(void 0, void 0).ser(se_ReturnSavingsPlanCommand).de(de_ReturnSavingsPlanCommand).build() {
+};
+__name(_ReturnSavingsPlanCommand, "ReturnSavingsPlanCommand");
+var ReturnSavingsPlanCommand = _ReturnSavingsPlanCommand;
+
 // src/commands/TagResourceCommand.ts
 
 
@@ -917,6 +967,7 @@ var commands = {
   DescribeSavingsPlansOfferingRatesCommand,
   DescribeSavingsPlansOfferingsCommand,
   ListTagsForResourceCommand,
+  ReturnSavingsPlanCommand,
   TagResourceCommand,
   UntagResourceCommand
 };
@@ -943,6 +994,7 @@ var import_util_endpoints = require("@aws-sdk/util-endpoints");
   DescribeSavingsPlansOfferingRatesCommand,
   DescribeSavingsPlansOfferingsCommand,
   ListTagsForResourceCommand,
+  ReturnSavingsPlanCommand,
   TagResourceCommand,
   UntagResourceCommand,
   InternalServerException,

package/dist-es/Savingsplans.js

@@ -6,6 +6,7 @@ import { DescribeSavingsPlansCommand, } from "./commands/DescribeSavingsPlansCom
 import { DescribeSavingsPlansOfferingRatesCommand, } from "./commands/DescribeSavingsPlansOfferingRatesCommand";
 import { DescribeSavingsPlansOfferingsCommand, } from "./commands/DescribeSavingsPlansOfferingsCommand";
 import { ListTagsForResourceCommand, } from "./commands/ListTagsForResourceCommand";
+import { ReturnSavingsPlanCommand, } from "./commands/ReturnSavingsPlanCommand";
 import { TagResourceCommand } from "./commands/TagResourceCommand";
 import { UntagResourceCommand, } from "./commands/UntagResourceCommand";
 import { SavingsplansClient } from "./SavingsplansClient";
@@ -17,6 +18,7 @@ const commands = {
     DescribeSavingsPlansOfferingRatesCommand,
     DescribeSavingsPlansOfferingsCommand,
     ListTagsForResourceCommand,
+    ReturnSavingsPlanCommand,
     TagResourceCommand,
     UntagResourceCommand,
 };

package/dist-es/commands/ReturnSavingsPlanCommand.js

@@ -0,0 +1,24 @@
+import { getEndpointPlugin } from "@smithy/middleware-endpoint";
+import { getSerdePlugin } from "@smithy/middleware-serde";
+import { Command as $Command } from "@smithy/smithy-client";
+import { commonParams } from "../endpoint/EndpointParameters";
+import { de_ReturnSavingsPlanCommand, se_ReturnSavingsPlanCommand } from "../protocols/Aws_restJson1";
+export { $Command };
+export class ReturnSavingsPlanCommand extends $Command
+    .classBuilder()
+    .ep({
+    ...commonParams,
+})
+    .m(function (Command, cs, config, o) {
+    return [
+        getSerdePlugin(config, this.serialize, this.deserialize),
+        getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+    ];
+})
+    .s("AWSSavingsPlan", "ReturnSavingsPlan", {})
+    .n("SavingsplansClient", "ReturnSavingsPlanCommand")
+    .f(void 0, void 0)
+    .ser(se_ReturnSavingsPlanCommand)
+    .de(de_ReturnSavingsPlanCommand)
+    .build() {
+}

package/dist-es/commands/index.js

@@ -5,5 +5,6 @@ export * from "./DescribeSavingsPlansCommand";
 export * from "./DescribeSavingsPlansOfferingRatesCommand";
 export * from "./DescribeSavingsPlansOfferingsCommand";
 export * from "./ListTagsForResourceCommand";
+export * from "./ReturnSavingsPlanCommand";
 export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";

package/dist-es/models/models_0.js

@@ -101,9 +101,11 @@ export const SavingsPlanState = {
     ACTIVE: "active",
     PAYMENT_FAILED: "payment-failed",
     PAYMENT_PENDING: "payment-pending",
+    PENDING_RETURN: "pending-return",
     QUEUED: "queued",
     QUEUED_DELETED: "queued-deleted",
     RETIRED: "retired",
+    RETURNED: "returned",
 };
 export const SavingsPlanPaymentOption = {
     ALL_UPFRONT: "All Upfront",

package/dist-es/protocols/Aws_restJson1.js

@@ -129,6 +129,20 @@ export const se_ListTagsForResourceCommand = async (input, context) => {
     b.m("POST").h(headers).b(body);
     return b.build();
 };
+export const se_ReturnSavingsPlanCommand = async (input, context) => {
+    const b = rb(input, context);
+    const headers = {
+        "content-type": "application/json",
+    };
+    b.bp("/ReturnSavingsPlan");
+    let body;
+    body = JSON.stringify(take(input, {
+        clientToken: [true, (_) => _ ?? generateIdempotencyToken()],
+        savingsPlanId: [],
+    }));
+    b.m("POST").h(headers).b(body);
+    return b.build();
+};
 export const se_TagResourceCommand = async (input, context) => {
     const b = rb(input, context);
     const headers = {
@@ -256,6 +270,20 @@ export const de_ListTagsForResourceCommand = async (output, context) => {
     Object.assign(contents, doc);
     return contents;
 };
+export const de_ReturnSavingsPlanCommand = async (output, context) => {
+    if (output.statusCode !== 200 && output.statusCode >= 300) {
+        return de_CommandError(output, context);
+    }
+    const contents = map({
+        $metadata: deserializeMetadata(output),
+    });
+    const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+    const doc = take(data, {
+        savingsPlanId: __expectString,
+    });
+    Object.assign(contents, doc);
+    return contents;
+};
 export const de_TagResourceCommand = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return de_CommandError(output, context);

package/dist-types/Savingsplans.d.ts

@@ -6,6 +6,7 @@ import { DescribeSavingsPlansCommandInput, DescribeSavingsPlansCommandOutput } f
 import { DescribeSavingsPlansOfferingRatesCommandInput, DescribeSavingsPlansOfferingRatesCommandOutput } from "./commands/DescribeSavingsPlansOfferingRatesCommand";
 import { DescribeSavingsPlansOfferingsCommandInput, DescribeSavingsPlansOfferingsCommandOutput } from "./commands/DescribeSavingsPlansOfferingsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
+import { ReturnSavingsPlanCommandInput, ReturnSavingsPlanCommandOutput } from "./commands/ReturnSavingsPlanCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { SavingsplansClient } from "./SavingsplansClient";
@@ -31,18 +32,21 @@ export interface Savingsplans {
     /**
      * @see {@link DescribeSavingsPlansCommand}
      */
+    describeSavingsPlans(): Promise<DescribeSavingsPlansCommandOutput>;
     describeSavingsPlans(args: DescribeSavingsPlansCommandInput, options?: __HttpHandlerOptions): Promise<DescribeSavingsPlansCommandOutput>;
     describeSavingsPlans(args: DescribeSavingsPlansCommandInput, cb: (err: any, data?: DescribeSavingsPlansCommandOutput) => void): void;
     describeSavingsPlans(args: DescribeSavingsPlansCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeSavingsPlansCommandOutput) => void): void;
     /**
      * @see {@link DescribeSavingsPlansOfferingRatesCommand}
      */
+    describeSavingsPlansOfferingRates(): Promise<DescribeSavingsPlansOfferingRatesCommandOutput>;
     describeSavingsPlansOfferingRates(args: DescribeSavingsPlansOfferingRatesCommandInput, options?: __HttpHandlerOptions): Promise<DescribeSavingsPlansOfferingRatesCommandOutput>;
     describeSavingsPlansOfferingRates(args: DescribeSavingsPlansOfferingRatesCommandInput, cb: (err: any, data?: DescribeSavingsPlansOfferingRatesCommandOutput) => void): void;
     describeSavingsPlansOfferingRates(args: DescribeSavingsPlansOfferingRatesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeSavingsPlansOfferingRatesCommandOutput) => void): void;
     /**
      * @see {@link DescribeSavingsPlansOfferingsCommand}
      */
+    describeSavingsPlansOfferings(): Promise<DescribeSavingsPlansOfferingsCommandOutput>;
     describeSavingsPlansOfferings(args: DescribeSavingsPlansOfferingsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeSavingsPlansOfferingsCommandOutput>;
     describeSavingsPlansOfferings(args: DescribeSavingsPlansOfferingsCommandInput, cb: (err: any, data?: DescribeSavingsPlansOfferingsCommandOutput) => void): void;
     describeSavingsPlansOfferings(args: DescribeSavingsPlansOfferingsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeSavingsPlansOfferingsCommandOutput) => void): void;
@@ -52,6 +56,12 @@ export interface Savingsplans {
     listTagsForResource(args: ListTagsForResourceCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsForResourceCommandOutput>;
     listTagsForResource(args: ListTagsForResourceCommandInput, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
     listTagsForResource(args: ListTagsForResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
+    /**
+     * @see {@link ReturnSavingsPlanCommand}
+     */
+    returnSavingsPlan(args: ReturnSavingsPlanCommandInput, options?: __HttpHandlerOptions): Promise<ReturnSavingsPlanCommandOutput>;
+    returnSavingsPlan(args: ReturnSavingsPlanCommandInput, cb: (err: any, data?: ReturnSavingsPlanCommandOutput) => void): void;
+    returnSavingsPlan(args: ReturnSavingsPlanCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ReturnSavingsPlanCommandOutput) => void): void;
     /**
      * @see {@link TagResourceCommand}
      */
@@ -66,11 +76,11 @@ export interface Savingsplans {
     untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
 }
 /**
+ * <p>Savings Plans are a pricing model that offer significant savings on Amazon Web Services usage (for example, on Amazon EC2 instances). You commit to a consistent
+ *          amount of usage per hour, in the specified currency, for a term of one or three years, and
+ *          receive a lower price for that usage. For more information, see the <a href="https://docs.aws.amazon.com/savingsplans/latest/userguide/">Amazon Web Services
+ *             Savings Plans User Guide</a>.</p>
  * @public
- * <p>Savings Plans are a pricing model that offer significant savings on AWS usage (for
- *         example, on Amazon EC2 instances). You commit to a consistent amount of usage, in USD
- *         per hour, for a term of 1 or 3 years, and receive a lower price for that usage. For
- *         more information, see the <a href="https://docs.aws.amazon.com/savingsplans/latest/userguide/">AWS Savings Plans User Guide</a>.</p>
  */
 export declare class Savingsplans extends SavingsplansClient implements Savingsplans {
 }

package/dist-types/SavingsplansClient.d.ts

@@ -14,6 +14,7 @@ import { DescribeSavingsPlansCommandInput, DescribeSavingsPlansCommandOutput } f
 import { DescribeSavingsPlansOfferingRatesCommandInput, DescribeSavingsPlansOfferingRatesCommandOutput } from "./commands/DescribeSavingsPlansOfferingRatesCommand";
 import { DescribeSavingsPlansOfferingsCommandInput, DescribeSavingsPlansOfferingsCommandOutput } from "./commands/DescribeSavingsPlansOfferingsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
+import { ReturnSavingsPlanCommandInput, ReturnSavingsPlanCommandOutput } from "./commands/ReturnSavingsPlanCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { ClientInputEndpointParameters, ClientResolvedEndpointParameters, EndpointParameters } from "./endpoint/EndpointParameters";
@@ -22,11 +23,11 @@ export { __Client };
 /**
  * @public
  */
-export type ServiceInputTypes = CreateSavingsPlanCommandInput | DeleteQueuedSavingsPlanCommandInput | DescribeSavingsPlanRatesCommandInput | DescribeSavingsPlansCommandInput | DescribeSavingsPlansOfferingRatesCommandInput | DescribeSavingsPlansOfferingsCommandInput | ListTagsForResourceCommandInput | TagResourceCommandInput | UntagResourceCommandInput;
+export type ServiceInputTypes = CreateSavingsPlanCommandInput | DeleteQueuedSavingsPlanCommandInput | DescribeSavingsPlanRatesCommandInput | DescribeSavingsPlansCommandInput | DescribeSavingsPlansOfferingRatesCommandInput | DescribeSavingsPlansOfferingsCommandInput | ListTagsForResourceCommandInput | ReturnSavingsPlanCommandInput | TagResourceCommandInput | UntagResourceCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = CreateSavingsPlanCommandOutput | DeleteQueuedSavingsPlanCommandOutput | DescribeSavingsPlanRatesCommandOutput | DescribeSavingsPlansCommandOutput | DescribeSavingsPlansOfferingRatesCommandOutput | DescribeSavingsPlansOfferingsCommandOutput | ListTagsForResourceCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput;
+export type ServiceOutputTypes = CreateSavingsPlanCommandOutput | DeleteQueuedSavingsPlanCommandOutput | DescribeSavingsPlanRatesCommandOutput | DescribeSavingsPlansCommandOutput | DescribeSavingsPlansOfferingRatesCommandOutput | DescribeSavingsPlansOfferingsCommandOutput | ListTagsForResourceCommandOutput | ReturnSavingsPlanCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput;
 /**
  * @public
  */
@@ -160,11 +161,11 @@ export type SavingsplansClientResolvedConfigType = __SmithyResolvedConfiguration
 export interface SavingsplansClientResolvedConfig extends SavingsplansClientResolvedConfigType {
 }
 /**
+ * <p>Savings Plans are a pricing model that offer significant savings on Amazon Web Services usage (for example, on Amazon EC2 instances). You commit to a consistent
+ *          amount of usage per hour, in the specified currency, for a term of one or three years, and
+ *          receive a lower price for that usage. For more information, see the <a href="https://docs.aws.amazon.com/savingsplans/latest/userguide/">Amazon Web Services
+ *             Savings Plans User Guide</a>.</p>
  * @public
- * <p>Savings Plans are a pricing model that offer significant savings on AWS usage (for
- *         example, on Amazon EC2 instances). You commit to a consistent amount of usage, in USD
- *         per hour, for a term of 1 or 3 years, and receive a lower price for that usage. For
- *         more information, see the <a href="https://docs.aws.amazon.com/savingsplans/latest/userguide/">AWS Savings Plans User Guide</a>.</p>
  */
 export declare class SavingsplansClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, SavingsplansClientResolvedConfig> {
     /**

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

@@ -22,10 +22,10 @@ export interface CreateSavingsPlanCommandOutput extends CreateSavingsPlanRespons
 }
 declare const CreateSavingsPlanCommand_base: {
     new (input: CreateSavingsPlanCommandInput): import("@smithy/smithy-client").CommandImpl<CreateSavingsPlanCommandInput, CreateSavingsPlanCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: CreateSavingsPlanCommandInput): import("@smithy/smithy-client").CommandImpl<CreateSavingsPlanCommandInput, CreateSavingsPlanCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
  * <p>Creates a Savings Plan.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -72,6 +72,7 @@ declare const CreateSavingsPlanCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class CreateSavingsPlanCommand extends CreateSavingsPlanCommand_base {
 }

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

@@ -22,10 +22,10 @@ export interface DeleteQueuedSavingsPlanCommandOutput extends DeleteQueuedSaving
 }
 declare const DeleteQueuedSavingsPlanCommand_base: {
     new (input: DeleteQueuedSavingsPlanCommandInput): import("@smithy/smithy-client").CommandImpl<DeleteQueuedSavingsPlanCommandInput, DeleteQueuedSavingsPlanCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: DeleteQueuedSavingsPlanCommandInput): import("@smithy/smithy-client").CommandImpl<DeleteQueuedSavingsPlanCommandInput, DeleteQueuedSavingsPlanCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
  * <p>Deletes the queued purchase for the specified Savings Plan.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -63,6 +63,7 @@ declare const DeleteQueuedSavingsPlanCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class DeleteQueuedSavingsPlanCommand extends DeleteQueuedSavingsPlanCommand_base {
 }

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

@@ -22,11 +22,11 @@ export interface DescribeSavingsPlanRatesCommandOutput extends DescribeSavingsPl
 }
 declare const DescribeSavingsPlanRatesCommand_base: {
     new (input: DescribeSavingsPlanRatesCommandInput): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlanRatesCommandInput, DescribeSavingsPlanRatesCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: DescribeSavingsPlanRatesCommandInput): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlanRatesCommandInput, DescribeSavingsPlanRatesCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
- * <p>Describes the specified Savings Plans rates.</p>
+ * <p>Describes the rates for the specified Savings Plan.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -87,6 +87,7 @@ declare const DescribeSavingsPlanRatesCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class DescribeSavingsPlanRatesCommand extends DescribeSavingsPlanRatesCommand_base {
 }

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

@@ -22,10 +22,10 @@ export interface DescribeSavingsPlansCommandOutput extends DescribeSavingsPlansR
 }
 declare const DescribeSavingsPlansCommand_base: {
     new (input: DescribeSavingsPlansCommandInput): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlansCommandInput, DescribeSavingsPlansCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [DescribeSavingsPlansCommandInput]): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlansCommandInput, DescribeSavingsPlansCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
  * <p>Describes the specified Savings Plans.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -43,7 +43,7 @@ declare const DescribeSavingsPlansCommand_base: {
  *   nextToken: "STRING_VALUE",
  *   maxResults: Number("int"),
  *   states: [ // SavingsPlanStateList
- *     "payment-pending" || "payment-failed" || "active" || "retired" || "queued" || "queued-deleted",
+ *     "payment-pending" || "payment-failed" || "active" || "retired" || "queued" || "queued-deleted" || "pending-return" || "returned",
  *   ],
  *   filters: [ // SavingsPlanFilterList
  *     { // SavingsPlanFilter
@@ -65,7 +65,7 @@ declare const DescribeSavingsPlansCommand_base: {
  * //       description: "STRING_VALUE",
  * //       start: "STRING_VALUE",
  * //       end: "STRING_VALUE",
- * //       state: "payment-pending" || "payment-failed" || "active" || "retired" || "queued" || "queued-deleted",
+ * //       state: "payment-pending" || "payment-failed" || "active" || "retired" || "queued" || "queued-deleted" || "pending-return" || "returned",
  * //       region: "STRING_VALUE",
  * //       ec2InstanceFamily: "STRING_VALUE",
  * //       savingsPlanType: "Compute" || "EC2Instance" || "SageMaker",
@@ -81,6 +81,7 @@ declare const DescribeSavingsPlansCommand_base: {
  * //       tags: { // TagMap
  * //         "<keys>": "STRING_VALUE",
  * //       },
+ * //       returnableUntil: "STRING_VALUE",
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",
@@ -103,6 +104,7 @@ declare const DescribeSavingsPlansCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class DescribeSavingsPlansCommand extends DescribeSavingsPlansCommand_base {
 }

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

@@ -22,11 +22,11 @@ export interface DescribeSavingsPlansOfferingRatesCommandOutput extends Describe
 }
 declare const DescribeSavingsPlansOfferingRatesCommand_base: {
     new (input: DescribeSavingsPlansOfferingRatesCommandInput): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlansOfferingRatesCommandInput, DescribeSavingsPlansOfferingRatesCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [DescribeSavingsPlansOfferingRatesCommandInput]): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlansOfferingRatesCommandInput, DescribeSavingsPlansOfferingRatesCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
- * <p>Describes the specified Savings Plans offering rates.</p>
+ * <p>Describes the offering rates for the specified Savings Plans.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -113,6 +113,7 @@ declare const DescribeSavingsPlansOfferingRatesCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class DescribeSavingsPlansOfferingRatesCommand extends DescribeSavingsPlansOfferingRatesCommand_base {
 }

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

@@ -22,11 +22,11 @@ export interface DescribeSavingsPlansOfferingsCommandOutput extends DescribeSavi
 }
 declare const DescribeSavingsPlansOfferingsCommand_base: {
     new (input: DescribeSavingsPlansOfferingsCommandInput): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlansOfferingsCommandInput, DescribeSavingsPlansOfferingsCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [DescribeSavingsPlansOfferingsCommandInput]): import("@smithy/smithy-client").CommandImpl<DescribeSavingsPlansOfferingsCommandInput, DescribeSavingsPlansOfferingsCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
- * <p>Describes the specified Savings Plans offerings.</p>
+ * <p>Describes the offerings for the specified Savings Plans.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -118,6 +118,7 @@ declare const DescribeSavingsPlansOfferingsCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class DescribeSavingsPlansOfferingsCommand extends DescribeSavingsPlansOfferingsCommand_base {
 }

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

@@ -22,10 +22,10 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
 }
 declare const ListTagsForResourceCommand_base: {
     new (input: ListTagsForResourceCommandInput): import("@smithy/smithy-client").CommandImpl<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: ListTagsForResourceCommandInput): import("@smithy/smithy-client").CommandImpl<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
  * <p>Lists the tags for the specified resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -64,6 +64,7 @@ declare const ListTagsForResourceCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class ListTagsForResourceCommand extends ListTagsForResourceCommand_base {
 }

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

@@ -0,0 +1,72 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ReturnSavingsPlanRequest, ReturnSavingsPlanResponse } from "../models/models_0";
+import { SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SavingsplansClient";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link ReturnSavingsPlanCommand}.
+ */
+export interface ReturnSavingsPlanCommandInput extends ReturnSavingsPlanRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link ReturnSavingsPlanCommand}.
+ */
+export interface ReturnSavingsPlanCommandOutput extends ReturnSavingsPlanResponse, __MetadataBearer {
+}
+declare const ReturnSavingsPlanCommand_base: {
+    new (input: ReturnSavingsPlanCommandInput): import("@smithy/smithy-client").CommandImpl<ReturnSavingsPlanCommandInput, ReturnSavingsPlanCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: ReturnSavingsPlanCommandInput): import("@smithy/smithy-client").CommandImpl<ReturnSavingsPlanCommandInput, ReturnSavingsPlanCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Returns the specified Savings Plan.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SavingsplansClient, ReturnSavingsPlanCommand } from "@aws-sdk/client-savingsplans"; // ES Modules import
+ * // const { SavingsplansClient, ReturnSavingsPlanCommand } = require("@aws-sdk/client-savingsplans"); // CommonJS import
+ * const client = new SavingsplansClient(config);
+ * const input = { // ReturnSavingsPlanRequest
+ *   savingsPlanId: "STRING_VALUE", // required
+ *   clientToken: "STRING_VALUE",
+ * };
+ * const command = new ReturnSavingsPlanCommand(input);
+ * const response = await client.send(command);
+ * // { // ReturnSavingsPlanResponse
+ * //   savingsPlanId: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param ReturnSavingsPlanCommandInput - {@link ReturnSavingsPlanCommandInput}
+ * @returns {@link ReturnSavingsPlanCommandOutput}
+ * @see {@link ReturnSavingsPlanCommandInput} for command's `input` shape.
+ * @see {@link ReturnSavingsPlanCommandOutput} for command's `response` shape.
+ * @see {@link SavingsplansClientResolvedConfig | config} for SavingsplansClient's `config` shape.
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>An unexpected error occurred.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource was not found.</p>
+ *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>A service quota has been exceeded.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the input parameters is not valid.</p>
+ *
+ * @throws {@link SavingsplansServiceException}
+ * <p>Base exception class for all service exceptions from Savingsplans service.</p>
+ *
+ * @public
+ */
+export declare class ReturnSavingsPlanCommand extends ReturnSavingsPlanCommand_base {
+}

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

@@ -22,10 +22,10 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
 }
 declare const TagResourceCommand_base: {
     new (input: TagResourceCommandInput): import("@smithy/smithy-client").CommandImpl<TagResourceCommandInput, TagResourceCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: TagResourceCommandInput): import("@smithy/smithy-client").CommandImpl<TagResourceCommandInput, TagResourceCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
  * <p>Adds the specified tags to the specified resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -66,6 +66,7 @@ declare const TagResourceCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class TagResourceCommand extends TagResourceCommand_base {
 }

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

@@ -22,10 +22,10 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
 }
 declare const UntagResourceCommand_base: {
     new (input: UntagResourceCommandInput): import("@smithy/smithy-client").CommandImpl<UntagResourceCommandInput, UntagResourceCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: UntagResourceCommandInput): import("@smithy/smithy-client").CommandImpl<UntagResourceCommandInput, UntagResourceCommandOutput, SavingsplansClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * @public
  * <p>Removes the specified tags from the specified resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -63,6 +63,7 @@ declare const UntagResourceCommand_base: {
  * @throws {@link SavingsplansServiceException}
  * <p>Base exception class for all service exceptions from Savingsplans service.</p>
  *
+ * @public
  */
 export declare class UntagResourceCommand extends UntagResourceCommand_base {
 }

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

@@ -5,5 +5,6 @@ export * from "./DescribeSavingsPlansCommand";
 export * from "./DescribeSavingsPlansOfferingRatesCommand";
 export * from "./DescribeSavingsPlansOfferingsCommand";
 export * from "./ListTagsForResourceCommand";
+export * from "./ReturnSavingsPlanCommand";
 export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";