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

 

功能介紹

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

調(diào)試

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

URI

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

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

名稱

是否必選

說明

project_id

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

security_group_rule_id

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

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

請(qǐng)求示例

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ī)則對(duì)象,請(qǐng)參見表3。

表3 security_group_rule對(duì)象

名稱

參數(shù)類型

說明

id

String

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

description

String

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

security_group_id

String

安全組標(biāo)識(shí)

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

  • 功能說明:遠(yuǎn)端IP地址,當(dāng)direction是egress時(shí)為虛擬機(jī)訪問端的地址,當(dāng)direction是ingress時(shí)為訪問虛擬機(jī)的地址
  • 取值范圍:IP地址,或者cidr格式
  • 約束:和remote_group_id,remote_address_group_id互斥

remote_group_id

String

  • 功能說明:對(duì)端安全組id
  • 約束:和remote_ip_prefix,remote_address_group_id互斥

remote_address_group_id

String

  • 功能說明:遠(yuǎn)端IP地址組ID
  • 約束:和remote_ip_prefix,remote_group_id互斥

tenant_id

String

  • 功能說明:安全組規(guī)則所屬項(xiàng)目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)碼

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

錯(cuò)誤碼

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