功能介紹
更新物理連接信息,包括名字,描述等信息
調(diào)試
您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。
URI
PUT /v3/{project_id}/dcaas/direct-connects/{direct_connect_id}
| 
 參數(shù)  | 
 是否必選  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|---|
| 
 direct_connect_id  | 
 是  | 
 String  | 
 物理專線連接ID。 最小長(zhǎng)度:36 最大長(zhǎng)度:36  | 
| 
 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”的值即為Token值。 最小長(zhǎng)度:0 最大長(zhǎng)度:10240  | 
| 
 參數(shù)  | 
 是否必選  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|---|
| 
 direct_connect  | 
 否  | 
 物理專線更新參數(shù)  | 
| 
 參數(shù)  | 
 是否必選  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|---|
| 
 name  | 
 否  | 
 String  | 
 物理專線的名字 最小長(zhǎng)度:0 最大長(zhǎng)度:64  | 
| 
 description  | 
 否  | 
 String  | 
 物理專線的描述信息 最小長(zhǎng)度:0 最大長(zhǎng)度:128  | 
| 
 bandwidth  | 
 否  | 
 Integer  | 
 指定托管專線接入帶寬,單位Mbps 最小值:2 最大值:100000  | 
| 
 peer_location  | 
 否  | 
 String  | 
 物理專線對(duì)端所在的物理位置,省/市/街道或IDC名字 最小長(zhǎng)度:0 最大長(zhǎng)度:255  | 
| 
 status  | 
 否  | 
 String  | 
 更新資源狀態(tài),合法值是:PENDING_PAY 枚舉值: 
  | 
| 
 provider_status  | 
 否  | 
 String  | 
 更新運(yùn)營(yíng)商狀態(tài),合法值是:ACTIVE,DOWN 枚舉值: 
  | 
響應(yīng)參數(shù)
狀態(tài)碼: 200
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 request_id  | 
 String  | 
 操作請(qǐng)求ID  | 
| 
 direct_connect  | 
 物理專線對(duì)象  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 id  | 
 String  | 
 物理專線標(biāo)識(shí)符ID  | 
| 
 tenant_id  | 
 String  | 
 實(shí)例所屬項(xiàng)目ID。  | 
| 
 name  | 
 String  | 
 物理專線名字 最小長(zhǎng)度:0 最大長(zhǎng)度:64  | 
| 
 description  | 
 String  | 
 物理專線描述信息 最小長(zhǎng)度:0 最大長(zhǎng)度:128  | 
| 
 port_type  | 
 String  | 
 物理專線接入接口的類型,支持1G 10G 40G 100G 枚舉值: 
  | 
| 
 bandwidth  | 
 Integer  | 
 物理專線接入帶寬,單位Mbps。 最小值:2 最大值:100000  | 
| 
 location  | 
 String  | 
 專線的接入位置信息 最小長(zhǎng)度:0 最大長(zhǎng)度:255  | 
| 
 peer_location  | 
 String  | 
 物理專線對(duì)端所在的物理位置,省/市/街道或IDC名字。 最小長(zhǎng)度:0 最大長(zhǎng)度:255  | 
| 
 device_id  | 
 String  | 
 物理專線連接的設(shè)備的標(biāo)識(shí)ID 最小長(zhǎng)度:0 最大長(zhǎng)度:36  | 
| 
 type  | 
 String  | 
 物理專線的類型,類似包括標(biāo)準(zhǔn)(standard),運(yùn)營(yíng)專線(hosting),托管專線(hosted) 缺省值:standard 枚舉值: 
  | 
| 
 hosting_id  | 
 String  | 
 hosted物理專線對(duì)應(yīng)的hosting物理專線的ID  | 
| 
 charge_mode  | 
 String  | 
 計(jì)費(fèi)模式:prepayment/bandwidth/traffic 枚舉值: 
  | 
| 
 provider  | 
 String  | 
 物理專線連接的線路運(yùn)營(yíng)商如:中國(guó)電信 中國(guó)聯(lián)通 中國(guó)移動(dòng) 中國(guó)其他 境外其他專線歸屬的運(yùn)營(yíng)商  | 
| 
 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 枚舉值: 
  | 
| 
 apply_time  | 
 String  | 
 物理專線的申請(qǐng)時(shí)間  | 
| 
 create_time  | 
 String  | 
 物理專線的創(chuàng)建時(shí)間  | 
| 
 provider_status  | 
 String  | 
 物理專線的運(yùn)營(yíng)商操作狀態(tài),合法值是:ACTIVE, DOWN 枚舉值: 
  | 
| 
 peer_port_type  | 
 String  | 
 連接對(duì)端的端口類型  | 
| 
 peer_provider  | 
 String  | 
 專線連接對(duì)接的運(yùn)營(yíng)商  | 
| 
 order_id  | 
 String  | 
 物理專線對(duì)應(yīng)訂單號(hào),用于支持包周期計(jì)費(fèi),識(shí)別用戶訂單  | 
| 
 product_id  | 
 String  | 
 物理專線訂單對(duì)應(yīng)產(chǎn)品標(biāo)識(shí),用于訂制包周期套餐等計(jì)費(fèi)策略  | 
| 
 spec_code  | 
 String  | 
 物理專線訂單對(duì)應(yīng)產(chǎn)品規(guī)格,用于訂制包周期套餐等計(jì)費(fèi)策略  | 
| 
 period_type  | 
 Integer  | 
 物理專線對(duì)應(yīng)訂單號(hào)對(duì)應(yīng)包周期的類型  | 
| 
 period_num  | 
 Integer  | 
 物理專線對(duì)應(yīng)的包周期時(shí)間  | 
| 
 vgw_type  | 
 String  | 
 專線要求的網(wǎng)關(guān)類型 缺省值:default 枚舉值: 
  | 
| 
 lag_id  | 
 String  | 
 物理專線歸屬的鏈路聚合組(lag)的ID  | 
| 
 signed_agreement_status  | 
 String  | 
 專線協(xié)議的簽暑狀態(tài) 枚舉值: 
  | 
| 
 enterprise_project_id  | 
 String  | 
 實(shí)例所屬企業(yè)項(xiàng)目ID 最小長(zhǎng)度:36 最大長(zhǎng)度:36  | 
| 
 tags  | 
 標(biāo)簽信息 數(shù)組長(zhǎng)度:0 - 10  | 
請(qǐng)求示例
更新物理連接的名稱和描述信息
PUT https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/direct-connects/6ecd9cf3-ca64-46c7-863f-f2eb1b9e838a
{
  "direct_connect" : {
    "description" : "",
    "name" : "direct connect1"
  }
}
響應(yīng)示例
狀態(tài)碼: 200
OK
{
  "request_id" : "9a4f4dfc4fb2fc101e65bba07d908535",
  "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" : "OTC",
    "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  | 
錯(cuò)誤碼
請(qǐng)參見錯(cuò)誤碼。
  
    