功能介紹
用于合作伙伴用戶最終租戶創(chuàng)建托管專線 創(chuàng)建者必須擁有合作伙伴資質(zhì)，并且已經(jīng)構(gòu)建好運(yùn)營(yíng)(hosting)專線
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
POST /v3/{project_id}/dcaas/hosted-connects
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租戶項(xiàng)目ID |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。 獲取Token ，請(qǐng)參考《 統(tǒng)一身份認(rèn)證 服務(wù)API參考》的“獲取用戶Token”章節(jié)。請(qǐng)求響應(yīng)成功后在響應(yīng)消息頭中包含的“X-Subject-Token”的值即為T(mén)oken值。 最小長(zhǎng)度：0 最大長(zhǎng)度：10240 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
hosted_connect |
是 |
創(chuàng)建托管專線參數(shù)對(duì)象 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
name |
否 |
String |
托管物理專線的名字。 最小長(zhǎng)度：0 最大長(zhǎng)度：64 |
|
description |
否 |
String |
托管專線的描述信息 最小長(zhǎng)度：0 最大長(zhǎng)度：128 |
|
bandwidth |
是 |
Integer |
指定托管專線接入帶寬,單位Mbps 最小值：2 最大值：400000 |
|
hosting_id |
是 |
String |
hosted物理專線對(duì)應(yīng)的hosting物理專線的ID |
|
vlan |
是 |
Integer |
指定托管(hosted)專線預(yù)分配的vlan 最小值：0 最大值：3999 |
|
resource_tenant_id |
是 |
String |
為其他租戶創(chuàng)建托管專線，指定對(duì)應(yīng)的租戶ID 最小長(zhǎng)度：0 最大長(zhǎng)度：32 |
|
peer_location |
否 |
String |
物理專線對(duì)端所在的物理位置，省/市/街道或IDC名字。 最小長(zhǎng)度：0 最大長(zhǎng)度：255 |
響應(yīng)參數(shù)
狀態(tài)碼： 201
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
request_id |
String |
操作請(qǐng)求ID |
|
hosted_connect |
托管專線對(duì)象信息 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
id |
String |
托管專線ID 最小長(zhǎng)度：36 最大長(zhǎng)度：36 |
|
tenant_id |
String |
實(shí)例所屬項(xiàng)目ID。 |
|
name |
String |
物理專線名字 最小長(zhǎng)度：0 最大長(zhǎng)度：64 |
|
description |
String |
物理專線的描述信息 最小長(zhǎng)度：0 最大長(zhǎng)度：128 |
|
bandwidth |
Integer |
物理專線接入帶寬，單位Mbps。 最小值：2 最大值：400000 |
|
location |
String |
專線的接入位置信息 最小長(zhǎng)度：0 最大長(zhǎng)度：255 |
|
peer_location |
String |
物理專線對(duì)端所在的物理位置，省/市/街道或IDC名字。 最小長(zhǎng)度：0 最大長(zhǎng)度：255 |
|
hosting_id |
String |
hosted物理專線對(duì)應(yīng)的hosting物理專線的ID |
|
provider |
String |
專線線路的提供商 |
|
admin_state_up |
Boolean |
管理狀態(tài)：true或false 缺省值：true |
|
vlan |
Integer |
hosted物理專線預(yù)分配的vlan。 最小值：0 最大值：3999 |
|
status |
String |
操作狀態(tài)，合法值是：ACTIVE， ERROR，PENDING_CREATE，PENDING_UPDATE。ACTIVE：虛擬網(wǎng)關(guān)正常ERROR： 虛擬網(wǎng)關(guān)異常PENDING_CREATE：創(chuàng)建中PENDING_UPDATE：更新中 枚舉值：
|
|
apply_time |
String |
物理專線申請(qǐng)時(shí)間 |
|
create_time |
String |
物理專線創(chuàng)建時(shí)間 |
|
provider_status |
String |
物理專線的運(yùn)營(yíng)商操作狀態(tài)，合法值是：ACTIVE， DOWN 枚舉值：
|
請(qǐng)求示例
創(chuàng)建一個(gè)托管物理連接，設(shè)置帶寬為10，VLAN為441。
POST https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects
{
"hosted_connect" : {
"name" : "client-dc-faf1",
"description" : "connect to beijing",
"resource_tenant_id" : "0605768a3300d5762f82c01180692873",
"hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836",
"vlan" : 441,
"bandwidth" : 10
}
}
響應(yīng)示例
狀態(tài)碼： 201
CREATED
{
"hosted_connect" : {
"id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6",
"name" : "client-dc-faf1",
"description" : "connect to beijing",
"tenant_id" : "0605768a3300d5762f82c01180692873",
"hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836",
"vlan" : 441,
"bandwidth" : 10,
"location" : "hangzhou",
"peer_location" : "",
"provider" : "client-dc-faf1%20\n\n",
"provider_status" : "ACTIVE",
"status" : "ACTIVE",
"apply_time" : "2022-07-13T08:25:38.000Z",
"admin_state_up" : true,
"create_time" : "2022-07-13T08:25:38.000Z"
},
"request_id" : "a59a3776faa1d055f8124dc7b0977a90"
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
201 |
CREATED |
錯(cuò)誤碼
請(qǐng)參見(jiàn)錯(cuò)誤碼。
