19.3　チャネルボードの情報を取得する : Hitachi Command Suite Configuration Manager REST API リファレンスガイド

メモ

このAPIは、ストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP G1000、VSP G1500、VSP Fx00 モデル、VSP F1500の場合に使用できます。VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合、SVP と連携する構成のときに使用できます。
ストレージシステムによっては、チャネルボードはチャネルアダプタに読み替えてください。
最新の情報を取得する場合、事前にストレージシステムの構成情報のキャッシュを更新するAPI を実行する必要があります。詳細については、「ストレージシステムの構成情報のキャッシュを更新する」の説明を参照してください。

ヒント

ストレージシステムがVSP G100、G200、G400、G600、G800、VSP F400、F600、F800の場合、またはストレージシステムがVSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP 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

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

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