Skip to content

get_enabled_control 

get_enabled_control(
    enabled_control_identifier: Arn,
    *,
    config_overrides: Optional[ControlTowerClientConfig] = None,
) -> GetEnabledControlOutput

Retrieves details about an enabled control. For usage examples, see the Controls Reference Guide .

Parameters:

  • enabled_control_identifier (Arn) –

    The controlIdentifier of the enabled control.

Raises:

Source code in docs_src/capo_controltower/_services/control_tower.py 
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
def get_enabled_control(
    self,
    enabled_control_identifier: "capo_controltower.types.arn.Arn",
    *,
    config_overrides: Optional[ControlTowerClientConfig] = None,
) -> "capo_controltower.types.get_enabled_control_output.GetEnabledControlOutput":
    """<p>Retrieves details about an enabled control. For usage examples, see the <a href="https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html"> <i>Controls Reference Guide</i> </a>.</p>

    Args:
        enabled_control_identifier: <p>The <code>controlIdentifier</code> of the enabled control.</p>

    Raises:
        capo_controltower.errors.access_denied_exception.AccessDeniedException: <p>You do not have sufficient access to perform this action.</p>
        capo_controltower.errors.internal_server_exception.InternalServerException: <p>An unexpected error occurred during processing of a request.</p>
        capo_controltower.errors.resource_not_found_exception.ResourceNotFoundException: <p>The request references a resource that does not exist.</p>
        capo_controltower.errors.throttling_exception.ThrottlingException: <p>The request was denied due to request throttling.</p>
        capo_controltower.errors.validation_exception.ValidationException: <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
        capo_controltower.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_controltower.types.get_enabled_control_input.GetEnabledControlInput]",
    ) -> OperationResponse[
        "capo_controltower.types.get_enabled_control_output.GetEnabledControlOutput"
    ]:
        import capo_controltower._operations.aws_control_tower_apis.get_enabled_control

        output, http_response = (
            capo_controltower._operations.aws_control_tower_apis.get_enabled_control.get_enabled_control(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("GetEnabledControl")
    )
    input_: capo_controltower.types.get_enabled_control_input.GetEnabledControlInput = {
        "enabled_control_identifier": enabled_control_identifier
    }

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