Menu
AWS Elemental MediaConvert API Reference
API Reference

Request Account Endpoint

URI

/2017-08-29/endpoints

HTTP Methods

POST

Operation ID: DescribeEndpoints

Send an request with an empty body to the regional API endpoint to get your account API endpoint.

Responses

Status Code Response Model Description
200 DescribeEndpointsResponse

200: OkRresponse

400 ExceptionBody

400: BadRequestException

The conditional request failed. The service can't process your request because of a problem in the request. Please check your request form and syntax.

500 ExceptionBody

500: InternalServiceException

The service encountered an unexpected condition and cannot fulfill your request.

403 ExceptionBody

403: AccessDeniedException

You don't have permissions for this action with the credentials you sent. Please check your authorization credentials. You should be sending credentials using the AWS Signature Version 4 signing process.

404 ExceptionBody

404: ResourceNotFoundException

The resource you requested does not exist.

429 ExceptionBody

429: LimitExceededException

Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests. For example, you may be hitting your account limits for preset creation or job submission.

409 ExceptionBody

409: ResourceInUseException

The service could not complete your request because there is a conflict with the current state of the resource. For example, you may be trying to delete a Queue that has jobs processing.

Schemas

Request Bodies

Example POST

{ "nextToken": "string", "maxResults": integer }

Response Bodies

Example DescribeEndpointsResponse

{ "endpoints": [ { "url": "string" } ], "nextToken": "string" }

Example ExceptionBody

{ "message": "string" }

Properties

DescribeEndpointsRequest

Send a request with an empty body to the regional API endpoint to get your account API endpoint.

Property Type Required Description
nextToken

string

False

Use this string, provided with the response to a previous request, to request the next batch of endpoints.

maxResults

integer

Format: int32

False

DescribeEndpointsResponse

Successful describe endpoints requests will return your account API endpoint.

Property Type Required Description
endpoints

Array of type Endpoint

False

List of endpoints

nextToken

string

False

Use this string to request the next batch of endpoints.

Endpoint

The API endpoint that is specific to your account. Use this endpoint to send your requests to the transcoding service.

Property Type Required Description
url

string

False

URL of your account-specific endpoint.

ExceptionBody

Property Type Required Description
message

string

False