Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

ListLanguages

Provides a list of languages (RFC-5646 codes and names) that Amazon Translate supports.

Request Syntax


{
   "DisplayLanguageCode": "string",
   "MaxResults": number,
   "NextToken": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

DisplayLanguageCode

The language code for the language to use to display the language names in the response. The language code is en by default.

Type: String

Valid Values: de | en | es | fr | it | ja | ko | pt | zh | zh-TW

Required: No

MaxResults

The maximum number of results to return in each response.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 500.

Required: No

NextToken

Include the NextToken value to fetch the next group of supported languages.

Type: String

Length Constraints: Maximum length of 8192.

Pattern: \p{ASCII}{0,8192}

Required: No

Response Syntax


{
   "DisplayLanguageCode": "string",
   "Languages": [ 
      { 
         "LanguageCode": "string",
         "LanguageName": "string"
      }
   ],
   "NextToken": "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.

DisplayLanguageCode

The language code passed in with the request.

Type: String

Valid Values: de | en | es | fr | it | ja | ko | pt | zh | zh-TW

Languages

The list of supported languages.

Type: Array of Language objects

NextToken

If the response does not include all remaining results, use the NextToken in the next request to fetch the next group of supported languages.

Type: String

Length Constraints: Maximum length of 8192.

Pattern: \p{ASCII}{0,8192}

Errors

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

InternalServerException

An internal server error occurred. Retry your request.

HTTP Status Code: 500

InvalidParameterValueException

The value of the parameter is not valid. Review the value of the parameter you are using to correct it, and then retry your operation.

HTTP Status Code: 400

TooManyRequestsException

You have made too many requests within a short period of time. Wait for a short time and then try your request again.

HTTP Status Code: 400

UnsupportedDisplayLanguageCodeException

Requested display language code is not supported.

HTTP Status Code: 400