14.4.7　ホストグループ名（iSCSIターゲット名）をサーバのニックネームと同期する

同期するホストグループ名（またはiSCSIターゲット名）は次に示す条件によって異なります。

• サーバのニックネームが24文字以下の場合で、同一ポート内に同期するサーバのニックネームと同じホストグループ名（またはiSCSIターゲット名）がないとき

  サーバのニックネームがホストグループ名（またはiSCSIターゲット名）にそのまま同期されます。

• サーバのニックネームが24文字以下の場合で、同一ポート内に同期するサーバのニックネームと同じホストグループ名（またはiSCSIターゲット名）がすでにあるとき

  サーバのニックネームに加えて25文字目までは「_（アンダーバー）」が付与され、26文字目から32文字目までは、すでにあるホストグループ名（またはiSCSIターゲット名）と重複しないように識別文字が付与されて同期されます。

  例：サーバのニックネームが「abcdefghijklmnopqrst」の場合

  abcdefghijklmnopqrst_____0001_AA

• サーバのニックネームが25文字以上の場合

  サーバのニックネームの先頭から24文字（25文字目以降は切り捨てられます。）＋「_（アンダーバー）」に加えて、26文字目から32文字目までは、ホストグループ名（またはiSCSIターゲット名）が重複しないように識別文字が付与されて同期されます。

  例：サーバのニックネームが「abcdefghijklmnopqrstuvwxyz」の場合

  abcdefghijklmnopqrstuvwx_0001_AA

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID

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

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

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ

属性	型	説明
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/10/actions/sync-host-group-names/invoke -d ""