# 查询参数组应用记录V3 #### 功能介绍 查询参数组应用记录V3 #### 接口约束 无 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-ddm/ddm_api_01_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ddm/ddm_api_01_0050.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ddm::listParamGroup | Read | parameterGroup \* | - | ddm:param:list | - | #### URI GET /v3/{project_id}/configurations/{config_id}/apply-histories 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 租户在某一Region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 **约束限制**： 不涉及。 **取值范围**： 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 | | config_id | 是 | String | **参数解释**： 参数组ID。 **约束限制**： 不涉及。 **取值范围**： 只能由英文字母、数字组成，长度为36个字符。 **默认取值**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 否 | Integer | **参数解释**： 索引位置，偏移量。 **约束限制**： 不涉及。 **取值范围**： 大于等于0。 **默认取值**： 默认值是0。 | | limit | 否 | Integer | **参数解释**： 查询记录数。 **约束限制**： 不涉及。 **取值范围**： 大于0且小于等于128。 **默认取值**： 默认值是10。 | #### 请求参数 无 #### 请求示例 查询参数组应用记录。 ``` GET https://{endpoint}/v3/configurations/{config_id}/apply-histories ``` #### 响应参数 - 正常响应参数说明 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | histories | Array of [ApplyHistory] objects | **参数解释**： 参数组应用记录相关信息的集合。 **取值范围**： 不涉及。 | | total | Integer | **参数解释**： 参数应用记录总数。 **取值范围**： 不涉及。 | 表4ApplyHistory | 参数 | 参数类型 | 描述 | |:---|:---|:---| | target_id | String | **参数解释**： 参数组ID。 **参数范围**： 不涉及。 | | target_name | String | **参数解释**： 参数组的名称。 **参数范围**： 不涉及。 | | apply_result | String | **参数解释**： 实例应用参数组结果。 **取值范围**： - "SUCCESS"：表示实例应用参数组成功。 - "FAILED"：表示实例应用参数组失败。 - "APPLYING": 表示实例还在应用参数组过程中。 | | applied_at | String | **参数解释**： 应用日期。格式为yyyy-mm-ddThh:mm:ssZ。其中，T指定某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 **取值范围**： 不涉及。 | | error_message | String | **参数解释**： 实例应用参数组的报错信息，若实例应用参数组成功则返回空。 **取值范围**： 不涉及。 | #### 响应示例 - 正常响应示例 ``` { "histories" : [ { "target_id" : "59974b82e7xxxxxxxxxx9802d28bbe18in09", "target_name" : "ddm-test1", "apply_result" : "SUCCESS", "applied_at" : "2026-01-06T07:07:51+0000", "error_code" : "" }, { "target_id" : "59974b82e7xxxxxxxxxx9802d28bbe18in09", "target_name" : "ddm-test2", "apply_result" : "SUCCESS", "applied_at" : "2026-01-06T06:22:48+0000", "error_code" : "" } ], "total" : 9 } ``` - 异常响应 请参见[异常请求结果](https://support.huaweicloud.com/api-ddm/ddm_api_01_0059.html)。 #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0060.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。