You need to enable JavaScript to run this app.
导航
IncBindVPC - 关联或取消关联 VPC (增量操作)
最近更新时间:2025.05.22 19:58:50首次发布时间:2023.02.08 13:11:21
复制全文
我的收藏
有用
有用
无用
无用

将域名与 VPC 关联或取消关联。该 API 为增量操作。

使用说明

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

注意事项

该 API 已废弃,推荐您使用 UpdateBindVPC

请求说明

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

调试

请求参数

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

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

IncBindVPC

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

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 所在的项目有操作权限,您需要传入该参数。

Binds
Array of Object

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

Unbinds
Array of Object

与域名解除关联的一个或多个 VPC。如果该域名仅关联了一个 VPC,您无法解除关联。

返回参数

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

请求示例

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

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20221214140553EC822FFD341E9C19EF59",
        "Action": "IncBindVPC",
        "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
ErrSubnetVPCChange

zone in subnet mode is not allowed to change vpc bind

开启智能解析的域名无法变更关联的 VPC

400
ErrOperationForbidden

operation forbidden for global zone

全局域名禁止当前操作

400
ErrZoneNotFound

zone not found

未找到域名

500
ErrInternalServer

server internal error

服务内部错误