GuardDuty / Client / get_master_account

get_master_account#

GuardDuty.Client.get_master_account(**kwargs)#

Provides the details for the GuardDuty administrator account associated with the current GuardDuty member account.

Danger

This operation is deprecated and may not function as expected. This operation should not be used going forward and is only kept for the purpose of backwards compatiblity.

See also: AWS API Documentation

Request Syntax

response = client.get_master_account(
    DetectorId='string'
)
Parameters:

DetectorId (string) –

[REQUIRED]

The unique ID of the detector of the GuardDuty member account.

To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.

Return type:

dict

Returns:

Response Syntax

{
    'Master': {
        'AccountId': 'string',
        'InvitationId': 'string',
        'RelationshipStatus': 'string',
        'InvitedAt': 'string'
    }
}

Response Structure

  • (dict) –

    • Master (dict) –

      The administrator account details.

      • AccountId (string) –

        The ID of the account used as the administrator account.

      • InvitationId (string) –

        The value used to validate the administrator account to the member account.

      • RelationshipStatus (string) –

        The status of the relationship between the administrator and member accounts.

      • InvitedAt (string) –

        The timestamp when the invitation was sent.

Exceptions

  • GuardDuty.Client.exceptions.BadRequestException

  • GuardDuty.Client.exceptions.InternalServerErrorException