Skip to main content

caller_identities

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

Overview

Namecaller_identities
TypeResource
Idaws.sts.caller_identities

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
accountstringThe Amazon Web Services account ID number of the account that owns or contains the calling entity.
arnstringThe Amazon Web Services ARN associated with the calling entity.
user_idstringThe unique identifier of the calling entity. The exact value depends on the type of entity that is making the call. The values returned are those listed in the aws:userid column in the Principal table found on the Policy Variables reference page in the IAM User Guide.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_caller_identityselectregionReturns details about the IAM user or role whose credentials are used to call the operation. No permissions are required to perform this operation. If an administrator attaches a policy to your identity that explicitly denies access to the sts:GetCallerIdentity action, you can still perform this operation. Permissions are not required because the same information is returned when access is denied. To view an example response, see I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice in the IAM User Guide.

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
regionstringAWS region (default: us-east-1)

SELECT examples

Returns details about the IAM user or role whose credentials are used to call the operation. No permissions are required to perform this operation. If an administrator attaches a policy to your identity that explicitly denies access to the sts:GetCallerIdentity action, you can still perform this operation. Permissions are not required because the same information is returned when access is denied. To view an example response, see I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice in the IAM User Guide.

SELECT
account,
arn,
user_id
FROM aws.sts.caller_identities
WHERE region = '{{ region }}' -- required
;