Queries the information about a job in a cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeJob

The operation that you want to perform. Set the value to DescribeJob.
ClusterId String Yes ehpc-hz-jeJki6****

The ID of the cluster.

You can call the ListClusters operation to query the cluster ID.

JobId String Yes 1.scheduler****

The ID of the job.

You can call the ListJobs operation to query the job ID.

Response parameters

Parameter Type Example Description
Message Struct

The list of returned job information.

JobInfo String {"2.scheduler": {"egroup": "users","Stageout_status": 1,"Keep_Files": "n","server": "scheduler","queue": "workq"}}

The details of the job.

RequestId String 9697AD8D-56FA-4C8E-B46C-00AC9***

The ID of the request.

Examples

Sample requests

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=DescribeJob
&ClusterId=ehpc-hz-jeJki6****
&JobId= 1.scheduler****
&<Common request parameters>

Sample success responses

XML format 

<DescribeJobResponse>
    <RequestId>9697AD8D-56FA-4C8E-B46C-00AC9****</RequestId>
    <Message>
        <JobInfo>
            <1.scheduler gmx.pbs>
                <egroup>users</egroup>
                <Stageout_status>1</Stageout_status>
                <Keep_Files>n</Keep_Files>
                <server>manager</server>
                <queue>workq</queue>
            </1.scheduler gmx.pbs>
        </JobInfo>
    </Message>
</DescribeJobResponse>

JSON format 

{
    "RequestId": "9697AD8D-56FA-4C8E-B46C-00AC9****",
    "Message": {
        "JobInfo": {
            "1.scheduler gmx.pbs": {
                "egroup": "users",
                "Stageout_status": 1,
                "Keep_Files": "n",
                "server": "manager",
                "queue": "workq"
            }
        }
    }
}

Error codes

HttpCode Error code Error message Description
400 InvalidParams The specified parameter %s is invalid. The error message returned because the following parameter is invalid: %s.
403 ExecFail Failed to execute the command: %s. The error message returned because the following command has failed to be run: %s.
404 ClusterNotFound The specified cluster does not exist. The error message returned because the specified cluster does not exist.
407 NotAuthorized You are not authorized by RAM for this request. The error message returned because you are not authorized by RAM for this request.
406 AgentError The agent service request failed. The error message returned because the proxy request has failed.
406 DbError A database service error occurred. The error message returned because the database request has failed.
406 RedisError A Redis service error occurred. The error message returned because the Redis request has failed.
406 AliyunError An Alibaba Cloud product error occurred. The error message returned because the operation has failed to call another Alibaba Cloud service.
409 PartFailure Part of the batch operation failed. The error message returned because the batch operation has failed.
500 UnknownError An unknown error occurred. The error message returned because an unknown error has occurred.
404 ManagerNotFound The manager nodes do not exist or their status is abnormal. The error message returned because the management node does not exist or is not running as expected.
503 ServiceUnavailable The request has failed due to a temporary failure of the server The error message returned because the request has failed. The service is temporarily unavailable.

For a list of error codes, visit the API Error Center.