接口说明
查询API的版本信息列表,包括API的版本兼容性、域名信息等。
URL
GET https://ims.cn-north-1.myhuaweicloud.com/{version}
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
version
|
string | path | 是 |
API版本号。例如:v2.0 |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
versions
|
Array of OsVersionResponse objects | 是 |
版本信息 |
200 versions
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
status
|
string | 是 |
接口状态。 |
|
id
|
string | 否 |
接口ID。 |
|
links
|
Array of Links objects | 否 |
自描述信息。 |
200 versions.links
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
href
|
string | 是 |
域名 |
|
rel
|
string | 是 |
域名描述 |
返回码: 400
Bad Request
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorMessageInfo object | 是 |
请求失败响应体 |
400 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
code
|
string | 是 |
错误码 |
|
message
|
string | 是 |
错误信息 |
返回码: 401
Unauthorized
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorMessageInfo object | 是 |
请求失败响应体 |
401 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
code
|
string | 是 |
错误码 |
|
message
|
string | 是 |
错误信息 |
返回码: 403
Forbidden
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorMessageInfo object | 是 |
请求失败响应体 |
403 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
code
|
string | 是 |
错误码 |
|
message
|
string | 是 |
错误信息 |
返回码: 500
Internal Server Error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorMessageInfo object | 是 |
请求失败响应体 |
500 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
code
|
string | 是 |
错误码 |
|
message
|
string | 是 |
错误信息 |
请求示例
示例 1
"GET https://{Endpoint}/"
返回示例
返回码：200
OK
示例 1
{
"versions": [
{
"status": "CURRENT",
"id": "v2.2",
"links": [
{
"href": "https://image.az1.dc1.domainname.com/v2/",
"rel": "self"
}
]
}
]
}
"versions": [
{
"status": "CURRENT",
"id": "v2.2",
"links": [
{
"href": "https://image.az1.dc1.domainname.com/v2/",
"rel": "self"
}
]
}
]
}
SDK
点击 镜像服务 (IMS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
