# 成员每日用量指标增量同步 - SyncUserDailyIndicators #### 功能介绍 按复合游标 (user_id, pk_id) 增量返回成员每日用量数据。通过start_date和end_date参数限定同步时间范围。 鉴权规则： - 企业管理员（enterprise_admin）：可传入user_id查询本租户下指定成员数据，或不传user_id查询全部成员数据。 - 其他成员：仅可根据传入的认证信息中携带的账号user_id查询单个成员的数据。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-codeartsagent/codeartsagent-api-0003.html)。 #### URI POST https://collector-agents-access.cn-north-4.myhuaweicloud.com/dataflywheel/datapreprocess/v1/sync/usage/user-daily #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user_id | 否 | String | **参数解释**： 用户ID，获取方式请参见：[获取账号名、账号ID、IAM用户ID](https://support.huaweicloud.com/api-codeartsagent/codeartsagent-api-0011.html)。 - 企业管理员：可传本租户下指定成员的user_id查询指定成员数据，不传时返回全部成员数据。 - 成员：仅可传自己的user_id，传他人user_id返回403。 **取值范围**： 不涉及 **约束限制**： 不涉及 **默认取值**： 不涉及 | | cursor | 否 | String | **参数解释**： 增量游标。 - 首次同步：不传或传空，从最小键开始。 - 增量同步：传入上次响应的next_cursor。 **取值范围**： 不涉及 **约束限制**： 格式：user_id\|pk_id，使用\|分隔。 **默认取值**： 不涉及 | | page_size | 是 | Integer | **参数解释**： 每页条数 **取值范围**： 1-500 **约束限制**： 不涉及 **默认取值**： 不涉及 | | start_date | 是 | String | **参数解释**： 起始时间 **取值范围**： 不涉及 **约束限制**： yyyy-MM-dd，闭区间。 **默认取值**： 不涉及 | | end_date | 是 | String | **参数解释**： 结束时间 **取值范围**： 不涉及 **约束限制**： yyyy-MM-dd，闭区间，与start_date最大跨度60天。 **默认取值**： 不涉及 | #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | Integer | **参数解释**： HTTP状态码 **取值范围**： 200：响应成功 | | data | [SyncUserDailyData] object | **参数解释**： 数据同步信息 | 表3SyncUserDailyData | 参数 | 参数类型 | 描述 | |:---|:---|:---| | items | Array of [SyncUserDailyItem] objects | **参数解释**： 用量详情 | | next_cursor | String | **参数解释**： 下一页游标 **取值范围**： 不涉及 | | has_more | Boolean | **参数解释**： 是否还有更多数据 **取值范围**： - true：还有更多数据 - false：已同步完成 | 表4SyncUserDailyItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | user_id | String | **参数解释**： 成员ID **取值范围**： 不涉及 | | user_name | String | **参数解释**： 成员名称 **取值范围**： 不涉及 | | team_id | String | **参数解释**： 团队ID **取值范围**： 不涉及 | | team_name | String | **参数解释**： 团队名称 **取值范围**： 不涉及 | | pk_id | String | **参数解释**： 记录唯一键 **取值范围**： 不涉及 | | dt | String | **参数解释**： 数据日期 **取值范围**： 不涉及 | | model_id | String | **参数解释**： 模型ID **取值范围**： 不涉及 | | model_name | String | **参数解释**： 模型名称 **取值范围**： 不涉及 | | service_function | String | **参数解释**： 功能模块名 **取值范围**： 不涉及 | | input_token_cnt | Long | **参数解释**： 输入Token数 **取值范围**： ≥0 | | output_token_cnt | Long | **参数解释**： 输出Token数 **取值范围**： ≥0 | | total_token_cnt | Long | **参数解释**： Token总消耗 **取值范围**： ≥0 | | total_credit_cnt | Double | **参数解释**： 积分消耗 **取值范围**： ≥0 | #### 请求示例 - 企业管理员查询指定成员，示例如下： ``` POST https://collector-agents-access.cn-north-4.myhuaweicloud.com:443/dataflywheel/datapreprocess/v1/sync/usage/user-daily { "user_id" : "u-10001", "page_size" : 500, "start_date" : "2026-04-01", "end_date" : "2026-04-30" } ``` - 首次同步（企业管理员查询全部成员），示例如下： ``` POST https://collector-agents-access.cn-north-4.myhuaweicloud.com:443/dataflywheel/datapreprocess/v1/sync/usage/user-daily { "page_size" : 500, "start_date" : "2026-04-01", "end_date" : "2026-04-30" } ``` - 增量同步（翻页），示例如下： ``` POST https://collector-agents-access.cn-north-4.myhuaweicloud.com:443/dataflywheel/datapreprocess/v1/sync/usage/user-daily { "cursor" : "u-10001|a1b2c3d4-e5f6-7890-abcd-ef1234567890", "page_size" : 500, "start_date" : "2026-04-01", "end_date" : "2026-04-30" } ``` #### 响应示例 **状态码：200** - 同步成功（还有下一页），示例如下： ``` { "code" : 200, "data" : { "items" : [ { "user_id" : "u-10001", "user_name" : "张三", "team_id" : "team-001", "team_name" : "平台组", "pk_id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "dt" : "2026-04-01", "model_id" : "gpt-4", "model_name" : "gpt-4", "service_function" : "Agent", "input_token_cnt" : 8000, "output_token_cnt" : 4000, "total_token_cnt" : 12000, "total_credit_cnt" : 1.25 } ], "next_cursor" : "u-10001|a1b2c3d4-e5f6-7890-abcd-ef1234567890", "has_more" : true } } ``` - 同步完成（无更多数据），示例如下： ``` { "code" : 200, "data" : { "items" : [ ], "next_cursor" : null, "has_more" : false } } ``` **状态码：403** ``` { "code" : 403, "status" : "DataFlywheel.00000403", "msg" : "Access denied" } ``` **状态码：429** ``` { "code" : 429, "status" : "DataFlywheel.00000429", "msg" : "Too many sync requests, please try again later." } ``` **状态码：500** ``` { "code" : 500, "status" : "DataFlywheel.00000500", "msg" : "Failed to sync usage indicators." } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | 参数校验失败（page_size超界、start_date \> end_date、时间跨度超过60天、游标格式错误、日期格式错误） | | 403 | 鉴权失败（token无效或越权查询） | | 429 | 请求频率超限（单位时间内请求过多） | | 500 | 服务端异常 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-codeartsagent/ErrorCode.html)。