2.7 HVMのNICポートの情報を取得する

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

ロール

Admin/Modify/View

リクエストライン

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

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

リクエストボディー

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

レスポンスボディー

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

ServerLpNICPort

{
   "ServerLpNICPort":[{
       "serverUniqueKey":"...",
       "pciDeviceNo":...,
       "vendor":"...",
       "deviceName":"...",
       "formattedSlotNo":"...",
       "slotNo":"...",
       "portNo":"...",
       "busNo":"...",
       "devNo":"...",
       "funcNo":...,
       "personality":"...",
       "allocation":"...",
       "status":"...",
       "assignedLparNo":...,
       "sharedNicNo":...,
       "sharedNicSegment":"...",
       "portStatus":"...",
       "packetFilter":"...",
       "srIovSupport":"...",
       "vfMacAddressEditable":"...",
       "vfVlanUndeffEditable":"...",
       "vfVlanTagEditable":"...",
       "vfVlanUntagEditable":"...",
       "vfPrmThroughEditable":"...",
       "vfPrmRestrictEditable":"...",
       "vfTxRateEditable":"...",
       "vfTxRateMax":...,
       "vfTxRateMin":...,
       "vfTxRateStep":...
   },
   :
   ]
}

属性データ型説明
serverUniqueKeystring1LPARが搭載されているブレードサーバを特定する識別子。
pciDeviceNointeger1PCI番号。
vendorstring1PCIデバイスのベンダー名。
deviceNamestring1デバイス名。
formattedSlotNostring1スロット番号を整形した文字列。
例:'Mezzanine:X (Server Blade:XX)'
slotNostring1スロット番号。
例:'EXX'
portNostring1ポート番号。
busNostring1バス番号。
devNostring1デバイス番号。
funcNointeger1ファンクション番号。
personalitystring1Personality
  • *:BE3/Skyhawkデバイス以外。FCoE非対応のファームウェアを使用した場合。
  • NIC:PeronaliryがNIC
  • FCoE:PeronaliryがFCoE
  • iSCSI:PeronaliryがiSCSI(not support)
  • OTHER:その他(Custum, etc. not support)
allocationstring1NICの割り当てモード。
  • Share:共有モード。
  • Dedicate:占有モード。
statusstring1PCIデバイスの状態。空の場合は正常。
  • Removed:削除された。
  • Error:障害閉塞。
assignedLparNointeger1割り当てられたLPAR番号。ポートがどのLPARにも割り当てられていない場合は'-1'。
sharedNicNointeger1共有NIC番号。
sharedNicSegmentstring1共有NICセグメント。
portStatusstring1ポートの状態。
  • U:Link Up状態。
  • D:Link Down状態。
  • -:未定義状態。
  • E:障害。
  • *:状態が不明。
packetFilterstring1共有NICの通信パケットフィルタ情報。このNICが無効の場合,値は空文字列です。
  • Disable:通信量は内部LPARネットワークで制限されます。
  • Disable(ALL):通信量のフィルタリングは無効です。
  • Enable:通信量は外部LPARネットワークで制限されます。
srIovSupportstring1SR-IOVサポート有無。
  • Disable
  • Enable
vfMacAddressEditablestring1VF NICのMACアドレスを編集できるかどうか。
  • Disable:VF NICはMACアドレスを編集できません。
  • Enable:VF NICはMACアドレスを編集できます。
vfVlanUndeffEditablestring1VF NICのVLANモードをUndefに設定できるかどうか。
  • Disable:VF NICはUndefに設定できません。
  • Enable:VF NICはUndefに設定できます。
vfVlanTagEditablestring1VF NICのVLANモードをTaggedに設定できるかどうか。
  • Disable:VF NICはTaggedに設定できません。
  • Enable:VF NICはTaggedに設定できます。
vfVlanUntagEditablestring1VF NICのVLANモードをUntaggedに設定できるかどうか。
  • Disable:VF NICはUntaggedに設定できません。
  • Enable:VF NICはUntaggedに設定できます。
vfPrmThroughEditablestring1VF NICのプロミスキャスモードをThroughに設定できるかどうか。
  • Disable:VF NICはプロミスキャスモードをThroughに設定できません。
  • Enable:VF NICはプロミスキャスモードをThroughに設定できます。
vfPrmRestrictEditablestring1VF NICのプロミスキャスモードをRestrictedに設定できるかどうか。
  • Disable:VF NICはプロミスキャスモードをRestrictedに設定できません。
  • Enable:VF NICはプロミスキャスモードをRestrictedに設定できます。
vfTxRateEditablestring1VF NICで最大転送速度(TXRATE)を設定できるかどうか。
  • Disable:VF NICは最大転送速度(TXRATE)を設定できません。
  • Enable:VF NICは最大転送速度(TXRATE)を設定できます。
vfTxRateMaxinteger1最大転送速度(TXRATE)の最大値。srIovSupportが'Disable'の場合は'-1'。
vfTxRateMininteger1最大転送速度(TXRATE)の最小値。srIovSupportが'Disable'の場合は'-1'。
vfTxRateStepinteger1最大転送速度(TXRATE)の間隔。srIovSupportが'Disable'の場合は'-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の同時最大接続数を超えました。