ListComputeMetricsByInstance - 列出后付费作业计算用量

列出后付费作业计算用量。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
odps:ListComputeMetricsByInstancelist
*全部资源
*

请求语法

POST /api/v1/computeMetrics/listByInstance HTTP/1.1

请求参数

名称类型必填描述示例值
bodyobject

请求体参数。

regionstring

地域 ID。

cn-hangzhou
projectNamesarray

项目名称。

projectNamestring

项目名称。

odps_porject
startDatelong

开始日期。

1715393576201
endDatelong

结束日期。

1718590596556
instanceIdstring

作业 ID。

20240730****ddlr
jobOwnerstring

作业 Owner。

ALIYUN$7632***@aliyun.com
signaturestring

SQL 作业签名。

ghijkl789012
pageNumberlong

分页页码。

1
pageSizelong

每页返回数目,默认为 10。

10
typesarray

计量类型。

typestring

计量类型。

  • ComputationSql:操作内部表的 SQL 类型作业计量数据。

  • ComputationSqlOTS:操作 OTS 外部表的 SQL 类型作业计量数据。

  • ComputationSqlOSS:操作 OSS 外部表的 SQL 类型作业计量数据。

  • MapReduce:MapReduce 类型作业计量数据。

  • spark:Spark 类型作业计量数据。

  • mars:Mars 类型作业计量数据。

SQL
specCodesarray

规格类型。

specCodestring

规格类型。

  • OdpsStandard:对应按量付费标准版。
  • OdpsSpot:按量计费闲时版。
OdpsStandard

返回参数

名称类型描述示例值
object

PopResult<ListResultDTO<InstanceComputeMetricDTO, DefaultPageInfo>>

requestIdstring

请求 ID。

0bc059b717363029839908920ea631
httpCodeinteger

HTTP 状态码。

  • 1xx:信息响应 - 请求已接收,正在处理中。
  • 2xx:成功 - 请求动作已被服务端成功接收、理解并接受。
  • 3xx:重定向 - 请求被重定向,采取进一步行动以完成请求。
  • 4xx:客户端错误 - 请求包含错误请求参、语法或特定请求条件无法满足。
  • 5xx:服务端错误 - 服务器由于其他原因无法满足请求。
200
errorCodestring

错误码。

OBJECT_NOT_EXIST
errorMsgstring

错误信息。

This object does not exist.
dataobject

请求返回结果。

instanceComputeMetricsarray<object>

后付费作业计算用量列表。

instanceComputeMetricsobject
instanceIdstring

作业 ID。

20240730****ddlr
typestring

计量类型。

  • ComputationSql:操作内部表的 SQL 类型作业计量数据。

  • ComputationSqlOTS:操作 OTS 外部表的 SQL 类型作业计量数据。

  • ComputationSqlOSS:操作 OSS 外部表的 SQL 类型作业计量数据。

  • MapReduce:MapReduce 类型作业计量数据。

  • spark:Spark 类型作业计量数据。

  • mars:Mars 类型作业计量数据。

ComputationSql
specCodestring

规格类型。

  • OdpsStandard:对应按量付费标准版。
  • OdpsSpot:按量计费闲时版。
OdpsStandard
jobOwnerstring

作业 Owner。

ALIYUN$7632***@aliyun.com
projectNamestring

项目名称。

odps_porject
submitTimelong

作业提交时间。

1610432000000
endTimelong

作业运行结束时间。

1710432000000
signaturestring

SQL 作业签名。

pqrs12345tuv
usagedouble

计算用量。

  • 扫描量计算类,单位为 GB。包括 ComputationSql、ComputationSqlOTS、ComputationSqlOSS 计费类型,都是按扫描量计费,计算使用量为每个作业的扫描量*复杂度,其中 ComputationSqlOTS 和 ComputationSqlOSS 类型复杂度固定为 1。

  • CU 时计算类,单位为 CU 时。包括 MapReduce、spark、mars 计费类型,都是按 CU 时计费。

1024
unitstring

计算用量单位。

GB
totalCountlong

返回结果的总数量。

64
pageNumberlong

当前页码。

1
pageSizelong

每页记录数。

10

示例

正常返回示例

JSON格式

{
  "requestId": "0bc059b717363029839908920ea631",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "instanceComputeMetrics": [
      {
        "instanceId": "20240730****ddlr",
        "type": "ComputationSql",
        "specCode": "OdpsStandard",
        "jobOwner": "ALIYUN$7632***@aliyun.com",
        "projectName": "odps_porject",
        "submitTime": 1610432000000,
        "endTime": 1710432000000,
        "signature": "pqrs12345tuv",
        "usage": 1024,
        "unit": "GB"
      }
    ],
    "totalCount": 64,
    "pageNumber": 1,
    "pageSize": 10
  }
}

错误码

访问错误中心查看更多错误码。