备案控制台
文档
产品文档
输入文档关键字查找
首页 人工智能平台 PAI 操作指南 API参考 PAI-DSW API API目录 实例 GetInstance - 查询实例详情

GetInstance - 查询实例详情

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

查询DSW实例详情。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v2/instances/{InstanceId}

请求参数

名称类型必填描述示例值
InstanceIdstring是

实例 ID。如何获取实例 ID，请参见 ListInstances 。

dsw-730xxxxxxxxxx

返回参数

名称类型描述示例值
object

实例详情。

WorkspaceIdstring

工作空间 ID。

40823
WorkspaceNamestring

工作空间名称。

training_data
InstanceIdstring

实例 ID。

dsw-730xxxxxxxxxx
InstanceNamestring

实例名称。

training_data
EcsSpecstring

实例对应的 ECS 规格。

ecs.c6.large
Statusstring

实例状态。

Running
InstanceUrlstring

实例 Url。

https://dsw-cn-shanghai.data.aliyun.com/notebook.htm?instance=3****#/
JupyterlabUrlstring

Jupyterlab Url。

https://dsw-gateway-cn-shanghai.aliyun.com/dsw-3****/lab/
WebIDEUrlstring

Web IDE Url。

https://dsw-gateway-cn-shanghai.aliyun.com/dsw-3****/ide/
TerminalUrlstring

终端 Url。

https://dsw-gateway-cn-shanghai.aliyun.com/dsw-3****/tty/
AccumulatedRunningTimeInMslong

累计运行时间，单位为毫秒。

3600000
ImageIdstring

镜像 ID。

image-05cefd0be2exxxx
ImageUrlstring

镜像地址。

registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu
ImageNamestring

镜像名称。

py36_cpu_tf1.12_ubuntu
GmtCreateTimestring

实例创建时间。

2021-01-12T14:36:01Z
GmtModifiedTimestring

实例修改时间。

2021-01-12T14:36:01Z
UserIdstring

用户 ID。

161228528250****
UserNamestring

用户名称。

测试用户
Datasetsobject []

数据集集合。

DatasetIdstring

数据集 ID。

d-vsqjvsjp4orp5l****
MountPathstring

容器内挂载路径。

/mnt/data
UserVpcobject

User VPC 配置。

VpcIdstring

VPC ID。

vpc-xxxxx
VSwitchIdstring

交换机 ID。

vsw-xxxxx
SecurityGroupIdstring

安全组 ID。

sg-xxxxxx
ExtendedCIDRsarray

扩展网段。

  • 当交换机 ID 为空时，此参数可以不提供，系统会自动获取 VPC 下的所有网段。
  • 当交换机 ID 不为空时，此参数必须提供，建议填写 VPC 下的所有网段。
string

扩展网段。

"172.16.19.0/24","172.16.2.0/24","172.16.12.0/24"
DefaultRoutestring

Default Route

eth0 | eth1
InstanceShutdownTimerobject

定时关机任务。

InstanceIdstring

实例 ID。

dsw-730xxxxxxxxxx
GmtCreateTimestring

创建时间。

2021-01-12T14:36:01Z
GmtModifiedTimestring

修改时间。

2021-01-12T14:36:01Z
DueTimestring

设定关机时间。

2021-01-12T14:36:01Z
RemainingTimeInMslong

剩余关机时间，单位为毫秒。

3600000
ReasonCodestring

实例错误代码。

Internal Error
ReasonMessagestring

实例错误原因。

ImagePullBackOff
PaymentTypestring

支付类型。可能值：

  • PayAsYouGo：后付费。
  • Subscription：预付费。
PayAsYouGo
LatestSnapshotobject

最新保存的用户镜像。

ImageIdstring

镜像 ID。

image-05cefd0be2exxxx
ImageNamestring

镜像名称。

py36_cpu_tf1.12_ubuntu
ImageUrlstring

镜像 Url。

registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu
RepositoryUrlstring

镜像仓库 Url。

https://cr.console.aliyun.com/repository/cn-hangzhou/zouxu/kf/images
GmtCreateTimestring

快照创建时间。

2021-01-12T14:36:01Z
GmtModifiedTimestring

快照修改时间。

2021-01-12T14:36:01Z
ReasonCodestring

实例快照错误代码。

Internal Error
ReasonMessagestring

实例快照错误消息。

ImagePullBackOff
Statusstring

实例快照状态。

Pushing
AcceleratorTypestring

实例计算类型。

CPU
Accessibilitystring

工作空间内是否他人可见。可能值：

  • PRIVATE：表示工作空间内自己及管理员可见。
  • PUBLIC：工作空间所有用户可见。
PRIVATE
EnvironmentVariablesobject

环境变量。

string

用户自定义的环境变量，将会在实例启动后，注入到容器内部。

app: MAAS
ResourceIdstring

资源 ID。预付费时填写。

dsw-12345****
ResourceNamestring

实例规格。

  • 预付费（subscription），是请求的 CPU 和内存大小。
  • 后付费（pay-as-you-go），是选择的 ECS 规格。
ecs.g7.xlarge
Prioritylong

优先级，在分配资源给实例时，优先级越高的实例越优先。

1
RequestedResourceobject

资源配置，弹内或者轻量化时使用。

CPUstring

CPU 核数。

32
Memorystring

内存大小，单位 GB。

32
SharedMemorystring

共享内存大小，单位 GB。

32
GPUstring

GPU 数量。

4
GPUTypestring

GPU 显卡类型。可能值：

  • V100
  • A100
  • T4
  • A10
  • P100
v100
Labelsobject []

用户自定义标签。

{'foo': 'bar'}
Keystring

用户定义标签键。

stsTokenOwner
Valuestring

用户定义标签值。

123xxxxxxxx
IdleInstanceCullerobject

闲置实例自动关机设置。

InstanceIdstring

实例 ID。

dsw-730xxxxxxxxxx
CpuPercentThresholdinteger

CPU 使用率阈值，单位是百分比，取值 1~100，低于此值则认为实例当前处于闲置。

20
GpuPercentThresholdinteger

GPU 使用率阈值，单位是百分比，取值 1~100。如果实例为 GPU 类型，则此参数生效。CPU 和 GPU 同时低于阈值则认为指定实例处于闲置。

10
MaxIdleTimeInMinutesinteger

闲置等待时间阈值，单位是分钟。如果闲置时长超过此值，将自动停止 DSW 实例。

60
IdleTimeInMinutesinteger

实例当前闲置时长，单位是分钟。

30
InstanceSnapshotListobject []

实例快照列表。

[]
ImageIdstring

镜像 ID。

image-05cefd0be2exxxx
ImageNamestring

镜像名称。

py36_cpu_tf1.12_ubuntu
ImageUrlstring

镜像 Url。

registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu
RepositoryUrlstring

镜像仓库 Url。

https://cr.console.aliyun.com/repository/cn-hangzhou/zouxu/kf/images
GmtCreateTimestring

快照创建时间。

2021-01-12T14:36:01Z
GmtModifiedTimestring

快照修改时间。

2021-01-12T14:36:01Z
ReasonCodestring

实例快照错误代码。

Internal Error
ReasonMessagestring

实例快照错误消息。

ImagePullBackOff
Statusstring

实例快照状态。

Pushing
CloudDisksobject []

实例的云盘列表

[]
Capacitystring

云盘容量

30Gi
SubTypestring

云盘使用方式, rootfs 挂载为 rootfs

rootfs
MountPathstring

容器内挂载云盘路径

/mmt/workspace
Pathstring

云盘内被挂载目录路径

/workspace
WorkspaceSourcestring

工作空间指向的存储，如果不指定，则依次使用 NAS，CloudDisk 或者本地磁盘

d-123456789
RequestIdstring

请求 ID。

E7D55162-4489-1619-AAF5-3F97D5FC****
Successboolean

成功标志，可能值：

  • true
  • false
true
Messagestring

操作结果说明。

  • 执行成功时，返回结果为 null。
  • 执行失败时，描述失败原因。
null
Codestring

状态码，可能值：

  • InternalError：内部错误（除了参数验证错误外的其他错误，目前都归类到内部错误）。
  • ValidationError：参数验证错误。
null
HttpStatusCodeinteger

HTTP 状态码，可能值：

  • 400
  • 404
null
Driverstring

NVIDIA 驱动配置

535.54.03

示例

正常返回示例

JSON格式

{
  "WorkspaceId": "40823",
  "WorkspaceName": "training_data",
  "InstanceId": "dsw-730xxxxxxxxxx",
  "InstanceName": "training_data",
  "EcsSpec": "ecs.c6.large",
  "Status": "Running",
  "InstanceUrl": "https://dsw-cn-shanghai.data.aliyun.com/notebook.htm?instance=3****#/",
  "JupyterlabUrl": "https://dsw-gateway-cn-shanghai.aliyun.com/dsw-3****/lab/",
  "WebIDEUrl": "https://dsw-gateway-cn-shanghai.aliyun.com/dsw-3****/ide/",
  "TerminalUrl": "https://dsw-gateway-cn-shanghai.aliyun.com/dsw-3****/tty/",
  "AccumulatedRunningTimeInMs": 3600000,
  "ImageId": "image-05cefd0be2exxxx",
  "ImageUrl": "registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu",
  "ImageName": "py36_cpu_tf1.12_ubuntu",
  "GmtCreateTime": "2021-01-12T14:36:01Z",
  "GmtModifiedTime": "2021-01-12T14:36:01Z",
  "UserId": "161228528250****",
  "UserName": "测试用户",
  "Datasets": [
    {
      "DatasetId": "d-vsqjvsjp4orp5l****",
      "MountPath": "/mnt/data"
    }
  ],
  "UserVpc": {
    "VpcId": "vpc-xxxxx",
    "VSwitchId": "vsw-xxxxx",
    "SecurityGroupId": "sg-xxxxxx",
    "ExtendedCIDRs": [
      "\"172.16.19.0/24\",\"172.16.2.0/24\",\"172.16.12.0/24\""
    ],
    "DefaultRoute": "eth0 | eth1",
    "ForwardInfos": [
      {
        "Enable": true,
        "ContainerName": "dsw-notebook",
        "Port": "22",
        "NatGatewayId": "ngw-bp1uewa15k4iy5770****",
        "EipAllocationId": "eip-25877c70gddh****",
        "SSHPublicKey": "",
        "ConnectInfo": {
          "Phase": "Ready",
          "Message": "DNAT and privateZone are both ready.",
          "Intranet": {
            "Endpoint": "dsw-notebook-22-urz3u6cnu0uts7ej9r.dsw-5cc6083084818f60.dsw.pai.alibaba.com",
            "Port": "22"
          },
          "Internet": {
            "Endpoint": "47.111.119.114",
            "Port": "22"
          }
        }
      }
    ]
  },
  "InstanceShutdownTimer": {
    "InstanceId": "dsw-730xxxxxxxxxx",
    "GmtCreateTime": "2021-01-12T14:36:01Z",
    "GmtModifiedTime": "2021-01-12T14:36:01Z",
    "DueTime": "2021-01-12T14:36:01Z",
    "RemainingTimeInMs": 3600000
  },
  "ReasonCode": "Internal Error",
  "ReasonMessage": "ImagePullBackOff",
  "PaymentType": "PayAsYouGo",
  "LatestSnapshot": {
    "ImageId": "image-05cefd0be2exxxx",
    "ImageName": "py36_cpu_tf1.12_ubuntu",
    "ImageUrl": "registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu",
    "RepositoryUrl": "https://cr.console.aliyun.com/repository/cn-hangzhou/zouxu/kf/images",
    "GmtCreateTime": "2021-01-12T14:36:01Z",
    "GmtModifiedTime": "2021-01-12T14:36:01Z",
    "ReasonCode": "Internal Error",
    "ReasonMessage": "ImagePullBackOff",
    "Status": "Pushing"
  },
  "AcceleratorType": "CPU",
  "Accessibility": "PRIVATE",
  "EnvironmentVariables": {
    "key": "app: MAAS"
  },
  "ResourceId": "dsw-12345****",
  "ResourceName": "ecs.g7.xlarge",
  "Priority": 1,
  "RequestedResource": {
    "CPU": "32",
    "Memory": "32",
    "SharedMemory": "32",
    "GPU": "4",
    "GPUType": "v100"
  },
  "Labels": [
    {
      "Key": "stsTokenOwner",
      "Value": "123xxxxxxxx"
    }
  ],
  "IdleInstanceCuller": {
    "InstanceId": "dsw-730xxxxxxxxxx",
    "CpuPercentThreshold": 20,
    "GpuPercentThreshold": 10,
    "MaxIdleTimeInMinutes": 60,
    "IdleTimeInMinutes": 30
  },
  "InstanceSnapshotList": [
    {
      "ImageId": "image-05cefd0be2exxxx",
      "ImageName": "py36_cpu_tf1.12_ubuntu",
      "ImageUrl": "registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu",
      "RepositoryUrl": "https://cr.console.aliyun.com/repository/cn-hangzhou/zouxu/kf/images",
      "GmtCreateTime": "2021-01-12T14:36:01Z",
      "GmtModifiedTime": "2021-01-12T14:36:01Z",
      "ReasonCode": "Internal Error",
      "ReasonMessage": "ImagePullBackOff",
      "Status": "Pushing"
    }
  ],
  "CloudDisks": [
    {
      "Capacity": "30Gi",
      "SubType": "rootfs",
      "MountPath": "/mmt/workspace",
      "Path": "/workspace"
    }
  ],
  "WorkspaceSource": "d-123456789",
  "RequestId": "E7D55162-4489-1619-AAF5-3F97D5FC****",
  "Success": true,
  "Message": "null",
  "Code": "null",
  "HttpStatusCode": 0,
  "Driver": "535.54.03"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-12-27OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
2023-11-14OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
2023-08-08OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
2023-07-25OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
2023-06-09OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
2023-05-06OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
2022-01-20OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
2022-01-20OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
文档推荐
  • 本页导读 （1）
文档反馈