Querying Application Records of a Parameter Template
Function
This API is used to query application records of a parameter template. Before calling this API:
- Learn how to authorize and authenticate it.
- Obtain the required region and endpoint.
URI
GET /v3/{project_id}/configurations/{config_id}/apply-history
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Definition: Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. Constraints: N/A Range: The value can contain 32 characters. Only letters and digits are allowed. Default value: N/A |
config_id |
Yes |
String |
Definition: Parameter template ID. Constraints: It must be the ID of the parameter template corresponding to the instance. Range: The value can contain 36 characters, starting with a UUID and ending with pr07. Only letters and digits are allowed. To obtain this value, see Querying Details of a DB Instance. After the request is processed, this parameter value is the value of configuration_id in the response body. Default value: N/A |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
limit |
No |
Integer |
Definition: Number of records to be queried. Constraints: The value cannot be a negative number. Range: 1–100 Default value: 100 |
offset |
No |
Integer |
Definition: Index offset. The query starts from the next piece of data indexed by this parameter. Constraints: The value cannot be a negative number. Range: ≥ 0 Default value: 0 |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
Definition: User token. To obtain this value, call the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the token value. Constraints: N/A Range: N/A Default value: N/A |
X-Language |
No |
String |
Definition: Request language type. Constraints: N/A Range: Default value: en-us |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
total_count |
String |
Definition: Number of application records of a parameter template. Range: N/A |
histories |
Array of TemplateApplyHistory objects |
Definition: Application record information of a parameter template. |
Parameter |
Type |
Description |
---|---|---|
target_id |
String |
Definition: ID of the instance that the template is applied to. Range: The value can contain 36 characters with a suffix of in07. Only letters and digits are allowed. |
target_name |
String |
Definition: Name of the instance that the template is applied to. Range: Instance name corresponding to the instance ID |
apply_result |
String |
Definition: Application results. Range: |
applied_at |
Number |
Definition: Time when the template was applied. Range: N/A |
error_code |
String |
Definition: Error code. Range: N/A |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. |
error_msg |
String |
Error message. |
Status code: 500
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. |
error_msg |
String |
Error message. |
Example Request
Querying application records of a parameter template
GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations/b366363c95b04b0eac39e73ea2672ffepr07/apply-history
Example Response
Status code: 200
Success.
{ "total_count" : 1, "histories" : [ { "target_id" : "06789bdfbe414d78b9cef1b79d7d9680in07", "target_name" : "gauss-11", "apply_result" : "SUCCESS", "applied_at" : 1712246191000, "error_code" : "" } ] }
Status Code
Status Code |
Description |
---|---|
200 |
Success. |
400 |
Client error. |
500 |
Server error. |
Error Code
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.