功能介紹
查詢合法作伙伴的Hosted專線類型.
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
GET /v3/{project_id}/dcaas/hosted-connects/{hosted_connect_id}
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租戶項(xiàng)目ID |
|
hosted_connect_id |
是 |
String |
托管專線連接ID。 最小長(zhǎng)度：36 最大長(zhǎng)度：36 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
每頁返回的個(gè)數(shù)。 取值范圍：1~2000。 最小值：1 最大值：2000 缺省值：2000 |
|
marker |
否 |
String |
上一頁最后一條資源記錄的ID，為空時(shí)為查詢第一頁。 使用說明：必須與limit一起使用。 最小長(zhǎng)度：0 最大長(zhǎng)度：36 |
|
fields |
否 |
Array |
顯示字段列表 數(shù)組長(zhǎng)度：1 - 5 |
|
sort_dir |
否 |
Array |
返回結(jié)果按照升序(asc)或降序(desc)排列，默認(rèn)為asc |
|
sort_key |
否 |
String |
排序字段。 缺省值：id 最小長(zhǎng)度：0 最大長(zhǎng)度：36 |
|
hosting_id |
否 |
Array |
根椐運(yùn)營(yíng)專線ID過濾托管專線列表 數(shù)組長(zhǎng)度：0 - 5 |
請(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”的值即為Token值。 最小長(zhǎng)度：0 最大長(zhǎng)度：10240 |
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(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)求示例
查詢合作伙伴的托管專線詳情
GET https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects/0278b472-ffa5-4eb3-8c0d-979d479f8ef6
響應(yīng)示例
狀態(tài)碼： 200
OK
{
"hosted_connect" : {
"id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6",
"name" : "client-dc-faf1",
"description" : "",
"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)碼 |
描述 |
|---|---|
|
200 |
OK |
錯(cuò)誤碼
請(qǐng)參見錯(cuò)誤碼。
