Reclaiming zero data pages of volumes

Virtual Storage Platform One SDS Block and SDS Cloud Virtual Private Storage Administration

Version
1.19.x
Audience
anonymous
Part Number
MK-24VSP1SDS028-03
ft:lastEdition
2026-04-20

Two methods are available for zero data page reclaim: 1) using the Write Same or Unmap command from the host, and 2) using a REST API, CLI, or VSP One SDS Block Administrator. In both cases, pages are reclaimed when the storage controller receives the commands.

For zero data page reclaim by using a REST API, CLI, or VSP One SDS Block Administrator, the execution status can be referenced from volume information.

Zero data page reclaim can be performed when the applicable volume meets all of the following conditions.

  • The status is "Normal", "Expanding", "Updating", or "DiscardZeroPageFailed."

  • volumeType is "Normal" or "Snapshot."

  • discardZeroDataPageStatus is "None" or "DiscardZeroDataPageFailed."

Note:
  • Zero data page reclaim is processed one volume at a time within the same storage controller. In contrast, multiple jobs of zero data page reclaim are processed concurrently across different storage controllers.

  • The maximum number of zero data page reclaim jobs that can be performed simultaneously is 800. Performing 801 or more zero data page reclaim jobs simultaneously results in failure.

  • While zero data page reclaim is executed, the I/O performance of volume might be affected.

  • When zero data page reclaim is being performed by using the Write Same command or Unmap command, if you perform zero data page reclaim for the same or other volumes simultaneously by using a REST API, CLI, or VSP One SDS Block Administrator, zero data page reclaim by using a REST API, CLI, or VSP One SDS Block Administrator is prioritized.

  • If you perform a high-priority job (that cannot run with other jobs) such as storage cluster stoppage, zero data page reclaim is automatically stopped.

  • For NVMe/TCP connections, pages are not reclaimed even if the storage controller receives the Dataset Management command from the host.

  • Required role: VpsStorage

  1. Verify the ID of the volume for which you will perform zero data page reclaim.

    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

  2. Perform zero data page reclaim of the volume.

    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: POST /v1/objects/volumes/<id>/actions/discard-zero-page/invoke

    CLI: volume_discard_zero_page

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

  3. 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.

  4. Obtain volume information to verify that the used logical capacity (usedCapacity) of the volume is reduced.

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

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

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

    CLI: volume_show