文档首页/数据复制服务 DRS/API参考/API v5（公测中）/实例详情/获取任务价格信息 - ShowMetering
更新时间：2025-12-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取任务价格信息 - ShowMetering

功能介绍

获取询价接口的参数。

接口约束

仅支持部分Region使用，详情参考终端节点。

授权信息

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

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

URI

GET /v5/{project_id}/jobs/{job_id}/metering

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

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

job_id

是

String

任务ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。

缺省值：application/json

X-Auth-Token

是

String

从IAM服务获取的用户Token。

用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

否

String

请求语言类型。

缺省值：en-us

枚举值：

  • en-us
  • zh-cn

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

product_info_list

Array of objects

资源信息列表。

详情请参见表4。

表4 product_info_list字段数据结构说明

参数

参数类型

描述

id

String

ID标识，同一次询价中不能重复，用于标识返回询价结果和请求的映射关系。

cloud_service_type

String

用户购买云服务产品的云服务类型，例如EC2，云服务类型为hws.service.type.ec2。

resource_type

String

用户购买云服务产品的资源类型，例如EC2中的VM，资源类型为hws.resource.type.vm。

resource_spec_code

String

用户购买云服务产品的资源规格，例如VM的小型规格，资源规格为m1.tiny。

resource_size

Integer

资源容量度量标识。

resource_size_measure_id

Integer

资源容量大小，例如购买的卷大小或带宽大小。

usage_factor

String

使用量因子，按需计费必填，取值和话单中的使用量因子一致，云服务和使用量因子对应关系如下：

  • Duration：云服务器
  • flow：流量

usage_value

Double

使用量值，按需询价必填，例如按小时询价，使用量值为1，使用量单位为小时。

usage_measure_id

Integer

使用量单位标识，按需询价必填，例如按小时询价，使用量值为1，使用量单位为小时。

  • 4：小时
  • 10：GB
  • 11：MB
  • 13：Byte
  • 17：FLOW_GB

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

最小长度：12

最大长度：12

error_msg

String

错误描述。

最小长度：1

最大长度：512

请求示例

获取任务价格信息请求示例。

https://{endpoint}/v5/{project_id}/jobs/{job_id}/metering

响应示例

状态码：200

OK 
{
  "product_info_list": [
    {
      "id": "78f3a9f1-3d8d-43f0-acc4-ee93f8a9d934",
      "cloud_service_type": "hws.service.type.drs",
      "resource_type": "hws.resource.type.drs.vm",
      "resource_spec_code": "drs.lg.dr",
      "resource_size": 1,
      "usage_factor": "Duration",
      "usage_value": 1,
      "usage_measure_id": 4
    },
    {
      "id": "f52a74ce-5b11-4c5b-b365-488d9fc38882",
      "cloud_service_type": "hws.service.type.drs",
      "resource_type": "hws.resource.type.drs.flow",
      "resource_spec_code": "drs.flow.free",
      "resource_size": 1,
      "usage_factor": "flow",
      "usage_value": 1,
      "usage_measure_id": 17
    }
  ]
}

状态码：400

Bad Request

{
  "error_code": "DRS.M00202",
  "error_msg": "The value of parameter jobId is invalid."
}

错误码

请参见错误码。

父主题：实例详情