接口功能介绍
查询物理机本地盘可选择的raid类型
接口约束
无
URI
GET /v4/ebm/raid-type-list
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 区域ID | 81f7728662dd11ec810800155d307d5b | |
azName | 是 | String | 可用区名称或者 default。您可以调用 https://eop.ctyun.cn/ebp/ctapiDocument/search?sid=25&api=5855&data=87 获取资源池信息,查询结果中zoneList内返回可用区名称,若查询结果中zoneList为空,即为单可用区,本字段填写default | az1 | |
deviceType | 是 | String | 套餐类型 | physical.t3.large | |
volumeType | 否 | String | 磁盘类型(system/data) | system |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败),默认值:800 | 800 | |
errorCode | String | 业务细分码,为product.module.code三段式码,详见错误码说明 | Ebm.RaidType.NotValid | |
message | String | 响应结果的描述,一般为英文描述 | error request | |
description | String | 响应结果的描述,一般为中文描述 | 错误请求 | |
returnObj | Object | 返回参数,参考表returnObj | {} | returnObj |
表returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
totalCount | Integer | 总记录数 | 200 | |
results | Array of Objects | 分页明细,元素类型是results,定义请参考表results | [{},{}] | results |
表results
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
deviceType | String | 套餐类型 | physical.t2.large | |
volumeType | String | 磁盘类型 | DATA | |
uuid | String | raid uuid | r-wtzluqacgzzxgunnabdkpnpjew3d | |
nameEn | String | raid英文名称 | RAID1 | |
nameZh | String | raid中文名称 | RAID1 | |
volumeDetail | String | 对应套餐磁盘描述 | 2*480 SSD | |
descriptionEn | String | raid英文介绍 | NO RAID means that each physical disk is displayed independently as a logical disk. There is no block stripping and no data redundancy. | |
descriptionZh | String | raid中文介绍 | NO RAID是每个物理磁盘独立显示为一个逻辑盘,没有数据块分条(no block stripping),不提供数据冗余。 |
请求示例
Query
/v4/ebm/raid-type-list?regionID=41f64827f25f468595ffa3a5deb5d15d&azName=default&deviceType=physical.t2.large.1&volumeType=system
响应示例
{
"returnObj": {
"totalCount": 2,
"results": [
{
"uuid": "r-sfykwibcvcyztuez3mk1klyha9nn",
"volumeType": "SYSTEM",
"descriptionEn": "RAID0 means that the entire logical disk data is striped among multiple physical disks, it allows read/write in parallel and provides the fastest speed with no redundancy.",
"deviceType": "physical.t2.large.1",
"descriptionZh": "RAID0是整个逻辑盘的数据是被分条(stripped)分布在多个物理磁盘上,可以并行读/写,提供最快的速度,但没有冗余能力。",
"nameEn": "RAID0",
"volumeDetail": "RAID0",
"nameZh": "RAID0"
},
{
"uuid": "r-wtzluqacgzzxgunnabdkpnpjew3d",
"volumeType": "SYSTEM",
"descriptionEn": "RAID1 also known as mirroring method, provides data redundancy. In the entire mirroring process, only half of the disk capacity is valid, the other half is used to store the same data. RAID1 has taken security into consideration with half capacity and full speed.",
"deviceType": "physical.t2.large.1",
"descriptionZh": "RAID1又称镜像方式,提供数据的冗余。在整个镜像过程中,只有一半的磁盘容量是有效的(另一半磁盘容量用来存放同样的数据),RAID1考虑了安全性,容量减半、速度不变。",
"nameEn": "RAID1",
"volumeDetail": "2*960G SSD",
"nameZh": "RAID1"
}
]
},
"errorCode": "",
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功 |
错误码
错误码 | 描述 |
---|---|
Ebm.RaidType.NotValid | 请求参数非法 |
Ebm.RaidType.NotFound | raid不存在 |
Ebm.Common.CheckError | 内部错误,请重试 |
其他 | 参见公共错误码说明 |