華為云計(jì)算 云知識(shí) 申請(qǐng)私有IPCreatePrivateip
申請(qǐng)私有IPCreatePrivateip

 

功能介紹

申請(qǐng)私有IP。

調(diào)試

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

URI

POST /v1/{project_id}/privateips

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

名稱

是否必選

說(shuō)明

project_id

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

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

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

名稱

是否必選

參數(shù)類型

說(shuō)明

privateips

Array of privateip objects

私有IP列表對(duì)象,請(qǐng)參見(jiàn)表3。

表3 privateip字段說(shuō)明

名稱

是否必選

參數(shù)類型

說(shuō)明

subnet_id

String

分配IP的子網(wǎng)標(biāo)識(shí)

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

ip_address

String

  • 功能說(shuō)明:指定IP地址申請(qǐng)
  • 取值范圍:子網(wǎng)網(wǎng)段中的可以使用且未分配的IP地址,不指定時(shí)由系統(tǒng)自動(dòng)分配

請(qǐng)求示例

  • 創(chuàng)建兩個(gè)私有IP,指定在id為531dec0f-3116-411b-a21b-e612e42349fd的子網(wǎng)中創(chuàng)建,一個(gè) ip地址 自動(dòng)分配,一個(gè)指定ip地址為192.168.1.17。
    POST https://{Endpoint}/v1/{project_id}/privateips
    
    {
      "privateips": 
       [ 
        {
            "subnet_id": "531dec0f-3116-411b-a21b-e612e42349fd"
        },
        {
            "subnet_id": "531dec0f-3116-411b-a21b-e612e42349fd",
             "ip_address": "192.168.1.17"
        }
       ]
    }

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

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

名稱

參數(shù)類型

說(shuō)明

privateips

Array of privateip objects

私有IP列表對(duì)象,請(qǐng)參見(jiàn)表5。

表5 privateip字段說(shuō)明

名稱

參數(shù)類型

說(shuō)明

status

String

  • 功能說(shuō)明:私有IP的狀態(tài)
  • 取值范圍:
    • ACTIVE:活動(dòng)的
    • DOWN:不可用

id

String

私有IP標(biāo)識(shí)

subnet_id

String

分配IP的子網(wǎng)標(biāo)識(shí)

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

tenant_id

String

項(xiàng)目ID

device_owner

String

  • 功能說(shuō)明:私有IP的使用者,空表示未使用
  • 取值范圍:

    network:dhcp DHCP服務(wù)IP地址

    network:router_interface_distributed 網(wǎng)關(guān)IP地址

    compute:xxx(xxx對(duì)應(yīng)具體的可用區(qū)名稱,例如compute:aa-bb-cc表示是被可用區(qū)aa-bb-cc上的ECS使用) 虛擬機(jī)網(wǎng)卡IP地址

    neutron:VIP_PORT 虛擬IP地址

    compute:subeni 輔助彈性網(wǎng)卡IP地址

    neutron:LOADBALANCERV2 共享ELB使用的IP地址

    neutron:LOADBALANCERV3 獨(dú)享ELB使用的IP地址

    network:endpoint_interface VPC終端節(jié)點(diǎn)使用的IP地址

  • 約束:此處的取值范圍只是本服務(wù)支持的類型,其他類型未做標(biāo)注

ip_address

String

申請(qǐng)到的私有IP

響應(yīng)示例

{
    "privateips": [
        {
            "status": "DOWN",
            "id": "c60c2ce1-1e73-44bd-bf48-fd688448ff7b",
            "subnet_id": "531dec0f-3116-411b-a21b-e612e42349fd",
            "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
            "device_owner": "",
            "ip_address": "192.168.1.10"
        },
        {
            "status": "DOWN",
            "id": "4b123c18-ae92-4dfa-92cd-d44002359aa1",
            "subnet_id": "531dec0f-3116-411b-a21b-e612e42349fd",
            "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
            "device_owner": "",
            "ip_address": "192.168.1.17"
        }
    ]
}

狀態(tài)碼

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

錯(cuò)誤碼

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