获取规则修改历史--veImageX-火山引擎

文档中心

立即注册

导航

veImageX

获取规则修改历史

最近更新时间：2024.08.20 11:34:24首次发布时间：2021.02.23 10:42:29

本接口支持通过指定应用 ID 和配置项 ID，来获取当前配置项下的所有规则修改历史。

说明

该接口属于历史版本 API，建议您使用新版 GetImageSettingRuleHistory 接口。

请求说明

接口名称：GetImageSettingRuleHistory
请求方式：GET
接口地址示例：https://imagex.volcengineapi.com/?Action=GetImageSettingRuleHistory&Version=2018-08-01
请求频率限制：10 次/秒
超时时间：5 秒

说明

veImageX 在全球多个区域部署，每个区域有自己对应的 OpenAPI 域名，不支持跨区域调用。具体详情请查看服务地址。

请求参数

以下请求参数列表仅列出了该接口的部分公共参数，完整公共参数列表见公共参数。

Query

参数	类型	是否必选	描述
Action	String	是	接口名称。
Version	String	是	接口版本。veImageX 当前 API 的版本为 `2018-08-01`。
AppId	String	是	应用 ID。说明您可以通过调用获取应用列表的方式获取所需的 AppId。
SettingId	String	是	配置项 ID。说明您可以通过调用获取配置项列表的方式获取所需的配置项 ID。
Offset	Integer	否	获取偏移。默认为 0，从最初的修改记录开始取值。取值为`1`时，表示跳过第一条数据，从第二条数据开始取值。
Limit	Integer	否	获取个数。默认为 10，取值范围为 [1,100]。

返回参数

参数	类型	描述
Total	Integer	总记录条数。
Records	Array of Records	修改记录列表。

Records

参数	类型	描述
ModifiedAt	String	修改时间，即修改规则的服务器当地时间。
Modifier	String	修改人，即修改规则的当前账号。
ModifyMsg	String	修改信息，如：新增规则、删除规则、调整优先级。
NewInfo	RuleInfo	新规则内容。
OldInfo	RuleInfo	旧规则内容。说明如果为新增规则操作，则旧规则内容此部分为空。

RuleInfo

参数	类型	描述
Content	String	规则配置信息，即匹配条件。
Value	类型由对应配置项类型决定	规则配置值，即配置内容。

示例

请求示例

GET https://imagex.volcengineapi.com/?Action=GetImageSettingRuleHistory&Version=2018-08-01&AppId=179132&SettingId=S-ccedaa3b-a914-4275-90ed-514300b40d4*

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "202012061450310100080730451902DFA4",
        "Action": "GetImageSettingRuleHistory",
        "Version": "2018-08-01",
        "Service": "imagex",
        "Region": "cn-north-1"
    },
    "Result": {
        "Total": 1,
        "Records": [
            {
                "ModifiedAt": "2020-12-06T06:21:57Z",
                "Modifier": "111",
                "ModifyMsg": "删除规则: test",
                "NewInfo": null,
                "OldInfo": {
                    "Content": "true",
                    "Value": 1
                }
            }
        ]
    }
}

异常返回示例

{
    "ResponseMetadata": {
        "RequestId": "201806041104200100100232280022D30",
				"Action": "GetImageSettingRuleHistory",
        "Version": "2018-08-01",
        "Service": "imagex",
        "Region": "cn-north-1",
        "Error": {
            "Code": "",
            "Message": ""
        }
    }
}

错误码

访问公共错误码和客户端配置下发相关错误码获取详细信息。