---
title: "policy query/策略查询"
method: POST
path: "/api/v2/policy/systems/{system_id}/query/"
tags: ["policy"]
---

# policy query/策略查询

`POST /api/v2/policy/systems/{system_id}/query/`

query the policy by conditions: system/subject/action and resources[optional]

## Path parameters

- `system_id` string, required

## Request body

- HandlerQueryRequest
  - `action` HandlerAction, required
    - `id` string, required
  - `resources` HandlerResource[] — can be empty
    - `attribute` object, required
    - `id` string, required
    - `system` string, required
    - `type` string, required
  - `subject` IamPkgApiPolicyHandlerSubject, required
    - `id` string, required
    - `type` string, required
  - `system` string, required

## Response `200`

OK

- UtilResponse
  - `code` integer
  - `data` unknown
  - `message` string

## Changes

- **2026-07-17** `f3a5fe2fe9c6` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2022-08-09** `d882726024a7` — 1 info
  - endpoint added
- **2021-07-19** `361087436cc5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/tencentblueking/apis/iam-api/changes/api/v2/policy/systems/:system_id/query/post.md)

---

[API](https://skmtc.dev/tencentblueking/apis/iam-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/iam-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/iam-api/revisions/f3a5fe2fe9c6/schema)