Listing Import and Export Tasks

Function

This API is used to list import and export tasks.

Constraints

This API is only supported for SFS Turbo 250 MB/s/TiB, 125 MB/s/TiB, 40 MB/s/TiB, and 20 MB/s/TiB file systems.

URI

GET /v1/{project_id}/sfs-turbo/{share_id}/hpc-cache/tasks

Table 1 Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
share_id	Yes	String	File system ID

Table 2 Query Parameters
Parameter	Mandatory	Type	Description
type	No	String	Task type
status	No	String	Task status
offset	No	Long	Offset. The default value is 0.
limit	No	Long	Limit. The default value is 20.
start_time	No	String	start_time
end_time	No	String	end_time

Request Parameters

Table 3 Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Account token
Content-Type	Yes	String	MIME type

Response Parameters

Status code: 200

Table 4 Response header parameters
Parameter	Type	Description
X-request-id	String	Request ID

Table 5 Response body parameters
Parameter	Type	Description
tasks	Array of OneHpcCacheTaskInfoResp objects	Task details
count	Long	Number of tasks

Table 6 OneHpcCacheTaskInfoResp
Parameter	Type	Description
task_id	String	Task ID
type	String	Task type
status	String	Task status
src_target	String	Name of the interworking directory
src_prefix	String	Source path prefix specified in an import or export task
dest_target	String	Keep it the same as src_target.
dest_prefix	String	Keep it the same as src_prefix.
start_time	String	Task start time
end_time	String	Task end time
message	String	Task execution results

Status code: 400

Table 7 Response header parameters
Parameter	Type	Description
X-request-id	String	Request ID

Table 8 Response body parameters
Parameter	Type	Description
errCode	String	Error code
errMsg	String	Error description

Status code: 500

Table 9 Response header parameters
Parameter	Type	Description
X-request-id	String	Request ID

Table 10 Response body parameters
Parameter	Type	Description
errCode	String	Error code
errMsg	String	Error description

Example Requests

Listing import and export tasks for the file system whose ID is 77ba6f4b-6365-4895-8dda-bc7142af4dde

GET /v1/{project_id}/sfs-turbo/77ba6f4b-6365-4895-8dda-bc7142af4dde/hpc-cache/tasks

Example Responses

Status code: 200

Success

{
  "tasks" : [ {
    "task_id" : "7bd2a9b6-xxxx-4605-xxxx-512d636001b0",
    "type" : "import",
    "status" : "DOING",
    "src_target" : "sfs-link-directory",
    "src_prefix" : "input/datasets/",
    "dest_target" : "sfs-link-directory",
    "dest_prefix" : "input/datasets/",
    "message" : "",
    "start_time" : "2023-09-02T15:04:05",
    "end_time" : ""
  } ],
  "count" : 1
}

Status code: 400

Error response

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "parameter error"
}

Status code: 500

Error response

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

Status Codes

Status Code	Description
200	Success
400	Error response
500	Error response

Error Codes

See Error Codes.

Parent topic: Storage Interworking Management

Предыдущая статья

Querying Details About an Import or Export Task

Следующая статья

Updating a File System

Была ли эта статья полезна?

Поддержка Юридические документы