16.4 外部ボリュームのニックネームを変更する
外部ボリュームIDを指定して、外部ボリュームのニックネームを変更します。
実行権限
ストレージ管理者(プロビジョニング)
リクエストライン
PATCH <ベースURL>/simple/v1/objects/external-volumes/<オブジェクトID>
リクエストメッセージ
- オブジェクトID
-
外部ボリュームの情報取得で取得したidの値を指定します。
属性
型
説明
id
int
(必須)外部ボリュームID
- クエリパラメータ
- なし。
- ボディ
-
{ "nickname": "externalVolumeForQuorum2" }
属性
型
説明
nickname
string
(必須)変更するニックネームを1~32文字で指定します。
使用できる文字は次のとおりです。
0~9 A~Z a~z ! # $ % & ' ( ) + , - . / : = @ [ \ ] ^ _ ` { } ~ 半角スペース
英字は、大文字と小文字が区別されます。
半角スペースは、使用できる文字と文字の間には使用できますが、先頭と末尾には使用できません。
レスポンスメッセージ
- ボディ
-
属性
型
説明
affectedResources
string[]
変更した外部ボリュームの情報を参照するためのURLの一覧
operationDetails
object[]
変更した外部ボリュームの詳細情報
詳細については、commandStatusオブジェクトの属性「operationDetails」の説明を参照してください。
ステータスコード
この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X PATCH --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/external-volumes/3