Updated on 2026-09-02 GMT+08:00

Querying the Log Backup Task List

Function

This API is used to query the log backup task list of a cluster. To be able to use this API, the target cluster must have log backup enabled, and log backup tasks were triggered earlier. This allows you to keep track of operations that were performed on the cluster.

Calling Method

For details, see Calling APIs.

URI

GET /v1.0/{project_id}/clusters/{cluster_id}/logs/records

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details about how to obtain the project ID and name, see Obtaining the Project ID and Name. Constraints N/A Range Project ID of an account. The value contains 32 characters, consisting of lowercase letters and digits. Default Value N/A
cluster_id	Yes	String	Definition ID of the cluster to be queried. For details about how to obtain the cluster ID, see Obtaining the Cluster ID. Constraints N/A Range The value is a UUID containing 36 characters. Default Value N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
offset	No	Integer	Definition: Start value for log query. The default value is 1, indicating that the query starts from the first log record. Constraints: N/A Value range: Greater than or equal to 1. Default value: 1
limit	No	Integer	Definition: Number of log records to be queried. The default value is 10, indicating that 10 log records are queried at a time. Constraints: N/A Value range: 1-1000 Default value: 10
status	No	String	Definition: Status of the log tasks to be queried. If this parameter is not specified, all log task records of the cluster are queried. Constraints: N/A Value range: FAIL: failed log tasks. NOT_FAIL: ongoing or successful log tasks. If this parameter is not specified, all tasks are queried. Default value: Empty string: Tasks of all states are queried.

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
clusterLogRecord	Array of clusterLogRecord objects	Parameter description: List of cluster log backup tasks. Options: N/A
totalSize	Integer	Definition Total number of log records. Range N/A

**Table 4** clusterLogRecord
Parameter	Type	Description
id	String	Definition: Cluster log task ID, which is generated based on the system UUID. Value range: N/A
clusterId	String	Parameter description: Cluster ID. Options: N/A
createAt	Integer	Definition Cluster log creation time. The value is a Unix timestamp in milliseconds. Range N/A
logPath	String	Parameter description: Storage path of backed up logs in the OBS bucket. Options: N/A
status	String	Definition: Cluster log task status. Value range: RUNNING: Backup is in progress. SUCCESS: The backup is successful. FAIL: The backup failed.
finishedAt	Long	Definition End time of cluster log creation. The value is a Unix timestamp in milliseconds. If the creation is still ongoing, the value is null. Range N/A
jobTypes	String	Definition: Type of a log creation task. Value range: Manual: Manual backup. Auto: Automatic backup.
failedMsg	String	Definition: Error returned for log creation. If the task status is not failed, this parameter is null. Value range: N/A
jobId	String	Definition: ID of a log creation task. Value range: N/A

Example Requests

Querying the First 10 Log Backup Tasks

GET https://{Endpoint}/v1.0/{project_id}/clusters/5c77b71c-5b35-4f50-8984-76387e42451a/logs/records

Example Responses

Status code: 200

Request succeeded.

{
  "clusterLogRecord" : [ {
    "id" : "d455a541-597e-4846-a6be-baad0ea361b1",
    "clusterId" : "4213d908-f5dc-4633-8401-cfd7175fca0c",
    "createAt" : 1656042837000,
    "logPath" : "css-backup-1610678043608/css/log",
    "status" : "RUNNING",
    "finishedAt" : null,
    "jobTypes" : "Manual",
    "failedMsg" : null,
    "jobId" : "2c9080df7c171342017c5e0884f8011c"
  } ],
  "totalSize" : 1
}

Status Codes

Status Code	Description
200	Request succeeded.
400	Invalid request. Modify the request before retry.
409	The request could not be completed due to a conflict with the current state of the resource. The resource that the client attempts to create already exists, or the update request fails to be processed because of a conflict.
412	The server did not meet one of the preconditions contained in the request.

Error Codes

See Error Codes.

Parent topic: Log Management