查詢VPCShowVpc

 

功能介紹

查詢 虛擬私有云 。

調(diào)試

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

URI

GET /v1/{project_id}/vpcs/{vpc_id}

參數(shù)說明請(qǐng)參見表1。
表1 參數(shù)說明

名稱

是否必選

說明

project_id

項(xiàng)目ID,獲取項(xiàng)目ID請(qǐng)參見獲取項(xiàng)目ID。

vpc_id

虛擬 私有云 唯一標(biāo)識(shí)

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

請(qǐng)求示例

GET https://{Endpoint}/v1/{project_id}/vpcs/99d9d709-8478-4b46-9f3f-2206b1023fd3

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

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

名稱

參數(shù)類型

說明

vpc

vpc object

vpc對(duì)象

表3 vpc對(duì)象

名稱

參數(shù)類型

說明

id

String

uuid形式的一個(gè)資源標(biāo)識(shí)。

name

String

  • 功能說明:虛擬私有云名稱
  • 取值范圍:0-64個(gè)字符,支持?jǐn)?shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點(diǎn))
  • 約束:如果名稱不為空,則同一個(gè)租戶下的名稱不能重復(fù)

description

String

  • 功能說明:虛擬私有云描述
  • 取值范圍:0-255個(gè)字符,不能包含“<”和“>”。

cidr

String

  • 功能說明:虛擬私有云下可用子網(wǎng)的范圍
  • 取值范圍:
    • 10.0.0.0/8~24
    • 172.16.0.0/12~24
    • 192.168.0.0/16~24
  • 不指定cidr時(shí),默認(rèn)值為空
  • 約束:必須是cidr格式,例如:192.168.0.0/16

status

String

  • 功能說明:虛擬私有云的狀態(tài)。
  • 取值范圍:
    • CREATING:創(chuàng)建中
    • OK:創(chuàng)建成功

routes

Array of route objects

  • 功能說明:路由信息列表。
  • 約束:詳情參見route對(duì)象。

enterprise_project_id

String

  • 功能說明:企業(yè)項(xiàng)目ID。
  • 取值范圍:最大長度36字節(jié),帶“-”連字符的UUID格式,或者是字符串“0”?!?”表示默認(rèn)企業(yè)項(xiàng)目。
    說明:

    關(guān)于企業(yè)項(xiàng)目ID的獲取及企業(yè)項(xiàng)目特性的詳細(xì)信息,請(qǐng)參見《企業(yè)管理用戶指南》。

tenant_id

String

功能說明:項(xiàng)目ID。

created_at

String

  • 功能說明:資源創(chuàng)建時(shí)間,UTC時(shí)間
  • 格式:yyyy-MM-ddTHH:mm:ss

updated_at

String

  • 功能說明:資源更新時(shí)間,UTC時(shí)間
  • 格式:yyyy-MM-ddTHH:mm:ss
表4 route對(duì)象

名稱

參數(shù)類型

說明

destination

String

  • 功能說明:路由目的網(wǎng)段
  • 約束:必須是cidr格式,且目前只支持0.0.0.0/0

nexthop

String

  • 功能說明:路由下一跳地址
  • 約束:必須為IP地址格式,且必須屬于本VPC下的子網(wǎng)范圍內(nèi)才能生效

響應(yīng)示例

{
    "vpc": {
        "id": "99d9d709-8478-4b46-9f3f-2206b1023fd3",
        "name": "vpc",
        "description": "test",
        "cidr": "192.168.0.0/16",
        "status": "OK",
        "enterprise_project_id": "0" ,
        "routes": [],
        "tenant_id": "087679f0aa80d32a2f4ec0172f5e902b",
        "created_at": "2022-12-15T02:25:11",
        "updated_at": "2022-12-15T02:25:11"
}
}

狀態(tài)碼

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

錯(cuò)誤碼

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