List security group rules

指定したプロジェクトが利用できるすべてのセキュリティグループを一覧表示する。

URI

/v2.0/security-group-rules

HTTPメソッド

GET

レスポンスステータス

ステータスコード 説明
200 Normal response codes
unauthorized (401) Error response codes

レスポンスボディ(正常系)


{
    "security_group_rules": [
        {
            "direction": "egress",
            "ethertype": "IPv6",
            "id": "3c0e45ff-adaf-4124-b083-bf390e5482ff",
            "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"
        },
        {
            "direction": "egress",
            "ethertype": "IPv4",
            "id": "93aa42e5-80db-4581-9391-3a608bd0e448",
            "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"
        },
        {
            "direction": "ingress",
            "ethertype": "IPv6",
            "id": "c0b09f00-1d49-4e64-a0a7-8a186d928138",
            "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"
        },
        {
            "direction": "ingress",
            "ethertype": "IPv4",
            "id": "f7d45c89-008e-4bab-88ad-d6811724c51c",
            "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"
        }
    ]
}
     

レスポンスボディ(正常系)の説明

要素名 説明
direction ingressまたはegress。セキュリティグループルールが適用される通信方向。コンピュートインスタンスの場合、ingressセキュリティグループルールは受信(ingress)トラフィックに適用されます。egressルールは、インスタンスから送信出てゆくトラフィックに適用されます。
ethertype IPv4またはIPv6を指定する必要があります。また、CIDR表記のアドレスがingressルールまたはegressルールと一致する必要があります。
security_group_id セキュリティグループID
port_range_min セキュリティグループルールに一致する範囲の最小ポート番号

プロトコルがTCPまたはUDPのときに、この値が指定されていない場合、セキュリティグループルールはすべてのポート番号に適用されます。

port_range_minが"0"の場合、port_range_maxの値に関係なく、すべてのポート番号が許可されます。

プロトコルがICMPの場合、この値にICMPタイプを指定する必要があります。この値が"null"の場合、セキュリティグループルールはすべてのICMPタイプに適用されます。

port_range_max セキュリティグループルールに一致する範囲の最大ポート番号

プロトコルがICMPのときに、この値が指定されていない場合、セキュリティグループルールはすべてのICMPコードに適用されます。

protocol セキュリティグループルールに一致するプロトコル

有効な数値は、null、tcp、udp、icmp、および、0~255の数字です。

remote_group_id このセキュリティグループと関連付ける通信先のセキュリティグループのID

リクエストボディ部では、remote_group_idまたはremote_ip_prefixを指定できます。

remote_ip_prefix このセキュリティグループと関連付けるリモートIPのプレフィックス

本属性は、IPパケットの発信先IPアドレスまたは宛先IPアドレスの指定されたIPプレフィックスに一致します。方向がingressであれば発信先IPアドレスに一致し、そうでなければ宛先IPアドレスに一致します。