バックアップイメージの一覧取得
説明
バックアップイメージの一覧を取得します。
Request
ヘッダー
Accept: application/xml
X-Auth-Token: Keystoneのtoken(※1)
X-VA-Project-Id: リソース作成先プロジェクトのID(※2)
X-VA-Domain-Id: ソース作成先ドメインのID(※2)
※1 システム管理者がAPIを利用する場合はtokenに指定されたスコープは無視されます。
※2 システム管理者がAPIを利用する場合は指定必須。利用者が指定した場合は無視されます。
メソッド
GET
パス
/server_images
クエリ
引数名 | 説明 |
---|---|
verbose | 一部の情報のみ取得する場合はfalse、すべての情報を取得する場合はtrueを指定します。省略した場合は、falseになります。 |
mode | backupを指定します。 |
availability_zone |
バックアップイメージの一覧を取得するアベイラビリティゾーンの名前を指定します。 省略時は、すべてのアベイラビリティゾーンからバックアップイメージの一覧を取得します。 |
Response
ステータスコード
200 OK
ボディ
・verbose=false、mode=backupの場合
<ServerImages>
<ServerImage name="Image名1">
<Project>プロジェクトID</Project>
<AvailabilityZone>アベイラビリティーゾーン</AvailabilityZone>
<LServerLink name="仮想サーバ名"id="仮想サーバID"/>
</ServerImage>
<ServerImage name="Image名2">
<Project>プロジェクトID</Project>
<AvailabilityZone>アベイラビリティーゾーン</AvailabilityZone>
<LServerLink name="仮想サーバ名"id="仮想サーバID"/>
</ServerImage>
</ServerImages>
・verbose=true、mode=backupの場合
<ServerImages>
<ServerImage name="Image名1">
<Project>プロジェクトID</Project>
<AvailabilityZone>アベイラビリティーゾーン</AvailabilityZone>
<Comment>コメント</Comment>
<CreateTime>作成日時</CreateTime>
<LServerLink name="仮想サーバ名"id="仮想サーバID"/>
</ServerImage>
<ServerImage name="Image名2">
<Project>バックアップイメージを作成したプロジェクトのID</Project>
<AvailabilityZone>アベイラビリティーゾーン</AvailabilityZone>
<Comment>コメント</Comment>
<CreateTime>作成日時</CreateTime>
<LServerLink name="仮想サーバ名"id="仮想サーバID"/>
</ServerImage>
</ServerImages>
要素名 | 説明 | 取り得る値、または例 |
---|---|---|
Image名 | バックアップイメージの名前 | バックアップイメージ名 先頭半角英字で、半角英数字、アンダースコア(“_”)で構成された32文字以内の文字列 |
プロジェクトID | バックアップイメージを作成したプロジェクトのID | プロジェクトのID |
アベイラビリティゾーン | 仮想サーバが存在するアベイラビリティゾーン名 | アベイラビリティゾーン名 |
仮想サーバ名 | バックアップ対象の仮想サーバ名 | 仮想サーバ名 先頭半角英字で、半角英数字、アンダースコア(“_”)で構成された32文字以内の文字列 |
仮想サーバID | バックアップ対象の仮想サーバのID | バックアップした仮想サーバの仮想サーバID |
コメント | バックアップイメージのコメント | パーセント("%")、円マーク("\")、ダブルクォーテーション( " )、および改行以外の文字で日本語、半角文字に関係なく96文字以内の文字列。 |
作成日時 | バックアップイメージを作成した日時(ローカルタイム) | YYYY-MM-DD-hh:mm:ss±hh:mm |