14.4.3　サーバを登録する

ストレージシステムに、Storage Advisor Embeddedで管理するためのサーバの情報を登録します。また、サーバのニックネームだけを指定して、ホストグループを追加するためのサーバを作成することもできます。

実行権限

ストレージ管理者（プロビジョニング）

リクエストライン

POST ＜ベースURL＞/simple/v1/objects/servers

リクエストメッセージ

オブジェクトID: なし。

クエリパラメータ: なし。

ボディ

FC接続のサーバの情報を次のとおり指定してストレージシステムに登録した例を次に示します。

サーバのニックネーム：hostA
プロトコル：FC
OSタイプ：Linux

{
  "serverNickname": "hostA",
  "protocol": "FC",
  "osType": "Linux"
}

iSCSI接続のサーバの情報を次のとおり指定してストレージシステムに登録した例を次に示します。

サーバのニックネーム：hostB
プロトコル：iSCSI
OSタイプ：：Linux

{
  "serverNickname": "hostB",
  "protocol": "iSCSI",
  "osType": "Linux"
}

ホストグループを追加するサーバを作成する例を次に示します。

{
  "serverNickname": "hostC",
  "isReserved": true
}

属性	型	説明
serverNickname	string	（必須）サーバのニックネームを1～229文字で指定します。使用できる文字は次のとおりです。 `0`～`9` `A`～`Z` `a`～`z` `,` `-` `.` `/` `:` `@` `\` `_` 半角スペース英字は、大文字と小文字を区別します。半角スペースは、使用できる文字と文字の間には使用できますが、先頭と末尾には使用できません。名前の先頭にハイフン（`-`）は使用できません。 iSCSI接続の場合、コンマ（`,`）、スラッシュ（`/`）、円マークまたはバックスラッシュ（`\`）は使用できません。
protocol	string	（任意）プロトコル指定できる値は次のとおりです。 `FC` `iSCSI` 属性`isReserved`に`true`を指定しない場合は、この属性を必ず指定してください。属性`isReserved`に`true`を指定した場合で、この属性を指定したときは指定した値は無視されます。
osType	string	（任意）OSタイプ指定できる値は次のとおりです。 `Linux` `HP-UX` `OpenVMS` `Tru64` `Solaris` `NetWare` `AIX` `VMware` `Windows` 属性`isReserved`に`true`を指定しない場合は、この属性を必ず指定してください。属性`isReserved`に`true`を指定した場合で、この属性を指定したときは指定した値は無視されます。
osTypeOptions	int[]	（任意）OSタイプのオプションを整数で指定します。 VSP Fx00 モデルまたはVSP Gx00 モデルの場合：`0`～`127` VSP E990の場合：`0`～`255` 指定できる値については、マニュアルシステム構築ガイドを参照してください。この属性は、RAID ManagerおよびDevice Manager - Storage Navigatorではホストモードオプションに対応します。 OSタイプを指定して、この属性を省略した場合、指定したOSタイプに対応する値が自動で設定されます。属性`isReserved`に`true`を指定した場合で、この属性を指定したときは指定した値は無視されます。
isReserved	boolean	（任意）ストレージシステムにホストグループを追加するサーバを作成するかどうかを指定します。 `true`：ホストグループを追加するサーバを作成する `false`：ホストグループを追加するサーバを作成しないこの属性を省略した場合、`false`が指定されたと見なされます。

レスポンスメッセージ

ボディ

属性	型	説明
statusResource	string	登録したサーバの実行結果の問い合わせに使用するURL

メモ: 非同期処理のAPIのステータス情報を取得するAPIを実行して、実行結果のステータス情報を参照することもできます。詳細は非同期処理のAPIのステータス情報を取得するAPIの説明を参照してください。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/servers

14.4.3 サーバを登録する

14.4.3　サーバを登録する