華為云計算 云知識 更新子網(wǎng)UpdateSubnet
更新子網(wǎng)UpdateSubnet

 

功能介紹

更新子網(wǎng)。

調(diào)試

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

URI

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

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

名稱

是否必選

說明

project_id

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

vpc_id

子網(wǎng)對應(yīng)的vpc_id

subnet_id

子網(wǎng)唯一標識

如果您使用管理控制臺,此值即為子網(wǎng)詳情中的“網(wǎng)絡(luò)ID”參數(shù)值。

請求參數(shù)

表2 請求參數(shù)

名稱

是否必選

參數(shù)類型

說明

subnet

subnet object

subnet對象

表3 subnet對象

名稱

是否必選

參數(shù)類型

說明

name

String

  • 功能說明:子網(wǎng)名稱
  • 取值范圍:1-64個字符,支持數(shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點)

description

String

  • 功能說明:子網(wǎng)描述
  • 取值范圍:0-255個字符,不能包含“<”和“>”。

ipv6_enable

Boolean

  • 功能說明:是否創(chuàng)建ipv6子網(wǎng)
  • 取值范圍:true(開啟),false(關(guān)閉)

dhcp_enable

Boolean

  • 功能說明:子網(wǎng)是否開啟dhcp功能
  • 取值范圍:true(開啟),false(關(guān)閉)
  • 約束:不填時默認為true。當設(shè)置為false時,會導(dǎo)致新創(chuàng)建的ECS無法獲取IP地址,Cloud-init無法注入帳號密碼,請謹慎操作。

primary_dns

String

  • 功能說明:子網(wǎng)dns服務(wù)器地址1
  • 約束:ip格式

內(nèi)網(wǎng) DNS地址 請參見華為云提供的內(nèi)網(wǎng)DNS地址是多少?

可以通過查詢名稱服務(wù)器列表查看DNS服務(wù)器的地址。

secondary_dns

String

  • 功能說明:子網(wǎng)dns服務(wù)器地址2
  • 約束:ip格式

內(nèi)網(wǎng)DNS地址請參見華為云提供的內(nèi)網(wǎng)DNS地址是多少?

可以通過查詢名稱服務(wù)器列表查看DNS服務(wù)器的地址。

dnsList

Array of strings

  • 功能說明:子網(wǎng)dns服務(wù)器地址的集合;如果想使用兩個以上dns服務(wù)器,請使用該字段。
  • 約束:是子網(wǎng)dns服務(wù)器地址1跟子網(wǎng)dns服務(wù)器地址2的合集的父集

內(nèi)網(wǎng)DNS地址請參見華為云提供的內(nèi)網(wǎng)DNS地址是多少?

可以通過查詢名稱服務(wù)器列表查看DNS服務(wù)器的地址。

extra_dhcp_opts

Array of extra_dhcp_opt objects

子網(wǎng)配置的NTP地址或租約時間,詳情請參見extra_dhcp_opt對象。

表4 extra_dhcp_opt對象

名稱

是否必選

參數(shù)類型

說明

opt_value

String

  • 功能說明:子網(wǎng)配置的NTP地址或子網(wǎng)配置的租約到期時間。
  • 約束:

    opt_name配置為“ntp”,則表示是子網(wǎng)ntp地址,目前只支持IPv4地址,每個IP地址以逗號隔開,IP地址個數(shù)不能超過4個,不能存在相同地址。該字段為null表示取消該子網(wǎng)NTP的設(shè)置,不能為“ ”(空字符串)。

    opt_name配置為“addresstime”,則該值表示是子網(wǎng)租約到期時間,取值格式有兩種,取-1,表示無限租約;數(shù)字+h,數(shù)字范圍是1~30000,比如5h,默認值為24h。

opt_name

String

  • 功能說明:子網(wǎng)配置的NTP地址名稱或子網(wǎng)配置的租約到期名稱。
  • 約束:目前只支持填寫字符串“ntp”或“addresstime”。

請求示例

  • 更新id為4779ab1c-7c1a-44b1-a02e-93dfc361b32d的子網(wǎng),名稱更新為subnet02,更新dns和dhcp。
    PUT https://{Endpoint}/v1/{project_id}/vpcs/{vpc_id}/subnets/4779ab1c-7c1a-44b1-a02e-93dfc361b32d
    
    {
        "subnet": {
            "name": "subnet02",
            "ipv6_enable": true,
            "dhcp_enable": false,
            "primary_dns": "114.xx.xx.115",
            "secondary_dns": "114.xx.xx.116",
            "extra_dhcp_opts": [
                {
                    "opt_value": "10.100.0.33,10.100.0.34",
                    "opt_name": "ntp"
                },
                {
                    "opt_value": "24h",
                    "opt_name": "addresstime"
                }
            ]
        }
    }
    

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

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

名稱

參數(shù)類型

說明

subnet

subnet object

subnet對象

表6 subnet對象

名稱

參數(shù)類型

說明

id

String

uuid形式的一個資源標識。

status

String

  • 功能說明:子網(wǎng)的狀態(tài)。
  • 取值范圍:ACTIVE,UNKNOWN,ERROR
    • ACTIVE表示子網(wǎng)已掛載到VPC上
    • UNKNOWN表示子網(wǎng)還未掛載到VPC上
    • ERROR表示子網(wǎng)狀態(tài)故障

響應(yīng)示例

{
    "subnet": {
        "id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
        "status": "ACTIVE"
    }
}

狀態(tài)碼

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

錯誤碼

請參考錯誤碼。