Updated on 2022-08-17 GMT+08:00

Viewing a Job File

Function

This API is used to check whether there are jobs and scripts in the job file to be imported from OBS to DLF.

URI

  • URI format

    POST /v1/{project_id}/jobs/check-file

  • 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.

Request

Table 2 Request parameters

Parameter

Mandatory

Type

Description

path

No

String

If OBS is deployed, the job definition file is stored on OBS, for example, obs://myBucket/jobs.zip.

Response

Table 3 Response parameters

Parameter

Mandatory

Type

Description

jobs

No

List<Job>

Job information. For details, see Table 4.

scripts

No

List<Script>

Script information. For details, see Table 5.

Table 4 job data structure description

Parameter

Mandatory

Type

Description

params

No

Map<String,String>

Job parameter.

name

Yes

String

Job name.

path

Yes

String

Path of the job.

Table 5 Data structure description of Script

Parameter

Mandatory

Type

Description

name

Yes

String

Script name.

path

Yes

String

Path of the script.

Table 6 Data structure description of Resource

Parameter

Mandatory

Type

Description

name

Yes

String

Name of the resource.

status

Yes

Int

Resource status. 0 indicates that the resource does not exist; 1 indicates that the resource exists.

type

Yes

String

Resource type.

  • DWS_CLUSTER
  • DWS_CONNECTION
  • DLI_QUEUE
  • DLI_CONNECTION
  • CDM_CLUSTER
  • GES_GRAPH

Example

View the parameter definitions in the job file on OBS.

  • Request
    POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/check-file
    {
    "path": "obs://aaaaa/DLF_myJob.zip"
    }
  • Success response
    {
        "jobs":[
            {
                "name":"test",
                "path":"/test",
                "params":{
                    "ddd":"dddd"
                }
            },
            {
                "name":"test1",
                "path":"/test",
                "params":{
                    "ddd":"dddd"
                }
            }
        ],
        "scripts":[
            {
                "name":"script1",
                "path":"/path1"
            },
            {
                "name":"script2",
                "path":"/path1"
            }
        ]
    }
  • Failure response

    HTTP status code 400

    {
        "error_code":"DLF.0815",
        "error_msg":"Fail to read OBS file."
    }

Status Codes

See Status Codes.