/scalemgmt/v3/filesystems/{filesystem}/filesets/{fileset}/afm/resumerequeued: POST

Resumes all pending requeued operations for an existing AFM fileset in an IBM Storage Scale file system.

Availability

Available on all IBM Storage Scale editions.

Description

The POST filesystems/{filesystem}/filesets/{fileset}/afm/resumerequeued request resumes all pending requeued operations for an existing AFM fileset. This operation restarts operations that were previously queued due to errors or resource constraints, allowing them to be retried. To run this request, you must have the RBAC permission for the post action on the /scalemgmt/v3/filesystems/{filesystem}/filesets/{fileset}/afm/resumerequeued resource.

Request URL

https://<IP address or host name of API server>:<port>/scalemgmt/v3/filesystems/{filesystem}/filesets/{fileset}/afm/resumerequeued
where
{filesystem}
Specifies the name of the file system.
{fileset}
Specifies the name of the AFM fileset.

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 filesystem. Required.
fileset The name of the AFM fileset. Required.
X-StorageScaleDomain The domain to be authorized against for the request. The default value is X-StorageScaleDomain. Optional.

Request data

No request data.

Response data

  • 200: A successful response and resumerequeued operation is 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"
  }
}
  • 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 resumes requeued operations for the fset-sw fileset in the fs1 file system:

Request data: 
curl -X 'POST' \
  'https://localhost:46443/scalemgmt/v3/filesystems/fs1/filesets/fset-sw/afm/resumerequeued' \
  -H 'accept: application/json' \
  -H 'authorization: Basic cm9vdDpXZWxjb21lMmlibTEyM0A=' \
  -d ''
Response data: 
{
	"name": "MTplMDg0MDE0MS02N2Y2LTQ3YWMtYjA1OC02NjI4NWJjNjVjN2Y=",
	"metadata": {
		"@type": "type.googleapis.com/generic.v3.LongRunningOperationMetadata",
		"job_id": "MTplMDg0MDE0MS02N2Y2LTQ3YWMtYjA1OC02NjI4NWJjNjVjN2Y=",
		"operation_details": {
			"@type": "type.googleapis.com/afmctl.v3.ResumeRequeuedAFMFilesetRequest",
			"filesystem": "fs1",
			"fileset": "fset-sw"
		},
		"status": "DONE",
		"check_point": "",
		"request_time": "2026-04-22T08:12:09.469271330Z",
		"completion_time": "2026-04-22T08:12:09.570934895Z",
		"last_update_time": "2026-04-22T08:12:09.570934895Z",
		"output": "",
		"domain_ids": [
			0
		]
	},
	"done": true,
	"response": {
		"@type": "type.googleapis.com/afmctl.v3.ResumeRequeuedAFMFilesetResponse",
		"response": [
			""
		]
	}
}