14.4.6　サーバにホストグループ（iSCSIターゲット）を追加する

重要

次の条件に該当するホストグループ（またはiSCSIターゲット）は追加できません。

• ホストグループ（またはiSCSIターゲット）に関連付けられたポートのセキュリティが無効である
• ホストグループ（またはiSCSIターゲット）のプロトコルが追加するサーバのプロトコルと異なっている
• ホストグループ（またはiSCSIターゲット）内にプールから作成された仮想的なボリュームではないボリュームがある
• すでに別のサーバに追加されているホストグループ（またはiSCSIターゲット）である
• 仮想ストレージマシンに割り当てられたホストグループ（またはiSCSIターゲット）である

実行権限

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

リクエストライン

POST ＜ベースURL＞/simple/v1/objects/servers/＜オブジェクトID＞/actions/add-host-groups/invoke

リクエストメッセージ

オブジェクトID

サーバの情報取得で取得したidの値を指定します。

属性	型	説明
id	int	（必須）サーバID

クエリパラメータ

なし。

ボディ

ホストグループIDを指定してホストグループを追加する例を次に示します。

{
  "hostGroups": [
    {
      "portId": "CL1-C",
      "hostGroupId": 1
    }
  ]
}

ホストグループ名を指定してSCSIターゲットを追加する例を次に示します。

{
  "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のどちらか一方を必ず指定してください。また、これらの属性を同時には指定しないでください。

レスポンスメッセージ

ボディ

属性	型	説明
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