Compute Systems Manager REST API リファレンスガイド

[目次][前へ][次へ]


2.9 HVMのUSBの情報を取得する

instanceIDに指定したブレードサーバ上のHVMの,USBの情報を取得します。

ロール

Admin/Modify/View

リクエストライン

GET http://<host>:<port>/ComputeSystemsManager/v1/objects/Blades/<instanceID>/collections/LpUsb

instanceID:
serverUniqueKeyをbase64urlでエンコードした文字列。

リクエストボディー

リクエストボディーには何も設定しません。

レスポンスボディー

レスポンスボディーの構造とオブジェクトの属性を次に示します。

ServerLpUSB

{
    "ServerLpUSB":[{
        "serverUniqueKey":"...",
        "pciDeviceNo":...,
        "vendor":"...",
        "deviceName":"...",
        "portNo":"...",
        "busNo":"...",
        "devNo":"...",
        "funcNo":...,
        "assignedLparNo":...,
        "usbAutoAssignment":"..."
    },
    :
    ]
}
属性 データ型 説明
serverUniqueKey string 1 LPARが搭載されているブレードサーバを特定する識別子。
pciDeviceNo integer 1 PCI番号。
vendor string 1 PCIデバイスのベンダー名。
deviceName string 1 デバイス名。
portNo string 1 ポート番号。
busNo string 1 バス番号。
devNo string 1 デバイス番号。
funcNo integer 1 ファンクション番号。
assignedLparNo integer 1 割り当てられたLPAR番号。USBがどのLPARにも割り当てられていない場合には'-1'。
usbAutoAssignment string 1 USBの自動アタッチ機能の設定。
  • 整数値:USBがアタッチされているLPAR番号を示します。
  • AnyLPAR:LPARのActivate時にUSBを自動的にアタッチします。
  • None:設定したLPARにだけ,USBを自動的にアタッチします。

リターンコード

HTTPステータスコード 結果コード 詳細コード 説明
200 - - 正常終了。
204 - - 指定したinstanceIDまたはcollectionはありません。
401 1000 1 HTTPヘッダーのAuthorizationが指定されていません。
401 1000 2 HTTPヘッダーのAuthorizationの値が不正です(Basic認証,HSSOセッション認証のどちらでもありません)。
401 1000 3 HTTPヘッダーのAuthorizationのBasic認証の値が不正です(認証情報のフォーマットが不正です)。
401 1000 4 ログインに失敗しました。
401 1002 1 ログインセッションが切断されました。または,不正なHSSOトークンが指定されました。
403 1003 1 基本ライセンスが登録されていない,または有効期限を過ぎています。
403 1003 100 論理分割の機能を使用するためのプラグインライセンスがありません。
403 2017 1 管理対象を参照または操作する権限がありません。
405 - - サポートされていないメソッドです。
406 2010 1 HTTPヘッダーのAcceptの値が不正です。
415 - - HTTPヘッダーのContent-Typeにサポートされていない形式が指定されています。
500 - - HTTPヘッダーのContent-Typeに不正な値が指定されている,またはそれ以外の内部エラーです。
500 1000 1 ログインに失敗しました(内部エラー)。
500 3000 100 内部エラーが発生しました。
503 2020 1 要求の数がAPIの同時最大接続数を超えました。

[目次] [前へ] [次へ]


All Rights Reserved. Copyright© 2016, Hitachi, Ltd.