feat(client-application-discovery-service): Add support to import dat…

…a from commercially available discovery tools without file manipulation.
aws · Nov 20, 2024 · 2cc0b79 · 2cc0b79
1 parent dc6c77d
commit 2cc0b79
Show file tree

Hide file tree

Showing 8 changed files with 125 additions and 9 deletions.
diff --git a/clients/client-application-discovery-service/src/commands/CreateApplicationCommand.ts b/clients/client-application-discovery-service/src/commands/CreateApplicationCommand.ts
@@ -42,6 +42,7 @@ export interface CreateApplicationCommandOutput extends CreateApplicationRespons
  * const input = { // CreateApplicationRequest
  *   name: "STRING_VALUE", // required
  *   description: "STRING_VALUE",
+ *   wave: "STRING_VALUE",
  * };
  * const command = new CreateApplicationCommand(input);
  * const response = await client.send(command);

diff --git a/clients/client-application-discovery-service/src/commands/DescribeImportTasksCommand.ts b/clients/client-application-discovery-service/src/commands/DescribeImportTasksCommand.ts
@@ -43,7 +43,7 @@ export interface DescribeImportTasksCommandOutput extends DescribeImportTasksRes
  * const input = { // DescribeImportTasksRequest
  *   filters: [ // DescribeImportTasksFilterList
  *     { // ImportTaskFilter
- *       name: "IMPORT_TASK_ID" || "STATUS" || "NAME",
+ *       name: "IMPORT_TASK_ID" || "STATUS" || "NAME" || "FILE_CLASSIFICATION",
  *       values: [ // ImportTaskFilterValueList
  *         "STRING_VALUE",
  *       ],
@@ -62,10 +62,11 @@ export interface DescribeImportTasksCommandOutput extends DescribeImportTasksRes
  * //       clientRequestToken: "STRING_VALUE",
  * //       name: "STRING_VALUE",
  * //       importUrl: "STRING_VALUE",
- * //       status: "IMPORT_IN_PROGRESS" || "IMPORT_COMPLETE" || "IMPORT_COMPLETE_WITH_ERRORS" || "IMPORT_FAILED" || "IMPORT_FAILED_SERVER_LIMIT_EXCEEDED" || "IMPORT_FAILED_RECORD_LIMIT_EXCEEDED" || "DELETE_IN_PROGRESS" || "DELETE_COMPLETE" || "DELETE_FAILED" || "DELETE_FAILED_LIMIT_EXCEEDED" || "INTERNAL_ERROR",
+ * //       status: "IMPORT_IN_PROGRESS" || "IMPORT_COMPLETE" || "IMPORT_COMPLETE_WITH_ERRORS" || "IMPORT_FAILED" || "IMPORT_FAILED_SERVER_LIMIT_EXCEEDED" || "IMPORT_FAILED_RECORD_LIMIT_EXCEEDED" || "IMPORT_FAILED_UNSUPPORTED_FILE_TYPE" || "DELETE_IN_PROGRESS" || "DELETE_COMPLETE" || "DELETE_FAILED" || "DELETE_FAILED_LIMIT_EXCEEDED" || "INTERNAL_ERROR",
  * //       importRequestTime: new Date("TIMESTAMP"),
  * //       importCompletionTime: new Date("TIMESTAMP"),
  * //       importDeletedTime: new Date("TIMESTAMP"),
+ * //       fileClassification: "MODELIZEIT_EXPORT" || "RVTOOLS_EXPORT" || "VMWARE_NSX_EXPORT" || "IMPORT_TEMPLATE",
  * //       serverImportSuccess: Number("int"),
  * //       serverImportFailure: Number("int"),
  * //       applicationImportSuccess: Number("int"),

diff --git a/...nt-application-discovery-service/src/commands/StartBatchDeleteConfigurationTaskCommand.ts b/...nt-application-discovery-service/src/commands/StartBatchDeleteConfigurationTaskCommand.ts
@@ -77,6 +77,9 @@ export interface StartBatchDeleteConfigurationTaskCommandOutput
  * @throws {@link HomeRegionNotSetException} (client fault)
  *  <p>The home Region is not set. Set the home Region to continue.</p>
  *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>One or more parameters are not valid. Verify the parameters and try again.</p>
+ *
  * @throws {@link InvalidParameterValueException} (client fault)
  *  <p>The value of one or more parameters are either invalid or out of range. Verify the
  *       parameter values and try again.</p>

diff --git a/clients/client-application-discovery-service/src/commands/StartImportTaskCommand.ts b/clients/client-application-discovery-service/src/commands/StartImportTaskCommand.ts
@@ -84,10 +84,11 @@ export interface StartImportTaskCommandOutput extends StartImportTaskResponse, _
  * //     clientRequestToken: "STRING_VALUE",
  * //     name: "STRING_VALUE",
  * //     importUrl: "STRING_VALUE",
- * //     status: "IMPORT_IN_PROGRESS" || "IMPORT_COMPLETE" || "IMPORT_COMPLETE_WITH_ERRORS" || "IMPORT_FAILED" || "IMPORT_FAILED_SERVER_LIMIT_EXCEEDED" || "IMPORT_FAILED_RECORD_LIMIT_EXCEEDED" || "DELETE_IN_PROGRESS" || "DELETE_COMPLETE" || "DELETE_FAILED" || "DELETE_FAILED_LIMIT_EXCEEDED" || "INTERNAL_ERROR",
+ * //     status: "IMPORT_IN_PROGRESS" || "IMPORT_COMPLETE" || "IMPORT_COMPLETE_WITH_ERRORS" || "IMPORT_FAILED" || "IMPORT_FAILED_SERVER_LIMIT_EXCEEDED" || "IMPORT_FAILED_RECORD_LIMIT_EXCEEDED" || "IMPORT_FAILED_UNSUPPORTED_FILE_TYPE" || "DELETE_IN_PROGRESS" || "DELETE_COMPLETE" || "DELETE_FAILED" || "DELETE_FAILED_LIMIT_EXCEEDED" || "INTERNAL_ERROR",
  * //     importRequestTime: new Date("TIMESTAMP"),
  * //     importCompletionTime: new Date("TIMESTAMP"),
  * //     importDeletedTime: new Date("TIMESTAMP"),
+ * //     fileClassification: "MODELIZEIT_EXPORT" || "RVTOOLS_EXPORT" || "VMWARE_NSX_EXPORT" || "IMPORT_TEMPLATE",
  * //     serverImportSuccess: Number("int"),
  * //     serverImportFailure: Number("int"),
  * //     applicationImportSuccess: Number("int"),

diff --git a/clients/client-application-discovery-service/src/commands/UpdateApplicationCommand.ts b/clients/client-application-discovery-service/src/commands/UpdateApplicationCommand.ts
@@ -43,6 +43,7 @@ export interface UpdateApplicationCommandOutput extends UpdateApplicationRespons
  *   configurationId: "STRING_VALUE", // required
  *   name: "STRING_VALUE",
  *   description: "STRING_VALUE",
+ *   wave: "STRING_VALUE",
  * };
  * const command = new UpdateApplicationCommand(input);
  * const response = await client.send(command);

diff --git a/clients/client-application-discovery-service/src/models/models_0.ts b/clients/client-application-discovery-service/src/models/models_0.ts
@@ -442,24 +442,30 @@ export interface BatchDeleteImportDataResponse {
  */
 export interface CreateApplicationRequest {
   /**
-   * <p>Name of the application to be created.</p>
+   * <p>The name of the application to be created.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * <p>Description of the application to be created.</p>
+   * <p>The description of the application to be created.</p>
    * @public
    */
   description?: string | undefined;
+
+  /**
+   * <p>The name of the migration wave of the application to be created.</p>
+   * @public
+   */
+  wave?: string | undefined;
 }
 
 /**
  * @public
  */
 export interface CreateApplicationResponse {
   /**
-   * <p>Configuration ID of an application to be created.</p>
+   * <p>The configuration ID of an application to be created.</p>
    * @public
    */
   configurationId?: string | undefined;
@@ -1374,6 +1380,7 @@ export interface DescribeExportTasksResponse {
  * @enum
  */
 export const ImportTaskFilterName = {
+  FILE_CLASSIFICATION: "FILE_CLASSIFICATION",
   IMPORT_TASK_ID: "IMPORT_TASK_ID",
   NAME: "NAME",
   STATUS: "STATUS",
@@ -1432,6 +1439,22 @@ export interface DescribeImportTasksRequest {
   nextToken?: string | undefined;
 }
 
+/**
+ * @public
+ * @enum
+ */
+export const FileClassification = {
+  IMPORT_TEMPLATE: "IMPORT_TEMPLATE",
+  MODELIZEIT_EXPORT: "MODELIZEIT_EXPORT",
+  RVTOOLS_EXPORT: "RVTOOLS_EXPORT",
+  VMWARE_NSX_EXPORT: "VMWARE_NSX_EXPORT",
+} as const;
+
+/**
+ * @public
+ */
+export type FileClassification = (typeof FileClassification)[keyof typeof FileClassification];
+
 /**
  * @public
  * @enum
@@ -1446,6 +1469,7 @@ export const ImportStatus = {
   IMPORT_FAILED: "IMPORT_FAILED",
   IMPORT_FAILED_RECORD_LIMIT_EXCEEDED: "IMPORT_FAILED_RECORD_LIMIT_EXCEEDED",
   IMPORT_FAILED_SERVER_LIMIT_EXCEEDED: "IMPORT_FAILED_SERVER_LIMIT_EXCEEDED",
+  IMPORT_FAILED_UNSUPPORTED_FILE_TYPE: "IMPORT_FAILED_UNSUPPORTED_FILE_TYPE",
   IMPORT_IN_PROGRESS: "IMPORT_IN_PROGRESS",
   INTERNAL_ERROR: "INTERNAL_ERROR",
 } as const;
@@ -1521,6 +1545,12 @@ export interface ImportTask {
    */
   importDeletedTime?: Date | undefined;
 
+  /**
+   * <p>The type of file detected by the import task.</p>
+   * @public
+   */
+  fileClassification?: FileClassification | undefined;
+
   /**
    * <p>The total number of server records in the import file that were successfully
    *       imported.</p>
@@ -2794,6 +2824,12 @@ export interface UpdateApplicationRequest {
    * @public
    */
   description?: string | undefined;
+
+  /**
+   * <p>The new migration wave of the application that you want to update.</p>
+   * @public
+   */
+  wave?: string | undefined;
 }
 
 /**

diff --git a/clients/client-application-discovery-service/src/protocols/Aws_json1_1.ts b/clients/client-application-discovery-service/src/protocols/Aws_json1_1.ts
@@ -1717,6 +1717,7 @@ const de_ImportTask = (output: any, context: __SerdeContext): ImportTask => {
     applicationImportSuccess: __expectInt32,
     clientRequestToken: __expectString,
     errorsAndFailedEntriesZip: __expectString,
+    fileClassification: __expectString,
     importCompletionTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
     importDeletedTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
     importRequestTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),

diff --git a/codegen/sdk-codegen/aws-models/application-discovery-service.json b/codegen/sdk-codegen/aws-models/application-discovery-service.json
@@ -1071,6 +1071,16 @@
         "smithy.api#pattern": "^[\\s\\S]*\\S[\\s\\S]*$"
       }
     },
+    "com.amazonaws.applicationdiscoveryservice#ApplicationWave": {
+      "type": "string",
+      "traits": {
+        "smithy.api#length": {
+          "min": 0,
+          "max": 256
+        },
+        "smithy.api#pattern": "^($|[^\\s\\x00]( *[^\\s\\x00])*$)$"
+      }
+    },
     "com.amazonaws.applicationdiscoveryservice#AssociateConfigurationItemsToApplication": {
       "type": "operation",
       "input": {
@@ -1763,14 +1773,20 @@
         "name": {
           "target": "com.amazonaws.applicationdiscoveryservice#ApplicationName",
           "traits": {
-            "smithy.api#documentation": "<p>Name of the application to be created.</p>",
+            "smithy.api#documentation": "<p>The name of the application to be created.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
           "target": "com.amazonaws.applicationdiscoveryservice#ApplicationDescription",
           "traits": {
-            "smithy.api#documentation": "<p>Description of the application to be created.</p>"
+            "smithy.api#documentation": "<p>The description of the application to be created.</p>"
+          }
+        },
+        "wave": {
+          "target": "com.amazonaws.applicationdiscoveryservice#ApplicationWave",
+          "traits": {
+            "smithy.api#documentation": "<p>The name of the migration wave of the application to be created.</p>"
           }
         }
       },
@@ -1784,7 +1800,7 @@
         "configurationId": {
           "target": "com.amazonaws.applicationdiscoveryservice#String",
           "traits": {
-            "smithy.api#documentation": "<p>Configuration ID of an application to be created.</p>"
+            "smithy.api#documentation": "<p>The configuration ID of an application to be created.</p>"
           }
         }
       },
@@ -3409,6 +3425,35 @@
         "target": "com.amazonaws.applicationdiscoveryservice#FailedConfiguration"
       }
     },
+    "com.amazonaws.applicationdiscoveryservice#FileClassification": {
+      "type": "enum",
+      "members": {
+        "MODELIZEIT_EXPORT": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "MODELIZEIT_EXPORT"
+          }
+        },
+        "RVTOOLS_EXPORT": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "RVTOOLS_EXPORT"
+          }
+        },
+        "VMWARE_NSX_EXPORT": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "VMWARE_NSX_EXPORT"
+          }
+        },
+        "IMPORT_TEMPLATE": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "IMPORT_TEMPLATE"
+          }
+        }
+      }
+    },
     "com.amazonaws.applicationdiscoveryservice#Filter": {
       "type": "structure",
       "members": {
@@ -3621,6 +3666,12 @@
             "smithy.api#enumValue": "IMPORT_FAILED_RECORD_LIMIT_EXCEEDED"
           }
         },
+        "IMPORT_FAILED_UNSUPPORTED_FILE_TYPE": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "IMPORT_FAILED_UNSUPPORTED_FILE_TYPE"
+          }
+        },
         "DELETE_IN_PROGRESS": {
           "target": "smithy.api#Unit",
           "traits": {
@@ -3704,6 +3755,12 @@
             "smithy.api#documentation": "<p>The time that the import task request was deleted, presented in the Unix time stamp\n      format.</p>"
           }
         },
+        "fileClassification": {
+          "target": "com.amazonaws.applicationdiscoveryservice#FileClassification",
+          "traits": {
+            "smithy.api#documentation": "<p>The type of file detected by the import task.</p>"
+          }
+        },
         "serverImportSuccess": {
           "target": "com.amazonaws.applicationdiscoveryservice#Integer",
           "traits": {
@@ -3783,6 +3840,12 @@
           "traits": {
             "smithy.api#enumValue": "NAME"
           }
+        },
+        "FILE_CLASSIFICATION": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "FILE_CLASSIFICATION"
+          }
         }
       }
     },
@@ -4332,6 +4395,9 @@
         {
           "target": "com.amazonaws.applicationdiscoveryservice#HomeRegionNotSetException"
         },
+        {
+          "target": "com.amazonaws.applicationdiscoveryservice#InvalidParameterException"
+        },
         {
           "target": "com.amazonaws.applicationdiscoveryservice#InvalidParameterValueException"
         },
@@ -5006,6 +5072,12 @@
           "traits": {
             "smithy.api#documentation": "<p>New description of the application to be updated.</p>"
           }
+        },
+        "wave": {
+          "target": "com.amazonaws.applicationdiscoveryservice#ApplicationWave",
+          "traits": {
+            "smithy.api#documentation": "<p>The new migration wave of the application that you want to update.</p>"
+          }
         }
       },
       "traits": {