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

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

4.4 仮想NICポートの情報を取得する

instanceIDに指定したLPARの仮想NICポートの情報を取得します。

ロール

Admin/Modify/View

リクエストライン

GET http://＜host＞:＜port＞/ComputeSystemsManager/v1/objects/Lpars/＜instanceID＞/collections/Virtualnicport

instanceID:
serverUniqueKey＋"_"＋LPAR番号をbase64urlでエンコードした文字列。

リクエストボディー

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

レスポンスボディー

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

LparVirtualNICPort 

{
    "LparVirtualNICPort":[{
        "serverUniqueKey":"...",
        "lparNo":...,
        "lparName":"...",
        "vnicNo":...,
        "macAddress":"...",
        "segment":"...",
        "formattedSlotNo":"...",
        "slotNo":"...",
        "pciDeviceNo":"...",
        "portNo":"...",
        "vlanTagType":"...",
        "vlanId":"...",
        "promiscuousMode":"...",
        "txRate":...
    },
    :
    ]
}
属性 データ型 数 説明
serverUniqueKey string 1 LPARが搭載されているブレードサーバを特定する識別子。
lparNo integer 1 LPAR番号。
lparName string 1 LPAR名。
vnicNo integer 1 仮想NIC番号。
macAddress string 1 MACアドレス（書式： XX:XX:XX:XX:XX:XX）。
segment string 1 セグメント。
formattedSlotNo string 1 スロット番号を整形した文字列。
例： 'Mezzanine:X (Server Blade:XX)'
slotNo string 1 スロット番号。
例：'EXX'
pciDeviceNo string 1 PCIデバイス番号。仮想NICのネットワークセグメント識別子が'Vx'（例：'Va'）の場合，空文字列。
portNo string 1 ポート番号。
vlanTagType string 1 VLANモード。VLANを使用しない場合OFFになります。
  • Tagged
  • Untagged
vlanId string 1 VLAN ID。複数のVLAN IDが設定されている場合，コンマで区切ってすべての値が列挙されます（書式：vlanId0[,vlanId1...]）。
例：'1001,2003,3004,4007,4016'
promiscuousMode string 1 プロミスキャスモード。
  • Through
  • Restricted
txRate integer 1 最大転送速度。セグメントがVF NICでない場合は'-1'。

リターンコード

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.