Disassociating
(removing) member account from administrator account
When you want to stop configuring the GuardDuty settings and accessing the data from a
member account, remove that account as a GuardDuty member account. You can do it by
disassociating (removing) that account from the GuardDuty administrator account.
When you disassociate a GuardDuty member account, GuardDuty remains enabled for the account in
the current AWS Region. However, the account is disassociated from the delegated GuardDuty administrator account and the
account becomes a standalone GuardDuty account. After you have disassociated the member
account, it continues to show in the account inventory. GuardDuty doesn't notify the
account's owner that you disassociated the account. You can add the account to your
organization again at a later time.
Choose a preferred method to disassociate (remove) a member account from your
organization.
- Console
-
Open the GuardDuty console at https://console.aws.amazon.com/guardduty/.
To sign in, use the credentials of the delegated GuardDuty administrator account.
-
In the navigation pane, choose
Accounts.
-
In the Accounts table, you can remove an
account that has Type as Via
Organizations and Status as
Enabled.
Select one or more accounts with the same
Type and
Status.
-
From the Actions dropdown menu, choose
Disassociate account.
-
Choose Disassociate account to confirm your
selection.
-
The Status value for the selected accounts
will change to Not a member. The Via
Organizations (Active/All) count at the top right
corner of the Accounts page will change to reflect the
update.
Repeat the preceding steps in each additional Region where you
want to disassociate the member account.
- API
-
-
To retrieve the account ID for the member account that you want to
remove, use the ListMembers API. Include the
OnlyAssociated
parameter in your request. If you
set this parameter's value to true
, GuardDuty returns a
members
array that provides details about only
those accounts that are currently GuardDuty members.
Alternatively, you can use AWS Command Line Interface (AWS CLI) to run the following
command:
aws guardduty list-members --only-associated true --region us-east-1
Replace us-east-1
by the Region where
you want to remove this account.
-
To remove one or more GuardDuty member accounts, run DisassociateMembers to remove the
member account that is associated with the administrator account.
Alternatively, you can use AWS CLI to run the following
command:
aws guardduty disassociate-members --detector-id 12abc34d567e8fa901bc2d34EXAMPLE --account-ids 111122223333
--region us-east-1
Replace us-east-1
by the Region where
you want to remove this account. If you have a list of account IDs
that you want to remove, separate them by a space character.