查询链路的任务规格信息 - ShowLinkFlavors
功能介绍
根据参数不同,可查询实时迁移、实时同步、实时灾备等场景的不同链路的任务规格信息。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v5/{project_id}/link-flavors
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 租户在某一Region下的Project ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| engine_type | 否 | String | 参数解释: 引擎类型。 约束限制: 不涉及。 取值范围: 具体取值范围可由查询可用链路信息获取。 默认取值: 不涉及 |
| job_type | 否 | String | 参数解释: 任务场景。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
| job_direction | 否 | String | 参数解释: 任务方向。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
| net_type | 否 | String | 参数解释: 网络类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及 |
| node_type | 否 | String | 参数解释: 任务实例规格类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及 |
| is_multi_write | 否 | Boolean | 参数解释: 灾备类型是否双主灾备。 约束限制: job_type 是cloudDataGuard时,必填。灾备类型是双主灾备时,is_multi_write取值true, 否则为false。 取值范围:
默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 参数解释: 发送的实体的MIME类型。推荐用户默认使用application/json,如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。 约束限制: 不涉及。 取值范围: application/json 默认取值: application/json |
| X-Auth-Token | 是 | String | 参数解释: 从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| X-Language | 否 | String | 参数解释: 请求语言类型。 约束限制: 不涉及。 取值范围:
默认取值: en-us |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| vm_flavor | object | 参数解释: 虚拟机规格信息。 详情请参见表5。 |
| volume_flavor | object | 参数解释: 磁盘规格信息。 详情请参见表5。 |
| flow_flavor | object | 参数解释: 流量规格信息。 详情请参见表5 。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 规格id。 约束限制: 不涉及。 取值范围: 不涉及。 |
| cloud_service_type | String | 参数解释: 云服务类型。 约束限制: 不涉及。 取值范围: 不涉及。 |
| spec_type_code | String | 参数解释: 类型规格码。 约束限制: 不涉及。 取值范围: 不涉及。 |
| spec_code | String | 参数解释: 规格码。 约束限制: 不涉及。 取值范围: 不涉及。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,当任务报错时返回的错误代码。 约束限制:
取值范围: 格式为DRS.XXXXXX。 |
| error_msg | String | 参数解释: 错误详细信息,当任务执行失败时返回的具体错误描述。 约束限制:
取值范围: 不涉及。 |
请求示例
查询高规格VPC网络类型的同步入云Mysql链路的任务规格信息。
https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/link-flavors?engine_type=mysql&job_type=sync&job_direction=up&net_type=vpc&node_type=high 响应示例
状态码:200
OK
{
"vm_flavor" : {
"id" : "59ac1c64-b798-4c40-93c2-a24c8514314c",
"cloud_service_type" : "hws.service.type.drs",
"spec_type_code" : "hws.resource.type.drs.vm",
"spec_code" : "drs.lg.sync"
},
"volume_flavor" : null,
"flow_flavor" : {
"id" : "f5dc1c46-9881-43c1-95a3-e00d45a7d2c5",
"cloud_service_type" : "hws.service.type.drs",
"spec_type_code" : "hws.resource.type.drs.flow",
"spec_code" : "drs.vpc.flow.in.sync"
}
} 状态码:400
Bad Request
{
"error_code" : "DRS.10000009",
"error_msg" : "Parameter error."
} 错误码
请参见错误码。