查询参数组应用记录V3

功能介绍

查询参数组应用记录V3

接口约束

无

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

ddm::listParamGroup

Read

parameterGroup *

-

ddm:param:list

-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
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。约束限制：不涉及。取值范围：只能由英文字母、数字组成，且长度为32个字符。默认取值：不涉及。
config_id	是	String	参数解释：参数组ID。约束限制：不涉及。取值范围：只能由英文字母、数字组成，长度为36个字符。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
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	参数解释：参数应用记录总数。取值范围：不涉及。

表4 ApplyHistory
参数	参数类型	描述
instance_id	String	参数解释：实例ID。取值范围：不涉及。
instance_name	String	参数解释：实例的名称。取值范围：不涉及。
apply_result	String	参数解释：实例应用参数组结果。取值范围： "SUCCESS"：表示实例应用参数组成功。 "FAILED"：表示实例应用参数组失败。 "APPLYING": 表示实例还在应用参数组过程中。
applied_at	String	参数解释：应用日期。格式为yyyy-mm-ddThh:mm:ssZ。其中，T指定某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。取值范围：不涉及。
error_message	String	参数解释：实例应用参数组的报错信息，若实例应用参数组成功则返回空。取值范围：不涉及。

响应示例

正常响应示例

{
  "histories" : [ {
    "instance_id" : "59974b82e7xxxxxxxxxx9802d28bbe18in09",
    "instance_name" : "ddm-test1",
    "apply_result" : "SUCCESS",
    "applied_at" : "2026-01-06T07:07:51+0000",
    "error_code" : ""
  }, {
    "instance_id" : "59974b82e7xxxxxxxxxx9802d28bbe18in09",
    "instance_name" : "ddm-test2",
    "apply_result" : "SUCCESS",
    "applied_at" : "2026-01-06T06:22:48+0000",
    "error_code" : ""
  } ],
  "total" : 9
}