Help Center/ Config/ API Reference/ APIs/ Compliance/ Querying the Compliance of a Resource

Updated on 2025-12-15 GMT+08:00

View PDF

Querying the Compliance of a Resource

Function

This API is used to query all compliance results of a resource evaluated by rules. The resource is searched by resource ID.

Calling Method

For details, see Calling APIs.

URI

GET /v1/resource-manager/domains/{domain_id}/resources/{resource_id}/policy-states

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Specifies the account ID. Maximum: 36
resource_id	Yes	String	Specifies the resource ID. Maximum: 512

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
compliance_state	No	String	Specifies the compliance status. Maximum: 16
limit	No	Integer	Specifies the maximum number of records to return. Minimum: 1 Maximum: 200 Default: 200
marker	No	String	Specifies the pagination parameter. You can use the marker value in a subsequent call to request the next set of list items. Minimum: 4 Maximum: 400

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	Specifies the invoker's token.
X-Security-Token	No	String	Specifies a temporary security credential. This parameter is mandatory when you make an API call using a temporary security credential.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
value	Array of PolicyState objects	Specifies the return value of querying the compliance result.
page_info	PageInfo object	Specifies the pagination object.

**Table 5** PolicyState
Parameter	Type	Description
domain_id	String	Specifies the user ID.
region_id	String	Specifies the ID of the region the resource belongs to.
resource_id	String	Specifies the resource ID.
resource_name	String	Specifies the resource name.
resource_provider	String	Specifies the cloud service name.
resource_type	String	Specifies the resource type.
trigger_type	String	Specifies the trigger type. The value can be resource or period.
compliance_state	String	Specifies the compliance status.
policy_assignment_id	String	Specifies the rule ID.
policy_assignment_name	String	Specifies the rule name.
policy_definition_id	String	Specifies the policy ID.
evaluation_time	String	Specifies the evaluation time of compliance status.

**Table 6** PageInfo
Parameter	Type	Description
current_count	Integer	Specifies the resource quantity on the current page. Minimum: 0 Maximum: 200
next_marker	String	Specifies the marker value of the next page. Minimum: 4 Maximum: 400

Status code: 400

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Specifies the error code.
error_msg	String	Specifies the error message.

Status code: 403

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Specifies the error code.
error_msg	String	Specifies the error message.

Status code: 404

**Table 9** Response body parameters
Parameter	Type	Description
error_code	String	Specifies the error code.
error_msg	String	Specifies the error message.

Status code: 500

**Table 10** Response body parameters
Parameter	Type	Description
error_code	String	Specifies the error code.
error_msg	String	Specifies the error message.

Example Requests

None

Example Responses

Status code: 200

Operation succeeded.

{
  "value" : [ {
    "domain_id" : "059b5c937100d3e40ff0c00a7675a0a0",
    "region_id" : "regionid1",
    "resource_id" : "010d95bd-87cd-4f22-ac00-db7fba7d927e",
    "resource_name" : "ecs-cc-image-test1",
    "resource_provider" : "ecs",
    "resource_type" : "cloudservers",
    "trigger_type" : "resource",
    "compliance_state" : "NonCompliant",
    "policy_assignment_id" : "5fb618a726a24c53767fa049",
    "policy_assignment_name" : "policy-assignment-test1",
    "policy_definition_id" : "5fa265c0aa1e6afc05a0ff07",
    "evaluation_time" : 1605776482523
  } ],
  "page_info" : {
    "current_count" : 1,
    "next_marker" : null
  }
}

Status Codes

Status Code	Description
200	Operation succeeded.
400	Invalid parameters.
403	Authentication failed or you do not have the operation permissions.
404	Resources not found.
500	Server error.