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タイプのオプションを0~127までの整数で指定します。
指定できる値については、マニュアルシステム構築ガイドを参照してください。この属性は、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