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

 

功能介紹

查詢單個安全組。

調(diào)試

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

URI

GET /v1/{project_id}/security-groups/{security_group_id}

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

名稱

是否必選

說明

project_id

是

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

security_group_id

是

安全組唯一標識

請求參數(shù)

無

請求示例

GET https://{Endpoint}/v1/{project_id}/security-groups/16b6e77a-08fa-42c7-aa8b-106c048884e6

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

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

名稱

參數(shù)類型

說明

security_group

security_group object

安全組對象
表3 security_group字段說明

名稱

參數(shù)類型

說明

name

String

安全組名稱

description

String

安全組描述

id

String

安全組唯一標識

vpc_id

String

安全組所在的vpc的資源標識

說明：

該參數(shù)功能已廢棄，不建議繼續(xù)使用。

當前該參數(shù)只作提示用，不約束安全組在此vpc下。

security_group_rules

Array of security_group_rule objects

默認安全組規(guī)則列表，保證安全組內(nèi)互通。

enterprise_project_id

String
  • 功能說明：企業(yè)項目ID。創(chuàng)建安全組時，給安全組綁定企業(yè)項目ID。
  • 取值范圍：最大長度36字節(jié)，帶“-”連字符的UUID格式，或者是字符串“0”?！?”表示默認企業(yè)項目。
說明：

關(guān)于企業(yè)項目ID的獲取及企業(yè)項目特性的詳細信息，請參見《企業(yè)管理用戶指南》。
表4 security_group_rule對象

名稱

參數(shù)類型

說明

id

String

安全組規(guī)則標識

description

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

security_group_id

String

安全組標識

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地址，當direction是egress時為虛擬機訪問端的地址，當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": {
        "id": "16b6e77a-08fa-42c7-aa8b-106c048884e6", 
        "name": "qq", 
        "description": "qq", 
        "vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85", 
        "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2",
        "security_group_rules": [
            {
                "direction": "egress", 
                "ethertype": "IPv4", 
                "id": "369e6499-b2cb-4126-972a-97e589692c62", 
                "description": "",
                "security_group_id": "16b6e77a-08fa-42c7-aa8b-106c048884e6",
                "remote_address_group_id": null
            }, 
            {
                "direction": "ingress", 
                "ethertype": "IPv4", 
                "id": "0222556c-6556-40ad-8aac-9fd5d3c06171", 
                "description": "",
                "remote_group_id": "16b6e77a-08fa-42c7-aa8b-106c048884e6", 
                "security_group_id": "16b6e77a-08fa-42c7-aa8b-106c048884e6"
            }
        ]
    }
}

狀態(tài)碼

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

錯誤碼

請參考錯誤碼。

 

查詢安全組ShowSecurityGroup

意見反饋

0/200

提交 取消

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