ページの先頭行へ戻る
Systemwalker Software Configuration Manager V14g リファレンスガイド
Systemwalker
第7章 CFMG API > 7.3 CFMG APIリファレンス > 7.3.4 増設ディスクの操作
前次

7.3.4 増設ディスクの操作

増設ディスクの操作に関連するCFMG APIについて説明します。

7.3.4.1 CreateVDisk

仮想マシンに新規の拡張ディスクを取り付けます。

リクエストパラメーター

パラメーター名

項目

項目説明

Version

説明

CFMG APIのバージョンID

型

string ASCII

設定内容

固定。「1.0」を指定してください。

Locale

説明

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

型

string ASCII

設定内容

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

Action

説明

実行するCFMG APIの名称

型

string ASCII

設定内容

固定。「CreateVDisk」を指定してください。

userId

説明

CFMG APIを実行するユーザーID

型

string ASCII

設定内容

31文字以内

orgId

説明

CFMG APIを実行するユーザーの組織ID

型

string ASCII

設定内容

8文字以内

vsysId

説明

システムID

型

string ASCII

設定内容

32文字以内

vserverId

説明

仮想マシンID

型

string ASCII

設定内容

32文字以内

vdiskSize

説明

取り付ける拡張ディスクサイズ。「GB」単位で小数点第一位まで指定できます。

型

decimal

設定内容

0.1～99999.9

vdiskName

説明

取り付ける拡張ディスクの名前

型

string UTF-8

設定内容

85文字以内

[storagePool]

説明

拡張ディスクを作成するストレージプールのリソース名

型

string ASCII

設定内容

32文字以内


レスポンス

《ステータスコード》

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


《XML》

<?xml version="1.0" encoding="UTF-8"?>
<AttachVDiskResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>[メッセージ]</responseMessage>
  <responseStatus>[ステータス]</responseStatus>
  <vdiskId>[作成されたディスクID]</vdiskId>
</AttachVDiskResponse>

《要素》

要素名

項目

項目説明

AttachVDiskResponse

説明

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

型

なし

出現回数

1

responseMessage

説明

メッセージ。リクエストが正しく処理されたかどうかを表します。
メッセージの詳細については、『メッセージ集』の「CFMG APIが出力するメッセージ」を参照してください。

型

string UTF-8

出現回数

1

responseStatus

説明

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

型

string ASCII

出現回数

1

vdiskId

説明

この操作により作成されたディスクID

型

string ASCII

出現回数

0または1


サンプルレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<AttachVDiskResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
  <vdiskId>VDISK000001</vdiskId>
</AttachVDiskResponse>

7.3.4.2 DestroyVDisk

仮想マシンに取り付けられている拡張ディスクを取り外します。

リクエストパラメーター

パラメーター名

項目

項目説明

Version

説明

CFMG APIのバージョンID

型

string ASCII

設定内容

固定。「1.0」を指定してください。

Locale

説明

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

型

string ASCII

設定内容

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

Action

説明

実行するCFMG APIの名称

型

string ASCII

設定内容

固定。「DestroyVDisk」を指定してください。

userId

説明

CFMG APIを実行するユーザーID

型

string ASCII

設定内容

31文字以内

orgId

説明

CFMG APIを実行するユーザーの組織ID

型

string ASCII

設定内容

8文字以内

vsysId

説明

システムID

型

string ASCII

設定内容

32文字以内

vserverId

説明

仮想マシンID

型

string ASCII

設定内容

32文字以内

vdiskId

説明

取り外す拡張ディスクID

型

string ASCII

設定内容

32文字以内


レスポンス

《ステータスコード》

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


《XML》

<?xml version="1.0" encoding="UTF-8"?>
<DestroyVDiskResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>[メッセージ]</responseMessage>
  <responseStatus>[ステータス]</responseStatus>
</DestroyVDiskResponse>

《要素》

要素名

項目

項目説明

DestroyVDiskResponse

説明

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

型

なし

出現回数

1

responseMessage

説明

メッセージ。リクエストが正しく処理されたかどうかを表します。
メッセージの詳細については、『メッセージ集』の「CFMG APIが出力するメッセージ」を参照してください。

型

string UTF-8

出現回数

1

responseStatus

説明

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

型

string ASCII

出現回数

1


サンプルレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<DetachVDiskResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</DetachVDiskResponse>
前次
Copyright 2010-2011 FUJITSU LIMITED