更新时间:2023-09-26 GMT+08:00

创建对等连接

功能介绍

创建对等连接。

同一租户下创建对等连接时,无需对端接受对等连接请求即可创建成功。

不同租户创建对等连接时,需要对端租户接受请求才可以创建成功。对端租户拒绝请求时,对等连接无法创建。

URI

POST /v2.0/vpc/peerings

请求参数

表1 请求参数

参数名称

是否必选

类型

说明

peering

peering object

peering对象,参见表2

表2 peering对象创建字段说明

属性

是否必选

类型

说明

name

String

对等连接的名称,支持长度为1-64。

description

String

对等连接的描述。

取值范围:0-255个字符,不能包含“<”和“>”。

request_vpc_info

vpc_info object

对等连接发起端vpc信息,请参见表3

accept_vpc_info

vpc_info object

对等连接接受端vpc信息,请参见表3

表3 vpc_info对象字段说明

属性

是否必选

类型

说明

vpc_id

String

对等连接其中一端vpc id

tenant_id

String

对等连接其中一端vpc所属的项目id

约束:跨租户创建时必须指定该字段。

请求示例

  • 创建一个对等连接,请求方vpc id为9daeac7c-a98f-430f-8e38-67f9c044e299,接收方vpc id为f583c072-0bb8-4e19-afb2-afb7c1693be5,命名为test。
    POST https://{Endpoint}/v2.0/vpc/peerings 
    
    { 
        "peering": { 
            "name": "test",  
            "description": "test",
            "request_vpc_info": {
               "vpc_id": "9daeac7c-a98f-430f-8e38-67f9c044e299"
            }, 
            "accept_vpc_info": {
               "vpc_id": "f583c072-0bb8-4e19-afb2-afb7c1693be5"
            }
        } 
    }

响应参数

表4 响应参数

参数名称

类型

说明

peering

peering object

peering对象,请参见表5

表5 peering对象

属性

类型

说明

id

String

对等连接id

name

String

对等连接的名称

status

String

状态位:

  • PENDING_ACCEPTANCE:等待接受
  • REJECTED:已拒绝。
  • EXPIRED:已过期。
  • DELETED:已删除。
  • ACTIVE:活动的。

request_vpc_info

vpc_info object

对等连接发起端vpc信息,请参见表6

accept_vpc_info

vpc_info object

对等连接接受端vpc信息,请参见表6

description

String

对等连接描述

created_at

String

资源创建时间,UTC时间

格式:yyyy-MM-ddTHH:mm:ss

updated_at

String

资源更新时间,UTC时间

格式:yyyy-MM-ddTHH:mm:ss

表6 vpc_info对象

属性

类型

说明

vpc_id

String

对等连接其中一端vpc id

tenant_id

String

对等连接其中一端vpc所属的项目id

响应示例

{ 
    "peering": { 
        "name": "test", 
        "id": "22b76469-08e3-4937-8c1d-7aad34892be1",
        "request_vpc_info": {
           "vpc_id": "9daeac7c-a98f-430f-8e38-67f9c044e299",
           "tenant_id": "f65e9ebc-ed5d-418b-a931-9a723718ba4e"
        },
        "accept_vpc_info": {
           "vpc_id": "f583c072-0bb8-4e19-afb2-afb7c1693be5",
           "tenant_id": "f65e9ebc-ed5d-418b-a931-9a723718ba4e"
        }, 
        "status": "ACTIVE"
    }
}

状态码

请参见状态码

错误码

请参考错误码