Adds zones for an endpoint.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes AddZoneToVpcEndpoint

The operation that you want to perform. Set the value to AddZoneToVpcEndpoint.

EndpointId String Yes ep-hp33b2e43fays7s8****

The ID of the endpoint for which you want to add zones.

RegionId String Yes eu-west-1

The ID of the region where the endpoint is created. You can call the DescribeRegions operation to query region IDs.

VSwitchId String Yes vsw-hjkshjvdkdvd****

The VSwitch of the zone to be added. The system automatically creates an endpoint elastic network interface (ENI) and associates it with the VSwitch.

ZoneId String Yes eu-west-1a

The ID of the zone to be added.

DryRun Boolean No false

Specifies whether to only check the API request. Valid values:

true: only checks the API request. After the request passes the check, zones are not added for the endpoint. Check items include whether the AccessKey pair is valid, whether the RAM user is authorized, and whether the required parameters are specified. If the request fails to meet the requirements in the check items, an error message is returned. If the request meets the requirements in the check items, the DryRunOperation error code is returned.

false (default): checks the API request. After the request passes the check, the 2XX HTTP status code is returned, and zones are added for the endpoint.

ClientToken String No 0c593ea1-3bea-11e9-b96b-88e9fe637760

The client token that is used to ensure the idempotence of the request. You can use the client to generate a value that is unique among different requests. ClientToken can contain only ASCII characters. It must be 1 to 64 characters in length.

Response parameters

Parameter Type Example Description
RequestId String 0c593ea1-3bea-11e9-b96b-88e9fe637760

The ID of the request.

Examples

Sample requests

https://[Endpoint]/?Action=AddZoneToVpcEndpoint
&EndpointId=ep-hp33b2e43fays7s8****
&RegionId=eu-west-1
&VSwitchId=vsw-hjkshjvdkdvd****
&ZoneId=eu-west-1a
&<Common request parameters>

Sample success responses

XML format

<AddZoneToVpcEndpointResponse>
      <RequestId>B40660B0-A67C-43B4-8C30-83BDBB541CFC</RequestId>
</AddZoneToVpcEndpointResponse>

JSON format

{
  "RequestId": "B40660B0-A67C-43B4-8C30-83BDBB541CFC"
}

Error codes

HttpCode Error code Error message Description
400 EndpointNotFound The specified Endpoint does not exist. The error message returned because the specified endpoint is not found.
400 EndpointOperationDenied The specified operation of endpoint is not allowed. The error message returned because the operation is not allowed when the endpoint is being processed.
400 EndpointLocked The specified Endpoint is locked. The error message returned because the endpoint is locked.
400 EndpointConnectionOperationDenied The endpoint is being connected. The error message returned because the operation is not allowed when the endpoint connection is being processed.
400 EndpointZoneDuplicated The zone is duplicated for the Endpoint. The error message returned because the zones must not be duplicate.
400 EndpointServiceNotSupportedZone The specified endpoint service does not support the zone. The error message returned because the specified zone is not supported by the endpoint service.

For a list of error codes, visit the API Error Center.