根据标签ID查询用量统计。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
 - 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
 - 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
 - 对于不支持资源级授权的操作,用
全部资源表示。 
 - 条件关键字:是指云产品自身定义的条件关键字。
 - 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
 
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 | 
|---|---|---|---|---|
| dytns:QueryUsageStatisticsByTagId | get | *全部资源 * | 
  | 无 | 
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 | 
|---|---|---|---|---|
| BeginTime | string | 否 | 查询开始时间。  | 20230308 | 
| EndTime | string | 否 | 查询结束时间。  | 20230406 | 
| TagId | long | 否 | 标签 ID。  | 89 | 
| PageNo | long | 否 | 当前页码,默认:1  | 1 | 
| PageSize | long | 否 | 页面大小。  | 10 | 
返回参数
示例
正常返回示例
JSON格式
{
  "RequestId": "D45CC751-34DF-5797-81FB-9A2ED6DC024B",
  "Message": "OK",
  "Data": [
    {
      "AuthorizationCode": "g61I8UV5zd",
      "SuccessTotal": 93,
      "FailTotal": 71,
      "TagName": "阿里云查询",
      "SceneName": "电话回访1",
      "Total": 41,
      "TagId": 69,
      "PartnerId": 0,
      "Id": 0,
      "GmtDateStr": 20230312,
      "IndustryName": "家政安保"
    }
  ],
  "Code": "OK",
  "Success": true
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 | 
|---|---|---|---|
| 400 | InvalidParameter | Invalid parameter. | 无效参数 | 
| 400 | AuthCodeIllegal | Illegal authCode. | 鉴权时使用的authcode不可用于该接口 | 
| 500 | InternalError | A system error occurred. | 系统异常 | 
| 500 | RequestTimeout | Request supplier timed out. | 请求供应商超时 | 
| 500 | RequestSupplierError | Request supplier error. | 请求第三方服务异常。 | 
访问错误中心查看更多错误码。
