Modifying settings of individual volumes

Virtual Storage Platform One SDS Block Storage Administrator Guide
Version
1.17.x
Audience
anonymous
Part Number
MK-24VSP1SDS002-04

You can edit volume names, nicknames, and QoS-related parameters (upperLimitForIops, upperLimitForTransferRate, and upperAlertAllowableTime).

You can only edit settings of volumes whose status is "Normal" or "UpdateFailed." For the volumes with the "UpdateFailed" status, reedit volume settings without specifying parameters corresponding to the editing target.

When you perform editing, note the following points:

  • Name can only be set to a unique value in the storage cluster.

  • Nickname can have duplicate values between volumes.

  • If you specify multiple parameters in step 3, you can specify them only in the following combinations: If you want to make a configuration change that cannot be combined, run the command again.

    • Combination of name and nickname

    • Combination of upperLimitForIops, upperLimitForTransferRate, and upperAlertAllowableTime

CAUTION:

If the event log KARS06170-C is issued and no actions are taken, verify to take actions for KARS06170-C before the operations on the volume.

  • Required role: Storage

  • When editing volumes in a VPS: Scope of the VPS

  1. When editing settings of volumes in a VPS, verify the VPS ID and conditions set for the VPS (QoS settings).

    If you want to specify a VPS by its name in the CLI, verify the VPS name.

    REST API: GET /v1/objects/virtual-private-storages

    CLI: vps_list

    Note:

    A system administrator can make QoS settings for individual volumes without limitation for the QoS settings of volumes.

  2. Verify the ID of the intended volume.

    If you use the CLI to specify a volume by name, check the name of the volume.

    REST API: GET /v1/objects/volumes

    CLI: volume_list

  3. Change the settings of the intended volume.

    Run either of the following commands with the volume ID and parameters for setting volumes specified.

    If you use the CLI, you can specify a name instead of the ID of the volume.

    REST API: PATCH /v1/objects/volumes/<id>

    CLI: volume_set

    Verify the job ID which is displayed after the command is run.

  4. Verify the state of the job.

    Run either of the following commands with the job ID specified.

    REST API: GET /v1/objects/jobs/<jobId>

    CLI: job_show

    If the job state is "Succeeded", the job is completed.

  5. Obtain information about the intended volume and verify that the settings of the volume are modified.

    Run either of the following commands with the volume ID specified.

    If you use the CLI, you can specify a name instead of the ID of the volume.

    REST API: GET /v1/objects/volumes/<id>

    CLI: volume_show

  6. (Bare metal) Back up the configuration information.

    Perform this step by referring to Backing up the configuration information (Bare metal).

    If you continue operations with other procedures, you must back up the configuration information after you have completed all operations.