feat(client-outposts): Enabling Asset Level Capacity Management feature, which allows customers to create a Capacity Task for a single Asset on their active Outpost.

Author: awstools

clients/client-outposts/src/commands/GetCapacityTaskCommand.ts

@@ -45,6 +45,7 @@ export interface GetCapacityTaskCommandOutput extends GetCapacityTaskOutput, __M
  * //   CapacityTaskId: "STRING_VALUE",
  * //   OutpostId: "STRING_VALUE",
  * //   OrderId: "STRING_VALUE",
+ * //   AssetId: "STRING_VALUE",
  * //   RequestedInstancePools: [ // RequestedInstancePools
  * //     { // InstanceTypeCapacity
  * //       InstanceType: "STRING_VALUE", // required

clients/client-outposts/src/commands/GetOutpostSupportedInstanceTypesCommand.ts

@@ -45,6 +45,7 @@ export interface GetOutpostSupportedInstanceTypesCommandOutput
  * const input = { // GetOutpostSupportedInstanceTypesInput
  *   OutpostIdentifier: "STRING_VALUE", // required
  *   OrderId: "STRING_VALUE",
+ *   AssetId: "STRING_VALUE",
  *   MaxResults: Number("int"),
  *   NextToken: "STRING_VALUE",
  * };

clients/client-outposts/src/commands/ListCapacityTasksCommand.ts

@@ -54,6 +54,7 @@ export interface ListCapacityTasksCommandOutput extends ListCapacityTasksOutput,
  * //       CapacityTaskId: "STRING_VALUE",
  * //       OutpostId: "STRING_VALUE",
  * //       OrderId: "STRING_VALUE",
+ * //       AssetId: "STRING_VALUE",
  * //       CapacityTaskStatus: "REQUESTED" || "IN_PROGRESS" || "FAILED" || "COMPLETED" || "WAITING_FOR_EVACUATION" || "CANCELLATION_IN_PROGRESS" || "CANCELLED",
  * //       CreationDate: new Date("TIMESTAMP"),
  * //       CompletionDate: new Date("TIMESTAMP"),

clients/client-outposts/src/commands/StartCapacityTaskCommand.ts

@@ -38,6 +38,7 @@ export interface StartCapacityTaskCommandOutput extends StartCapacityTaskOutput,
  * const input = { // StartCapacityTaskInput
  *   OutpostIdentifier: "STRING_VALUE", // required
  *   OrderId: "STRING_VALUE",
+ *   AssetId: "STRING_VALUE",
  *   InstancePools: [ // RequestedInstancePools // required
  *     { // InstanceTypeCapacity
  *       InstanceType: "STRING_VALUE", // required
@@ -64,6 +65,7 @@ export interface StartCapacityTaskCommandOutput extends StartCapacityTaskOutput,
  * //   CapacityTaskId: "STRING_VALUE",
  * //   OutpostId: "STRING_VALUE",
  * //   OrderId: "STRING_VALUE",
+ * //   AssetId: "STRING_VALUE",
  * //   RequestedInstancePools: [ // RequestedInstancePools
  * //     { // InstanceTypeCapacity
  * //       InstanceType: "STRING_VALUE", // required

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

@@ -228,7 +228,7 @@ export interface ComputeAttributes {
  */
 export interface AssetInfo {
   /**
-   * <p> The ID of the asset. </p>
+   * <p> The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
    * @public
    */
   AssetId?: string | undefined;
@@ -294,7 +294,7 @@ export interface AssetInstance {
   InstanceType?: string | undefined;
 
   /**
-   * <p>The ID of the asset.</p>
+   * <p>The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
    * @public
    */
   AssetId?: string | undefined;
@@ -582,6 +582,12 @@ export interface CapacityTaskSummary {
    */
   OrderId?: string | undefined;
 
+  /**
+   * <p>The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
+   * @public
+   */
+  AssetId?: string | undefined;
+
   /**
    * <p>The status of the capacity task.</p>
    * @public
@@ -846,7 +852,7 @@ export interface CreateOrderInput {
  */
 export interface LineItemAssetInformation {
   /**
-   * <p> The ID of the asset. </p>
+   * <p> The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
    * @public
    */
   AssetId?: string | undefined;
@@ -1774,6 +1780,12 @@ export interface GetCapacityTaskOutput {
    */
   OrderId?: string | undefined;
 
+  /**
+   * <p>The ID of the Outpost asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
+   * @public
+   */
+  AssetId?: string | undefined;
+
   /**
    * <p>List of instance pools requested in the capacity task.</p>
    * @public
@@ -1804,14 +1816,27 @@ export interface GetCapacityTaskOutput {
    *             </li>
    *             <li>
    *                <p>
-   *                   <code>IN_PROGRESS</code> - The capacity task is running and cannot be
-   *           cancelled.</p>
+   *                   <code>IN_PROGRESS</code> - The capacity task is running and cannot be cancelled.</p>
    *             </li>
    *             <li>
    *                <p>
-   *                   <code>WAITING_FOR_EVACUATION</code> - The capacity task requires capacity to run. You
-   *           must stop the recommended EC2 running instances to free up capacity for the task to
-   *           run.</p>
+   *                   <code>FAILED</code> - The capacity task could not be completed.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>COMPLETED</code> - The capacity task has completed successfully.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>WAITING_FOR_EVACUATION</code> - The capacity task requires capacity to run. You must stop the recommended EC2 running instances to free up capacity for the task to run.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>CANCELLATION_IN_PROGRESS</code> - The capacity task has been cancelled and is in the process of cleaning up resources.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>CANCELLED</code> - The capacity task is cancelled.</p>
    *             </li>
    *          </ul>
    * @public
@@ -2041,6 +2066,12 @@ export interface GetOutpostSupportedInstanceTypesInput {
    */
   OrderId?: string | undefined;
 
+  /**
+   * <p>The ID of the Outpost asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
+   * @public
+   */
+  AssetId?: string | undefined;
+
   /**
    * <p>The maximum page size.</p>
    * @public
@@ -2653,6 +2684,12 @@ export interface StartCapacityTaskInput {
    */
   OrderId?: string | undefined;
 
+  /**
+   * <p>The ID of the Outpost asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
+   * @public
+   */
+  AssetId?: string | undefined;
+
   /**
    * <p>The instance pools specified in the capacity task.</p>
    * @public
@@ -2715,6 +2752,12 @@ export interface StartCapacityTaskOutput {
    */
   OrderId?: string | undefined;
 
+  /**
+   * <p>The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>
+   * @public
+   */
+  AssetId?: string | undefined;
+
   /**
    * <p>List of the instance pools requested in the specified capacity task.</p>
    * @public
@@ -2795,7 +2838,7 @@ export interface StartConnectionRequest {
   DeviceSerialNumber?: string | undefined;
 
   /**
-   * <p> The ID of the Outpost server. </p>
+   * <p> The ID of the Outpost server.</p>
    * @public
    */
   AssetId: string | undefined;
@@ -3047,13 +3090,11 @@ export interface UpdateSiteRackPhysicalPropertiesInput {
    *                <ul>
    *                   <li>
    *                      <p>
-   *                         <b>AH530P7W (red)</b> – 3P+N+E, 7hr; 30A; three
-   *               phase</p>
+   *                         <b>AH530P7W (red)</b> – 3P+N+E, 7hr; 30A; three phase</p>
    *                   </li>
    *                   <li>
    *                      <p>
-   *                         <b>AH532P6W (red)</b> – 3P+N+E, 6hr; 32A; three
-   *               phase</p>
+   *                         <b>AH532P6W (red)</b> – 3P+N+E, 6hr; 32A; three phase</p>
    *                   </li>
    *                   <li>
    *                      <p>

clients/client-outposts/src/protocols/Aws_restJson1.ts

@@ -356,6 +356,7 @@ export const se_GetOutpostSupportedInstanceTypesCommand = async (
   b.p("OutpostIdentifier", () => input.OutpostIdentifier!, "{OutpostIdentifier}", false);
   const query: any = map({
     [_OI]: [, input[_OI]!],
+    [_AI]: [, input[_AI]!],
     [_MR]: [() => input.MaxResults !== void 0, () => input[_MR]!.toString()],
     [_NT]: [, input[_NT]!],
   });
@@ -605,6 +606,7 @@ export const se_StartCapacityTaskCommand = async (
   let body: any;
   body = JSON.stringify(
     take(input, {
+      AssetId: [],
       DryRun: [],
       InstancePools: (_) => _json(_),
       InstancesToExclude: (_) => _json(_),
@@ -934,6 +936,7 @@ export const de_GetCapacityTaskCommand = async (
   });
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
+    AssetId: __expectString,
     CapacityTaskId: __expectString,
     CapacityTaskStatus: __expectString,
     CompletionDate: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
@@ -1338,6 +1341,7 @@ export const de_StartCapacityTaskCommand = async (
   });
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
+    AssetId: __expectString,
     CapacityTaskId: __expectString,
     CapacityTaskStatus: __expectString,
     CompletionDate: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
@@ -1741,6 +1745,7 @@ const de_CapacityTaskList = (output: any, context: __SerdeContext): CapacityTask
  */
 const de_CapacityTaskSummary = (output: any, context: __SerdeContext): CapacityTaskSummary => {
   return take(output, {
+    AssetId: __expectString,
     CapacityTaskId: __expectString,
     CapacityTaskStatus: __expectString,
     CompletionDate: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
@@ -1888,6 +1893,7 @@ const deserializeMetadata = (output: __HttpResponse): __ResponseMetadata => ({
 const collectBodyString = (streamBody: any, context: __SerdeContext): Promise<string> =>
   collectBody(streamBody, context).then((body) => context.utf8Encoder(body));
 
+const _AI = "AssetId";
 const _AIF = "AssetIdFilter";
 const _AIFc = "AccountIdFilter";
 const _ASF = "AwsServiceFilter";

codegen/sdk-codegen/aws-models/outposts.json

@@ -252,6 +252,16 @@
         "smithy.api#pattern": "^(\\w+)$"
       }
     },
+    "com.amazonaws.outposts#AssetIdInput": {
+      "type": "string",
+      "traits": {
+        "smithy.api#length": {
+          "min": 10,
+          "max": 10
+        },
+        "smithy.api#pattern": "^\\d{10}$"
+      }
+    },
     "com.amazonaws.outposts#AssetIdList": {
       "type": "list",
       "member": {
@@ -264,7 +274,7 @@
         "AssetId": {
           "target": "com.amazonaws.outposts#AssetId",
           "traits": {
-            "smithy.api#documentation": "<p> The ID of the asset. </p>"
+            "smithy.api#documentation": "<p> The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>"
           }
         },
         "RackId": {
@@ -314,7 +324,7 @@
         "AssetId": {
           "target": "com.amazonaws.outposts#AssetId",
           "traits": {
-            "smithy.api#documentation": "<p>The ID of the asset.</p>"
+            "smithy.api#documentation": "<p>The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>"
           }
         },
         "AccountId": {
@@ -788,6 +798,12 @@
             "smithy.api#documentation": "<p>The ID of the Amazon Web Services Outposts order of the host associated with the capacity task.</p>"
           }
         },
+        "AssetId": {
+          "target": "com.amazonaws.outposts#AssetId",
+          "traits": {
+            "smithy.api#documentation": "<p>The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>"
+          }
+        },
         "CapacityTaskStatus": {
           "target": "com.amazonaws.outposts#CapacityTaskStatus",
           "traits": {
@@ -1670,6 +1686,12 @@
             "smithy.api#documentation": "<p>ID of the Amazon Web Services Outposts order associated with the specified capacity task.</p>"
           }
         },
+        "AssetId": {
+          "target": "com.amazonaws.outposts#AssetId",
+          "traits": {
+            "smithy.api#documentation": "<p>The ID of the Outpost asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>"
+          }
+        },
         "RequestedInstancePools": {
           "target": "com.amazonaws.outposts#RequestedInstancePools",
           "traits": {
@@ -1692,7 +1714,7 @@
         "CapacityTaskStatus": {
           "target": "com.amazonaws.outposts#CapacityTaskStatus",
           "traits": {
-            "smithy.api#documentation": "<p>Status of the capacity task.</p>\n         <p>A capacity task can have one of the following statuses:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>REQUESTED</code> - The capacity task was created and is awaiting the next step\n          by Amazon Web Services Outposts.</p>\n            </li>\n            <li>\n               <p>\n                  <code>IN_PROGRESS</code> - The capacity task is running and cannot be\n          cancelled.</p>\n            </li>\n            <li>\n               <p>\n                  <code>WAITING_FOR_EVACUATION</code> - The capacity task requires capacity to run. You\n          must stop the recommended EC2 running instances to free up capacity for the task to\n          run.</p>\n            </li>\n         </ul>"
+            "smithy.api#documentation": "<p>Status of the capacity task.</p>\n         <p>A capacity task can have one of the following statuses:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>REQUESTED</code> - The capacity task was created and is awaiting the next step\n          by Amazon Web Services Outposts.</p>\n            </li>\n            <li>\n               <p>\n                  <code>IN_PROGRESS</code> - The capacity task is running and cannot be cancelled.</p>\n            </li>\n            <li>\n               <p>\n                  <code>FAILED</code> - The capacity task could not be completed.</p>\n            </li>\n            <li>\n               <p>\n                  <code>COMPLETED</code> - The capacity task has completed successfully.</p>\n            </li>\n            <li>\n               <p>\n                  <code>WAITING_FOR_EVACUATION</code> - The capacity task requires capacity to run. You must stop the recommended EC2 running instances to free up capacity for the task to run.</p>\n            </li>\n            <li>\n               <p>\n                  <code>CANCELLATION_IN_PROGRESS</code> - The capacity task has been cancelled and is in the process of cleaning up resources.</p>\n            </li>\n            <li>\n               <p>\n                  <code>CANCELLED</code> - The capacity task is cancelled.</p>\n            </li>\n         </ul>"
           }
         },
         "Failed": {
@@ -2111,6 +2133,13 @@
             "smithy.api#httpQuery": "OrderId"
           }
         },
+        "AssetId": {
+          "target": "com.amazonaws.outposts#AssetIdInput",
+          "traits": {
+            "smithy.api#documentation": "<p>The ID of the Outpost asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>",
+            "smithy.api#httpQuery": "AssetId"
+          }
+        },
         "MaxResults": {
           "target": "com.amazonaws.outposts#MaxResults1000",
           "traits": {
@@ -2528,7 +2557,7 @@
         "AssetId": {
           "target": "com.amazonaws.outposts#AssetId",
           "traits": {
-            "smithy.api#documentation": "<p> The ID of the asset. </p>"
+            "smithy.api#documentation": "<p> The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>"
           }
         },
         "MacAddressList": {
@@ -5624,6 +5653,12 @@
             "smithy.api#documentation": "<p>The ID of the Amazon Web Services Outposts order associated with the specified capacity task.</p>"
           }
         },
+        "AssetId": {
+          "target": "com.amazonaws.outposts#AssetIdInput",
+          "traits": {
+            "smithy.api#documentation": "<p>The ID of the Outpost asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>"
+          }
+        },
         "InstancePools": {
           "target": "com.amazonaws.outposts#RequestedInstancePools",
           "traits": {
@@ -5676,6 +5711,12 @@
             "smithy.api#documentation": "<p>ID of the Amazon Web Services Outposts order of the host associated with the capacity task.</p>"
           }
         },
+        "AssetId": {
+          "target": "com.amazonaws.outposts#AssetId",
+          "traits": {
+            "smithy.api#documentation": "<p>The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.</p>"
+          }
+        },
         "RequestedInstancePools": {
           "target": "com.amazonaws.outposts#RequestedInstancePools",
           "traits": {
@@ -5779,7 +5820,7 @@
         "AssetId": {
           "target": "com.amazonaws.outposts#AssetId",
           "traits": {
-            "smithy.api#documentation": "<p> The ID of the Outpost server. </p>",
+            "smithy.api#documentation": "<p> The ID of the Outpost server.</p>",
             "smithy.api#required": {}
           }
         },
@@ -6415,7 +6456,7 @@
         "PowerConnector": {
           "target": "com.amazonaws.outposts#PowerConnector",
           "traits": {
-            "smithy.api#documentation": "<p>The power connector that Amazon Web Services should plan to provide for connections to the hardware.\n      Note the correlation between <code>PowerPhase</code> and <code>PowerConnector</code>. </p>\n         <ul>\n            <li>\n               <p>Single-phase AC feed</p>\n               <ul>\n                  <li>\n                     <p>\n                        <b>L6-30P</b> – (common in US); 30A; single phase</p>\n                  </li>\n                  <li>\n                     <p>\n                        <b>IEC309 (blue)</b> – P+N+E, 6hr; 32 A; single\n              phase</p>\n                  </li>\n               </ul>\n            </li>\n            <li>\n               <p>Three-phase AC feed</p>\n               <ul>\n                  <li>\n                     <p>\n                        <b>AH530P7W (red)</b> – 3P+N+E, 7hr; 30A; three\n              phase</p>\n                  </li>\n                  <li>\n                     <p>\n                        <b>AH532P6W (red)</b> – 3P+N+E, 6hr; 32A; three\n              phase</p>\n                  </li>\n                  <li>\n                     <p>\n                        <b>CS8365C</b> – (common in US); 3P+E, 50A; three phase</p>\n                  </li>\n               </ul>\n            </li>\n         </ul>"
+            "smithy.api#documentation": "<p>The power connector that Amazon Web Services should plan to provide for connections to the hardware.\n      Note the correlation between <code>PowerPhase</code> and <code>PowerConnector</code>. </p>\n         <ul>\n            <li>\n               <p>Single-phase AC feed</p>\n               <ul>\n                  <li>\n                     <p>\n                        <b>L6-30P</b> – (common in US); 30A; single phase</p>\n                  </li>\n                  <li>\n                     <p>\n                        <b>IEC309 (blue)</b> – P+N+E, 6hr; 32 A; single\n              phase</p>\n                  </li>\n               </ul>\n            </li>\n            <li>\n               <p>Three-phase AC feed</p>\n               <ul>\n                  <li>\n                     <p>\n                        <b>AH530P7W (red)</b> – 3P+N+E, 7hr; 30A; three phase</p>\n                  </li>\n                  <li>\n                     <p>\n                        <b>AH532P6W (red)</b> – 3P+N+E, 6hr; 32A; three phase</p>\n                  </li>\n                  <li>\n                     <p>\n                        <b>CS8365C</b> – (common in US); 3P+E, 50A; three phase</p>\n                  </li>\n               </ul>\n            </li>\n         </ul>"
           }
         },
         "PowerFeedDrop": {