Drive情報の取得

GET /drive/{drive_id}

概要説明

Drive情報を取得します。

リクエスト例

  • Drive ID 0204 のDriveについて、Drive ID、ステータス、Capacityのみを取得する場合の例です。

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/drive/0204?fields=status,capacity"

レスポンス例

{
  "drive_id": "010a",
  "drive_href": "/api/v1/drive/010a",
  "enclosure_id": "01",
  "ce_id": "0",
  "de_id": "01",
  "slot": 10,
  "status": "Normal",
  "detail_status": "Available",
  "capacity": 300,
  "speed": 15000,
  "drive_type": "Online",
  "is_advanced_format": false,
  "is_hotspare": false,
  "is_dedicated": true,
  "allocated_raidgroup_href": "/api/v1/raidgroup/1",
  "health": 0,
  "rebuild_copyback_progress": 0,
  "vendor_id": "FUJITSU",
  "product_id": "PRODUCT-00000001",
  "serial_number": "SERIAL-000000001",
  "wwn": "0000000000000000",
  "internal_id": "000000000000000000000000000000000000000000000000",
  "firmware_revision": "REV-0001"
}

Parameters

PATH PARAMETERS

drive_id

(required)

string

Drive ID。

Formatは以下です。

  • CE搭載Drive w0yy

    • w - 16進 CE ID (0～b)

    • yy - 16進 Slot Id (00～17)

  • DE搭載Drive xxyy

    • xx - 16進 DE ID (00～ff)

    • yy - 16進 Slot Id (00～17)

QUERY PARAMETERS

fields

Array of strings

表示したいParameter。

指定したParameter名(Response Body Parameter)の情報のみを抜き出して取得します。

指定方法の詳細は、表示する項目の絞り込みを参照してください。

Responses

正常に取得できた場合、HTTPステータスコードが200 (OK)となりレスポンスボディを応答します。

RESPONSE BODY

drive_id

string

Drive ID。

Formatは以下です。

  • CE搭載Drive w0yy

    • w - 16進 CE ID (0～b)

    • yy - 16進 Slot Id (00～17)

  • DE搭載Drive xxyy

    • xx - 16進 DE ID (00～ff)

    • yy - 16進 Slot Id (00～17)
drive_href

string

DriveのResourceへのLink。
enclosure_id

string

Driveが積載されているEnclosure (CE or DE)のID。

DEの場合、DE IDと一致します。

CEの場合、CE IDに0を付与したものがEnclosure IDとなります。

例えば、CE#1のEnclosure IDは"10"です。
ce_id

string

Driveが搭載されているCEのID。

DriveがCEに搭載されている場合に応答します。

フォーマットは16進数1桁です。
de_id

string

Driveが搭載されているDEのID。

DriveがDEに搭載されている場合に応答します。

フォーマットは16進数2桁です。
slot

integer

Driveが搭載されているSlot Number。

10進表示です。
status

string

ステータス。
項目 説明
Normal 正常状態です。
Unused 実装されていますが、未使用状態です。
Maintenance 保守状態です。
Warning 予防保守が必要な状態です。
Error 異常が発生し、保守が必要な状態です。
detail_status

string

詳細ステータス。
項目 説明
Available Driveは正常状態です。DriveはRAID Groupなどに使用されています。
Spare DriveはHotspareとして登録されています。
Present Driveは未使用です。
Readying Drive起動中です。
Rebuild-Copyback DriveはRebuild / Copyback中です。
Redundant_Copy DriveはRedundant Copy中です。
Not_Supported Driveはサポート対象外です。
Not_Exist Driveは認識できなくなりました。
Failed_Usable DriveにRAID Group故障を伴う障害が発生しました。
Broken Driveに障害が発生しました。
capacity

integer

Driveの容量。

単位はGBです。

製品上の容量とは異なります。
speed

integer

Driveの回転数。

単位はrpmです。

Driveの種別がSAS SSD、SAS SSD SED、NVMe SSD、またはNVMe SSD SEDの場合は応答しません。
drive_type

string

Driveの種別。
項目 説明
Online Online HDD
Nearline Nearline HDD
SSD SAS SSD
NVMe_SSD NVMe SSD
Online_SED Online HDD SED
Nearline_SED Nearline HDD SED
SSD_SED SAS SSD SED
NVMe_SSD_SED NVMe SSD SED
is_advanced_format

boolean

Advanced Format対応Driveかどうか。

Driveの種別がSAS SSD、SAS SSD SED、NVMe SSD、またはNVMe SSD SEDの場合は応答しません。
is_hotspare

boolean

Hot Spare登録Driveかどうか。
is_dedicated

boolean

Dedicated Hot Spare登録Driveかどうか。

is_hotspareがtrueの場合に応答します。

trueの場合は、Dedicated Hot Spareとして登録されていることを表し、falseの場合は、Global Hot Spareとして登録されていることを表します。
allocated_raidgroup_href

string

Driveが構成しているRAID GroupへのLink。

DriveがRAID Groupの構成Driveだった場合(Dedicated Hot Spareも含みます)にRAID GroupへのLinkを応答します。

RAID Groupを構成していないDriveの場合は、応答しません。

テナントユーザーで、自テナントに属するRAID Groupを構成していないDriveの場合は応答しません。
allocated_resource_href

string

Driveが構成しているResourceへのLink。

DriveがThin Provisioning Poolの構成Driveだった場合に、Thin Provisioning PoolへのLinkを応答します。

DriveがFlexible Tier Poolの構成Driveだった場合に、Flexible Tier PoolへのLinkを応答します。

DriveがRAID Groupの構成Driveだった場合(Dedicated Hot Spareも含みます)に、RAID GroupへのLinkを応答します。

未使用のDriveの場合は、応答しません。

テナントユーザーで、自テナントに属するResourceを構成していないDriveの場合は応答しません。
health

integer

Driveの残り使用可能量(寿命)。

残り使用可能量が少なくなっていくにつれて、値は低くなっていきます。

単位は%です。

Driveの種別がSAS SSD、SAS SSD SED、NVMe SSD、またはNVMe SSD SEDの場合に応答されます。

ただし、Data消去中、または使用可能量を取得できなかった場合は応答されません。
rebuild_copyback_progress

integer

RebuildまたはCopybackの進捗率。

単位は%です。

RebuildまたはCopybackが実行中の場合、応答されます。
vendor_id

string

Driveの製造社名。
product_id

string

Driveの製品名。
serial_number

string

Driveの製造番号。
wwn

string

DriveのWWN。

Driveの種別がNVMe SSDまたはNVMe SSD SEDの場合は応答しません。
internal_id

string

DriveのInternal ID。

Driveの種別がNVMe SSDまたはNVMe SSD SED以外の場合は応答しません。
firmware_revision

string

DriveのFirmware revision。