/scalemgmt/v3/filesystems/{filesystem}:restripe: POST

Restripes all the files in the filesystem.

Availability

Available on all IBM Storage Scale editions.

Description

The POST filesystems/{filesystem}:restripe request restores the replication factor of all files in the file system. This command also completes any incomplete or deferred file compression or decompression for all files in the file system. It redistributes existing file system data across different disks based on changes to the disk state made by file system disk operations, such as starting, stopping, adding, or deleting disks.

The operation attributes for this command are LRO and cancel operation. To run this command, you must have the RBAC permission for the restripe action on the /scalemgmt/v3/filesystems/{filesystem}:restripe resource.

Alternatively, you can issue the /scalemgmt/v3/filesystems/{filesystem}:restripe API to perform any deferred or incomplete file compression or decompression in all the files of a file system.

You must specify one of the restripe operations. The possible values are migrate-critical, migrate-all, reset-replication, check-conflicting-replicas, repair-file-placement, compression.

Note: The restripe operation can take a long time to complete if the file system contains many files or a large amount of data. If you are adding, deleting, or replacing multiple disks, run the restripe command after all disks are modified, rather than after each individual disk.

Request URL

https://<IP address or host name of API server>:<port>/scalemgmt/v3/filesystems/{filesystem}:restripe
where
filesystems/{filesystem}:restripe
Specifies the IBM Storage Scale file system as the target of the POST call.
{filesystem}
Specifies the name of the file system.

Request headers

Accept: application/json

Parameters

The following parameters can be used in the request URL to customize the request:
Table 1. List of parameters
Parameter name Description and applicable keywords Required/optional
filesystem The name of the file system. Required.
restripe_operation The strategy to use for rebalancing the file system. The possible values are "strict", "no_rebalance", "default". The default value is "no_rebalance". Optional.
metadata_only To limit the specified operation to metadata blocks. Optional.
target_nodes List of target IBM Storage Scale nodes. The value can include any combination of node numbers, node number ranges, node names, IP addresses, or node classes. Optional.
pit_continue_on_error To continue repairing the remaining files, if errors are encountered in the parallel inode traverse (PIT). Optional.
qos_class The quality of service for IO operations to which the processing of this command is assigned Optional.
X-StorageScaleDomain The domain to be authorized against for the request. The default value is StorageScaleDomain. Optional.

Request data

No request data.

Response data

  • 200: A successful response.
    {
  "done": true,
  "error": {
    "details": [
      {
        "@type": "string",
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    ],
    "httpcode": 0,
    "message": "string",
    "status": "CANCELLED"
  },
  "metadata": {
    "@type": "string",
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "name": "string",
  "response": {
    "@type": "string",
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}
  • 202: The request has been accepted for processing, but the processing has not been completed.
    {
  "done": true,
  "error": {
    "details": [
      {
        "@type": "string",
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    ],
    "httpcode": 0,
    "message": "string",
    "status": "CANCELLED"
  },
  "metadata": {
    "@type": "string",
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "name": "string",
  "response": {
    "@type": "string",
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}
  • default: An unexpected error response.
    {
  "code": 0,
  "details": [
    {
      "@type": "string",
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ],
  "message": "string"
}

Examples

The following example restripe the files in the filesystem:

Request data: 
curl -X 'POST'   'https://localhost:46443/scalemgmt/v3/filesystems/fs2:restripe'   -H 'accept: application/json'   -H 'Content-Type: application/json'   -d '{
  "restripe_operation": "MIGRATE_ALL"
}' -k -n
Response data: 
{
	"name":  "MToyNTNmNjk0Ni0xMDA2LTQ4MmYtOGNjZi1hODlmNzU3NjFiM2U=",
	"metadata":  {
		"@type":  "type.googleapis.com/generic.v3.LongRunningOperationMetadata",
		"job_id":  "MToyNTNmNjk0Ni0xMDA2LTQ4MmYtOGNjZi1hODlmNzU3NjFiM2U=",
		"operation_details":  {
			"@type":  "type.googleapis.com/restripe.v3.RestripeFilesystemRequest",
			"filesystem":  "fs2",
			"restripe_operation":  "MIGRATE_ALL",
			"metadata_only":  false,
			"target_nodes":  [],
			"pit_continues_on_error":  false,
			"qos_class":  "",
			"pool_name":  "",
			"inode_criteria":  [],
			"inode_result_file":  ""
		},
		"status":  "RUNNING",
		"check_point":  "",
		"request_time":  "2026-03-13T18:21:09.824864268Z",
		"completion_time":  null,
		"last_update_time":  "2026-03-13T18:21:10.250026018Z",
		"output":  "Scanning file system metadata, p...",
		"domain_ids":  [
			0
		]
	},
	"done":  false
}