SecurityHub / Client / invite_members

invite_members#

SecurityHub.Client.invite_members(**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.

Invites other Amazon Web Services accounts to become member accounts for the Security Hub administrator account that the invitation is sent from.

This operation is only used to invite accounts that don’t belong to an Amazon Web Services organization. Organization accounts don’t receive invitations.

Before you can use this action to invite a member, you must first use the CreateMembers action to create the member account in Security Hub.

When the account owner enables Security Hub and accepts the invitation to become a member account, the administrator account can view the findings generated in the member account.

Request Syntax

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

Parameters:

AccountIds (list) –

[REQUIRED]

The list of account IDs of the Amazon Web Services accounts to invite to Security Hub as members.

(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 could not be 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.LimitExceededException
SecurityHub.Client.exceptions.ResourceNotFoundException