Updated on 2025-09-18 GMT+08:00

Querying PatchData Instances

Function

This API is used to query PatchData instances. Pagination query is supported.

URI

  • URI format

    GET /v2/{project_id}/factory/supplement-data

  • Parameter description
    Table 1 URI parameter

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID. For details about how to obtain a project ID, see Project ID and Account ID.

    Table 2 Query parameters

    Parameter

    Mandatory

    Type

    Description

    sort

    No

    String

    Sorting field

    • desc: The results are displayed in descending order of creation time.
    • asc: The results are displayed in ascending order of creation time.

    The default value is desc.

    page

    No

    Integer

    Start page of the paging list. The default value is 0. The value must be greater than or equal to 0.

    size

    No

    Integer

    Maximum number of records on each page. The default value is 10.

    name

    No

    String

    PatchData instance name

    user_name

    No

    String

    Username

    status

    No

    String

    Instance status

    • SUCCESS: The job is successful.
    • RUNNING: The job is running.
    • CANCEL: The job has been canceled.

    start_date

    No

    Long

    Query start date, which is a 13-digit timestamp

    end_date

    No

    Long

    Query end date, which is a 13-digit timestamp

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

workspace

No

String

Workspace ID

  • If this parameter is not set, data in the default workspace is queried by default.
  • To query data in other workspaces, this header must be carried.
    NOTE:
    • You need to specify a workspace for multiple DataArts Studio instances.
    • This parameter is mandatory if no default workspace is available. If you do not set it, an error is reported.

X-Auth-Token

Yes

String

IAM Token

Minimum length: 0

Maximum length: 4096

Response Parameters

Table 4 Parameter description

Parameter

Mandatory

Type

Description

total

Yes

Integer

Number of jobs

success

Yes

Boolean

The value can be true or false.

msg

Yes

String

success

rows

Yes

List<row>

Information about PatchData instances. For details, see Table 5.

Table 5 row data structure description

Parameter

Mandatory

Type

Description

job_list

Yes

List<String>

PatchData job. There may be dependent jobs, so there may be multiple jobs.

name

Yes

String

PatchData instance name

user_name

Yes

String

Username

type

Yes

int

How a PatchData job is triggered. The value is 0 or 1. Value 0 indicates that the PatchData job is triggered on the job monitoring page, and value 1 indicates that the PatchData job is triggered by a restoration.

start_date

Yes

Long

Job start date, which is a 13-digit timestamp

end_date

Yes

Long

Job end date, which is a 13-digit timestamp

parallel

Yes

int

Number of parallel periods of the PatchData instance. The value ranges from 1 to 5.

status

Yes

String

Instance status

  • SUCCESS: The job is successful.
  • RUNNING: The job is running.
  • CANCEL: The job has been canceled.

submitted_date

Yes

Long

Job creation time

supplement_data_run_time

No

supplement_data_run_time object

PatchData time period. Currently, data can only be patched only every day. If this parameter is not specified, the default value 00:00-00:00 is used. For details, see Table 6.

supplement_data_instance_time

No

supplement_data_instance_time object

Discrete time for the PatchData job. For details, see Table 7.

Table 6 SupplementDataRunTime parameters

Parameter

Mandatory

Type

Description

time_of_day

Yes

String

Time period for patching data every day, for example, 10:15-23:30.

day_of_week

No

String

Days of each week for patching data, for example, 10:15 to 23:30 on Monday and Wednesday

day_of_month

No

String

Days in each month for patching data, for example, 1,3 which indicates the first and third day in each month

Table 7 SupplementDataInstanceTime parameters

Parameter

Mandatory

Type

Description

days

No

array[string]

Discrete days

time_of_day

No

String

Time period on a specified day

Example Request

Query the job list.

GET /v2/62099355b894428e8916573ae635f1f9/factory/supplement-data

Example Response

  • Success response: HTTP status code 200
    {
        "msg": "success",
        "rows": [
            {
                "end_date": 1692633599000,
                "job_list": [
                    "job_8810",
                    "job_1000"
                ],
                "name": "P_job_8810_20230821_175711",
                "parallel": 1,
                "start_date": 1692547200000,
                "status": "RUNNING",
                "submitted_date": 1692611566436,
                "supplement_data_run_time": {
                    "time_of_day": "00:00-00:00"
                },
                "supplement_data_instance_time": {},
                "type": 0,
                "user_name": "user_test"
            }
        ],
        "success": true,
        "total": 1
    }
  • Failure response

    HTTP status code 400

    {
        "error_code":"DLF.3051",
        "error_msg":"The request parameter is invalid."
    }