Amazon Web Services Invitation API

openapi: 3.1.0
info:
  title: Amazon Web Services accessanalyzer 2012 09 25 Invitation API
  description: <p>Identity and Access Management Access Analyzer helps you to set, verify, and refine your IAM policies by providing a suite of capabilities. Its features include findings for external and unused access, basic and custom policy checks for validating policies, and policy generation to generate fine-grained policies. To start using IAM Access Analyzer to identify external or unused access, you first need to create an analyzer.</p> <p> <b>External access analyzers</b> help identify potential risks of accessing resources by enabling you to identify any resource policies that grant access to an external principal. It does this by using logic-based reasoning to analyze resource-based policies in your Amazon Web Services environment. An external principal can be another Amazon Web Services account, a root user, an IAM user or role, a federated user, an Amazon Web Services service, or an anonymous user. You can also use IAM Access Analyzer to preview public and cross-account access to your resources before deploying permissions changes.</p> <p> <b>Unused access analyzers</b> help identify potential identity access risks by enabling you to identify unused IAM roles, unused access keys, unused console passwords, and IAM principals with unused service and action-level permissions.</p> <p>Beyond findings, IAM Access Analyzer provides basic and custom policy checks to validate IAM policies before deploying permissions changes. You can use policy generation to refine permissions by attaching a policy generated using access activity logged in CloudTrail logs. </p> <p>This guide describes the IAM Access Analyzer operations that you can call programmatically. For general information about IAM Access Analyzer, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html">Identity and Access Management Access Analyzer</a> in the <b>IAM User Guide</b>.</p>
tags:
- name: Invitation
paths:
  /invitation:
    PUT:
      summary: Amazon Web Services Acceptinvitation
      description: Accepts an invitation for the member account to contribute data to a behavior graph. This operation can only be called by an invited member account.  The request provides the ARN of behavior graph. The member account status in the graph must be INVITED.
      operationId: amazonWebServicesAcceptInvitation
      tags:
      - Invitation
    GET:
      summary: Amazon Web Services Listinvitations
      description: Lists all GuardDuty membership invitations that were sent to the current Amazon Web Services account.
      operationId: amazonWebServicesListInvitations
      tags:
      - Invitation
  /invitation/removal:
    POST:
      summary: Amazon Web Services Rejectinvitation
      description: Rejects an invitation to contribute the account data to a behavior graph. This operation must be called by an invited member account that has the INVITED status.  RejectInvitation cannot be called by an organization account in the organization behavior graph. In the organization behavior graph, organization accounts do not receive an invitation.
      operationId: amazonWebServicesRejectInvitation
      tags:
      - Invitation
  /invitation/decline:
    POST:
      summary: Amazon Web Services Declineinvitations
      description: Declines invitations sent to the current member account by Amazon Web Services accounts specified by their account IDs.
      operationId: amazonWebServicesDeclineInvitations
      tags:
      - Invitation
  /invitation/delete:
    POST:
      summary: Amazon Web Services Deleteinvitations
      description: Deletes invitations sent to the current member account by Amazon Web Services accounts specified by their account IDs.
      operationId: amazonWebServicesDeleteInvitations
      tags:
      - Invitation
  /invitation/count:
    GET:
      summary: Amazon Web Services Getinvitationscount
      description: Returns the count of all GuardDuty membership invitations that were sent to the current member account except the currently accepted invitation.
      operationId: amazonWebServicesGetInvitationsCount
      tags:
      - Invitation