華為云計算 云知識 更新VPCUpdateVpc
更新VPCUpdateVpc

 

功能介紹

更新 虛擬私有云 。

調(diào)試

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

URI

PUT /v1/{project_id}/vpcs/{vpc_id}

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

名稱

是否必選

說明

project_id

項目ID,獲取項目ID請參見獲取項目ID。

vpc_id

虛擬 私有云 唯一標識

請求參數(shù)

表2 請求參數(shù)

名稱

是否必選

參數(shù)類型

說明

vpc

vpc object

vpc對象。

表3 vpc對象

名稱

是否必選

參數(shù)類型

說明

name

String

  • 功能說明:虛擬私有云名稱
  • 取值范圍:0-64個字符,支持數(shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點)
  • 約束:如果名稱不為空,則同一個租戶下的VPC不允許重名。

description

String

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

cidr

String

  • 功能說明:虛擬私有云下可用子網(wǎng)的范圍
  • 取值范圍:
    • 10.0.0.0/8~24
    • 172.16.0.0/12~24
    • 192.168.0.0/16~24
  • 不指定cidr時,默認值為空
  • 約束:

    必須是cidr格式,例如:192.168.0.0/16

    如果要更新VPC的cidr,修改后的cidr必須包含VPC下所有子網(wǎng)的cidr

routes

Array of route objects

  • 功能說明:路由信息列表,詳情參見表 route對象。
表4 route對象

名稱

是否必選

參數(shù)類型

說明

destination

String

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

nexthop

String

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

請求示例

  • 更新id為99d9d709-8478-4b46-9f3f-2206b1023fd3的vpc,將名稱更新為vpc1,描述更新為test1,cidr更新為192.168.0.0/16。
    PUT https://{Endpoint}/v1/{project_id}/vpcs/99d9d709-8478-4b46-9f3f-2206b1023fd3
    
    {
        "vpc": {
            "name": "vpc1",
            "description": "test1",
            "cidr": "192.168.0.0/16"
        }
    }

響應參數(shù)

表5 響應參數(shù)

名稱

參數(shù)類型

說明

vpc

vpc object

vpc對象

表6 vpc對象

名稱

參數(shù)類型

說明

id

String

uuid形式的一個資源標識。

name

String

虛擬私有云名稱。

description

String

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

cidr

String

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

status

String

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

enterprise_project_id

String

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

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

routes

Array of route objects

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

tenant_id

String

String

功能說明:項目ID。

created_at

String

String

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

updated_at

String

String

  • 功能說明:資源更新時間,UTC時間
  • 格式:yyyy-MM-ddTHH:mm:ss
表7 route對象

名稱

參數(shù)類型

說明

destination

String

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

nexthop

String

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

響應示例

{
    "vpc": {
        "id": "99d9d709-8478-4b46-9f3f-2206b1023fd3",
        "name": "vpc1",
        "description": "test1",
        "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-15T06:23:15"
    }
}

狀態(tài)碼

請參見狀態(tài)碼。

錯誤碼

請參考錯誤碼