文档首页/ 统一身份认证服务 IAM_统一身份认证服务（新版）/ API参考/ API/ Access Analyzer/ 内部接口/ 采集话单计量项记录
更新时间：2025-10-20 GMT+08:00
查看PDF
分享

采集话单计量项记录

功能介绍

采集话单计量项记录。

URI

GET /v1/sdr-meters/{sdr_meter}/records

表1 路径参数

参数

是否必选

参数类型

描述

sdr_meter

是

Object

计量项ID。
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Object

单页计量项最大记录数。

marker

否

Object

页面标记。

start_time

是

Object

起始时间。

end_time

是

Object

结束时间。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

source_data

Array of SdrMeterSummaryRecord objects

话单计量项源记录。

数组长度：0 - 1000

marker

String

页面标记。
表4 SdrMeterSummaryRecord

参数

参数类型

描述

user_id

String

全网的用户的唯一编号，填写 ProjectID。

最小长度：1

最大长度：64

region_id

String

RegionID。

最小长度：1

最大长度：32

cloud_service_type

String

云资源ResourceID的云服务类型。

最小长度：1

最大长度：64

resource_id

String

具体的资源实例ID。

最小长度：1

最大长度：64

resource_type

String

云资源ResourceID的云资源类型。

最小长度：1

最大长度：64

resource_spec_code

String

云资源计量规格：iam.accessanalyzer.check_for_new_access（自定义策略检查），iam.accessanalyzer.preview_access（预览访问），iam.accessanalyzer.external_access（外部访问分析），iam.accessanalyzer.unused_access（未使用访问分析），iam.accessanalyzer.privilege_escalation（提权访问分析）。

begin_time

String

云资源实际使用开始时间，UTC格式，如：20180807120000。

最小长度：14

最大长度：14

end_time

String

云资源实际使用结束时间，UTC格式，如：20180807130000。

最小长度：14

最大长度：14

accumulate_factor_name

String

约定的累积因子名，云服务需要和运营商定计量维度：numberofresources（资源数量），totalnumberofusersandagencies（用户和委托总数），numberofrequests（请求次数）。

accumulate_factor_value

Long

云资源使用量累计值。

最小值：1

最大值：100000000

请求示例

采集话单计量项记录

GET https://{hostname}/v1/sdr-meters/{sdr_meter}/records

响应示例

状态码：200

OK

{
  "source_data" : [ {
    "user_id" : "xxxxxafa932d43cfb9f81759cea0f176",
    "region_id" : "{region_id}",
    "cloud_service_type" : "iam",
    "resource_id" : "xxxxx393-a345-48e3-8270-ca4f940c5532",
    "resource_type" : "iam.accessanalyzer",
    "resource_spec_code" : "iam.accessanalyzer.external_access",
    "begin_time" : "20240512140000",
    "end_time" : "20240513150000",
    "accumulate_factor_name" : "numberofresources",
    "accumulate_factor_value" : 15
  } ],
  "marker" : "{marker_string}"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 内部接口

相关文档