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

DescribeIsoImages

処理概要

ISOイメージの情報を取得します。

ISOイメージIDを指定しない場合は、取得可能なすべてのISOイメージ情報を取得します。

絞り込み条件の項目の値「Filter.n.Value.m」を指定する際、ワイルドカード文字（曖昧検索）指定可能です。「∗」は0 個以上任意文字、「?」は1 個任意文字、「¥」はエスケープ変換文字（「¥∗niftycloud¥?¥¥ 」は「∗niftycloud?¥」を検索）となります。

指定するパラメーター

パラメーター	型	説明	必須
IsoImageId	string	ISOイメージID
Filter.n.Name	string	絞り込み条件の項目名 値: iso-image-id (ISOイメージID) iso-image-name (ISOイメージ名) availability-zone (ISOイメージのゾーン情報) description (ISOイメージのメモ情報)
Filter.n.Value.m	string	絞り込み条件の項目の値

応答フィールド

フィールド (項目)	型	説明
DescribeIsoImagesResponse	-	DescribeIsoImagesレスポンス
␣requestId	string	リクエスト識別子
␣isoImagesSet	-	ISOイメージの情報セット
␣␣item	-	ISOイメージの情報
␣␣␣isoImageId	string	ISOイメージID
␣␣␣isoImageName	string	ISOイメージ名
␣␣␣isoImageSize	string	ISOイメージのサイズ 単位: MB
␣␣␣status	string	ISOイメージの状態 値: processing (ISOイメージの処理中) available (ISOイメージが利用可能) expired (ISOイメージが保持期間切れ)
␣␣␣instancesSet	-	サーバーの情報セット
␣␣␣␣item	-	サーバーの情報
␣␣␣␣␣instanceId	string	サーバー名
␣␣␣␣␣instanceUniqueId	string	サーバーユニークID
␣␣␣description	string	メモ情報(CDATA付)
␣␣␣createdTime	string	作成日時 表示形式:yyyy-mm-ddThh:mi:ss+09:00
␣␣␣expiredTime	string	ISOイメージの有効期限日時 表示形式:yyyy-mm-ddThh:mi:ss+09:00
␣␣␣availabilityZone	string	ゾーン情報

リクエストサンプル

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

応答サンプル

    <DescribeIsoImagesResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>b8373eab-042c-47ee-b9c4-fb2b2bef8544</requestId>
  <isoImagesSet>
    <item>
      <isoImageId>iso-0k87jg18</isoImageId>
      <isoImageName>isoimage1</isoImageName>
      <isoImageSize>1940</isoImageSize>
      <status>available</status>
      <description/>
      <createdTime>2020-07-03T12:03:31+09:00</createdTime>
      <expiredTime>2020-07-04T12:03:31+09:00</expiredTime>
      <availabilityZone>east-13</availabilityZone>
    </item>
    <item>
      <isoImageId>iso-0glomi10</isoImageId>
      <isoImageName>isoimage2</isoImageName>
      <status>processing</status>
      <description><![CDATA[test]]></description>
      <availabilityZone>east-11</availabilityZone>
    </item>
  </isoImagesSet>
</DescribeIsoImagesResponse>