/

The Amazon Translate multi-region endpoint

POST

Stops an asynchronous batch translation job that is in progress.

If the job's state is IN_PROGRESS, the job will be marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state. Otherwise, the job is put into the STOPPED state.

Asynchronous batch translation jobs are started with the StartTextTranslationJob operation. You can use the DescribeTextTranslationJob or ListTextTranslationJobs operations to get a batch translation job's JobId.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http://translate.{region}.amazonaws.com/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw ''

Response Example

200 - Example 1

{
  "JobId": "string",
  "JobStatus": "SUBMITTED"
}

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

JobId

string

required

The job ID of the job to be stopped.

>= 1 characters<= 32 characters

Match pattern:

^([\p{L}\p{Z}\p{N}_.:/=+\-%@]*)$

Examples

Responses

🟢200Success

application/json

Body

JobId

string

optional

The job ID of the stopped batch translation job.

>= 1 characters<= 32 characters

Match pattern:

^([\p{L}\p{Z}\p{N}_.:/=+\-%@]*)$

JobStatus

enum<string>

optional

The status of the designated job. Upon successful completion, the job's status will be STOPPED.

Allowed values:

SUBMITTEDIN_PROGRESSCOMPLETEDCOMPLETED_WITH_ERRORFAILEDSTOP_REQUESTEDSTOPPED

🟠480ResourceNotFoundException

🟠481TooManyRequestsException

🟠482InternalServerException

Modified at 2022-09-12 09:51:45