Updated on 2025-08-28 GMT+08:00

Obtaining Task Details

Function

Obtain task details.

URI

GET /koodrive/ose/v1/task/{task_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

task_id

Yes

String

Task ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Authorization

Yes

String

Access token. Token authentication is used to call KooDrive APIs. A token indicates the permission. When an API is called, the token is added to the request header to obtain the operation permission. For details about how to obtain an access token, see the corresponding developer guide. The format is Bearer+{access_token}.

language

No

String

Language code, which complies with the internationalization specifications. For example, en-US indicates English (United States). English (United States) is used by default.

X-Traceid

No

String

Message log tracing ID (58 bits).

X-User-Id

Yes

String

User ID, which is used for app authentication.

X-Date

Yes

String

Date, which is used for app authentication.

Host

Yes

String

Address, which is used for app authentication.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

taskId

String

Task ID.

taskName

String

Task name.

taskType

Integer

Task type. 0: transfer and deletion.

tenantId

String

Tenant ID.

userId

String

Internal user ID.

status

Integer

Task status. 0: NEW; 1: EXECUTING; 2: SUCCESS; 3: FAILED.

resultCode

String

Result code.

18xxxxxx: specific errors. (This parameter is not returned when the task is successful.)

code

String

Response code.

msg

String

Response information.

Example Requests

Obtains task details.

GET /koodrive/ose/v1/task/1534087020903704704

Authorization: Bearer+dsadasd*******4ad83c8f

Example Responses

Status code: 200

Response for obtaining task details.

{
  "taskId" : "1534087020903704704",
  "taskName" : "lym0412normal",
  "taskType" : 0,
  "tenantId" : "d5ac574bd2934a69baa4f23c55daa8d4",
  "userId" : "1395497048157130881",
  "status" : 3,
  "resultCode" : "18000205",
  "code" : 0,
  "msg" : "Success."
}

Status Codes

Status Code

Description

200

Response for obtaining task details.