華為云計(jì)算 云知識(shí) 創(chuàng)建VPCCreateVpc
創(chuàng)建VPCCreateVpc

 

功能介紹

創(chuàng)建 虛擬私有云

調(diào)試

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

URI

POST /v1/{project_id}/vpcs

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

名稱

是否必選

說(shuō)明

project_id

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

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

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

名稱

是否必選

參數(shù)類型

說(shuō)明

vpc

vpc object

vpc對(duì)象

表3 vpc對(duì)象

名稱

是否必選

參數(shù)類型

說(shuō)明

name

String

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

description

String

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

cidr

String

  • 功能說(shuō)明:虛擬私有云下可用子網(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

enterprise_project_id

String

  • 功能說(shuō)明:企業(yè)項(xiàng)目ID。創(chuàng)建虛擬私有云時(shí),給虛擬私有云綁定企業(yè)項(xiàng)目ID。
  • 取值范圍:最大長(zhǎng)度36字節(jié),帶“-”連字符的UUID格式,或者是字符串“0”?!?”表示默認(rèn)企業(yè)項(xiàng)目。
說(shuō)明:

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

tags

Array of Strings

  • 功能說(shuō)明:虛擬私有云資源標(biāo)簽。創(chuàng)建虛擬私有云時(shí),給虛擬私有云添加資源標(biāo)簽。
  • 取值范圍:最大10個(gè)標(biāo)簽
    • key:標(biāo)簽名稱。不能為空,長(zhǎng)度不超過(guò)128個(gè)字符(當(dāng)前控制臺(tái)操作key長(zhǎng)度不超過(guò)36個(gè)字符),由英文字母、數(shù)字、下劃線、中劃線、中文字符組成,同一資源的key值不能重復(fù)。
    • value:標(biāo)簽值。長(zhǎng)度不超過(guò)255個(gè)字符(當(dāng)前控制臺(tái)操作value長(zhǎng)度不超過(guò)43個(gè)字符),由英文字母、數(shù)字、下劃線、點(diǎn)、中劃線、中文字符組成。
  • 格式:[key*value],每一個(gè)標(biāo)簽的key和value之間用*連接

請(qǐng)求示例

  • 創(chuàng)建一個(gè)vpc,命名為vpc,設(shè)置cidr為192.168.0.0/16。
    POST https://{Endpoint}/v1/{project_id}/vpcs
    
    {
        "vpc": {
            "name": "vpc",
            "description": "test",
            "cidr": "192.168.0.0/16",
            "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2"
        }
    }

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

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

名稱

參數(shù)類型

說(shuō)明

vpc

vpc object

vpc對(duì)象

表5 vpc對(duì)象

名稱

參數(shù)類型

說(shuō)明

id

String

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

name

String

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

description

String

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

cidr

String

  • 功能說(shuō)明:虛擬私有云下可用子網(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

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

routes

Array of route objects

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

enterprise_project_id

String

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

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

tenant_id

String

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

created_at

String

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

updated_at

String

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

名稱

參數(shù)類型

說(shuō)明

destination

String

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

nexthop

String

  • 功能說(shuō)明:路由下一跳地址
  • 約束:必須為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": "CREATING",
     "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", 
     "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ò)誤碼