本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/cp/api/DescribeVolumes.htmへ移行しました。 今後は新ページをご参照ください。

DescribeVolumes

処理概要

指定したディスクの情報を取得します。

ディスクを指定するためには、ディスク名が必要です。
削除済みのディスクを指定した、管理外のディスクを指定したなど、無効なディスクを指定した場合は、エラーが返されます。

ディスクを指定しない場合、取得できるすべてのディスク情報を取得します。

指定するパラメーター

パラメーター 説明 必須
VolumeId.n string ディスク名

応答フィールド

フィールド (項目) 説明
DescribeVolumesResponse - DescribeVolumesレスポンス
requestId string リクエスト識別子
volumeSet - 取得したディスクの情報セット
item - 取得したディスクの情報
volumeId string ディスク名
volumeUniqueId string ディスクユニークID
size string ディスクサイズ
単位: GB
diskType string ディスクタイプ
値:
  • Standard Storage (標準ディスク)
  • High-Speed Storage A (高速ディスクA)
  • High-Speed Storage B (高速ディスクB)
  • Flash Storage (フラッシュドライブ)
  • Standard Flash Storage A (標準フラッシュドライブA)
  • Standard Flash Storage B (標準フラッシュドライブB)
  • High-Speed Flash Storage A (高速フラッシュドライブA)
  • High-Speed Flash Storage B (高速フラッシュドライブB)
snapshotId string ※返却値なし
availabilityZone string ゾーン名
status string 作成ステータス
値:
  • in-use (接続済み)
  • creating (作成中)
  • available (利用可能)
  • wait_configure (設定待ち)
  • configuring (設定中)
createTime timestamp ディスク作成日時
表示形式:yyyy-mm-ddThh:mi:ss.sss+09:00
accountingType string 利用料金タイプ
値:
  • 1 (月額課金)
  • 2 (従量課金)
nextMonthAccountingType string 次月からの利用料金タイプ
値:
  • 1 (月額課金)
  • 2 (従量課金)
attachmentSet - 接続しているサーバーの情報セット
item - 接続しているサーバーの情報
volumeId string ディスク名
volumeUniqueId string ディスクユニークID
instanceId string サーバー名
instanceUniqueId string サーバーユニークID
device string ※空を返却
ディスクの接続デバイス
status string 接続ステータス
値:
  • attached (接続済み)
  • attaching (接続中)
attachTime string ディスク接続日時
表示形式:yyyy-mm-ddThh:mi:ss.sss+09:00
deleteOnTermination string サーバー削除時のディスク削除
値:
  • false (削除しない)
description string メモ

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=DescribeVolumes
  &CommonParams

  

応答サンプル

    <DescribeVolumesResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <volumeSet>
    <item>
      <volumeId>disk01</volumeId>
      <volumeUniqueId>vol-abfd1234</volumeUniqueId>
      <size>200</size>
      <diskType>High-Speed Storage A</diskType>
      <snapshotId/>
      <availabilityZone>east-11</availabilityZone>
      <accountingType>1</accountingType>
      <nextMonthAccountingType>1</nextMonthAccountingType>
      <status>in-use</status>
      <createTime>2020-07-27T11:22:33.456+09:00</createTime>
      <attachmentSet>
        <item>
          <volumeId>disk01</volumeId>
          <volumeUniqueId>vol-abfd1234</volumeUniqueId>
          <instanceId>server01</instanceId>
          <instanceUniqueId>i-efgj1234</instanceUniqueId>
          <device/>
          <status>attached</status>
          <attachTime>2020-07-27T11:22:33.456+09:00</attachTime>
          <deleteOnTermination>false</deleteOnTermination>
        </item>
      </attachmentSet>
      <description>Memo</description>
    </item>
  </volumeSet>
</DescribeVolumesResponse>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

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