Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


19.3 チャネルボードの情報を取得する

チャネルボードの情報を一覧で取得します。
メモ
  • このAPIは、ストレージシステムがVSP 5000 シリーズVSP E シリーズVSP Gx00 モデルVSP G1000VSP G1500VSP Fx00 モデルVSP F1500の場合に使用できます。VSP E シリーズVSP G150、G350、G370、G700、G900VSP F350、F370、F700、F900の場合、SVP と連携する構成のときに使用できます。
  • ストレージシステムによっては、チャネルボードはチャネルアダプタに読み替えてください。

  • 最新の情報を取得する場合、事前にストレージシステムの構成情報のキャッシュを更新するAPI を実行する必要があります。詳細については、「ストレージシステムの構成情報のキャッシュを更新する」の説明を参照してください。

ヒント

ストレージシステムがVSP G100、G200、G400、G600、G800VSP F400、F600、F800の場合、またはストレージシステムがVSP E シリーズVSP G150、G350、G370、G700、G900VSP F350、F370、F700、F900でSVPと連携する構成の場合、チャネルボードの情報は、ストレージシステムに搭載されたハードウェアの情報を取得するAPIでも取得できます。

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/components/instance

上記のAPIでチャネルボードの情報を取得する場合、付加情報を取得するためのクエリパラメータの指定は不要です。

実行権限

ストレージ管理者(参照)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/channel-boards

リクエストメッセージ

オブジェクトID
なし。
クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "data" : [ {
    "channelBoardId" : 3,
    "location" : "CHB-01F",
    "clusterNumber" : 1,
    "channelBoardNumber" : 3,
    "channelBoardType" : "FIBRE",
    "numOfPorts" : "4Port",
    "maxPortSpeed" : "32G",
    "cableMaterial" : "-"
  }, {
    "channelBoardId" : 7,
    "location" : "CHB-02F",
    "clusterNumber" : 2,
    "channelBoardNumber" : 3,
    "channelBoardType" : "FIBRE",
    "numOfPorts" : "4Port",
    "maxPortSpeed" : "32G",
    "cableMaterial" : "-"
  } ]
}

属性

説明

channelBoardId

int

チャネルボードのID

location

string

チャネルボードの場所

clusterNumber

int

チャネルボードのクラスタの番号

channelBoardNumber

int

チャネルボードの番号

クラスタ内で一意の番号を持ちます。

channelBoardType

string

チャネルボードに実装されているポートの種類

  • FICON
  • FIBRE
  • FCoE
  • ISCSI
  • NAS

numOfPorts

string

チャネルボードに実装されているポートの数

  • 2Port
  • 4Port
  • 8Port
  • -

情報が取得できない場合は、-(ハイフン)が出力されます。

maxPortSpeed

string

チャネルボードに実装されているポートのデータ伝送速度

  • 8G
  • 10G
  • 16G
  • 32G
  • -

情報が取得できない場合は、-(ハイフン)が出力されます。

cableMaterial

string

チャネルボードに実装されているポートに利用できるケーブルの素材

  • Optical
  • Copper
  • -

ケーブルの素材の種別情報がない場合は、-(ハイフン)が出力されます。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/900000012345/channel-boards