DescribeUploads
処理概要
アップロード中のタスク情報を返却します。
アップロードタスクを指定するためには、タスクIDが必要です。
タスクIDを指定した場合、指定したIDのアップロードタスクの情報が返されます。
タスクIDを指定しなかった場合は、現在アップロード・インポート中のすべてのタスクが返されます。
すでにインポートが完了したタスクやキャンセル済みのタスクなど、無効なタスクIDを指定した場合は、エラーが返されます。
指定するパラメーター
| パラメーター | 説明 | 必須 | サンプル値 |
|---|---|---|---|
| ConversionTaskId.n | タスクID Type : String |
応答フィールド
| フィールド(項目) | 説明 | サンプル値 |
|---|---|---|
| DescribeUploadsResponse | DescribeUploadsResponse レスポンス Type : DescribeUploadsResponse Ancestor : なし Children : uploads |
|
| uploads | アップロードタスクのセット Type : UploadSetType Ancestor : DescribeUploadsResponse Children : item |
|
| item | アップロードタスク Type : UploadItemType Ancestor : uploads Children : conversionTaskId, expirationTime, importInstance |
|
| conversionTaskId | アップロードタスクID Type : xsd:long Ancestor : item Children : なし |
d6f1ba72-0a76-4b1d-8421-a4f6089d3d7a |
| expirationTime | 破棄予定時刻 Type : xsd:string Ancestor : item Children : なし |
2012-02-19T18:50:32.986+09:00 |
| importInstance | インポートするサーバー情報 Type : UploadDetailType Ancestor : item Children : availabilityZone, image, instanceId |
|
| availabilityZone | ゾーン情報 Type : xsd:string Ancestor : importInstance Children : なし |
east-11 |
| image | イメージ詳細 Type : DiskImageDescriptionType Ancestor : importInstance Children : format, size |
|
| format | イメージフォーマット Type : xsd:string 値 : VMDK Ancestor : image Children : なし |
VMDK |
| size | イメージサイズ Type : xsd:integer Ancestor : image Children : なし |
|
| instanceId | サーバー名 Type : xsd:string Ancestor : importInstance Children : なし |
server04 |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/?Action=DescribeUploads&ConversionTaskId.1=d6f1ba72-0a76-4b1d-8421-a4f6089d3d7a&CommonParams
応答サンプル
<DescribeUploadsResponse xmlns="https://cp.cloud.nifty.com/api/">
<uploads>
<item>
<conversionTaskId>d6f1ba72-0a76-4b1d-8421-a4f6089d3d7a</conversionTaskId>
<expirationTime>2010-10-13T19:17:28.799+09:00</expirationTime>
<importInstance>
<availabilityZone>east-11</availabilityZone>
<image>
<format>VMDK</format>
<size>3489231321</size>
</image>
<instanceId>server01</instanceId>
</importInstance>
</item>
</uploads>
</DescribeUploadsResponse>
