You need to enable JavaScript to run this app.
导航
BindVPC - 关联 VPC (全量操作)
最近更新时间:2025.05.22 19:30:40首次发布时间:2023.02.08 13:11:14
我的收藏
有用
有用
无用
无用

将域名与 VPC 关联。该 API 为全量操作。

使用说明

请求频率:每秒最多调用 10 次。

请求说明

  • 请求方式:POST
  • 请求地址:https://private-zone.volcengineapi.com/?Action=BindVPC?Version=2022-06-01

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

BindVPC

要执行的操作,取值:BindVPC。

Version
String

2022-06-01

API的版本,取值:2022-06-01。

ZID
Long

1013

标识域名的唯一 ID。您可以通过以下 API 获取:

VpcTrns
Array of String

["trn:vpc:cn-beijing:12345678:vpc/vpc-3reow******hxad79k"]

域名所关联的一个或多个 VPC 的 TRN。格式为 trn:vpc:region:accountId:vpc/vpcId。如果您需要验证子用户是否对域名关联的 VPC 所在的项目有操作权限,您需要传入该参数。

Vpcs
Array of Object

与域名关联的一个或多个 VPC。您需要关联至少一个 VPC。BindVPC API 支持关联当前火山引擎账号下的 VPC 或跨账号关联 VPC。

返回参数

本接口无特有的返回参数。更多信息请见返回结构

请求示例

POST https://private-zone.volcengineapi.com/?Action=BindVPC&Version=2022-06-01

{
  "ZID": 1013,
  "Vpcs": [
    {
      "VpcId": "vpc-2d6si87atfh1c58ozfd0nzq8k",
      "Region": "cn-beijing"
    }
  ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20221214140553EC822FFD341E9C19EF59",
        "Action": "BindVPC",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn-beijing"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
ErrRegionNotSupport

%s of [%s] not supported by private_zone

private_zone不支持[%s]地域的%s

400
ErrParamInvalid

validation fail: params:[%s] , value:[%v]

参数校验失败

400
ErrQuotaExceeded

[%s] exceeds quota [%d]

[%s] 超出限额 [%d]

400
ErrVPCCountLimited

vpc count limited when binding zone

关联VPC数量超出限制

400
ErrNoVPCSpecified

at least one vpc should be specified

未关联VPC

400
ErrOperationForbidden

operation forbidden for global zone

全局域名禁止当前操作

500
ErrInternalServer

server internal error

服务内部错误