Skip to content

disassociate_from_master_account

disassociate_from_master_account(
    detector_id: DetectorId, *, config_overrides: Optional[GuardDutyClientConfig] = None
) -> DisassociateFromMasterAccountResponse

Disassociates the current GuardDuty member account from its administrator account.

When you disassociate an invited member from a GuardDuty delegated administrator, the member account details obtained from the CreateMembers API, including the associated email addresses, are retained. This is done so that the delegated administrator can invoke the InviteMembers API without the need to invoke the CreateMembers API again. To remove the details associated with a member account, the delegated administrator must invoke the DeleteMembers API.

Parameters:

  • detector_id (DetectorId) –

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

Raises:

Source code in docs_src/capo_guardduty/_services/guard_duty.py
def disassociate_from_master_account(
    self,
    detector_id: "capo_guardduty.types.detector_id.DetectorId",
    *,
    config_overrides: Optional[GuardDutyClientConfig] = None,
) -> "capo_guardduty.types.disassociate_from_master_account_response.DisassociateFromMasterAccountResponse":
    """<p>Disassociates the current GuardDuty member account from its administrator account.</p> <p>When you disassociate an invited member from a GuardDuty delegated administrator, the member account details obtained from the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_CreateMembers.html">CreateMembers</a> API, including the associated email addresses, are retained. This is done so that the delegated administrator can invoke the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_InviteMembers.html">InviteMembers</a> API without the need to invoke the CreateMembers API again. To remove the details associated with a member account, the delegated administrator must invoke the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_DeleteMembers.html">DeleteMembers</a> API.</p>

    Args:
        detector_id: <p>The unique ID of the detector of the GuardDuty member account.</p>

    Raises:
        capo_guardduty.errors.bad_request_exception.BadRequestException: <p>A bad request exception object.</p>
        capo_guardduty.errors.internal_server_error_exception.InternalServerErrorException: <p>An internal server error exception object.</p>
        capo_guardduty.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_guardduty.types.disassociate_from_master_account_request.DisassociateFromMasterAccountRequest]",
    ) -> OperationResponse[
        "capo_guardduty.types.disassociate_from_master_account_response.DisassociateFromMasterAccountResponse"
    ]:
        import capo_guardduty._operations.guard_duty_api_service.disassociate_from_master_account

        output, http_response = (
            capo_guardduty._operations.guard_duty_api_service.disassociate_from_master_account.disassociate_from_master_account(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("DisassociateFromMasterAccount")
    )
    input_: capo_guardduty.types.disassociate_from_master_account_request.DisassociateFromMasterAccountRequest = {
        "detector_id": detector_id
    }

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output