華為云計算 云知識 查詢安全組規(guī)則ShowSecurityGroupRule
查詢安全組規(guī)則ShowSecurityGroupRule

 

功能介紹

查詢單個安全組規(guī)則。

調(diào)試

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

URI

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

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

名稱

是否必選

說明

project_id

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

security_group_rule_id

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

請求參數(shù)

請求示例

GET https://{Endpoint}/v1/{project_id}/security-group-rules/2bc0accf-312e-429a-956e-e4407625eb62

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

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

名稱

參數(shù)類型

說明

security_group_rule

security_group_rule object

安全組規(guī)則對象,請參見表3。

表3 security_group_rule對象

名稱

參數(shù)類型

說明

id

String

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

description

String

  • 功能說明:安全組規(guī)則描述
  • 取值范圍:0-255個字符,支持數(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_rule": {
        "direction": "ingress", 
        "ethertype": "IPv4", 
        "id": "2bc0accf-312e-429a-956e-e4407625eb62", 
        "description":"",
        "port_range_max": 80, 
        "port_range_min": 80, 
        "protocol": "tcp", 
        "remote_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
        "remote_ip_prefix": null, 
        "security_group_id": "a7734e61-b545-452d-a3cd-0189cbd9747a", 
        "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
        "remote_address_group_id": null
    }
}

狀態(tài)碼

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

錯誤碼

請參考錯誤碼。