SecurityHub / Client / decline_invitations

decline_invitations#

SecurityHub.Client.decline_invitations(**kwargs)#

Note

We recommend using Organizations instead of Security Hub invitations to manage your member accounts. For information, see Managing Security Hub administrator and member accounts with Organizations in the Security Hub User Guide.

Declines invitations to become a Security Hub member account.

A prospective member account uses this operation to decline an invitation to become a member.

Only member accounts that aren’t part of an Amazon Web Services organization should use this operation. Organization accounts don’t receive invitations.

Request Syntax

response = client.decline_invitations(
    AccountIds=[
        'string',
    ]
)

Parameters:

AccountIds (list) –

[REQUIRED]

The list of prospective member account IDs for which to decline an invitation.

(string) –

Return type:

dict

Returns:

Response Syntax

{
    'UnprocessedAccounts': [
        {
            'AccountId': 'string',
            'ProcessingResult': 'string'
        },
    ]
}

Response Structure

(dict) –
- UnprocessedAccounts (list) –
  
  The list of Amazon Web Services accounts that were not processed. For each account, the list includes the account ID and the email address.
  - (dict) –
    
    Details about the account that was not processed.
    - AccountId (string) –
      
      An Amazon Web Services account ID of the account that was not processed.
    - ProcessingResult (string) –
      
      The reason that the account was not processed.

Exceptions

SecurityHub.Client.exceptions.InternalException
SecurityHub.Client.exceptions.InvalidInputException
SecurityHub.Client.exceptions.InvalidAccessException
SecurityHub.Client.exceptions.ResourceNotFoundException