華為云計(jì)算 云知識(shí) 創(chuàng)建對(duì)等連接CreateVpcPeering
創(chuàng)建對(duì)等連接CreateVpcPeering

 

功能介紹

創(chuàng)建對(duì)等連接。

同一租戶下創(chuàng)建對(duì)等連接時(shí),無需對(duì)端接受對(duì)等連接請(qǐng)求即可創(chuàng)建成功。

不同租戶創(chuàng)建對(duì)等連接時(shí),需要對(duì)端租戶接受請(qǐng)求才可以創(chuàng)建成功。對(duì)端租戶拒絕請(qǐng)求時(shí),對(duì)等連接無法創(chuàng)建。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

POST /v2.0/vpc/peerings

請(qǐng)求參數(shù)

表1 請(qǐng)求參數(shù)

參數(shù)名稱

是否必選

類型

說明

peering

peering object

peering對(duì)象,參見表2。

表2 peering對(duì)象創(chuàng)建字段說明

屬性

是否必選

類型

說明

name

String

對(duì)等連接的名稱,支持長(zhǎng)度為1-64。

description

String

對(duì)等連接的描述。

取值范圍:0-255個(gè)字符,不能包含“<”和“>”。

request_vpc_info

vpc_info object

對(duì)等連接發(fā)起端vpc信息,請(qǐng)參見表3。

accept_vpc_info

vpc_info object

對(duì)等連接接受端vpc信息,請(qǐng)參見表3。

表3 vpc_info對(duì)象字段說明

屬性

是否必選

類型

說明

vpc_id

String

對(duì)等連接其中一端vpc id

tenant_id

String

對(duì)等連接其中一端vpc所屬的項(xiàng)目id

約束:跨租戶創(chuàng)建時(shí)必須指定該字段。

請(qǐng)求示例

  • 創(chuàng)建一個(gè)對(duì)等連接,請(qǐng)求方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"
            }
        } 
    }

響應(yīng)參數(shù)

表4 響應(yīng)參數(shù)

參數(shù)名稱

類型

說明

peering

peering object

peering對(duì)象,請(qǐng)參見表5。

表5 peering對(duì)象

屬性

類型

說明

id

String

對(duì)等連接id

name

String

對(duì)等連接的名稱

status

String

狀態(tài)位:

  • PENDING_ACCEPTANCE:等待接受
  • REJECTED:已拒絕。
  • EXPIRED:已過期。
  • DELETED:已刪除。
  • ACTIVE:活動(dòng)的。

request_vpc_info

vpc_info object

對(duì)等連接發(fā)起端vpc信息,請(qǐng)參見表6。

accept_vpc_info

vpc_info object

對(duì)等連接接受端vpc信息,請(qǐng)參見表6。

description

String

對(duì)等連接描述

created_at

String

資源創(chuàng)建時(shí)間,UTC時(shí)間

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

updated_at

String

資源更新時(shí)間,UTC時(shí)間

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

表6 vpc_info對(duì)象

屬性

類型

說明

vpc_id

String

對(duì)等連接其中一端vpc id

tenant_id

String

對(duì)等連接其中一端vpc所屬的項(xiàng)目id

響應(yīng)示例

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

狀態(tài)碼

請(qǐng)參見狀態(tài)碼。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼