镜像列表查询
接口功能介绍
列举对应规格节点所支持的镜像
接口约束
无
URI
GET /v4/cwai/node/image
路径参数
无
Query参数
名称 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 区域唯一ID | 81f7728662dd11ec810800155d307d5b | |
azName | 是 | String | 可用区名称 | az1 | |
deviceType | 是 | String | 设备类型 | physical.t10.large | |
flavorType | 是 | String | 规格类型 | EBM | |
serviceType | 是 | String | 服务类型,取值范围:paas, iaas | paas |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例值 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 区域的唯一ID | xxx-xxx-yyyzzz |
请求体body参数
无
响应参数
名称 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
statusCode | 是 | Integer | 请求成功(800)或者失败(900) | 800 | |
errorCode | 否 | String | 错误代码 | Cwai.Api.xxxx | |
message | 否 | String | 错误信息的英文描述 | Invalid Request | |
returnObj | 否 | Array of Objects | 返回的集群信息 | returnObj |
表returnObj
名称 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
nameEN | 是 | String | 名称 | CTyunOS 910B | |
distro | 是 | String | 操作系统发行版名称 | CTyunOS | |
version | 是 | String | 镜像版本 | 22.06.2@ascend-910b | |
imageUUID | 是 | String | 镜像UUID | im-u3rcbw5saubzawardf7wvxcginjf |
请求示例
GET https://cwai-global.ctapi.ctyun.cn/v4/cwai/node/image?regionID=81f7728662dd11ec810800155d307d5b&azName=az1&deviceType=physical.t10.large&flavorType=EBM&serviceType=paas
Content-Type:application/json
regionID:81f7728662dd11ec810800155d307d5b
请求体body
无
响应示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 800,
"returnObj": [
{
"nameEN": "CTyunOS",
"distro": "CTyunOS",
"version": "22.06.2@ascend-910b",
"imageUUID": "im-u3rcbw5saubzawardf7wvxcginjf"
}
]
}
错误参数返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 900,
"errorCode": "Cwai.Api.BadRequest",
"message": "***",
}
内部服务错误返回示例
TTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 900,
"errorCode": "Cwai.Api.InternalServerError",
"message": "***",
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功 |
错误码
错误码 | 描述 |
---|---|
Cwai.Api.BadRequest | 错误请求 |
Cwai.Api.NotFound | 资源不存在 |
Cwai.Api.StatusUnauthorized | 状态未授权 |
Cwai.Api.InternalServerError | 内部错误 |