14.4.7 ホストグループ名(iSCSIターゲット名)をサーバのニックネームと同期する
サーバIDを指定して、サーバのニックネームをサーバと関連づけられたホストグループ(またはiSCSIターゲット)のホストグループ名(または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 ""