---
title: "query subjects/获取有权限的用户列表"
method: GET
path: "/api/v1/systems/{system_id}/policies/-/subjects"
tags: ["open"]
---

# query subjects/获取有权限的用户列表

`GET /api/v1/systems/{system_id}/policies/-/subjects`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `X-Bk-App-Code`
  - API key in header `X-Bk-App-Secret`

system+action+policy_ids => subjects

## Path parameters

- `system_id` string, required

## Query parameters

- `ids` string, required
- `type` 'abac' | 'rbac'

## Response `200`

OK

- object
  - `code` integer
  - `data` HandlerPolicyIDSubject[]
    - `id` integer
    - `subject` IamPkgApiOpenHandlerPolicyResponseSubject
      - `id` string
      - `name` string
      - `type` string
  - `message` string

## Changes

- **2026-07-17** `f3a5fe2fe9c6`: 1 info
  - added the new optional `query` request parameter `type`
- **2021-07-19** `361087436cc5`: 1 warning
  - deleted the `query` request parameter `type`

[Operation history](https://skmtc.dev/tencentblueking/apis/iam-api/changes/api/v1/systems/:system_id/policies/-/subjects/get.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.dev/tencentblueking/apis/iam-api/revisions/f3a5fe2fe9c6?raw)