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

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

ロール

Admin/Modify/View

リクエストライン

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

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

リクエストボディー

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

レスポンスボディー

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

ServerNicPort

{
   "ServerNicPort":[{
       "serverUniqueKey":"...",
       "serverBladeNumber":...,
       "cardSlotNumber":...,
       "cardType":"...",
       "cardName":"...",
       "busNumber":...,
       "deviceNumber":...,
       "functionNumber":...,
       "controllerNumber":...,
       "portNumber":...,
       "macAddress":"...",
       "duplication":"...",
       "changeFromDefault":"..."
   },
   :
   ]
}

属性データ型説明
serverUniqueKeystring1NICポートが搭載されているブレードサーバを特定する識別子。
serverBladeNumberinteger1NIC ポートが搭載されているブレードの番号。
cardSlotNumberinteger1カードのスロット番号。
cardTypestring1カード種別。
  • MEZZANINE
  • PCI
  • ONBOARD
  • PCI_IOEU
  • PCI_IOBD
  • PCI_EXPANSION_BLADE
cardNamestring1カードの名前。
例:'Emulex 10Gb 4-port converged network mezzanine card'
busNumberinteger1バス番号。
deviceNumberinteger1デバイス番号。
functionNumberinteger1ファンクション番号。
controllerNumberinteger1コントローラー番号。
portNumberinteger1ポート番号。
macAddressstring1MACアドレス(書式:XX:XX:XX:XX:XX:XX)。
duplicationstring1MACアドレスが重複しているかどうか
  • TRUE
  • FALSE
changeFromDefaultstring1MACアドレスが初期値から変更されたかどうか。
  • TRUE
  • FALSE

リターンコード

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