request_authorization_details
Creates, updates, deletes, gets or lists a request_authorization_details resource.
Overview​
| Name | request_authorization_details |
| Type | Resource |
| Id | aws.iam_toolbox.request_authorization_details |
Fields​
The following fields are returned by SELECT queries:
- get_request_authorization_details
| Name | Datatype | Description |
|---|---|---|
action | string | The action evaluated for this request (for example, iam:PassRole). |
context | object | The context keys and values specific to this evaluation. These are applied on top of the request context. |
evaluated_effect | string | The result of the evaluation. Valid values: ALLOW - The action was allowed. EXPLICIT_DENY - The action was explicitly denied by a policy. IMPLICIT_DENY - The action was denied because no policy allowed it. (ALLOW, EXPLICIT_DENY, IMPLICIT_DENY) |
matched_policies | array | The policies that matched during evaluation of this action and resource. An implicit denial produces no matched policies. |
resource | string | The resource that the action targeted. This is typically a resource ARN, but can be a wildcard ARN that matches multiple resources, or empty for actions that are not resource-specific. |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_request_authorization_details | select | authorization_id, region | nextToken | Retrieves the authorization details for a specific access denied request. The details include the request context, the evaluations performed, and the policies that were evaluated. Use this operation to understand why a request was denied. Supported services include an authorization ID in the access denied error message. Pass that ID to this operation to retrieve the details. Authorization details are available for at least 24 hours after the denial. To use this operation, you must have the iam:GetRequestAuthorizationDetails permission. |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
authorization_id | string | The authorization ID received in the access denied error message. This ID identifies the specific request to retrieve details for. |
region | string | AWS region (default: us-east-1) |
nextToken | string | The pagination token from a previous call, used to retrieve the next page of evaluations. Omit this value on the first call. |
SELECT examples​
- get_request_authorization_details
Retrieves the authorization details for a specific access denied request. The details include the request context, the evaluations performed, and the policies that were evaluated. Use this operation to understand why a request was denied. Supported services include an authorization ID in the access denied error message. Pass that ID to this operation to retrieve the details. Authorization details are available for at least 24 hours after the denial. To use this operation, you must have the iam:GetRequestAuthorizationDetails permission.
SELECT
action,
context,
evaluated_effect,
matched_policies,
resource
FROM aws.iam_toolbox.request_authorization_details
WHERE authorization_id = '{{ authorization_id }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
;