POST 创建实例
POST /v1/gpu/instance/create
Body 请求参数
{
"productId": "78",
"gpuNum": 1,
"diskSize": 100,
"imageUrl": "fooocus:v1",
"billingMode": "afterusage",
"name": "test_openapi_1",
"duration": 1,
"imageAuth": "",
"ports": "8888,8000,9000",
"envs": [
{
"key": "JUPYTER_PASSWORD",
"value": "123"
}
],
"command": "",
"clusterId": "5",
"networkStorageId": "fs-xxxxxxxx",
"localStorageMountPoint": "/ppio_local2",
"networkStorageMountPoint": "/ppio_net2"
}
请求参数
名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
---|---|---|---|---|---|
X-Appid | header | string | 否 | none | |
X-Nonce | header | string | 否 | none | |
X-Timestamp | header | string | 否 | none | |
X-Signature | header | string | 否 | none | |
X-Request-Id | header | string | 否 | none | |
body | body | object | 否 | none | |
» name | body | string | 否 | 实例名 | none |
» productId | body | string | 是 | 产品 ID(通过产品列表获取) | none |
» gpuNum | body | integer | 是 | 显卡数量 | none |
» diskSize | body | integer | 是 | 本地存储大小(单位 GB) | none |
» billingMode | body | string | 是 | 计费方式(产品列表价格信息返回) | none |
» duration | body | integer | 否 | 包周期时长(单位根据计费方式,日/周/月) | none |
» imageUrl | body | string | 是 | 镜像地址 | none |
» imageAuth | body | string | 否 | 镜像认证信息(格式: username:password) | none |
» ports | body | string | 否 | 端口信息(端口/协议) | none |
» envs | body | [object] | 否 | 环境变量 | none |
»» key | body | string | 是 | 变量名 | none |
»» value | body | string | 是 | 变量值 | none |
» command | body | string | 否 | 自定义 docker 启动命令 | none |
» clusterId | body | string | 否 | 集群 Id(通过集群列表获取) | none |
» networkStorageId | body | string | 否 | 云存储 Id(通过网络存储列表获取) | none |
» localStorageMountPoint | body | string | 否 | 本地存储挂载地址 默认/ppio_local | none |
» networkStorageMountPoint | body | string | 否 | 网络存储挂载地址 默认/ppio_net0 | none |
返回示例
200 Response
{
"id": "string"
}
返回结果
状态码 | 状态码含义 | 说明 | 数据模型 |
---|---|---|---|
200 | OK | A successful response. | Inline |
返回数据结构
状态码 200
名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
---|---|---|---|---|---|
» id | string | true | none | 实例 ID | none |