Skip to main content

request_authorization_details

Creates, updates, deletes, gets or lists a request_authorization_details resource.

Overview​

Namerequest_authorization_details
TypeResource
Idaws.iam_toolbox.request_authorization_details

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
actionstringThe action evaluated for this request (for example, iam:PassRole).
contextobjectThe context keys and values specific to this evaluation. These are applied on top of the request context.
evaluated_effectstringThe 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_policiesarrayThe policies that matched during evaluation of this action and resource. An implicit denial produces no matched policies.
resourcestringThe 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:

NameAccessible byRequired ParamsOptional ParamsDescription
get_request_authorization_detailsselectauthorization_id, regionnextTokenRetrieves 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.

NameDatatypeDescription
authorization_idstringThe authorization ID received in the access denied error message. This ID identifies the specific request to retrieve details for.
regionstringAWS region (default: us-east-1)
nextTokenstringThe pagination token from a previous call, used to retrieve the next page of evaluations. Omit this value on the first call.

SELECT examples​

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 }}'
;