# Alibaba Cloud VPC peering connection API

> Alibaba Cloud VPC peering connection API on Apizie: 12 endpoints (Accepts a VPC peering connection request, Creates a VPC peering connection, Deletes a VPC peering connection, Queries the attributes of a specified VPC peering connection, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-vpcpeer`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/vpcpeer
- Page: https://zieapi.vercel.app/api/cloud/aliyun-vpcpeer
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-vpcpeer/openapi.json

Alibaba Cloud OpenAPI for VPC peering connection (vpcpeer, version 2022-01-01). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Accepts a VPC peering connection request
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/accept-vpc-peer-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ResourceOwnerAccount | string | no | The ResourceOwnerAccount |
| InstanceId | string | yes | The ID of VPC peering connection |
| DryRun | string | no | Specifies whether to perform a dry run. Valid values: true: Sends a request without accepting the VPC peering connection request. The… |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Generate a token from your client to make sure that it is unique… |
| ResourceGroupId | string | no | The ID of the resource group. For more information, see https://help.aliyun.com/document_detail/94475.html |
| Tag | string | no | The tags (JSON-encoded) |

### Creates a VPC peering connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/create-vpc-peer-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RegionId | string | yes | The ID of the region where you want to create a VPC peering connection. Call the https://help.aliyun.com/document_detail/36063.html… |
| VpcId | string | yes | The ID of the requester VPC |
| AcceptingAliUid | integer | yes | The ID of the Alibaba Cloud account to which the accepter VPC belongs. To create a VPC peering connection within your Alibaba Cloud… |
| AcceptingRegionId | string | yes | The region ID of the accepter VPC of the VPC peering connection that you want to create. To create an intra-region VPC peering connection,… |
| AcceptingVpcId | string | yes | The ID of the accepter VPC |
| Name | string | no | The name of the VPC peering connection. The name must be 2 to 128 characters in length, and can contain digits, underscores (_), and… |
| Description | string | no | The description of the VPC peering connection. The description must be 2 to 256 characters in length. The description must start with a… |
| DryRun | string | no | Specifies whether to perform only a dry run, without performing the actual request. Valid values: true: performs only a dry run. The… |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |
| ResourceGroupId | string | no | The ID of the resource group. For more information about resource groups, see https://help.aliyun.com/document_detail/94475.html |
| Bandwidth | integer | no | The bandwidth of the VPC peering connection. Unit: Mbit/s. The value must be an integer greater than 0. Before you specify this parameter,… |
| LinkType | string | no | The link type of the VPC peering connection that you want to create. Valid values: Platinum. Gold: default value. If you need to specify… |
| Tag | string | no | The tags (JSON-encoded) |

### Deletes a VPC peering connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/delete-vpc-peer-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| InstanceId | string | yes | The ID of the VPC peering connection |
| Force | string | no | Specifies whether to force delete the VPC peering connection. Valid values: false (default): does not force delete the VPC peering… |
| DryRun | string | no | Specifies whether to perform a dry run. Valid values: true: performs a dry run but does not delete the VPC peering connection. The system… |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Generate a value for this parameter from your client to make sure… |

### Queries the attributes of a specified VPC peering connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/get-vpc-peer-connection-attribute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ResourceOwnerAccount | string | no | The ResourceOwnerAccount |
| InstanceId | string | yes | The ID of the VPC peering connection |

### Queries the tags that are attached to a VPC peering connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ResourceType | string | yes | The resource type. Valid value: PeerConnection. This value specifies a VPC peering connection |
| ResourceId | string | no | The IDs of the resources. You can specify up to 20 resource IDs (JSON-encoded) |
| Tag | string | no | The tags (JSON-encoded) |
| MaxResults | integer | no | The number of entries to return on each page. Valid values: 1 to 50. Default value: 50 |
| NextToken | string | no | The token that is used to start the next query. Valid values: If this is the first query or no subsequent query is to be sent, do not… |
| RegionId | string | yes | The ID of the region where the resource is deployed. See https://help.aliyun.com/document_detail/36063.html |
| Category | string | no | The type of the tag. All (default) Custom System |

### Queries VPC peering connections
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/list-vpc-peer-connections` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RegionId | string | no | The region ID of the VPC peering connection. You can call the https://help.aliyun.com/document_detail/36063.html operation to obtain the… |
| InstanceId | string | no | The ID of the VPC peering connection |
| VpcId | string | no | The ID of a VPC in the peering connection. You can specify the ID of the requester or accepter VPC. If you specify only one VPC ID, the… |
| Name | string | no | The name of the VPC peering connection |
| NextToken | string | no | The token that is used for the next query. Valid values: Do not specify this parameter for the first request. You must specify the token… |
| MaxResults | integer | no | The number of entries to return on each page. Valid values: 1 to 100. Default value: 20 |
| Tags | string | no | The tags (JSON-encoded) |
| ResourceGroupId | string | no | The ID of the resource group. For more information about resource groups, see https://help.aliyun.com/document_detail/94475.html |

### Modifies the name or description of a VPC peering connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/modify-vpc-peer-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| InstanceId | string | yes | The ID of the VPC peering connection |
| Name | string | no | The new name of the VPC peering connection. The name must be 1 to 128 characters in length and cannot start with `http://` or `https://` |
| Description | string | no | The new description of the VPC peering connection. The description must be 1 to 256 characters in length and cannot start with `http://`… |
| Bandwidth | integer | no | The new bandwidth of the VPC peering connection. Unit: Mbps. The value must be an integer greater than 0 |
| DryRun | string | no | Specifies whether to perform a dry run. Valid values: true: Performs a dry run. The system checks the required parameters, request format,… |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Generate a unique token on your client for each request. The token… |
| LinkType | string | no | The link type. Valid values: Platinum and Gold. The default value is Gold. If you specify this parameter, make sure that you create a… |

### Moves a VPC peering connection to a different resource group
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/move-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ResourceId | string | yes | The ID of the peering connection instance |
| ResourceType | string | yes | The resource type. Set the value to PeerConnection for a VPC peering connection |
| NewResourceGroupId | string | yes | The ID of the resource group to which you want to move the peering connection instance. This feature lets you manage resources under your… |
| RegionId | string | yes | The ID of the region to which the resource belongs. You can call the https://help.aliyun.com/document_detail/36063.html operation to… |

### Rejects a connection request for a VPC peering connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/reject-vpc-peer-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ResourceOwnerAccount | string | no | The ResourceOwnerAccount |
| InstanceId | string | yes | The ID of the VPC peering connection |
| DryRun | string | no | Specifies whether to perform a dry run. Valid values: true: Sends a check request without rejecting the connection request. The system… |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Generate a parameter value from your client to make sure that the… |

### Creates and attaches tags to VPC peering connections
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ResourceId | string | yes | The ID of the resource. You can specify up to 20 resource IDs (JSON-encoded) |
| Tag | string | yes | The tag details (JSON-encoded) |
| ResourceType | string | yes | The resource type. Set the value to PeerConnection |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Generate a unique token for each request from your client. The… |
| RegionId | string | yes | The ID of the region where the resource is located. For more information, see https://help.aliyun.com/document_detail/36063.html |

### Detaches tags from VPC peering connections
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/un-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ResourceId | string | yes | The resource ID. You can specify up to 20 resource IDs (JSON-encoded) |
| TagKey | string | no | The key of the tag to detach. You can specify up to 20 tag keys. An empty string is supported. The tag key can be up to 128 characters in… |
| All | string | no | Specifies whether to detach all tags from the resource. Valid values: true: Detaches all tags from the resource. false (default): Does not… |
| ResourceType | string | yes | The resource type. Set the value to PeerConnection, which specifies a VPC peering connection |
| ClientToken | string | no | A client token to ensure that the request is idempotent. Generate a unique token from your client for each request. The token can contain… |
| RegionId | string | yes | The ID of the region where the resource is located. For more information, see https://help.aliyun.com/document_detail/36063.html |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/version` (byok)

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/accept-vpc-peer-connection" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud VPC peering connection API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-vpcpeer/accept-vpc-peer-connection with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud VPC peering connection API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud VPC peering connection itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud VPC peering connection API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-vpcpeer.

### What is the status of the Alibaba Cloud VPC peering connection API?
Needs your own provider key (bring your own key)