All Products
Search
Document Center

EventBridge:UpdateApiDestination

Last Updated:Mar 15, 2024

Updates an API destination.

Operation description

You can call this API operation to update an API destination.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DescriptionstringNo

The description of the API destination. The description can be up to 255 characters in length.

demo
ApiDestinationNamestringYes

The name of the API destination. The name must be 2 to 127 characters in length.

api-destination-name
ConnectionNamestringYes

The name of the connection. The name must be 2 to 127 characters in length.

Note: Before you configure this parameter, you must call the CreateConnection operation to create a connection. Then, set this parameter to the name of the connection that you created.

connection-name
HttpApiParametersobjectYes

The parameters that are configured for the API destination.

EndpointstringYes

The endpoint of the API destination. The endpoint can be up to 127 characters in length.

http://127.0.0.1:8001/api
MethodstringYes

The HTTP request method. Valid values:

  • GET
  • POST
  • HEAD
  • DELETE
  • PUT
  • PATCH
POST

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

382E6272-8E9C-5681-AC96-A8AF0BFAC1A5
Messagestring

The returned message. If the request is successful, success is returned.

success
Codestring

The response code. If the request is successful, Success is returned.

Success
ApiDestinationNamestring

api-destination-name

api-destination-name

Examples

Sample success responses

JSONformat

{
  "RequestId": "382E6272-8E9C-5681-AC96-A8AF0BFAC1A5",
  "Message": "success",
  "Code": "Success",
  "ApiDestinationName": "api-destination-name"
}

Error codes

HTTP status codeError codeError message
409RequestParameterExceptionRequest parameter exception

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-09-13The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 409 change
    Added Error Codes: 500
2023-04-12The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 409
2023-04-06The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 409