7.27　WWNにニックネームを設定する

実行権限

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

リクエストライン

PUT ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/host-wwns/＜オブジェクトID＞

このAPIはPATCHメソッドでも実行できます。

リクエストメッセージ

オブジェクトID

WWNの情報取得で取得したhostWwnIdの値を指定します。次に示す属性値を連結した形式でも指定できます。

＜portId＞,＜hostGroupNumber＞,＜hostWwn＞

属性	型	説明
portId	string	（必須）ポート番号
hostGroupNumber	int	（必須）ポート上のホストグループ番号
hostWwn	string	（必須）ホストグループに登録されているHBAのWWN

クエリパラメータ

なし。

ボディ

WWNにニックネームを設定する場合

{
  "wwnNickname": "REST_API_Created"
}

WWNからニックネームを削除する場合

{
  "wwnNickname": ""
}

属性	型	説明
wwnNickname	string	（必須） WWNのニックネームを1～64文字で指定します。 次の文字が使用できます。 半角英数字 次の半角記号 . @ _ : , \ - ハイフン（-）は先頭には指定できません。 同一ポートのほかのWWNに使用されているニックネームは指定できません。 WWNからニックネームを削除する場合は、空文字列を指定します。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。

属性	説明
affectedResources	設定を変更したWWNのURL

Actionテンプレート

なし。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X PUT --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/host-wwns/CL1-A,0,1212121212121212