Queries the details of a serverless job by job ID or subtask ID (array job). You can specify only a single job ID or a single subtask ID at a time.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ClusterId | string | Yes | The ID of the E-HPC cluster. You can call the ListClusters operation to query the cluster ID. | ehpc-hz-FYUr32**** |
JobIds | array | Yes | The list of serverless job IDs or the subtask IDs (array jobs). Note
| |
string | Yes | The ID of the serverless job or the subtask (array job). | 5 |
Response parameters
Examples
Sample success responses
JSON
format
{
"TotalCount": 1,
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
"JobInfos": [
{
"JobId": "5",
"JobName": "testjob",
"State": "Running",
"Priority": 9,
"Queue": "comp",
"User": "testuser",
"SubmitTime": 1647423718,
"StartTime": 1647427667,
"EndTime": 1662016121,
"LastModifyTime": 1663831441000,
"IsArrayJob": false,
"ArrayProperties": {
"IndexStart": 1,
"IndexEnd": 5,
"IndexStep": 2
},
"ContainerGroups": [
{
"ContainerGroupId": "eci-bp1jrgfqqy54kg5hc****",
"ContainerGroupName": "test",
"Status": "Running",
"InstanceType": "ecs.g5.large",
"SpotStrategy": "NoSpot",
"SpotPriceLimit": 0.025,
"Cpu": 2,
"Memory": 4,
"Containers": [
{
"Args": [
"hello.py"
],
"Commands": [
"/usr/bin/python"
],
"Cpu": 2,
"CurrentState": {
"DetailStatus": "working",
"ExitCode": 0,
"FinishTime": "2018-08-02T15:00:00Z\n",
"Message": "Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)\n",
"Reason": "Started\n",
"Signal": 1,
"StartTime": "2019-12-19T12:05:02Z\n",
"State": "Terminated\n"
},
"EnvironmentVars": [
{
"Key": "PATH\n",
"Value": "/usr/bin/\n",
"ValueFrom": {
"FieldRef": {
"FieldPath": "status.podIP"
}
}
}
],
"Gpu": 1,
"Image": "HPL",
"ImagePullPolicy": "Always",
"LivenessProbe": {
"Execs": [
"[\"/bin/sh\", \"-c\", \"echo Hello world > /usr/share/message\"]\n"
],
"FailureThreshold": 3,
"HttpGet": {
"Path": "/usr/nginx/\n",
"Port": 80,
"Scheme": "HTTP"
},
"InitialDelaySeconds": 10,
"PeriodSeconds": 5,
"SuccessThreshold": 1,
"TcpSocket": {
"Host": "1.2.3.4\n",
"Port": 80
},
"TimeoutSeconds": 10
},
"Memory": 4,
"Name": "HPL",
"Ports": [
{
"Port": 8080,
"Protocol": "TCP"
}
],
"PreviousState": {
"DetailStatus": "working",
"ExitCode": 0,
"FinishTime": "2018-08-02T15:00:00Z",
"Message": "Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)",
"Reason": "Completed",
"Signal": 1,
"StartTime": "2018-08-02T15:00:00Z",
"State": "Terminated"
},
"ReadinessProbe": {
"Execs": [
"[\n \"/bin/sh\",\n \"-c\",\n \"echo Hello world > /usr/share/message\"\n]"
],
"FailureThreshold": 3,
"HttpGet": {
"Path": "/usr/local",
"Port": 8080,
"Scheme": "HTTP"
},
"InitialDelaySeconds": 10,
"PeriodSeconds": 5,
"SuccessThreshold": 1,
"TcpSocket": {
"Host": "1.2.3.4",
"Port": 8888
},
"TimeoutSeconds": 1
},
"Ready": true,
"RestartCount": 5,
"SecurityContext": {
"Capability": {
"Adds": [
"NET_ADMIN"
]
},
"ReadOnlyRootFilesystem": true,
"RunAsUser": 1558
},
"Stdin": true,
"StdinOnce": true,
"Tty": false,
"VolumeMounts": [
{
"MountPath": "/usr/share/",
"MountPropagation": "None",
"Name": "test-empty",
"ReadOnly": false,
"SubPath": "/usr/sub"
}
],
"WorkingDir": "/usr/local/nginx"
}
],
"Volumes": [
{
"ConfigFileVolumeConfigFileToPaths": [
{
"Content": "hello world",
"Path": "/usr/bin/"
}
],
"DiskVolumeDiskId": "d-xxxx",
"DiskVolumeFsType": "xfs",
"EmptyDirVolumeMedium": "Memory",
"EmptyDirVolumeSizeLimit": "256Mi",
"FlexVolumeDriver": "flexvolume",
"FlexVolumeFsType": "ntfs",
"FlexVolumeOptions": "[nolock,tcp,noresvport]",
"NFSVolumePath": "/eci",
"NFSVolumeReadOnly": false,
"NFSVolumeServer": "0eafxxxxx-xxxxx.cn-hangzhou.nas.aliyuncs.com",
"Name": "test-empty",
"Type": "EmptyDirVolume"
}
],
"Events": [
{
"Count": 20,
"FirstTimestamp": "2018-08-02T15:00:00Z",
"LastTimestamp": "2018-08-02T15:00:00Z\n",
"Message": "Started container",
"Name": "test-xxx",
"Reason": "Created",
"Type": "Normal"
}
],
"CreationTime": "2018-08-02T15:00:00Z",
"SucceededTime": "2019-12-11T04:33:42Z",
"ExpiredTime": "2018-08-02T15:00:00Z",
"FailedTime": "2018-08-02T15:00:00Z",
"Discount": 9,
"DnsConfig": {
"NameServers": [
"[10.2.*.*]"
],
"Options": [
{
"Name": "name",
"Value": "value"
}
],
"Searches": [
"svc.local.kubenetes"
]
},
"EciSecurityContext": {
"Sysctls": [
{
"Name": "kernel.msgmax",
"Value": "65536"
}
]
},
"EniInstanceId": "eni-bp14rzqi6fd8satm****",
"EphemeralStorage": 20,
"HostAliases": [
{
"Hostnames": [
"['hehe.com', 'haha.com']"
],
"Ip": "192.0.XX.XX"
}
],
"InitContainers": [
{
"Args": [
"['hello world']"
],
"Command": [
"[/bin/sh echo]"
],
"Cpu": 1,
"CurrentState": {
"DetailStatus": "working",
"ExitCode": 0,
"FinishTime": "2018-08-02T15:00:00Z",
"Message": "Created container",
"Reason": "Started",
"Signal": 1,
"StartTime": "2018-08-02T15:00:00Z",
"State": "Running"
},
"EnvironmentVars": [
{
"Key": "PATH",
"Value": "/usr/local/bin",
"ValueFrom": {
"FieldRef": {
"FieldPath": "status.podIP"
}
}
}
],
"Gpu": 1,
"Image": "nginx",
"ImagePullPolicy": "Always",
"Memory": 2,
"Name": "Init-xxx",
"Ports": [
{
"Port": 8888,
"Protocol": "TCP"
}
],
"PreviousState": {
"DetailStatus": "working",
"ExitCode": 0,
"FinishTime": "2019-12-24T05:35:44Z",
"Message": "Started container",
"Reason": "completed",
"Signal": 1,
"StartTime": "2019-12-24T05:35:44Z",
"State": "Terminated"
},
"Ready": true,
"RestartCount": 5,
"SecurityContext": {
"Capability": {
"Adds": [
"NET_ADMIN"
]
},
"ReadOnlyRootFilesystem": true,
"RunAsUser": 1557
},
"VolumeMounts": [
{
"MountPath": "/usr/share/",
"MountPropagation": "None",
"Name": "test-empty",
"ReadOnly": false
}
],
"WorkingDir": "/usr/test"
}
],
"InternetIp": "192.0.XX.XX",
"IntranetIp": "172.16.XX.XX",
"Ipv6Address": "2001:XXXX:4:4:4:4:4:4",
"RamRoleName": "ram:PassRole",
"RegionId": "cn-hangzhou",
"ResourceGroupId": "rg-aekzh43v*****",
"RestartPolicy": "Never",
"SecurityGroupId": "sg-bp12ujq5zpxuyjfo3o8r",
"Tags": [
{
"Key": "name",
"Value": "test-xh"
}
],
"TenantEniInstanceId": "i-xxx",
"TenantEniIp": "10.10.XX.XX",
"TenantSecurityGroupId": "sg-xxx",
"TenantVSwitchId": "vsw-xxx",
"VSwitchId": "vsw-bp1vzjjflab6wvjox****",
"VpcId": "vpc-1vzjjflab6wvjox****",
"ZoneId": "cn-hangzhou-h"
}
]
}
]
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidParams | The specified parameter %s is invalid. | The specified parameter %s is invalid. |
400 | NotEnabled | You have not enabled this service | You have not enabled this service |
404 | ClusterNotFound | The specified cluster does not exist. | The specified instance does not exist. |
404 | ManagerNotFound | The manager nodes do not exist or their status is abnormal. | The manager nodes do not exist or their status is abnormal. |
406 | EcsError | An error occurred while calling the ECS API operation. | An error occurred while calling the ECS API operation. |
406 | DbError | A database service error occurred. | Database request failed. |
406 | RedisError | A Redis service error occurred. | Redis request failed. |
406 | AliyunError | An Alibaba Cloud product error occurred. | An Alibaba Cloud product error occurred. |
406 | AgentError | The agent service request failed: %s | The agent request failed. |
407 | NotAuthorized | You are not authorized by RAM for this request. | The request is not authorized by RAM. |
500 | UnknownError | An unknown error occurred. | An unknown error occurred. |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server | The request has failed due to a temporary failure of the server. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2023-07-21 | The Error code has changed | see changesets | ||||||||||||||||
| ||||||||||||||||||
2023-07-17 | The Error code has changed. The response structure of the API has changed | see changesets | ||||||||||||||||
|