@aws-sdk/client-database-migration-service 3.1097.0 → 3.1098.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/dist-cjs/index.js +1 -1
  2. package/dist-types/commands/CancelMetadataModelConversionCommand.d.ts +24 -0
  3. package/dist-types/commands/CancelMetadataModelCreationCommand.d.ts +24 -0
  4. package/dist-types/commands/CreateDataProviderCommand.d.ts +25 -24
  5. package/dist-types/commands/CreateInstanceProfileCommand.d.ts +23 -20
  6. package/dist-types/commands/CreateMigrationProjectCommand.d.ts +36 -36
  7. package/dist-types/commands/DeleteDataProviderCommand.d.ts +18 -12
  8. package/dist-types/commands/DeleteInstanceProfileCommand.d.ts +16 -10
  9. package/dist-types/commands/DeleteMigrationProjectCommand.d.ts +25 -19
  10. package/dist-types/commands/DescribeConversionConfigurationCommand.d.ts +9 -5
  11. package/dist-types/commands/DescribeDataProvidersCommand.d.ts +20 -17
  12. package/dist-types/commands/DescribeExtensionPackAssociationsCommand.d.ts +35 -13
  13. package/dist-types/commands/DescribeInstanceProfilesCommand.d.ts +20 -14
  14. package/dist-types/commands/DescribeMetadataModelAssessmentsCommand.d.ts +41 -12
  15. package/dist-types/commands/DescribeMetadataModelChildrenCommand.d.ts +38 -0
  16. package/dist-types/commands/DescribeMetadataModelCommand.d.ts +29 -0
  17. package/dist-types/commands/DescribeMetadataModelConversionsCommand.d.ts +42 -10
  18. package/dist-types/commands/DescribeMetadataModelCreationsCommand.d.ts +55 -1
  19. package/dist-types/commands/DescribeMetadataModelExportsAsScriptCommand.d.ts +42 -10
  20. package/dist-types/commands/DescribeMetadataModelExportsToTargetCommand.d.ts +38 -10
  21. package/dist-types/commands/DescribeMetadataModelImportsCommand.d.ts +38 -10
  22. package/dist-types/commands/DescribeMigrationProjectsCommand.d.ts +26 -23
  23. package/dist-types/commands/ExportMetadataModelAssessmentCommand.d.ts +15 -10
  24. package/dist-types/commands/GetTargetSelectionRulesCommand.d.ts +20 -0
  25. package/dist-types/commands/ModifyConversionConfigurationCommand.d.ts +9 -5
  26. package/dist-types/commands/ModifyDataProviderCommand.d.ts +20 -18
  27. package/dist-types/commands/ModifyInstanceProfileCommand.d.ts +18 -18
  28. package/dist-types/commands/ModifyMigrationProjectCommand.d.ts +27 -36
  29. package/dist-types/commands/StartExtensionPackAssociationCommand.d.ts +18 -7
  30. package/dist-types/commands/StartMetadataModelAssessmentCommand.d.ts +22 -10
  31. package/dist-types/commands/StartMetadataModelConversionCommand.d.ts +56 -6
  32. package/dist-types/commands/StartMetadataModelCreationCommand.d.ts +53 -2
  33. package/dist-types/commands/StartMetadataModelExportAsScriptCommand.d.ts +22 -9
  34. package/dist-types/commands/StartMetadataModelExportToTargetCommand.d.ts +25 -6
  35. package/dist-types/commands/StartMetadataModelImportCommand.d.ts +16 -8
  36. package/dist-types/models/models_0.d.ts +339 -71
  37. package/dist-types/models/models_1.d.ts +93 -25
  38. package/package.json +6 -6
@@ -26,6 +26,10 @@ declare const DescribeDataProvidersCommand_base: {
26
26
  /**
27
27
  * <p>Returns a paginated list of data providers for your account in the current
28
28
  * region.</p>
29
+ * <p>
30
+ * <b>Required permissions:</b>
31
+ * <code>dms:ListDataProviders</code>. For more information, see
32
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
29
33
  * @example
30
34
  * Use a bare-bones client and the command you need to make an API call.
31
35
  * ```javascript
@@ -186,20 +190,18 @@ declare const DescribeDataProvidersCommand_base: {
186
190
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
187
191
  *
188
192
  *
189
- * @example Describe Data Providers
193
+ * @example Describe data providers with a filter
190
194
  * ```javascript
191
- * //
195
+ * // The following example retrieves the details of a data provider identified by its ARN.
192
196
  * const input = {
193
197
  * Filters: [
194
198
  * {
195
199
  * Name: "data-provider-identifier",
196
200
  * Values: [
197
- * "arn:aws:dms:us-east-1:012345678901:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRSTUVWXYZ012345"
201
+ * "arn:aws:dms:us-east-1:111122223333:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS"
198
202
  * ]
199
203
  * }
200
- * ],
201
- * Marker: "EXAMPLEABCDEFGHIJKLMNOPQRSTUVWXYZ012345",
202
- * MaxRecords: 20
204
+ * ]
203
205
  * };
204
206
  * const command = new DescribeDataProvidersCommand(input);
205
207
  * const response = await client.send(command);
@@ -207,21 +209,22 @@ declare const DescribeDataProvidersCommand_base: {
207
209
  * {
208
210
  * DataProviders: [
209
211
  * {
210
- * DataProviderArn: "arn:aws:dms:us-east-1:012345678901:data-provider:my-target-data-provider",
211
- * DataProviderCreationTime: "2023-05-12T10:50:41.988561Z",
212
- * DataProviderName: "my-target-data-provider",
213
- * Engine: "postgres",
212
+ * DataProviderArn: "arn:aws:dms:us-east-1:111122223333:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS",
213
+ * DataProviderCreationTime: "2026-01-09T12:30:00.000000Z",
214
+ * DataProviderName: "example-data-provider",
215
+ * Description: "Example data provider for documentation",
216
+ * Engine: "sqlserver",
214
217
  * Settings: {
215
- * PostgreSqlSettings: {
216
- * DatabaseName: "target",
217
- * Port: 5432,
218
- * ServerName: "postrgesql.0a1b2c3d4e5f.us-east-1.rds.amazonaws.com",
219
- * SslMode: "none"
218
+ * MicrosoftSqlServerSettings: {
219
+ * CertificateArn: "arn:aws:dms:us-east-1:111122223333:cert:EXAMPLEABCDEFGHIJKLMNOPQRS",
220
+ * DatabaseName: "ExampleDatabase",
221
+ * Port: 1433,
222
+ * ServerName: "example-source-server.us-east-1.rds.amazonaws.com",
223
+ * SslMode: "verify-full"
220
224
  * }
221
225
  * }
222
226
  * }
223
- * ],
224
- * Marker: "EXAMPLEABCDEFGHIJKLMNOPQRSTUVWXYZ012345"
227
+ * ]
225
228
  * }
226
229
  * *\/
227
230
  * ```
@@ -24,9 +24,13 @@ declare const DescribeExtensionPackAssociationsCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Returns a paginated list of extension pack associations for the specified migration
28
- * project. An extension pack is an add-on module that emulates functions present in a source
29
- * database that are required when converting objects to the target database.</p>
27
+ * <p>Returns a paginated list of extension pack installation requests for a migration
28
+ * project, initiated by
29
+ * <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_StartExtensionPackAssociation.html">StartExtensionPackAssociation</a>.</p>
30
+ * <p>
31
+ * <b>Required permissions:</b>
32
+ * <code>dms:ListExtensionPacks</code>. For more information, see
33
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
30
34
  * @example
31
35
  * Use a bare-bones client and the command you need to make an API call.
32
36
  * ```javascript
@@ -92,32 +96,50 @@ declare const DescribeExtensionPackAssociationsCommand_base: {
92
96
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
93
97
  *
94
98
  *
95
- * @example Describe Extension Pack Associations
99
+ * @example Retrieve the status of extension pack associations
96
100
  * ```javascript
97
- * // Returns a paginated list of extension pack associations for the specified migration project.
101
+ * // The following example retrieves the status of operations that apply an extension pack to the target database, identified by their request IDs.
98
102
  * const input = {
99
103
  * Filters: [
100
104
  * {
101
- * Name: "instance-profile-identifier",
105
+ * Name: "request-id",
102
106
  * Values: [
103
- * "arn:aws:dms:us-east-1:012345678901:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRSTUVWXYZ012345"
107
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
108
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
109
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
104
110
  * ]
105
111
  * }
106
112
  * ],
107
- * Marker: "0123456789abcdefghijklmnopqrs",
108
- * MaxRecords: 20,
109
- * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:012345678901:migration-project:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012"
113
+ * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"
110
114
  * };
111
115
  * const command = new DescribeExtensionPackAssociationsCommand(input);
112
116
  * const response = await client.send(command);
113
117
  * /* response is
114
118
  * {
115
- * Marker: "0123456789abcdefghijklmnopqrs",
116
119
  * Requests: [
117
120
  * {
118
- * MigrationProjectArn: "arn:aws:dms:us-east-1:012345678901:migration-project:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012",
119
- * RequestIdentifier: "01234567-89ab-cdef-0123-456789abcdef",
121
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
122
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
120
123
  * Status: "SUCCESS"
124
+ * },
125
+ * {
126
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
127
+ * Progress: {
128
+ * ProgressPercent: 50.0,
129
+ * ProgressStep: "IN_PROGRESS"
130
+ * },
131
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
132
+ * Status: "IN_PROGRESS"
133
+ * },
134
+ * {
135
+ * Error: {
136
+ * defaultErrorDetails: {
137
+ * Message: "The database user in your target secret does not have sufficient privileges. Grant the required privileges and try again."
138
+ * }
139
+ * },
140
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
141
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
142
+ * Status: "FAILED"
121
143
  * }
122
144
  * ]
123
145
  * }
@@ -26,6 +26,10 @@ declare const DescribeInstanceProfilesCommand_base: {
26
26
  /**
27
27
  * <p>Returns a paginated list of instance profiles for your account in the current
28
28
  * region.</p>
29
+ * <p>
30
+ * <b>Required permissions:</b>
31
+ * <code>dms:ListInstanceProfiles</code>. For more information, see
32
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
29
33
  * @example
30
34
  * Use a bare-bones client and the command you need to make an API call.
31
35
  * ```javascript
@@ -90,20 +94,18 @@ declare const DescribeInstanceProfilesCommand_base: {
90
94
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
91
95
  *
92
96
  *
93
- * @example Describe Instance Profiles
97
+ * @example Describe instance profiles with a filter
94
98
  * ```javascript
95
- * // Returns a paginated list of instance profiles for your account in the current region.
99
+ * // The following example retrieves the details of an instance profile identified by its ARN.
96
100
  * const input = {
97
101
  * Filters: [
98
102
  * {
99
103
  * Name: "instance-profile-identifier",
100
104
  * Values: [
101
- * "arn:aws:dms:us-east-1:012345678901:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRSTUVWXYZ012345"
105
+ * "arn:aws:dms:us-east-1:111122223333:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS"
102
106
  * ]
103
107
  * }
104
- * ],
105
- * Marker: "0123456789abcdefghijklmnopqrs",
106
- * MaxRecords: 20
108
+ * ]
107
109
  * };
108
110
  * const command = new DescribeInstanceProfilesCommand(input);
109
111
  * const response = await client.send(command);
@@ -111,15 +113,19 @@ declare const DescribeInstanceProfilesCommand_base: {
111
113
  * {
112
114
  * InstanceProfiles: [
113
115
  * {
114
- * InstanceProfileArn: "arn:aws:dms:us-east-1:012345678901:instance-profile:my-instance-profile",
115
- * InstanceProfileCreationTime: "2022-12-16T09:44:43.543246Z",
116
- * InstanceProfileName: "my-instance-profile",
117
- * KmsKeyArn: "arn:aws:kms:us-east-1:012345678901:key/01234567-89ab-cdef-0123-456789abcdef",
118
- * PubliclyAccessible: true,
119
- * SubnetGroupIdentifier: "public-subnets"
116
+ * Description: "Example instance profile for documentation",
117
+ * InstanceProfileArn: "arn:aws:dms:us-east-1:111122223333:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS",
118
+ * InstanceProfileCreationTime: "2026-01-09T12:30:00.000000Z",
119
+ * InstanceProfileName: "example-instance-profile",
120
+ * KmsKeyArn: "arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
121
+ * NetworkType: "IPV4",
122
+ * PubliclyAccessible: false,
123
+ * SubnetGroupIdentifier: "example-replication-subnet-group",
124
+ * VpcSecurityGroups: [
125
+ * "sg-0123456789abcdef0"
126
+ * ]
120
127
  * }
121
- * ],
122
- * Marker: "0123456789abcdefghijklmnopqrs"
128
+ * ]
123
129
  * }
124
130
  * *\/
125
131
  * ```
@@ -24,8 +24,13 @@ declare const DescribeMetadataModelAssessmentsCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Returns a paginated list of metadata model assessments for your account in the current
28
- * region.</p>
27
+ * <p>Returns a paginated list of metadata model assessment requests for a migration
28
+ * project, initiated by
29
+ * <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_StartMetadataModelAssessment.html">StartMetadataModelAssessment</a>.</p>
30
+ * <p>
31
+ * <b>Required permissions:</b>
32
+ * <code>dms:ListMetadataModelAssessments</code>. For more information, see
33
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
29
34
  * @example
30
35
  * Use a bare-bones client and the command you need to make an API call.
31
36
  * ```javascript
@@ -94,32 +99,56 @@ declare const DescribeMetadataModelAssessmentsCommand_base: {
94
99
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
95
100
  *
96
101
  *
97
- * @example Describe Metadata Model Assessments
102
+ * @example Retrieve the status of metadata model assessments
98
103
  * ```javascript
99
- * // Returns a paginated list of metadata model assessments for your account in the current region.
104
+ * // The following example retrieves the status of metadata model assessment operations identified by their request IDs.
100
105
  * const input = {
101
106
  * Filters: [
102
107
  * {
103
- * Name: "my-migration-project",
108
+ * Name: "request-id",
104
109
  * Values: [
105
- * "arn:aws:dms:us-east-1:012345678901:migration-project:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012"
110
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
111
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
112
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
106
113
  * ]
107
114
  * }
108
115
  * ],
109
- * Marker: "0123456789abcdefghijklmnopqrs",
110
- * MaxRecords: 20,
111
- * MigrationProjectIdentifier: ""
116
+ * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"
112
117
  * };
113
118
  * const command = new DescribeMetadataModelAssessmentsCommand(input);
114
119
  * const response = await client.send(command);
115
120
  * /* response is
116
121
  * {
117
- * Marker: "ASDLKJASDJKHDFHGDNBGDASKJHGFK",
118
122
  * Requests: [
119
123
  * {
120
- * MigrationProjectArn: "arn:aws:dms:us-east-1:012345678901:migration-project:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012",
121
- * RequestIdentifier: "01234567-89ab-cdef-0123-456789abcdef",
124
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
125
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
122
126
  * Status: "SUCCESS"
127
+ * },
128
+ * {
129
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
130
+ * Progress: {
131
+ * ProcessedObject: {
132
+ * EndpointType: "SOURCE",
133
+ * Name: "ExampleTable",
134
+ * Type: "table"
135
+ * },
136
+ * ProgressPercent: 50.0,
137
+ * ProgressStep: "ANALYZING",
138
+ * TotalObjects: 100
139
+ * },
140
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
141
+ * Status: "IN_PROGRESS"
142
+ * },
143
+ * {
144
+ * Error: {
145
+ * defaultErrorDetails: {
146
+ * Message: "No objects were found according to the specified selection rules. Please review your selection rules and try again."
147
+ * }
148
+ * },
149
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
150
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
151
+ * Status: "FAILED"
123
152
  * }
124
153
  * ]
125
154
  * }
@@ -25,6 +25,10 @@ declare const DescribeMetadataModelChildrenCommand_base: {
25
25
  };
26
26
  /**
27
27
  * <p>Gets a list of child metadata models for the specified metadata model in the database hierarchy.</p>
28
+ * <p>
29
+ * <b>Required permissions:</b>
30
+ * <code>dms:DescribeMetadataModelChildren</code>. For more information, see
31
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
28
32
  * @example
29
33
  * Use a bare-bones client and the command you need to make an API call.
30
34
  * ```javascript
@@ -71,6 +75,40 @@ declare const DescribeMetadataModelChildrenCommand_base: {
71
75
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
72
76
  *
73
77
  *
78
+ * @example Retrieve children of a schema
79
+ * ```javascript
80
+ * // The following example retrieves the child metadata models of the ExampleSchema schema from the source metadata tree.
81
+ * const input = {
82
+ * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
83
+ * Origin: "SOURCE",
84
+ * SelectionRules: `{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}`
85
+ * };
86
+ * const command = new DescribeMetadataModelChildrenCommand(input);
87
+ * const response = await client.send(command);
88
+ * /* response is
89
+ * {
90
+ * MetadataModelChildren: [
91
+ * {
92
+ * MetadataModelName: "Tables",
93
+ * SelectionRules: `{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema", "category-name": "Tables"}, "rule-action": "explicit"}]}`
94
+ * },
95
+ * {
96
+ * MetadataModelName: "Views",
97
+ * SelectionRules: `{"rules": [{"rule-type": "selection", "rule-id": "2", "rule-name": "2", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema", "category-name": "Views"}, "rule-action": "explicit"}]}`
98
+ * },
99
+ * {
100
+ * MetadataModelName: "Functions",
101
+ * SelectionRules: `{"rules": [{"rule-type": "selection", "rule-id": "3", "rule-name": "3", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema", "category-name": "Functions"}, "rule-action": "explicit"}]}`
102
+ * },
103
+ * {
104
+ * MetadataModelName: "Sequences",
105
+ * SelectionRules: `{"rules": [{"rule-type": "selection", "rule-id": "4", "rule-name": "4", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema", "category-name": "Sequences"}, "rule-action": "explicit"}]}`
106
+ * }
107
+ * ]
108
+ * }
109
+ * *\/
110
+ * ```
111
+ *
74
112
  * @public
75
113
  */
76
114
  export declare class DescribeMetadataModelChildrenCommand extends DescribeMetadataModelChildrenCommand_base {
@@ -25,6 +25,10 @@ declare const DescribeMetadataModelCommand_base: {
25
25
  };
26
26
  /**
27
27
  * <p>Gets detailed information about the specified metadata model, including its definition and corresponding converted objects in the target database if applicable.</p>
28
+ * <p>
29
+ * <b>Required permissions:</b>
30
+ * <code>dms:DescribeMetadataModel</code>. For more information, see
31
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
28
32
  * @example
29
33
  * Use a bare-bones client and the command you need to make an API call.
30
34
  * ```javascript
@@ -71,6 +75,31 @@ declare const DescribeMetadataModelCommand_base: {
71
75
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
72
76
  *
73
77
  *
78
+ * @example Retrieve a source table metadata model
79
+ * ```javascript
80
+ * // The following example retrieves detailed information about the ExampleTable table in the ExampleSchema schema from the source metadata tree, including its SQL definition and references to the corresponding converted metadata models in the target database.
81
+ * const input = {
82
+ * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
83
+ * Origin: "SOURCE",
84
+ * SelectionRules: `{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema", "table-name": "ExampleTable"}, "rule-action": "explicit"}]}`
85
+ * };
86
+ * const command = new DescribeMetadataModelCommand(input);
87
+ * const response = await client.send(command);
88
+ * /* response is
89
+ * {
90
+ * Definition: "CREATE TABLE ExampleTable (ExampleColumn INTEGER NOT NULL);",
91
+ * MetadataModelName: "ExampleTable",
92
+ * MetadataModelType: "table",
93
+ * TargetMetadataModels: [
94
+ * {
95
+ * MetadataModelName: "exampletable",
96
+ * SelectionRules: `{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-target-server.us-east-1.rds.amazonaws.com", "schema-name": "exampleschema", "table-name": "exampletable"}, "rule-action": "explicit"}]}`
97
+ * }
98
+ * ]
99
+ * }
100
+ * *\/
101
+ * ```
102
+ *
74
103
  * @public
75
104
  */
76
105
  export declare class DescribeMetadataModelCommand extends DescribeMetadataModelCommand_base {
@@ -24,7 +24,15 @@ declare const DescribeMetadataModelConversionsCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Returns a paginated list of metadata model conversions for a migration project.</p>
27
+ * <p>Returns a paginated list of metadata model conversion requests for a migration
28
+ * project, initiated by
29
+ * <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_StartMetadataModelConversion.html">StartMetadataModelConversion</a>.</p>
30
+ * <p>To cancel a queued or in-progress request, call
31
+ * <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_CancelMetadataModelConversion.html">CancelMetadataModelConversion</a>.</p>
32
+ * <p>
33
+ * <b>Required permissions:</b>
34
+ * <code>dms:ListMetadataModelConversions</code>. For more information, see
35
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
28
36
  * @example
29
37
  * Use a bare-bones client and the command you need to make an API call.
30
38
  * ```javascript
@@ -93,32 +101,56 @@ declare const DescribeMetadataModelConversionsCommand_base: {
93
101
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
94
102
  *
95
103
  *
96
- * @example Describe Metadata Model Conversions
104
+ * @example Retrieve the status of metadata model conversions
97
105
  * ```javascript
98
- * // Returns a paginated list of metadata model conversions for a migration project.
106
+ * // The following example retrieves the status of metadata model conversion operations identified by their request IDs.
99
107
  * const input = {
100
108
  * Filters: [
101
109
  * {
102
110
  * Name: "request-id",
103
111
  * Values: [
104
- * "01234567-89ab-cdef-0123-456789abcdef"
112
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
113
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
114
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
105
115
  * ]
106
116
  * }
107
117
  * ],
108
- * Marker: "EXAMPLEABCDEFGHIJKLMNOPQRSTUVWXYZ123456",
109
- * MaxRecords: 123,
110
- * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:012345678901:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRSTUVWXYZ012345"
118
+ * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"
111
119
  * };
112
120
  * const command = new DescribeMetadataModelConversionsCommand(input);
113
121
  * const response = await client.send(command);
114
122
  * /* response is
115
123
  * {
116
- * Marker: "0123456789abcdefghijklmnopqrs",
117
124
  * Requests: [
118
125
  * {
119
- * MigrationProjectArn: "arn:aws:dms:us-east-1:012345678901:migration-project:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012",
120
- * RequestIdentifier: "01234567-89ab-cdef-0123-456789abcdef",
126
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
127
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
121
128
  * Status: "SUCCESS"
129
+ * },
130
+ * {
131
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
132
+ * Progress: {
133
+ * ProcessedObject: {
134
+ * EndpointType: "SOURCE",
135
+ * Name: "ExampleTable",
136
+ * Type: "table"
137
+ * },
138
+ * ProgressPercent: 50.0,
139
+ * ProgressStep: "CONVERTING",
140
+ * TotalObjects: 100
141
+ * },
142
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
143
+ * Status: "IN_PROGRESS"
144
+ * },
145
+ * {
146
+ * Error: {
147
+ * defaultErrorDetails: {
148
+ * Message: "No objects were found according to the specified selection rules. Please review your selection rules and try again."
149
+ * }
150
+ * },
151
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
152
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
153
+ * Status: "FAILED"
122
154
  * }
123
155
  * ]
124
156
  * }
@@ -24,7 +24,15 @@ declare const DescribeMetadataModelCreationsCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Returns a paginated list of metadata model creation requests for a migration project.</p>
27
+ * <p>Returns a paginated list of metadata model creation requests for a migration
28
+ * project, initiated by
29
+ * <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_StartMetadataModelCreation.html">StartMetadataModelCreation</a>.</p>
30
+ * <p>To cancel a queued or in-progress request, call
31
+ * <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_CancelMetadataModelCreation.html">CancelMetadataModelCreation</a>.</p>
32
+ * <p>
33
+ * <b>Required permissions:</b>
34
+ * <code>dms:DescribeMetadataModelCreations</code>. For more information, see
35
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
28
36
  * @example
29
37
  * Use a bare-bones client and the command you need to make an API call.
30
38
  * ```javascript
@@ -97,6 +105,52 @@ declare const DescribeMetadataModelCreationsCommand_base: {
97
105
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
98
106
  *
99
107
  *
108
+ * @example Retrieve the status of metadata model creations
109
+ * ```javascript
110
+ * // The following example retrieves the status of metadata model creation operations identified by their request IDs.
111
+ * const input = {
112
+ * Filters: [
113
+ * {
114
+ * Name: "request-id",
115
+ * Values: [
116
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
117
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
118
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
119
+ * ]
120
+ * }
121
+ * ],
122
+ * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"
123
+ * };
124
+ * const command = new DescribeMetadataModelCreationsCommand(input);
125
+ * const response = await client.send(command);
126
+ * /* response is
127
+ * {
128
+ * Requests: [
129
+ * {
130
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
131
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
132
+ * Status: "SUCCESS"
133
+ * },
134
+ * {
135
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
136
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
137
+ * Status: "IN_PROGRESS"
138
+ * },
139
+ * {
140
+ * Error: {
141
+ * defaultErrorDetails: {
142
+ * Message: "No objects were found according to the specified selection rules. Please review your selection rules and try again."
143
+ * }
144
+ * },
145
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
146
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
147
+ * Status: "FAILED"
148
+ * }
149
+ * ]
150
+ * }
151
+ * *\/
152
+ * ```
153
+ *
100
154
  * @public
101
155
  */
102
156
  export declare class DescribeMetadataModelCreationsCommand extends DescribeMetadataModelCreationsCommand_base {
@@ -24,7 +24,13 @@ declare const DescribeMetadataModelExportsAsScriptCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Returns a paginated list of metadata model exports.</p>
27
+ * <p>Returns a paginated list of metadata model export requests for a migration
28
+ * project, initiated by
29
+ * <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_StartMetadataModelExportAsScript.html">StartMetadataModelExportAsScript</a>.</p>
30
+ * <p>
31
+ * <b>Required permissions:</b>
32
+ * <code>dms:ListMetadataModelExports</code>. For more information, see
33
+ * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
28
34
  * @example
29
35
  * Use a bare-bones client and the command you need to make an API call.
30
36
  * ```javascript
@@ -93,32 +99,58 @@ declare const DescribeMetadataModelExportsAsScriptCommand_base: {
93
99
  * <p>Base exception class for all service exceptions from DatabaseMigrationService service.</p>
94
100
  *
95
101
  *
96
- * @example Describe Metadata Model Exports As Script
102
+ * @example Retrieve the status of metadata model exports as script
97
103
  * ```javascript
98
- * // Returns a paginated list of metadata model exports.
104
+ * // The following example retrieves the status of operations that export metadata models as data definition language (DDL) scripts, identified by their request IDs.
99
105
  * const input = {
100
106
  * Filters: [
101
107
  * {
102
108
  * Name: "request-id",
103
109
  * Values: [
104
- * "01234567-89ab-cdef-0123-456789abcdef"
110
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
111
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
112
+ * "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
105
113
  * ]
106
114
  * }
107
115
  * ],
108
- * Marker: "0123456789abcdefghijklmnopqrs",
109
- * MaxRecords: 20,
110
- * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:012345678901:migration-project:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012"
116
+ * MigrationProjectIdentifier: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"
111
117
  * };
112
118
  * const command = new DescribeMetadataModelExportsAsScriptCommand(input);
113
119
  * const response = await client.send(command);
114
120
  * /* response is
115
121
  * {
116
- * Marker: "0123456789abcdefghijklmnopqrs",
117
122
  * Requests: [
118
123
  * {
119
- * MigrationProjectArn: "arn:aws:dms:us-east-1:012345678901:migration-project:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012",
120
- * RequestIdentifier: "01234567-89ab-cdef-0123-456789abcdef",
124
+ * ExportSqlDetails: {
125
+ * ObjectURL: "https://amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com/example-migration-project/ExampleScript.zip",
126
+ * S3ObjectKey: "s3://amzn-s3-demo-bucket/example-migration-project/ExampleScript.zip"
127
+ * },
128
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
129
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
121
130
  * Status: "SUCCESS"
131
+ * },
132
+ * {
133
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
134
+ * Progress: {
135
+ * ProcessedObject: {
136
+ * EndpointType: "TARGET"
137
+ * },
138
+ * ProgressPercent: 50.0,
139
+ * ProgressStep: "IN_PROGRESS",
140
+ * TotalObjects: 100
141
+ * },
142
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
143
+ * Status: "IN_PROGRESS"
144
+ * },
145
+ * {
146
+ * Error: {
147
+ * defaultErrorDetails: {
148
+ * Message: "No objects were found according to the specified selection rules. Please review your selection rules and try again."
149
+ * }
150
+ * },
151
+ * MigrationProjectArn: "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS",
152
+ * RequestIdentifier: "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
153
+ * Status: "FAILED"
122
154
  * }
123
155
  * ]
124
156
  * }