本文へジャンプします。

ニフティクラウド APIリファレンス

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://cp.cloud.nifty.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>

ニフティクラウド サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフティクラウド公式フェイスブックページ

推奨画面サイズ 1024×768 以上