Event type
IAM Delete Policy Event
Management API call to delete an IAM policy
AWS IAM DeletePolicy API call event with error handling and identity type variations
Overview
What this event covers
Records when an AWS IAM policy is deleted via the DeletePolicy API operation. This is a critical security event as it permanently removes permission definitions that may be attached to users, groups, or roles.
When generated
- ›When an administrator deletes an IAM policy via AWS Console
- ›When DeletePolicy API is called programmatically (CLI, SDK, Terraform)
- ›During automated policy cleanup processes
- ›When cleaning up test or temporary policies
- ›During security incident response (removing compromised policies)
Security relevance
CriticalCompliance
Frequency notes
Low frequency event - policy deletions are infrequent but critical administrative actions
Resources
Docs and tools
Generation
Configuration
- Base frequency
- 3 events/hour
- Time patterns
- business_hours night_hours weekend
- Business hours
- 3.0x
- Night hours
- 0.2x
- Weekend
- 0.1x
Schema
Field definitions
Field reference for this event type — types, requirements, examples, and allowed values.
eventVersion
CloudTrail event format version
Source: 1.08 or 1.09. Both include eventCategory.
1.08-
1.08CloudTrail format that introduced tlsDetails -
1.09CloudTrail format used by later DeletePolicy samples
userIdentity.type
Type of identity that made the API call
Source: Random selection between IAMUser and AssumedRole
AssumedRole-
IAMUserDirect IAM user authentication -
AssumedRoleRole-based authentication (federated or cross-account)
userIdentity.principalId
Unique identifier for the principal
Source: IAM user is AIDA plus 17 characters. Assumed role is AROA plus 17 characters, a colon, and the session name.
AIDACKCEVSQ6C2EXAMPLEeventName
The IAM API operation name
Source: Static value
DeletePolicyrequestParameters.policyArn
ARN of the policy being deleted
Source: Constructed ARN with account ID and policy name
arn:aws:iam::123456789012:policy/AdminPolicyerrorCode
Error code if the operation failed
Source: Random selection when error occurs
DeleteConflictException-
NoSuchEntityExceptionPolicy does not exist -
DeleteConflictExceptionPolicy cannot be deleted due to dependencies -
AccessDeniedInsufficient permissions to delete policy
errorMessage
Detailed error message when operation fails
Source: Conditional message based on error code
Cannot delete a policy attached to entities.sourceIPAddress
IP address of the API caller
Source: Public address. vpcEndpointId is omitted.
203.0.113.42userAgent
User agent string indicating the client tool used
Source: Random selection from realistic AWS client user agents
aws-cli/2.0.62 Python/3.9.2 Darwin/19.6.0-
aws-cli/*AWS Command Line Interface -
console.amazonaws.comAWS Management Console -
aws-sdk-go/*AWS SDK for Go (often Terraform) -
aws-sdk-python/*AWS SDK for Python (boto3)
userIdentity.sessionContext.attributes.mfaAuthenticated
Whether the session used multi-factor authentication
Source: Random boolean as string
trueawsRegion
AWS region where the API call was made
Source: IAM is global, so CloudTrail records the event in us-east-1.
us-east-1managementEvent
Indicates this is a management plane event
Source: Static value (always true for IAM operations)
true