華為云計算 云知識 查詢物理連接詳情ShowDirectConnect
查詢物理連接詳情ShowDirectConnect

 

功能介紹

查詢物理連接詳細信息.

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

GET /v3/{project_id}/dcaas/direct-connects/{direct_connect_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

direct_connect_id

String

物理專線連接ID。

最小長度:36

最大長度:36

project_id

String

租戶項目ID

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

fields

Array

顯示字段列表

數(shù)組長度:1 - 5

請求參數(shù)

表3 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 獲取Token ,請參考《 統(tǒng)一身份認證 服務(wù)API參考》的“獲取用戶Token”章節(jié)。請求響應(yīng)成功后在響應(yīng)消息頭中包含的“X-Subject-Token”的值即為Token值。

最小長度:0

最大長度:10240

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

request_id

String

操作請求ID

direct_connect

DirectConnect object

物理專線對象

表5 DirectConnect

參數(shù)

參數(shù)類型

描述

id

String

物理專線標識符ID

tenant_id

String

實例所屬項目ID。

name

String

物理專線名字

最小長度:0

最大長度:64

description

String

物理專線描述信息

最小長度:0

最大長度:128

port_type

String

物理專線接入接口的類型,支持1G 10G 40G 100G

枚舉值:

  • 1G

  • 10G

  • 40G

  • 100G

bandwidth

Integer

物理專線接入帶寬,單位Mbps。

最小值:2

最大值:100000

location

String

專線的接入位置信息

最小長度:0

最大長度:255

peer_location

String

物理專線對端所在的物理位置,省/市/街道或IDC名字。

最小長度:0

最大長度:255

device_id

String

物理專線連接的設(shè)備的標識ID

最小長度:0

最大長度:36

type

String

物理專線的類型,類似包括標準(standard),運營專線(hosting),托管專線(hosted)

缺省值:standard

枚舉值:

  • standard

  • hosting

  • hosted

hosting_id

String

hosted物理專線對應(yīng)的hosting物理專線的ID

charge_mode

String

計費模式:prepayment/bandwidth/traffic

枚舉值:

  • prepayment

  • bandwidth

  • traffic

provider

String

物理專線連接的線路運營商如:中國電信 中國聯(lián)通 中國移動 中國其他 境外其他專線歸屬的運營商

admin_state_up

Boolean

管理狀態(tài):true或false

缺省值:true

vlan

Integer

為托管hosted物理專線分配的vlan。

最小值:0

最大值:3999

status

String

資源狀態(tài),合法值是:ACTIVE,DOWN,BUILD,ERROR,PENDING_DELETE,DELETED,APPLY,DENY,PENDING_PAY,PAID,ORDERING,ACCEPT,REJECTED

枚舉值:

  • BUILD

  • PAID

  • APPLY

  • PENDING_SURVEY

  • ACTIVE

  • DOWN

  • ERROR

  • PENDING_DELETE

  • DELETED

  • DENY

  • PENDING_PAY

  • ORDERING

  • ACCEPT

  • REJECTED

apply_time

String

物理專線的申請時間

create_time

String

物理專線的創(chuàng)建時間

provider_status

String

物理專線的運營商操作狀態(tài),合法值是:ACTIVE, DOWN

枚舉值:

  • ACTIVE

  • DOWN

peer_port_type

String

連接對端的端口類型

peer_provider

String

專線連接對接的運營商

order_id

String

物理專線對應(yīng)訂單號,用于支持包周期計費,識別用戶訂單

product_id

String

物理專線訂單對應(yīng)產(chǎn)品標識,用于訂制包周期套餐等計費策略

spec_code

String

物理專線訂單對應(yīng)產(chǎn)品規(guī)格,用于訂制包周期套餐等計費策略

period_type

Integer

物理專線對應(yīng)訂單號對應(yīng)包周期的類型

period_num

Integer

物理專線對應(yīng)的包周期時間

vgw_type

String

專線要求的網(wǎng)關(guān)類型

缺省值:default

枚舉值:

  • default

lag_id

String

物理專線歸屬的鏈路聚合組(lag)的ID

signed_agreement_status

String

專線協(xié)議的簽暑狀態(tài)

枚舉值:

  • signed

enterprise_project_id

String

實例所屬企業(yè)項目ID

最小長度:36

最大長度:36

tags

Array of Tag objects

標簽信息

數(shù)組長度:0 - 10

表6 Tag

參數(shù)

參數(shù)類型

描述

key

String

標簽鍵,最大長度36個unicode字符,格式為大小寫字母,數(shù)字,中劃線“-”,下劃線“_”,中文。

最小長度:0

最大長度:36

value

String

標簽值,最大長度43個unicode字符,格式為大小寫字母,數(shù)字,中劃線“-”,下劃線“_”,點“.”,中文。

最小長度:0

最大長度:43

請求示例

查詢物理專線詳情

GET https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/direct-connects/6ecd9cf3-ca64-46c7-863f-f2eb1b9e838a

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "direct_connect" : {
    "bandwidth" : 100,
    "create_time" : "2018-10-19 09:53:26.389556",
    "port_type" : "10G",
    "id" : "6ecd9cf3-ca64-46c7-863f-f2eb1b9e838a",
    "apply_time" : "2018-10-19 09:53:26.389556",
    "peer_location" : "",
    "location" : "Biere",
    "provider" : "CTC",
    "type" : "standard",
    "status" : "BUILD",
    "description" : "",
    "provider_status" : "ACTIVE",
    "order_id" : "",
    "vlan" : null,
    "device_id" : "172.16.40.2",
    "name" : "direct connect1",
    "admin_state_up" : true,
    "tenant_id" : "6fbe9263116a4b68818cf1edce16bc4f",
    "hosting_id" : null,
    "product_id" : "",
    "charge_mode" : ""
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯誤碼

請參見錯誤碼。