ページの先頭行へ戻る
ServerView Resource Orchestrator Cloud Edition V3.1.0 リファレンスガイド (API編)
ServerView
第2章 L-Platform APIリファレンス > 2.1 L-Platformテンプレートの操作 > 2.1.2 ListDiskImage (マスターイメージの一覧を取得)
前次

2.1.2 ListDiskImage (マスターイメージの一覧を取得)

仮想データセンター内にあるディスクイメージのIDを取得します。ディスクイメージのコンテンツに対応するProduct IDは、ディスクイメージを登録する際に指定します。

リクエストパラメーター

パラメーター名

項目

項目説明

Version

説明

L-Platform APIのバージョンID

型

string ASCII

設定内容

固定。"2.0"を指定してください。

Locale

説明

L-Platform APIと通信するための言語。ISO 639で規定されている言語コードを指定します。

型

string ASCII

設定内容

以下から選択します。
・"ja": 日本語
・"en": 英語

Action

説明

実行するL-Platform APIの名称

型

string ASCII

設定内容

固定。"ListDiskImage"を指定してください。

userId

説明

L-Platform APIを実行するユーザーID

型

string ASCII

設定内容

31文字以内

orgId

説明

L-Platform APIを実行するユーザーのテナント名

型

string ASCII

設定内容

32文字以内


レスポンス

《ステータスコード》

正常に終了した場合に"200 OK"を返します。

《XML》

<?xml version="1.0" encoding="UTF-8"?>
<ListDiskImageResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>[メッセージ]</responseMessage>
  <responseStatus>[ステータス]</responseStatus>
  <diskimages>
    <diskimage>
      <creatorName>[ディスクイメージの作成者のテナント名]</creatorName>
      <name>[ディスクイメージ情報の名称]</name>
      <diskimageId>[ディスクイメージID]</diskimageId>
      <diskimageName>[ディスクイメージ名]</diskimageName>
      <registrant>[ディスクイメージの登録者のID]</registrant>
      <size>[ディスクイメージのサイズ]</size>
      <maxCpuPerf>[最大CPU性能]</maxCpuPerf>
      <numOfMaxCpu>[最大CPU数]</numOfMaxCpu>
      <maxMemorySize>[最大メモリ量]</maxMemorySize>
      <numOfMaxDisk>[最大ディスク数]</numOfMaxDisk>
      <maxDiskSize>[最大ディスク容量]</maxDiskSize>
      <numOfMaxNic>[最大NIC数]</numOfMaxNic>
      <disks>
        <disk>
          <diskNo>[ディスク連番]</diskNo>
          <size>[ディスクサイズ]</size>
        </disk>
      </disks>
      <softwares>
        <software>
          <license>[ライセンス]</license>
          <name>[ソフトウェア名称]</name>
          <softwareId>[ソフトウェアID]</softwareId>
          <category>[ソフトウェア区分]</category>
          <osCategory>[OS区分]</osCategory>
          <version>[バージョン]</version>
          <officialVersion>[正式バージョン]</officialVersion>
          <patch>[パッチ版数]</patch>
          <support>[サポート]</support>
        </software>
      </softwares>
      <patches>
        <patch>
          <softwareId>[ソフトウェアID]</softwareId>
          <patchId>[パッチID]</patchId>
          <componentName>[コンポーネント名]</componentName>
          <description>[パッチの説明]</description>
        </patch>
      </patches>
    </diskimage>
  </diskimages>
</ListDiskImageResponse>

《要素》

要素名

項目

項目説明

ListDiskImageResponse

説明

レスポンスの情報を持つ要素

型

なし

出現回数

1

responseMessage

説明

メッセージ。リクエストが正しく処理されたかどうかを表します。
メッセージの詳細については、「メッセージ集」の「第16章 PAPIで始まるメッセージ」を参照してください。

型

string UTF-8

出現回数

1

responseStatus

説明

ステータス。リクエストが正常に処理されたかどうかを表します。正常に処理された場合は "SUCCESS" が返却されます。それ以外の場合はエラーコードが返却されます。
エラーコードの詳細については、「付録A レスポンスステータス・エラーコード一覧（L-Platform API）」を参照してください。

型

string ASCII

出現回数

1

diskimages

説明

ディスクイメージ情報のレスポンス情報を持つ要素

型

なし

出現回数

0または1

diskimage

説明

ディスクイメージ情報の一式

型

なし

出現回数

0以上

creatorName

説明

ディスクイメージ作成者のテナント名

型

string ASCII

出現回数

diskimageの数分(それぞれに対して0または1)

name

説明

ディスクイメージ情報の名称

型

string ASCII

出現回数

diskimageの数分(それぞれに対して0または1)

diskimageId

説明

ディスクイメージID

型

string ASCII

出現回数

diskimageの数分(それぞれに対して0または1)

diskimageName

説明

ディスクイメージ名

型

string ASCII

出現回数

diskimageの数分(それぞれに対して0または1)

registrant

説明

ディスクイメージの登録者のID

型

string ASCII

出現回数

diskimageの数分(それぞれに対して0または1)

size

説明

ディスクイメージのサイズ。単位は"GB"です。

型

decimal

出現回数

diskimageの数分(それぞれに対して0または1)

maxCpuPerf

説明

最大CPU性能

型

decimal

出現回数

diskimageの数分(それぞれに対して0または1)

numOfMaxCpu

説明

最大CPU数

型

int

出現回数

diskimageの数分(それぞれに対して0または1)

maxMemorySize

説明

最大メモリ量

型

decimal

出現回数

diskimageの数分(それぞれに対して0または1)

numOfMaxDisk

説明

最大ディスク数

型

int

出現回数

diskimageの数分(それぞれに対して0または1)

maxDiskSize

説明

最大ディスク容量

型

decimal

出現回数

diskimageの数分(それぞれに対して0または1)

numOfMaxNic

説明

最大NIC数

型

int

出現回数

diskimageの数分(それぞれに対して0または1)

softwares

説明

ソフトウェア情報のレスポンス情報を持つ要素

型

なし

出現回数

diskimageの数分(それぞれに対して0または1)

software

説明

ソフトウェア情報の一式

型

なし

出現回数

0以上

license

説明

ライセンス

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

name

説明

ソフトウェア名

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

softwareId

説明

ソフトウェアID

型

string ASCII

出現回数

softwareの数分(それぞれに対して0または1)

category

説明

ソフトウェア区分

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

osCategory

説明

OS区分

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

version

説明

バージョン

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

officialVersion

説明

正式バージョン

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

patch

説明

パッチ版数

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

support

説明

サポート

型

string UTF-8

出現回数

softwareの数分(それぞれに対して0または1)

patches

説明

パッチ情報のレスポンス情報を持つ要素

型

なし

出現回数

diskimageの数分(それぞれに対して0または1)

patch

説明

パッチ情報の一式

型

なし

出現回数

0以上

softwareId

説明

ソフトウェアID

型

string ASCII

出現回数

patchの数分(それぞれに対して0または1)

patchId

説明

パッチID

型

string ASCII

出現回数

patchの数分(それぞれに対して0または1)

componentName

説明

コンポーネント名

型

string UTF-8

出現回数

patchの数分(それぞれに対して0または1)

description

説明

パッチの説明

型

string UTF-8

出現回数

patchの数分(それぞれに対して0または1)

disks

説明

ディスク情報のレスポンス情報を持つ要素

型

なし

出現回数

diskimageの数分(それぞれに対して0または1)

disk

説明

ディスク情報の一式

型

なし

出現回数

0以上

diskNo

説明

ディスク連番

型

string ASCII

出現回数

diskの数分(それぞれに対して0または1)

size

説明

ディスクサイズ[GB]

型

string ASCII

出現回数

diskの数分(それぞれに対して0または1)


サンプルレスポンス

<?xml version="1.0" encoding="UTF-8"?>
 <ListDiskImageResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
  <diskimages>
    <diskimage>
      <creatorName>cfmgadm</creatorName>
      <diskimageId>image_id_1</diskimageId>
      <diskimageName>image-1</diskimageName>
      <maxCpuPerf>3.0</maxCpuPerf>
      <maxDiskSize>500.0</maxDiskSize>
      <maxMemorySize>4.0</maxMemorySize>
      <numOfMaxCpu>4</numOfMaxCpu>
      <numOfMaxDisk>3</numOfMaxDisk>
      <numOfMaxNic>1</numOfMaxNic>
      <disks>
        <disk>
          <diskNo>1</diskNo>
          <size>20.0</size>
        </disk>
      </disks>
      <patches>
        <patch>
          <componentName>INSERVEE</componentName>
          <description>JServlet緊急修正</description>
          <patchId>T000519WP-04</patchId>
          <softwareId>SW00000004</softwareId>
        </patch>
      </patches>
      <registrant>cfmgadm</registrant>
      <size>15.0</size>
      <softwares>
        <software>
          <category>APP</category>
          <license>Fujitsu</license>
          <name>Interstage Application Server(日本語版)</name>
          <officialVersion />
          <osCategory>windows</osCategory>
          <patch />
          <softwareId>SW00000004</softwareId>
          <support>SDK基本</support>
          <version>6.1</version>
        </software>
      </softwares>
    </diskimage>
  </diskimages>
</ListDiskImageResponse>

前次
Copyright 2011-2012 FUJITSU LIMITED