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

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

属性	データ型	数	説明
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 *：BE3/Skyhawkデバイス以外。FCoE非対応のファームウェアを使用した場合。 NIC：PeronaliryがNIC FCoE：PeronaliryがFCoE iSCSI：PeronaliryがiSCSI（not support） OTHER：その他（Custum, etc. not support）
allocation	string	1	NICの割り当てモード。 Share：共有モード。 Dedicate：占有モード。
status	string	1	PCIデバイスの状態。空の場合は正常。 Removed：削除された。 Error：障害閉塞。
assignedLparNo	integer	1	割り当てられたLPAR番号。ポートがどのLPARにも割り当てられていない場合は'-1'。
sharedNicNo	integer	1	共有NIC番号。
sharedNicSegment	string	1	共有NICセグメント。
portStatus	string	1	ポートの状態。 U：Link Up状態。 D：Link Down状態。 -：未定義状態。 E：障害。 *：状態が不明。
packetFilter	string	1	共有NICの通信パケットフィルタ情報。このNICが無効の場合，値は空文字列です。 Disable：通信量は内部LPARネットワークで制限されます。 Disable(ALL)：通信量のフィルタリングは無効です。 Enable：通信量は外部LPARネットワークで制限されます。
srIovSupport	string	1	SR-IOVサポート有無。 Disable Enable
vfMacAddressEditable	string	1	VF NICのMACアドレスを編集できるかどうか。 Disable：VF NICはMACアドレスを編集できません。 Enable：VF NICはMACアドレスを編集できます。
vfVlanUndeffEditable	string	1	VF NICのVLANモードをUndefに設定できるかどうか。 Disable：VF NICはUndefに設定できません。 Enable：VF NICはUndefに設定できます。
vfVlanTagEditable	string	1	VF NICのVLANモードをTaggedに設定できるかどうか。 Disable：VF NICはTaggedに設定できません。 Enable：VF NICはTaggedに設定できます。
vfVlanUntagEditable	string	1	VF NICのVLANモードをUntaggedに設定できるかどうか。 Disable：VF NICはUntaggedに設定できません。 Enable：VF NICはUntaggedに設定できます。
vfPrmThroughEditable	string	1	VF NICのプロミスキャスモードをThroughに設定できるかどうか。 Disable：VF NICはプロミスキャスモードをThroughに設定できません。 Enable：VF NICはプロミスキャスモードをThroughに設定できます。
vfPrmRestrictEditable	string	1	VF NICのプロミスキャスモードをRestrictedに設定できるかどうか。 Disable：VF NICはプロミスキャスモードをRestrictedに設定できません。 Enable：VF NICはプロミスキャスモードをRestrictedに設定できます。
vfTxRateEditable	string	1	VF NICで最大転送速度（TXRATE）を設定できるかどうか。 Disable：VF NICは最大転送速度（TXRATE）を設定できません。 Enable：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の同時最大接続数を超えました。

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

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