调用CreateInstance，创建实例。

调试

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

请求语法

POST /api/v1/instances/ HTTP/1.1
Content-Type:application/json

{
  "InstanceName" : "String",
  "EcsSpec" : "String",
  "ImageId" : "String",
  "NasFileSystemId" : "String",
  "UserVpc" : {
    "VpcId" : "String",
    "VswitchId" : "String",
    "RoleArn" : "String",
    "SecurityGroupId" : "String"
  },
  "ImageUrl" : "String"
}

请求参数

表 1. 请求Body参数
参数名称 类型 是否必选 示例 说明
InstanceName String 是 test

实例名称
EcsSpec String 是 ecs.g6.8xlarge

实例规格（PAI-DSW ListEcsSpecs 获取）

ImageId String 否 img-d7adefa77718****

镜像ID（PAI-DSW ListImages获取）

NasFileSystemId String 否 0051a4****

nas文件系统ID（ 文件存储 NAS DescribeFileSystems获取）

UserVpc UserVpc 否

打通的VPC网络配置
ImageUrl String 否 registry.cn-shanghai.aliyuncs.com/pai_product/image:pai-images-dsw-ubuntu18.04-py3.6-paitf1.15-buil****

镜像地址

响应体语法

HTTP/1.1 200 OK
Content-Type:application/json

{
  "InstanceId" : "String",
  "RequestId" : "String"
}

响应参数

表 2. 响应Body参数
参数名称 类型 示例 说明
InstanceId String dsw-d7adefa77718****

实例ID
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID

创建一个实例

POST /api/v1/instances/ HTTP/1.1
Host:pai-dsw.aliyuncs.com
Content-Type:application/json

{
  "InstanceName" : "test",
  "EcsSpec" : "ecs.g6.8xlarge",
  "ImageId" : "img-d7adefa77718****",
  "NasFileSystemId" : "0051a4****",
  "UserVpc" : {
    "VpcId" : "vpc-bp1i4x5wj2kgro93l****",
    "VswitchId" : "vsw-bp1irltu139f5qufw****",
    "RoleArn" : "acs:ram::123456789012****:role/appserverrole",
    "SecurityGroupId" : "sg-bp10mttdnsk58y5n****"
  },
  "ImageUrl" : "registry.cn-shanghai.aliyuncs.com/pai_product/image:pai-images-dsw-ubuntu18.04-py3.6-paitf1.15-buil****"
}

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<InstanceId>dsw-d7adefa77718****</InstanceId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "InstanceId" : "dsw-d7adefa77718****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

错误码

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

开发者资源

  • SDK

    阿里云为您提供多种语言的SDK，帮助您快速通过API集成阿里云的产品和服务，推荐您使用SDK调用API，已免除您手动签名验证。

  • OpenAPI Explorer

    快速检索，可视化调试API，在线命令行工具，同步动态生成可执行的SDK代码示例。

  • 阿里云CLI

    阿里云资产管理和配置工具，可通过命令方式同时管理多个阿里云产品和服务，简单快捷，是您上云好帮手。