Skip to content

put_block_public_access_configuration

put_block_public_access_configuration(
    *,
    config_overrides: Optional[EMRClientConfig] = None,
    block_public_access_configuration: Optional[BlockPublicAccessConfiguration] = None,
) -> PutBlockPublicAccessConfigurationOutput

Creates or updates an Amazon EMR block public access configuration for your Amazon Web Services account in the current Region. For more information see Configure Block Public Access for Amazon EMR in the Amazon EMR Management Guide.

Parameters:

  • block_public_access_configuration (Optional[BlockPublicAccessConfiguration], default: None ) –

    A configuration for Amazon EMR block public access. The configuration applies to all clusters created in your account for the current Region. The configuration specifies whether block public access is enabled. If block public access is enabled, security groups associated with the cluster cannot have rules that allow inbound traffic from 0.0.0.0/0 or ::/0 on a port, unless the port is specified as an exception using PermittedPublicSecurityGroupRuleRanges in the BlockPublicAccessConfiguration. By default, Port 22 (SSH) is an exception, and public access is allowed on this port. You can change this by updating BlockPublicSecurityGroupRules to remove the exception.

    For accounts that created clusters in a Region before November 25, 2019, block public access is disabled by default in that Region. To use this feature, you must manually enable and configure it. For accounts that did not create an Amazon EMR cluster in a Region before this date, block public access is enabled by default in that Region.

Raises:

Source code in docs_src/capo_emr/_services/emr.py
def put_block_public_access_configuration(
    self,
    *,
    config_overrides: Optional[EMRClientConfig] = None,
    block_public_access_configuration: Optional[
        "capo_emr.types.block_public_access_configuration.BlockPublicAccessConfiguration"
    ] = None,
) -> "capo_emr.types.put_block_public_access_configuration_output.PutBlockPublicAccessConfigurationOutput":
    """<p>Creates or updates an Amazon EMR block public access configuration for your Amazon Web Services account in the current Region. For more information see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/configure-block-public-access.html">Configure Block Public Access for Amazon EMR</a> in the <i>Amazon EMR Management Guide</i>.</p>

    Args:
        block_public_access_configuration: <p>A configuration for Amazon EMR block public access. The configuration applies to all clusters created in your account for the current Region. The configuration specifies whether block public access is enabled. If block public access is enabled, security groups associated with the cluster cannot have rules that allow inbound traffic from 0.0.0.0/0 or ::/0 on a port, unless the port is specified as an exception using <code>PermittedPublicSecurityGroupRuleRanges</code> in the <code>BlockPublicAccessConfiguration</code>. By default, Port 22 (SSH) is an exception, and public access is allowed on this port. You can change this by updating <code>BlockPublicSecurityGroupRules</code> to remove the exception.</p> <note> <p>For accounts that created clusters in a Region before November 25, 2019, block public access is disabled by default in that Region. To use this feature, you must manually enable and configure it. For accounts that did not create an Amazon EMR cluster in a Region before this date, block public access is enabled by default in that Region.</p> </note>

    Raises:
        capo_emr.errors.internal_server_exception.InternalServerException: <p>This exception occurs when there is an internal failure in the Amazon EMR service.</p>
        capo_emr.errors.invalid_request_exception.InvalidRequestException: <p>This exception occurs when there is something wrong with user input.</p>
        capo_emr.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_emr.types.put_block_public_access_configuration_input.PutBlockPublicAccessConfigurationInput]",
    ) -> OperationResponse[
        "capo_emr.types.put_block_public_access_configuration_output.PutBlockPublicAccessConfigurationOutput"
    ]:
        import capo_emr._operations.elastic_map_reduce.put_block_public_access_configuration

        output, http_response = (
            capo_emr._operations.elastic_map_reduce.put_block_public_access_configuration.put_block_public_access_configuration(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("PutBlockPublicAccessConfiguration")
    )
    input_: capo_emr.types.put_block_public_access_configuration_input.PutBlockPublicAccessConfigurationInput = {}
    if block_public_access_configuration is not None:
        input_["block_public_access_configuration"] = (
            block_public_access_configuration
        )

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