14.4.6 サーバにホストグループ(iSCSIターゲット)を追加する
サーバIDを指定して、特定のサーバにホストグループ(またはiSCSIターゲット)を追加します。
- 重要
-
次の条件に該当するホストグループ(またはiSCSIターゲット)は追加できません。
- ホストグループ(またはiSCSIターゲット)のプロトコルが追加するサーバのプロトコルと異なっている
- すでに別のサーバに追加されているホストグループ(またはiSCSIターゲット)である
- 追加するサーバとホストグループ(またはiSCSIターゲット)に関連付けられたポートがすでに接続されている
- 追加するサーバとホストグループ(またはiSCSIターゲット)に登録されているWWN(またはiSCSIネーム)の合計が32個を超えている
- ホストグループ(またはiSCSIターゲット)内にプールから作成された仮想的なボリュームではないボリュームがある
- ホストグループ(またはiSCSIターゲット)に関連付けられたポートのセキュリティが無効である
- ホストグループ番号(またはiSCSIターゲット番号)が「0」のホストグループ(またはiSCSIターゲット)である
- 仮想ストレージマシンに割り当てられたホストグループ(またはiSCSIターゲット)である
- ホストグループに関連付けられたポートの動作モードがNVMeである
実行権限
ストレージ管理者(プロビジョニング)
リクエストライン
POST <ベースURL>/simple/v1/objects/servers/<オブジェクトID>/actions/add-host-groups/invoke
リクエストメッセージ
- オブジェクトID
-
サーバの情報取得で取得したidの値を指定します。
属性
型
説明
id
int
(必須)サーバID
- クエリパラメータ
- なし。
- ボディ
-
ホストグループIDを指定してホストグループを追加する例を次に示します。
{ "hostGroups": [ { "portId": "CL1-C", "hostGroupId": 1 } ] }
ホストグループ名を指定してiSCSIターゲットを追加する例を次に示します。
{ "hostGroups": [ { "portId": "CL1-D", "hostGroupName": "My_REST_API_HOST" } ] }
属性
型
説明
hostGroups
object[]
追加するホストグループ(またはiSCSIターゲット)の情報
- (必須)portId:(string)
ポートIDを5文字で指定します。
- (任意)hostGroupId:(int)
ホストグループ(またはiSCSIターゲット)IDを1~254までの整数で指定します。
hostGroupIdまたはhostGroupNameのどちらか一方を必ず指定してください。また、これらの属性を同時には指定しないでください。
- (任意)hostGroupName:(string)
ホストグループ名(またはiSCSIターゲット名)を1~64文字で指定します。
hostGroupIdまたはhostGroupNameのどちらか一方を必ず指定してください。また、これらの属性を同時には指定しないでください。
- (必須)portId:(string)
レスポンスメッセージ
- ボディ
-
属性
型
説明
statusResource
string
追加したホストグループ(またはiSCSIターゲット)の実行結果の問い合わせに使用する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/8/actions/add-host-groups/invoke