12.4.4　ボリュームの設定を変更する

実行権限

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

リクエストライン

PATCH ＜ベースURL＞/simple/v1/objects/volumes/＜オブジェクトID＞

リクエストメッセージ

オブジェクトID

ボリュームの情報取得で取得したidの値を指定します。

属性	型	説明
id	int	（必須）ボリュームID

クエリパラメータ

なし。

ボディ

指定した属性だけが変更されます。

ニックネームを変更する例を次に示します。

{
  "nickname": "REST_API_10GVolume"
}

容量削減機能（圧縮および重複排除機能）の設定値を無効に変更する例を次に示します。

{
  "savingSetting": "DISABLE"
}

属性	型	説明
nickname	string	（任意）変更するニックネームを1～32文字で指定します。 使用できる文字は次のとおりです。 1～9 A～Z a～z - . / : @ \ _ 半角スペース 英字は、大文字と小文字が区別されます。 半角スペースは、使用できる文字と文字の間には使用できますが、先頭と末尾には使用できません。 名前の先頭にハイフン（-）は使用できません。 この属性を指定する場合、savingSettingを同時に指定しないでください。
savingSetting	string	（任意）容量削減機能（圧縮および重複排除機能）の設定 DEDUPLICATION_AND_COMPRESSION：容量削減機能（圧縮および重複排除機能）を有効にする 容量削減機能（重複排除）を有効にする場合、容量削減機能（圧縮）も有効となります。 COMPRESSION：容量削減機能（圧縮）を有効にする DISABLE：設定しない この属性を指定する場合、ボリュームの設定変更に時間が掛かることがあります。 この属性を指定する場合、nicknameを同時に指定しないでください。

レスポンスメッセージ

ボディ

• ニックネームを変更した場合

  属性	型	説明
  affectedResources	string[]	変更したボリュームの情報を参照するためのURLの一覧
  operationDetails	object[]	変更したボリュームの詳細情報 詳細については、commandStatusオブジェクトの属性operationDetailsの説明を参照してください。

• 容量削減機能（圧縮および重複排除機能）の設定を変更した場合

  属性	型	説明
  statusResource	string	変更したボリュームの情報を参照するためのURL

  メモ

  非同期処理のAPIのステータス情報を取得するAPIを実行して、実行結果のステータス情報を参照することもできます。詳細は非同期処理のAPIのステータス情報を取得するAPIの説明を参照してください。

ステータスコード

この操作のリクエストに対するステータスコードについては、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/volumes/100