Access Analyzer

API version: 2019-11-01

Auth

AWS SigV4

Base URL

Not specified.

Setup

1. 1. Configure auth: AWS SigV4
2. GET /analyzed-resource -- verify access
3. POST /policy/check-access-not-granted -- create first check-access-not-granted

Endpoints

35 endpoints across 10 groups. See references/api-spec.lap for full details.

archive-rule

Method	Path	Description
PUT	/archive-rule	Retroactively applies the archive rule to existing findings that meet the archive rule criteria.

policy

Method	Path	Description
PUT	/policy/generation/{jobId}	Cancels the requested policy generation.
POST

/policy/check-access-not-granted | Checks whether the specified access isn't allowed by a policy. |

| POST | /policy/check-no-new-access | Checks whether new access is allowed for an updated policy when compared to the existing policy. You can find examples for reference policies and learn how to set up and run a custom policy check for new access in the IAM Access Analyzer custom policy checks samples repository on GitHub. The reference policies in this repository are meant to be passed to the existingPolicyDocument request parameter. | | POST | /policy/check-no-public-access | Checks whether a resource policy can grant public access to the specified resource type. | | GET | /policy/generation/{jobId} | Retrieves the policy that was generated using StartPolicyGeneration. | | GET | /policy/generation | Lists all of the policy generations requested in the last seven days. | | PUT | /policy/generation | Starts the policy generation request. | | POST | /policy/validation | Requests the validation of a policy and returns a list of findings. The findings help you identify issues and provide actionable recommendations to resolve the issue and enable you to author functional policies that meet security best practices. |

access-preview

Method	Path	Description
PUT	/access-preview	Creates an access preview that allows you to preview IAM Access Analyzer findings for your resource before deploying resource permissions.
GET

/access-preview/{accessPreviewId} | Retrieves information about an access preview for the specified analyzer. |

| POST | /access-preview/{accessPreviewId} | Retrieves a list of access preview findings generated by the specified access preview. | | GET | /access-preview | Retrieves a list of access previews for the specified analyzer. |

analyzer

Method	Path	Description
PUT	/analyzer	Creates an analyzer for your account.
PUT

/analyzer/{analyzerName}/archive-rule | Creates an archive rule for the specified analyzer. Archive rules automatically archive new findings that meet the criteria you define when you create the rule. To learn about filter keys that you can use to create an archive rule, see IAM Access Analyzer filter keys in the IAM User Guide. |

| DELETE | /analyzer/{analyzerName} | Deletes the specified analyzer. When you delete an analyzer, IAM Access Analyzer is disabled for the account or organization in the current or specific Region. All findings that were generated by the analyzer are deleted. You cannot undo this action. | | DELETE | /analyzer/{analyzerName}/archive-rule/{ruleName} | Deletes the specified archive rule. | | GET | /analyzer/{analyzerName} | Retrieves information about the specified analyzer. | | GET | /analyzer/{analyzerName}/archive-rule/{ruleName} | Retrieves information about an archive rule. To learn about filter keys that you can use to create an archive rule, see IAM Access Analyzer filter keys in the IAM User Guide. | | GET | /analyzer | Retrieves a list of analyzers. | | GET | /analyzer/{analyzerName}/archive-rule | Retrieves a list of archive rules created for the specified analyzer. | | PUT | /analyzer/{analyzerName}/archive-rule/{ruleName} | Updates the criteria and values for the specified archive rule. |

recommendation

Method	Path	Description
POST	/recommendation/{id}	Creates a recommendation for an unused permissions finding.
GET

/recommendation/{id} | Retrieves information about a finding recommendation for the specified analyzer. |

analyzed-resource

Method	Path	Description
GET	/analyzed-resource	Retrieves information about a resource that was analyzed.
POST

/analyzed-resource | Retrieves a list of resources of the specified type that have been analyzed by the specified external access analyzer. This action is not supported for unused access analyzers. |

finding

Method	Path	Description
GET	/finding/{id}	Retrieves information about the specified finding. GetFinding and GetFindingV2 both use access-analyzer:GetFinding in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:GetFinding action.
POST

/finding | Retrieves a list of findings generated by the specified analyzer. ListFindings and ListFindingsV2 both use access-analyzer:ListFindings in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:ListFindings action. To learn about filter keys that you can use to retrieve a list of findings, see IAM Access Analyzer filter keys in the IAM User Guide. |

| PUT | /finding | Updates the status for the specified findings. |

findingv2

Method	Path	Description
GET	/findingv2/{id}	Retrieves information about the specified finding. GetFinding and GetFindingV2 both use access-analyzer:GetFinding in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:GetFinding action.
POST

/findingv2 | Retrieves a list of findings generated by the specified analyzer. ListFindings and ListFindingsV2 both use access-analyzer:ListFindings in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:ListFindings action. To learn about filter keys that you can use to retrieve a list of findings, see IAM Access Analyzer filter keys in the IAM User Guide. |

tags

Method	Path	Description
GET	/tags/{resourceArn}	Retrieves a list of tags applied to the specified resource.
POST

/tags/{resourceArn} | Adds a tag to the specified resource. |

| DELETE | /tags/{resourceArn} | Removes a tag from the specified resource. |

resource

Method	Path	Description
POST	/resource/scan	Immediately starts a scan of the policies applied to the specified resource.

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• - "Update a generation?" -> PUT /policy/generation/{jobId}
• "Create a check-access-not-granted?" -> POST /policy/check-access-not-granted
• "Create a check-no-new-access?" -> POST /policy/check-no-new-access
• "Create a check-no-public-access?" -> POST /policy/check-no-public-access
• "Delete a analyzer?" -> DELETE /analyzer/{analyzerName}
• "Delete a archive-rule?" -> DELETE /analyzer/{analyzerName}/archive-rule/{ruleName}
• "Get access-preview details?" -> GET /access-preview/{accessPreviewId}
• "List all analyzed-resource?" -> GET /analyzed-resource
• "Get analyzer details?" -> GET /analyzer/{analyzerName}
• "Get archive-rule details?" -> GET /analyzer/{analyzerName}/archive-rule/{ruleName}
• "Get finding details?" -> GET /finding/{id}
• "Get recommendation details?" -> GET /recommendation/{id}
• "Get findingv2 details?" -> GET /findingv2/{id}
• "Get generation details?" -> GET /policy/generation/{jobId}
• "List all access-preview?" -> GET /access-preview
• "Create a analyzed-resource?" -> POST /analyzed-resource
• "List all analyzer?" -> GET /analyzer
• "List all archive-rule?" -> GET /analyzer/{analyzerName}/archive-rule
• "Create a finding?" -> POST /finding
• "Create a findingv2?" -> POST /findingv2
• "List all generation?" -> GET /policy/generation
• "Get tag details?" -> GET /tags/{resourceArn}
• "Create a scan?" -> POST /resource/scan
• "Delete a tag?" -> DELETE /tags/{resourceArn}
• "Update a archive-rule?" -> PUT /analyzer/{analyzerName}/archive-rule/{ruleName}
• "Create a validation?" -> POST /policy/validation
• "How to authenticate?" -> See Auth section

Response Tips

• - Check response schemas in references/api-spec.lap for field details
• Create/update endpoints typically return the created/updated object

CLI

CODEBLOCK0

References

• - Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP