instanceIDに指定したブレードサーバ上のHVMの,NICポートの情報を取得します。
ロール
Admin/Modify/View
リクエストライン
GET http://<host>:<port>/ComputeSystemsManager/v1/objects/Blades/<instanceID>/collections/LpNicport
リクエストボディー
リクエストボディーには何も設定しません。
レスポンスボディー
レスポンスボディーの構造とオブジェクトの属性を次に示します。
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":...
},
:
]
}
属性 | データ型 | 数 | 説明 |
---|---|---|---|
serverUniqueKey | string | 1 | LPARが搭載されているブレードサーバを特定する識別子。 |
pciDeviceNo | integer | 1 | PCI番号。 |
vendor | string | 1 | PCIデバイスのベンダー名。 |
deviceName | string | 1 | デバイス名。 |
formattedSlotNo | string | 1 | スロット番号を整形した文字列。 例:'Mezzanine:X (Server Blade:XX)' |
slotNo | string | 1 | スロット番号。 例:'EXX' |
portNo | string | 1 | ポート番号。 |
busNo | string | 1 | バス番号。 |
devNo | string | 1 | デバイス番号。 |
funcNo | integer | 1 | ファンクション番号。 |
personality | string | 1 | Personality
|
allocation | string | 1 | NICの割り当てモード。
|
status | string | 1 | PCIデバイスの状態。空の場合は正常。
|
assignedLparNo | integer | 1 | 割り当てられたLPAR番号。ポートがどのLPARにも割り当てられていない場合は'-1'。 |
sharedNicNo | integer | 1 | 共有NIC番号。 |
sharedNicSegment | string | 1 | 共有NICセグメント。 |
portStatus | string | 1 | ポートの状態。
|
packetFilter | string | 1 | 共有NICの通信パケットフィルタ情報。このNICが無効の場合,値は空文字列です。
|
srIovSupport | string | 1 | SR-IOVサポート有無。
|
vfMacAddressEditable | string | 1 | VF NICのMACアドレスを編集できるかどうか。
|
vfVlanUndeffEditable | string | 1 | VF NICのVLANモードをUndefに設定できるかどうか。
|
vfVlanTagEditable | string | 1 | VF NICのVLANモードをTaggedに設定できるかどうか。
|
vfVlanUntagEditable | string | 1 | VF NICのVLANモードをUntaggedに設定できるかどうか。
|
vfPrmThroughEditable | string | 1 | VF NICのプロミスキャスモードをThroughに設定できるかどうか。
|
vfPrmRestrictEditable | string | 1 | VF NICのプロミスキャスモードをRestrictedに設定できるかどうか。
|
vfTxRateEditable | string | 1 | VF NICで最大転送速度(TXRATE)を設定できるかどうか。
|
vfTxRateMax | integer | 1 | 最大転送速度(TXRATE)の最大値。srIovSupportが'Disable'の場合は'-1'。 |
vfTxRateMin | integer | 1 | 最大転送速度(TXRATE)の最小値。srIovSupportが'Disable'の場合は'-1'。 |
vfTxRateStep | integer | 1 | 最大転送速度(TXRATE)の間隔。srIovSupportが'Disable'の場合は'-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の同時最大接続数を超えました。 |