DescribeImport - Amazon Lex

DescribeImport

Gets information about a specific import.

Request Syntax

GET /imports/importId/ HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

importId

The unique identifier of the import to describe.

Length Constraints: Fixed length of 10.

Pattern: ^[0-9a-zA-Z]+$

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "creationDateTime": number, "failureReasons": [ "string" ], "importedResourceId": "string", "importedResourceName": "string", "importId": "string", "importStatus": "string", "lastUpdatedDateTime": number, "mergeStrategy": "string", "resourceSpecification": { "botImportSpecification": { "botName": "string", "botTags": { "string" : "string" }, "dataPrivacy": { "childDirected": boolean }, "idleSessionTTLInSeconds": number, "roleArn": "string", "testBotAliasTags": { "string" : "string" } }, "botLocaleImportSpecification": { "botId": "string", "botVersion": "string", "localeId": "string", "nluIntentConfidenceThreshold": number, "voiceSettings": { "voiceId": "string" } } } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

creationDateTime

The date and time that the import was created.

Type: Timestamp

failureReasons

If the importStatus field is Failed, this provides one or more reasons for the failture.

Type: Array of strings

importedResourceId

The unique identifier that Amazon Lex assigned to the resource created by the import.

Type: String

Length Constraints: Minimum length of 5. Maximum length of 10.

Pattern: ^([0-9a-zA-Z_])+$

importedResourceName

The name of the imported resource.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^([0-9a-zA-Z][_-]?)+$

importId

The unique identifier of the described import.

Type: String

Length Constraints: Fixed length of 10.

Pattern: ^[0-9a-zA-Z]+$

importStatus

The status of the import process. When the status is Completed the resource is imported and ready for use.

Type: String

Valid Values: InProgress | Completed | Failed | Deleting

lastUpdatedDateTime

The date and time that the import was last updated.

Type: Timestamp

mergeStrategy

The strategy used when there was a name conflict between the imported resource and an existing resource. When the merge strategy is FailOnConflict existing resources are not overwritten and the import fails.

Type: String

Valid Values: Overwrite | FailOnConflict

resourceSpecification

The specifications of the imported bot or bot locale.

Type: ImportResourceSpecification object

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalServerException

HTTP Status Code: 500

ResourceNotFoundException

HTTP Status Code: 404

ThrottlingException

HTTP Status Code: 429

ValidationException

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: