更新时间:2022-01-25 GMT+08:00

创建对等连接

功能介绍

创建对等连接。

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

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

URI

POST /v2.0/vpc/peerings

请求消息

  • 请求参数
    表1 请求参数

    参数名称

    是否必选

    类型

    说明

    peering

    Object

    peering对象列表,参见表2

    表2 peering对象创建字段说明

    属性

    是否必选

    类型

    说明

    name

    String

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

    request_vpc_info

    Object

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

    accept_vpc_info

    Object

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

    表3 vpc_info对象字段说明

    属性

    是否必选

    类型

    说明

    vpc_id

    String

    对等连接其中一端vpc id

    tenant_id

    String

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

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

  • 请求样例
    POST https://{Endpoint}/v2.0/vpc/peerings 
    
    { 
        "peering": { 
            "name": "test",  
            "request_vpc_info": {
               "vpc_id": "9daeac7c-a98f-430f-8e38-67f9c044e299"
            }, 
            "accept_vpc_info": {
               "vpc_id": "f583c072-0bb8-4e19-afb2-afb7c1693be5"
            }
        } 
    }

响应消息

  • 响应参数
    表4 响应参数

    参数名称

    类型

    说明

    peering

    Object

    peering信息,请参见表5

    表5 peering对象

    属性

    类型

    说明

    id

    String

    对等连接id

    name

    String

    对等连接的名称

    status

    String

    状态位:

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

    request_vpc_info

    Object

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

    accept_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"
        }
    }

状态码

请参见状态码

错误码

请参考错误码