文档首页/ 数据复制服务 DRS/ API参考/ API v5(公测中)/ 资源管理/ 查询链路的任务规格信息 - ShowLinkFlavors
更新时间:2026-07-29 GMT+08:00

查询链路的任务规格信息 - ShowLinkFlavors

功能介绍

根据参数不同,可查询实时迁移、实时同步、实时灾备等场景的不同链路的任务规格信息。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/link-flavors

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

租户在某一Region下的Project ID。

获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

engine_type

String

参数解释

引擎类型。

约束限制

不涉及。

取值范围

具体取值范围可由查询可用链路信息获取。

默认取值

不涉及

job_type

String

参数解释

任务场景。

约束限制

不涉及。

取值范围

  • migration:实时迁移。
  • sync:实时同步。
  • cloudDataGuard:实时灾备。
  • subscription:数据订阅。
  • replay:录制回放。
  • verify:校验任务。
  • cdc:CDC任务。

默认取值

不涉及。

job_direction

String

参数解释

任务方向。

约束限制

不涉及。

取值范围

  • up:入云 ,灾备场景时对应本云为备。
  • down:出云,灾备场景时对应本云为主。
  • non-dbs:自建。

默认取值

不涉及。

net_type

String

参数解释

网络类型。

约束限制

不涉及。

取值范围

  • eip:公网网络。
  • vpc:VPC网络,灾备场景不支持选择VPC网络。
  • vpn:VPN、专线网络。

默认取值

不涉及

node_type

String

参数解释

任务实例规格类型。

约束限制

不涉及。

取值范围

  • micro:极小规格。
  • small:小规格。
  • medium:中规格。
  • high:大规格。
  • xlarge:超大规格。
  • 2xlarge:极大规格。

默认取值

不涉及

is_multi_write

Boolean

参数解释

灾备类型是否双主灾备。

约束限制

job_type 是cloudDataGuard时,必填。灾备类型是双主灾备时,is_multi_write取值true, 否则为false。

取值范围

  • true 多写任务
  • false 非多写任务

默认取值

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

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:英语
  • zh-cn:中文

默认取值:

en-us

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

vm_flavor

object

参数解释

虚拟机规格信息。

详情请参见表5

volume_flavor

object

参数解释

磁盘规格信息。

详情请参见表5

flow_flavor

object

参数解释

流量规格信息。

详情请参见表5

表5 FlavorInfo

参数

参数类型

描述

id

String

参数解释

规格id。

约束限制

不涉及。

取值范围

不涉及。

cloud_service_type

String

参数解释

云服务类型。

约束限制

不涉及。

取值范围

不涉及。

spec_type_code

String

参数解释

类型规格码。

约束限制

不涉及。

取值范围

不涉及。

spec_code

String

参数解释

规格码。

约束限制

不涉及。

取值范围

不涉及。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码,当任务报错时返回的错误代码。

约束限制

  • 最小长度:12
  • 最大长度:12

取值范围

格式为DRS.XXXXXX。

error_msg

String

参数解释

错误详细信息,当任务执行失败时返回的具体错误描述。

约束限制

  • 最小长度:1
  • 最大长度:512

取值范围

不涉及。

请求示例

查询高规格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." 
}

状态码

状态码

描述

200

OK

400

Bad Request

其他状态请参见状态码

错误码

请参见错误码