本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/cp/api/DescribeSecurityGroups.htmへ移行しました。 今後は新ページをご参照ください。

DescribeSecurityGroups

処理概要

指定したファイアウォールグループの設定情報を取得します。

ファイアウォールグループを指定するためには、ファイアウォールグループ名が必要です。指定しない場合は、取得可能なすべてのファイアウォールグループの設定情報を取得します。

指定するパラメーター

パラメーター 説明 必須
GroupName.n string ファイアウォールグループ名
Filter.n.Name string 絞り込み条件の項目名
値:
  • description (グループのメモ)
  • group-name (ファイアウォールグループ名(GroupName.n を指定している場合、無効))
Filter.n.Value.m string 絞り込み条件の値 (前方一致)

応答フィールド

フィールド (項目) 説明
DescribeSecurityGroupsResponse - DescribeSecurityGroups レスポンス
requestId string リクエスト識別子
securityGroupInfo - ファイアウォールグループ情報セット
item - ファイアウォールグループ情報
ownerId string ※空を返却
groupName string ファイアウォールグループ名
groupDescription string ファイアウォールグループのメモ
groupStatus string ファイアウォールグループのステータス
値:
  • processing (適用中)
  • applied (適用済み)
ipPermissions - 許可ルール情報セット
item - 許可ルール情報
ipProtocol string 許可プロトコル名
値:
  • ANY
  • TCP
  • UDP
  • ICMP
  • SSH
  • HTTP
  • HTTPS
  • RDP
  • GRE
  • ESP
  • AH
  • VRRP
  • L2TP
  • ICMPv6-all
fromPort integer 許可開始ポート
toPort integer 許可終了ポート
inOut string Incoming/Outgoing指定
値:
  • IN (Incoming)
  • OUT (Outgoing)
groups - 許可するファイアウォールグループ
item - 許可するファイアウォールグループの指定
userId string ※空を返却
groupName string 許可するファイアウォールグループ名
ipRanges - 許可するIPアドレス
item - 許可するIPアドレスの指定
cidrIp string 許可するIPアドレス(IPv4, IPv6)
description string 許可ルールのメモ
addDatetime timestamp 許可ルールをファイアウォールグループに追加した日時
instancesSet - 適用しているサーバー情報セット
item - 適用しているサーバー情報
instanceId string サーバー名
instanceUniqueIdsSet - 適用しているサーバーユニークID情報セット
item - 適用しているサーバーユニークID情報
instanceUniqueId string サーバーユニークID
routerSet - VM全体にFW適用しているルーター情報セット
item - VM全体にFW適用しているルーター情報
routerId string ルーターユニークID
routerName string ルーター名
vpnGatewaySet - 適用している拠点間VPNゲートウェイ情報セット
item - 適用している拠点間VPNゲートウェイ情報
vpnGatewayId string 拠点間VPNゲートウェイユニークID
niftyVpnGatewayName string 拠点間VPNゲートウェイ名
groupRuleLimit integer ルール数の上限
groupLogLimit integer ログ取得件数
groupLogFilterNetBios boolean WindowsサーバのBroadcast通信ログの抑止状態
groupLogFilterBroadcast boolean ブロードキャスト通信ログの抑止状態
availabilityZone string ゾーン情報

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=DescribeSecurityGroups
  &GroupName.1=group01
  &CommonParams

  

応答サンプル

    <DescribeSecurityGroupsResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <securityGroupInfo>
    <item>
      <ownerId/>
      <groupName>group1</groupName>
      <groupDescription>Security Group memo.</groupDescription>
      <groupStatus>applied</groupStatus>
      <ipPermissions>
        <item>
          <ipProtocol>TCP</ipProtocol>
          <fromPort>80</fromPort>
          <toPort>81</toPort>
          <inOut>IN</inOut>
          <ipRanges>
            <item>
              <cidrIp>0.0.0.0/0</cidrIp>
            </item>
          </ipRanges>
          <description>GroupMemoUpdate</description>
          <addDatetime>2016-01-27T11:11:39+09:00</addDatetime>
        </item>
        <item>
          <ipProtocol>TCP</ipProtocol>
          <fromPort>80</fromPort>
          <toPort>81</toPort>
          <inOut>IN</inOut>
          <groups>
            <item>
              <userId></userId>
              <groupName>group</groupName>
            </item>
          </groups>
          <description>GroupMemo</description>
          <addDatetime>2016-01-27T11:12:39+09:00</addDatetime>
        </item>
      </ipPermissions>
      <instancesSet>
        <item>
          <instanceId>server03</instanceId>
        </item>
      </instancesSet>
      <instanceUniqueIdsSet>
        <item>
          <instanceUniqueId>i-hrfg1234</instanceUniqueId>
        </item>
      </instanceUniqueIdsSet>
      <routerSet>
        <item>
          <routerId>rt-8db04f81</routerId>
          <routerName>router01</routerName>
        </item>
      </routerSet>
      <vpnGatewaySet>
        <item>
          <vpnGatewayId>vgw-cdj1124w</vpnGatewayId>
          <niftyVpnGatewayName>vpn1</niftyVpnGatewayName>
        </item>
      </vpnGatewaySet>
      <groupRuleLimit>10</groupRuleLimit>
      <groupLogLimit>1000</groupLogLimit>
      <groupLogFilterNetBios>false</groupLogFilterNetBios>
      <groupLogFilterBroadcast>true</groupLogFilterBroadcast>
      <availabilityZone>east-11</availabilityZone>
    </item>
  </securityGroupInfo>
</DescribeSecurityGroupsResponse>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上