Querying the Change History of a Parameter Template

API Description

This API is used to view change history of a parameter template.

Restrictions

Only the parameter change history of the last seven days can be viewed.

URI

URI format
GET https://{Endpoint}/v3/{project_id}/configurations/{config_id}/histories
URI example
https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/configurations/341bc383a3e24221a94c4ad0b4547e8apr02/histories?offset=0&limit=10

**Table 1** Request parameters
Name	Type	IN	Mandatory	Description
X-Auth-Token	string	header	Yes	Definition User token obtained from IAM. For details, see Authentication. Constraints N/A Range N/A Default Value N/A
project_id	string	path	Yes	Definition Project ID of a tenant in a region. Obtain the project ID by following the instructions in Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A

**Table 2** Path parameters
Name	Mandatory	Type	Description
config_id	Yes	String	Definition Parameter template ID. Constraints N/A Range N/A Default Value N/A

**Table 3** Query parameters
Name	Mandatory	Type	Description
offset	No	Integer	Definition Index offset. Constraints If offset is set to N, the query starts from the N+1 piece of data. The value is 0 by default, indicating that the query starts from the first piece of data. The value must be a positive number or 0. Range N/A Default Value 0
limit	No	Integer	Definition Maximum records to be queried. Constraints If this parameter is not transferred, the first 100 records are queried by default. Range 1 to 100 Default Value 100

Request Parameters

None

Response Parameters

Parameter description

**Table 4** Response body parameters
Name	Type	Description
histories	Array of Table 5-5 objects	Definition Change history of the parameter template. Range N/A

**Table 5** HistoryInfo
Name	Type	Description
parameter_name	String	Definition Parameter name. Range N/A
old_value	String	Definition Value before modification. Range N/A
new_value	String	Definition New value. Range N/A
updated_at	String	Definition Modification time. The format is "yyyy-MM-ddTHH:mm:ssZ". T is the separator between the calendar and the hourly notation of time. Z indicates the time zone offset. For example, in the Beijing time zone, the time zone offset is shown as +0800. Range N/A

Example response

{ 
  "histories" : [ { 
    "parameter_name" : "rateLimit.mbps", 
    "old_value" : "500", 
    "new_value" : "350", 
    "updated_at" : "2022-06-07T09:25:45+0000" 
  } ] 
}

SDK

Click Document Database Service DDS SDK to download the SDK or view the SDK document. To learn how to install and authenticate an SDK, read the Usage section.