manage_roles
List and retrieve roles with permissions, access rules, and policies for security audits, access troubleshooting, and IAM planning.
Instructions
ROLE MANAGEMENT TOOL - Discover and analyze role-based access control
SUPPORTED ACTIONS: • list: Discover all roles with advanced filtering and pagination • get: Retrieve comprehensive role details including permissions, access rules, and policies
ROLE INFORMATION PROVIDED: • Permission sets and access rules • Associated policies and restrictions • User/group assignments and mappings • Resource access configurations • Audit and compliance information
USE CASES: • Security audits and compliance reporting • Access permission troubleshooting • Role-based access control planning • Identity and access management (IAM) integration • Permission inheritance analysis
Example: Check what permissions the 'database-admin' role has
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| json | No | Return structured JSON output instead of human-readable format. Use TRUE for programmatic processing or when integrating with other tools | |
| name | No | Exact role name or path (REQUIRED for 'get' action). Examples: 'admin-role', '/production/database-admin', 'read-only-secrets' | |
| action | Yes | Role management action to perform. SUPPORTED ACTIONS: 'list' (discover all roles with filtering and pagination), 'get' (retrieve detailed role information including permissions, access rules, and policies) | |
| filter | No | Pattern to filter role names (for 'list' action). Supports wildcards and partial matches. Examples: 'admin*', '*database*', 'prod-' | |
| uid_token | No | Universal identity authentication token. Only required when using universal_identity authentication method instead of API key authentication | |
| pagination_token | No | Continuation token for retrieving next page of results when listing large numbers of roles. Returned in previous response's metadata |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||