将域名与 VPC 关联。该 API 为全量操作。
请求频率:每秒最多调用 10 次。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
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。格式为 |
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 | private_zone不支持[%s]地域的%s |
400 | ErrParamInvalid | 参数校验失败 |
400 | ErrQuotaExceeded | [%s] 超出限额 [%d] |
400 | ErrVPCCountLimited | 关联VPC数量超出限制 |
400 | ErrNoVPCSpecified | 未关联VPC |
400 | ErrOperationForbidden | 全局域名禁止当前操作 |
500 | ErrInternalServer | 服务内部错误 |