ニフクラAPI (コンピューティング: DescribeMultiIpAddressGroups)

DescribeMultiIpAddressGroups

処理概要

マルチIPアドレスグループの情報を取得します。1回のリクエストで、複数のマルチIPアドレスグループ情報を取得できます。

マルチIPアドレスグループの情報を指定するためには、マルチIPアドレスグループユニークIDが必要です。指定しない場合は、取得可能なすべてのマルチIPアドレスグループの情報を取得します。

指定するパラメーター

パラメーター	型	説明	必須
MultiIpAddressGroupId.n	string	マルチIPアドレスグループユニークID

応答フィールド

フィールド (項目)	型	説明
DescribeMultiIpAddressGroupsResponse	-	DescribeMultiIpAddressGroupsのレスポンス
␣requestId	string	リクエスト識別子
␣multiIpAddressGroupsSet	-	マルチIPアドレスグループ情報
␣␣item	-	マルチIPアドレスグループ情報
␣␣␣availabilityZone	string	ゾーン情報
␣␣␣createTime	string	作成日時
␣␣␣description	string	メモ情報(CDATA付)
␣␣␣instancesSet	-	マルチIPアドレスグループに紐づくサーバー情報
␣␣␣␣item	-	サーバー情報
␣␣␣␣␣instanceId	string	サーバー名
␣␣␣␣␣instanceUniqueId	string	サーバーユニークID
␣␣␣multiIpAddressGroupId	string	マルチIPアドレスグループユニークID
␣␣␣multiIpAddressGroupName	string	マルチIPアドレスグループ名
␣␣␣multiIpAddressNetwork	-	マルチIPアドレスグループネットワーク情報
␣␣␣␣defaultGateway	string	マルチIPアドレスグループネットワークのデフォルトゲートウェイ
␣␣␣␣ipAddressesSet	-	確保しているマルチIPアドレス情報
␣␣␣␣␣item	-	マルチIPアドレス情報
␣␣␣␣␣␣ipAddress	string	マルチIPアドレス
␣␣␣␣subnetMask	string	マルチIPアドレスグループネットワークのサブネットマスク
␣␣␣status	string	マルチIPアドレスグループのステータス 値: wait_create creating available wait_update updating wait_delete deleting error

リクエストサンプル

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

応答サンプル

    <DescribeMultiIpAddressGroupsResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>cec1c6a8-9642-413c-a741-2f56e9138b64</requestId>
  <multiIpAddressGroupsSet>
    <item>
      <availabilityZone>east-11</availabilityZone>
      <createTime>2019-09-30T20:58:23+09:00</createTime>
      <description>&lt;![CDATA[memo]]&gt;</description>
      <instancesSet>
        <item>
          <instanceId>server01</instanceId>
          <instanceUniqueId>i-0123abcd</instanceUniqueId>
        </item>
      </instancesSet>
      <multiIpAddressGroupId>mipag-0123abcd</multiIpAddressGroupId>
      <multiIpAddressGroupName>group01</multiIpAddressGroupName>
      <multiIpAddressNetwork>
        <defaultGateway>192.0.2.1</defaultGateway>
        <ipAddressesSet>
          <item>
            <ipAddress>192.0.2.2</ipAddress>
          </item>
        </ipAddressesSet>
        <subnetMask>255.255.0.0</subnetMask>
      </multiIpAddressNetwork>
      <status>available</status>
    </item>
  </multiIpAddressGroupsSet>
</DescribeMultiIpAddressGroupsResponse>