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":...
   },
   :
   ]
}

属性データ型説明
serverUniqueKeystring1LPARが搭載されているブレードサーバを特定する識別子。
lparNointeger1LPAR番号。
lparNamestring1LPAR名。
vnicNointeger1仮想NIC番号。
macAddressstring1MACアドレス(書式: XX:XX:XX:XX:XX:XX)。
segmentstring1セグメント。
formattedSlotNostring1スロット番号を整形した文字列。
例: 'Mezzanine:X (Server Blade:XX)'
slotNostring1スロット番号。
例:'EXX'
pciDeviceNostring1PCIデバイス番号。仮想NICのネットワークセグメント識別子が'Vx'(例:'Va')の場合,空文字列。
portNostring1ポート番号。
vlanTagTypestring1VLANモード。VLANを使用しない場合OFFになります。
  • Tagged
  • Untagged
vlanIdstring1VLAN ID。複数のVLAN IDが設定されている場合,コンマで区切ってすべての値が列挙されます(書式:vlanId0[,vlanId1...])。
例:'1001,2003,3004,4007,4016'
promiscuousModestring1プロミスキャスモード。
  • Through
  • Restricted
txRateinteger1最大転送速度。セグメントがVF NICでない場合は'-1'。

リターンコード

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