iam.users.who-can

List the principals allowed to perform an action on a resource today

GET /iam/api/users/who-canIAM iam:ListUsersRead

The same evaluation the routes perform, over every active principal of the organization.

Request syntax

GET /iam/api/users/who-can

Query parameters

  • actionRequired

    string

    One action, e.g. git:PushRepository

  • resourceRequired

    string

    The RN of a resource of this organization, or * for every resource

Response

200 with { action, resource, allowed, evaluated }: allowed lists the active IAM users the policies allow (id, username, type, memberEmail); evaluated is how many users were checked.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow iam:ListUsers on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud iam users who-can --action example --resource example

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_iam_users_who-can.