调用CreateInstance创建一个DSW实例。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求语法
POST /api/v2/instances
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| body | object | 否 | 实例属性。 | |
| WorkspaceId | string | 否 | 工作空间 ID。如何获取工作空间 ID，请参见 ListWorkspaces 。 | 40823 |
| InstanceName | string | 否 | 实例名称。格式要求：
| training_data |
| EcsSpec | string | 否 | 实例对应的 ECS 规格。如何获取 ECS 规格，请参见 ListEcsSpecs 。 | ecs.c6.large |
| ImageId | string | 否 | 镜像 ID。如何获取镜像 ID，请参见 ListImages 。 | image-05cefd0be2exxxx |
| ImageUrl | string | 否 | 镜像地址。如何获取镜像地址，请参见 ListImages 。 | registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu |
| Datasets | object [] | 否 | 数据集集合。 | |
| DatasetId | string | 否 | 数据集 ID。如何获取数据集 ID，请参见 ListDatasets 。 | d-vsqjvsjp4orp5l206u |
| MountPath | string | 否 | 容器内挂载路径。 | /mnt/data |
| UserVpc | object | 否 | User VPC 配置。 | |
| VpcId | string | 否 | VPC ID。 | vpc-xxxxx |
| VSwitchId | string | 否 | 交换机 ID。 | vsw-xxxxx |
| SecurityGroupId | string | 否 | 安全组 ID。 | sg-xxxxxx |
| ExtendedCIDRs | array | 否 | 扩展网段。
| |
| string | 否 | 扩展网段。 | "172.16.19.0/24","172.16.2.0/24","172.16.12.0/24" | |
| DefaultRoute | string | 否 | 默认路由。取值如下：
| eth0 |
| ForwardInfos | array | 否 | 端口透出信息。 | |
| ForwardInfo | 否 | 端口透出信息列表。 | ||
| Accessibility | string | 否 | 工作空间内是否他人可见。取值如下：
| PRIVATE |
| EnvironmentVariables | object | 否 | 环境变量。 | |
| string | 否 | 用户指定环境变量，DSW 实例启动后，指定环境变量会被注入到容器中。 | MAAS | |
| ResourceId | string | 否 | 资源组 ID，预付费时配置。如何创建专有资源组，请参见准备及管理 DLC 资源组集群。 | dsw-123456789 |
| Priority | long | 否 | 优先级，在分配资源给实例时，优先级越高的实例越优先。取值范围为 1~9。
| 1 |
| RequestedResource | object | 否 | 资源配置，弹内或者轻量化时使用。 | |
| CPU | string | 否 | CPU 核数。 | 32 |
| Memory | string | 否 | 内存大小。单位为 GB。 | 32GB |
| SharedMemory | string | 否 | 共享内存大小。单位为 GB。 | |
| GPU | string | 否 | GPU 数量。 | 4 |
| GPUType | string | 否 | GPU 显卡类型，取值如下：
| v100 |
| Labels | object [] | 否 | 用户自定义标签。 | {'foo': 'bar'} |
| Key | string | 否 | 用户定义标签键。 | stsTokenOwner |
| Value | string | 否 | 用户定义标签值。 | 123xxxxxxxx |
| CloudDisks | object [] | 否 | 云盘列表。 | [] |
| Capacity | string | 否 | 为每个按量付费实例赠送免费云盘做持久化存储。
| 30 |
| SubType | string | 否 | rootfs：表示将磁盘挂载为系统盘，系统环境存储在磁盘上。 | rootfs |
| MountPath | string | 否 | 磁盘在容器内额外挂载的数据目录路径。 | /mnt/workspace |
| Path | string | 否 | 磁盘被挂载的路径。 | /mnt/systemdist |
| Status | object | 否 | 云盘或者快照使用情况。 | |
| Available | long | 否 | 可使用量，单位 Byte。 | 31841058816 |
| Usage | long | 否 | 已使用量，单位 Byte。 | 371195904 |
| Capacity | long | 否 | 容量，单位 Byte。 | 32212254720 |
| WorkspaceSource | string | 否 | 选择云盘作为默认工作目录。 | rootfsCloudDisk |
| UserId | string | 否 | 实例所有者的账号 ID。支持阿里云账号或 RAM 用户。 | 161228528250**** |
| Driver | string | 否 | NVIDIA 驱动配置。 | 535.54.03 |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "E7D55162-4489-1619-AAF5-3F97D5FCA948",
"Success": true,
"Message": "\"XXX\"",
"Code": "null",
"HttpStatusCode": 200,
"InstanceId": "dsw-730xxxxxxxxxx"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||
|---|---|---|---|---|
| 2024-01-09 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2023-12-27 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2023-11-14 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2023-08-09 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2023-08-08 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2023-07-25 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2023-03-28 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2022-09-05 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2022-01-20 | API 内部配置变更，不影响调用 | 看变更集 | ||
| ||||
| 2022-01-20 | OpenAPI 返回结构发生变更 | 看变更集 | ||
|