華為云計算 云知識 更新白名單UpdateWhitelist
更新白名單UpdateWhitelist

 

功能介紹

更新白名單。可以打開或關(guān)閉白名單,或更新訪問控制的IP。更新白名單后,會刪除老的白名單,以新的白名單替換老的白名單。

調(diào)試

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

URI

PUT /v2/{project_id}/elb/whitelists/{whitelist_id}

表1 參數(shù)說明

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

操作用戶的項目ID。

獲取方法詳見獲取項目ID

whitelist_id

String

白名單id。

請求消息

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

whitelist

Whitelist object

白名單對象。詳見 表3。

表3 whitelist字段說明

參數(shù)

是否必選

參數(shù)類型

描述

enable_whitelist

Boolean

是否開啟訪問控制開關(guān)。

true:打開

false:關(guān)閉

默認值:true。

whitelist

String

白名單IP的字符串。不同IP之間通過逗號分隔。

可以指定一個IP,例如:

192.168.11.1

也可以指定網(wǎng)段,例如:

192.168.0.1/24

默認值:“”。

響應(yīng)消息

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

參數(shù)

參數(shù)類型

描述

whitelist

Whitelist object

白名單對象。詳見 表5。

表5 whitelist字段說明

參數(shù)

參數(shù)類型

描述

id

String

白名單的ID。

tenant_id

String

白名單所在的項目ID。

支持的最大字符長度:255

listener_id

String

白名單關(guān)聯(lián)的監(jiān)聽器ID。

enable_whitelist

Boolean

是否開啟訪問控制開關(guān)。

true:打開

false:關(guān)閉

whitelist

String

白名單IP的字符串。

請求示例

  • 請求樣例 更新白名單
    PUT https://{Endpoint}/v2/eabfefa3fd1740a88a47ad98e132d238/elb/whitelists/dcaf46f1-037c-4f63-a31f-e0c4c18032c7
    
    { 
        "whitelist": { 
            "enable_whitelist": true,  
            "whitelist": "192.168.11.1,192.168.0.1/24,192.168.201.18/8,100.164.0.1/24" 
        } 
    }

響應(yīng)示例

  • 響應(yīng)樣例
    { 
        "whitelist": { 
            "id": "eabfefa3fd1740a88a47ad98e132d238",  
            "listener_id": "eabfefa3fd1740a88a47ad98e132d238",  
            "tenant_id": "eabfefa3fd1740a88a47ad98e132d238",  
            "enable_whitelist": true,  
            "whitelist": "192.168.11.1,192.168.0.1/24,192.168.201.18/8,100.164.0.1/24" 
        } 
    }

返回碼

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