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://computing.api.nifcloud.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>