華為云計算 云知識 查詢安全組規(guī)則列表ListSecurityGroupRules
查詢安全組規(guī)則列表ListSecurityGroupRules
時間: 2023-09-20 16:20:48
猜你想看：
實時語音識別 云服務(wù)器配置 CDN是什么意思 視頻點播加速 什么是云桌面

 

功能介紹

查詢安全組規(guī)則列表。

調(diào)試

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

URI

GET /v1/{project_id}/security-group-rules

樣例： 
GET https://{Endpoint}/v1/{project_id}/security-group-rules?
security_group_id=a7734e61-b545-452da3cd-0189cbd9747a&limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d
參數(shù)說明請參見表1。
表1 參數(shù)說明

名稱

是否必選

參數(shù)類型

說明

project_id

是

String

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

marker

否

String

分頁查詢的起始資源ID，表示從指定資源的下一條記錄開始查詢。

marker需要和limit配合使用：

  • 若不傳入marker和limit參數(shù)，查詢結(jié)果返回第一頁全部資源記錄。
  • 若不傳入marker參數(shù)，limit為10，查詢結(jié)果返回第1~10條資源記錄。
  • 若marker為第10條記錄的資源ID，limit為10，查詢結(jié)果返回第11~20條資源記錄。
  • 若marker為第10條記錄的資源ID，不傳入limit參數(shù)，查詢結(jié)果返回第11條及之后的所有資源記錄。

limit

否

Integer

分頁查詢每頁返回的記錄個數(shù)，取值范圍為0~intmax（2^31-1），默認(rèn)值2000。

limit需要和marker配合使用，詳細規(guī)則請見marker的參數(shù)說明。

security_group_id

否

String

功能說明：安全組標(biāo)識

請求參數(shù)

無

請求示例

GET https://{Endpoint}/v1/{project_id}/security-group-rules

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

名稱

參數(shù)類型

說明

security_group_rules

Array of security_group_rule objects

安全組規(guī)則對象列表，請參見表2。
表2 security_group_rule對象

名稱

參數(shù)類型

說明

id

String

安全組規(guī)則標(biāo)識

description

String
  • 功能說明：安全組規(guī)則描述
  • 取值范圍：0-255個字符，支持?jǐn)?shù)字、字母、中文字符

security_group_id

String

安全組標(biāo)識

direction

String
  • 功能說明：出入控制方向
  • 取值范圍：
    • egress：出方向
    • ingress：入方向

ethertype

String
  • 功能說明：IP協(xié)議類型
  • 取值范圍：IPv4，IPv6

protocol

String
  • 功能說明：協(xié)議類型
  • 取值范圍：icmp、tcp、udp、icmpv6等
  • 約束：為空表示支持所有協(xié)議

port_range_min

Integer

port_range_max

Integer

remote_ip_prefix

String
  • 功能說明：遠端IP地址，當(dāng)direction是egress時為虛擬機訪問端的地址，當(dāng)direction是ingress時為訪問虛擬機的地址
  • 取值范圍：IP地址，或者cidr格式
  • 約束：和remote_group_id，remote_address_group_id互斥

remote_group_id

String
  • 功能說明：對端安全組id
  • 約束：和remote_ip_prefix，remote_address_group_id互斥

remote_address_group_id

String
  • 功能說明：遠端IP地址組ID
  • 約束：和remote_ip_prefix，remote_group_id互斥

tenant_id

String
  • 功能說明：安全組規(guī)則所屬項目ID

響應(yīng)示例

{
    "security_group_rules": [
        {
            "direction": "egress", 
            "ethertype": "IPv6", 
            "id": "3c0e45ff-adaf-4124-b083-bf390e5482ff", 
            "description": "",
            "port_range_max": null, 
            "port_range_min": null, 
            "protocol": null, 
            "remote_group_id": null, 
            "remote_ip_prefix": null, 
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "remote_address_group_id": null
        }, 
        {
            "direction": "egress", 
            "ethertype": "IPv4", 
            "id": "93aa42e5-80db-4581-9391-3a608bd0e448",
            "description": "", 
            "port_range_max": null, 
            "port_range_min": null, 
            "protocol": null, 
            "remote_group_id": null, 
            "remote_ip_prefix": null, 
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "remote_address_group_id": null
        }, 
        {
            "direction": "ingress", 
            "ethertype": "IPv6", 
            "id": "c0b09f00-1d49-4e64-a0a7-8a186d928138", 
            "description": "",
            "port_range_max": null, 
            "port_range_min": null, 
            "protocol": null, 
            "remote_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
            "remote_ip_prefix": null, 
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "remote_address_group_id": null
        }, 
        {
            "direction": "ingress", 
            "ethertype": "IPv4", 
            "id": "f7d45c89-008e-4bab-88ad-d6811724c51c", 
            "description": "",
            "port_range_max": null, 
            "port_range_min": null, 
            "protocol": null, 
            "remote_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
            "remote_ip_prefix": null, 
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "remote_address_group_id": null
        }
    ]
}

狀態(tài)碼

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

錯誤碼

請參考錯誤碼。

 

查詢安全組規(guī)則列表ListSecurityGroupRules

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會繼續(xù)努力做到更好 反饋提交失??！請稍后重試！