容器
查询容器实例详情
1.接口说明
接口路径:/ai/openapi/v2/instance-service/{id}/detail
请求方式:GET
请求数据类型:
接口描述:查询容器实例详情
2.请求消息
请求参数:
Headers:
| 名称 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| token | string | 是 | 接口凭证 | eyJhbGciOiJIUzI1... |
参数:
| 名称 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| id | string | 是 | 容器实例ID | 4c1f43ddb030483e89b55413bee6c004 |
3.请求示例
cURL请求示例
shell
curl --location 'https://scnet-demo.accloud.cn/ai/openapi/v2/instance-service/4c1f43ddb030483e89b55413bee6c004/detail' \
--header 'token: <Token>'Java请求示例
java
import okhttp3.*;
public class QueryContainerDetailDemo {
public static final String TOKEN = "<Token>";
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://scnet-demo.accloud.cn/ai/openapi/v2/instance-service/4c1f43ddb030483e89b55413bee6c004/detail")
.method("GET", null)
.addHeader("token", TOKEN)
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}
}Python请求示例
python
import requests
url = "https://scnet-demo.accloud.cn/ai/openapi/v2/instance-service/4c1f43ddb030483e89b55413bee6c004/detail"
payload = {}
headers = {
"token": "<Token>"
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)4.响应消息
返回参数:
| 名称 | 类型 | 描述 | 示例 |
|---|---|---|---|
| msg | string | 信息 | 操作成功 |
| code | string | 状态码 | 0 |
| data | Object | 容器详情 | |
| acceleratorType | string | 加速器类型 | |
| taskType | string | 任务类型 | |
| containerPortInfoList | array | 容器公开服务的端口信息集合 | |
| accessUrl | string | 用户访问容器内服务的入口 | |
| containerPort | string | 容器内已经开放的端口 | |
| protocolType | string | 协议类型 | |
| cpuNumber | int | CPU数量 | |
| createTime | string | 创建时间 | |
| currentIndex | int | 容器当前索引 | |
| description | string | 描述信息 | |
| duration | string | 持续时间 | |
| endTime | string | 结束时间 | |
| gpuNumber | int | GPU数量 | |
| headerNotebookId | string | 容器实例关联的首个notebook任务ID | |
| id | string | 容器实例ID | |
| imagePath | string | 镜像路径 | |
| instanceServiceName | string | 名称 | |
| mountInfoList | array | 容器挂载信息集合 | |
| sourcePath | string | 挂载路径 | |
| type | string | 类型 | |
| ramSize | int | 内存 | |
| remainingTime | string | 剩余时间 | |
| resourceGroup | string | 资源分组 | |
| resourceSpec | string | 资源配置 | |
| startScriptActionScope | string | 启用脚本范围 | |
| startScriptPath | string | 启动脚本路径 | |
| startScriptContent | string | 启动脚本的内容 | |
| startTime | string | 开始时间 | |
| status | string | 状态 | |
| taskNumber | string | 实例任务数量 | |
| tensorboardId | string | TB-ID | |
| tensorboardPath | string | TB路径 | |
| timeoutLimit | string | 超时时间 | |
| useStartScript | boolean | 启用脚本 | |
| userName | string | 用户名 | |
| version | string | 镜像名称 |
返回示例:
json
{
"code":"0",
"msg":"SUCCESS",
"data":{
"id":"4c1f43ddb030483e89b55413bee6c004",
"headerNotebookId":"1a07f501dc89459686996a26ef521abb",
"instanceServiceName":"Instances_2205113837",
"currentIndex":2,
"gpuNumber":1,
"cpuNumber":3,
"ramSize":15360,
"acceleratorType":"gpu",
"resourceGroup":"TeslaM40",
"resourceSpec":"3 核心; 1 加速器; 15.0G 内存",
"taskNumber":1,
"timeoutLimit":"unlimited",
"userName":"magic2",
"version":"jupyter:4.4-py3.7-cpu",
"imagePath":"10.0.35.26:5000/gpu/admin/base/jupyter:4.4-py3.7-cpu",
"status":"Waiting",
"taskType":"ssh",
"description":"",
"createTime":"2022-05-11 19:30:34",
"startTime":null,
"endTime":null,
"duration":"--",
"remainingTime":"--",
"tensorboardId":null,
"tensorboardPath":null,
"mountInfoList":[
],
"containerPortInfoList":[
],
"useStartScript":false,
"startScriptContent":"",
"startScriptPath":null,
"startScriptActionScope":"all",
"headerNotebookIp":null
}
}5.错误码
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| 10001 | 内部异常(其他异常) |
| 10003 | 参数不全 |
| 10004 | 参数无效 |
| 10007 | 用户已被冻结 |
| 10008 | 权限不足 |
| 10009 | 没有权限访问接口 |
| 10010 | 文件校验失败 |
| 10011 | 文件过大 |
| 10012 | 连接中断 |