Adds a zone 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.

RegionId String Yes cn-hangzhou

The ID of the region where the endpoint is created.

You can call the DescribeRegions operation to query the most recent region list.

ZoneId String Yes cn-hangzhou-b

The ID of the zone to be added.

VSwitchId String Yes vsw-hjkshjvdkdvd****

The vSwitch in the zone to be added. The system automatically creates an endpoint elastic network interface (ENI) in the vSwitch.

ip String No 192.XX.XX.32

The IP address of the endpoint ENI in the zone to be added.

EndpointId String Yes ep-hp33b2e43fays7s8****

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

DryRun Boolean No false

Specifies whether to only precheck this request. Valid values:

  • true: only prechecks the API request without performing the operation. The system prechecks whether your AccessKey pair is valid, whether the Resource Access Management (RAM) user is authorized, and whether required parameters are set. If the request fails to pass the precheck, an error code is returned. If the request passes the precheck, the DryRunOperation error code is returned.
  • false (default): sends the API request. If the request passes the precheck, a 2xx HTTP status code is returned and the operation is performed.
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 the value, but you must make sure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 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=cn-hangzhou
&VSwitchId=vsw-hjkshjvdkdvd****
&ZoneId=cn-hangzhou-b
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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 configured.
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 you cannot add duplicate zones.
400 EndpointServiceNotSupportedZone The specified endpoint service does not support the zone. The error message returned because the endpoint service is not supported in the zone.
400 QuotaMisMatched The resource you applied for has exceeded the quota. The error message returned because the requested amount of resources has reached the upper limit.
400 EndpointDuplicated The endpoint of the service already exists and cannot be created again. The error message returned because a duplicate endpoint exists.
400 EndpointServiceDeleted The specified Service is already deleted. The error message returned because the specified endpoint service is deleted.
400 EndpointServiceResourceNotFound The specified service resource is not found. The error message returned because the specified service resource for the endpoint service is not found.
400 VSwitchNotFound The specified VSwitch does not exist. The error message returned because the specified vSwitch is not found.
400 EniIpUnavailable The specified IP address is unavailable. The error message returned because the specified IP address is unavailable.
400 EndpointProtected The specified Endpoint is protected. The error message returned because the configuration read-only mode is enabled for the endpoint.

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