绑定 VPC

更新时间:
复制 MD 格式

使用 BindAgentStorage2Vpc 接口把 AgentStorage 绑定到指定 VPC 和虚拟交换机,并返回 VPC 访问地址。

前提条件

  • 拥有阿里云账号并获取 AccessKey(AccessKey ID 和 AccessKey Secret),用于管控面 OpenAPI 签名认证。

  • 当前账号或 RAM 子账号具备 AgentStorage 管理权限(如 AliyunOTSFullAccess 或对应管控策略)。

  • 目标 AgentStorage 实例须存在且状态为 normal;已准备好可用的 VPC ID 和虚拟交换机 ID。

请求语法

POST /v2/openapi/bindagentstorage2vpc HTTP/1.1

请求参数

字段

类型

必填

说明

VpcId

string

是

VPC ID。

VirtualSwitchId

string

是

虚拟交换机 ID。

AgentStorageName

string

是

AgentStorage 名称。

AgentStorageVpcName

string

是

本次绑定使用的 VPC 名称。

请求示例

{
  "VpcId": "vpc-example",
  "VirtualSwitchId": "vsw-example",
  "AgentStorageName": "agent-prod",
  "AgentStorageVpcName": "prod-vpc"
}

响应

字段

类型

说明

RequestId

string

请求 ID。

Domain

string

VPC 访问域名。

Endpoint

string

实例连接地址。

{
  "RequestId": "39871ED2-62C0-578F-A32E-B88072D5582F",
  "Domain": "prod-vpc-agent-prod.cn-beijing.vpc.ots.aliyuncs.com",
  "Endpoint": "172.16.0.34"
}

应用应优先使用 Domain,不要把可能变化的 IP 地址硬编码到配置中。