create_multi_region_access_point `async` ¶

create_multi_region_access_point(
    account_id: AccountId,
    client_token: MultiRegionAccessPointClientToken,
    details: CreateMultiRegionAccessPointInput,
    *,
    config_overrides: Optional[AsyncS3ControlClientConfig] = None,
) -> CreateMultiRegionAccessPointResult

This operation is not supported by directory buckets.

Creates a Multi-Region Access Point and associates it with the specified buckets. For more information about creating Multi-Region Access Points, see Creating Multi-Region Access Points in the Amazon S3 User Guide.

This action will always be routed to the US West (Oregon) Region. For more information about the restrictions around working with Multi-Region Access Points, see Multi-Region Access Point restrictions and limitations in the Amazon S3 User Guide.

This request is asynchronous, meaning that you might receive a response before the command has completed. When this request provides a response, it provides a token that you can use to monitor the status of the request with DescribeMultiRegionAccessPointOperation.

The following actions are related to CreateMultiRegionAccessPoint:

Parameters:

account_id (AccountId) –

The Amazon Web Services account ID for the owner of the Multi-Region Access Point. The owner of the Multi-Region Access Point also must own the underlying buckets.
client_token (MultiRegionAccessPointClientToken) –

An idempotency token used to identify the request and guarantee that requests are unique.
details (CreateMultiRegionAccessPointInput) –

A container element containing details about the Multi-Region Access Point.

Raises:

UnknownServiceError –

The service returned an error code this client does not model.

Source code in docs_src/capo_s3_control/_services/async_s3_control.py

async def create_multi_region_access_point(
    self,
    account_id: "capo_s3_control.types.account_id.AccountId",
    client_token: "capo_s3_control.types.multi_region_access_point_client_token.MultiRegionAccessPointClientToken",
    details: "capo_s3_control.types.create_multi_region_access_point_input.CreateMultiRegionAccessPointInput",
    *,
    config_overrides: Optional[AsyncS3ControlClientConfig] = None,
) -> "capo_s3_control.types.create_multi_region_access_point_result.CreateMultiRegionAccessPointResult":
    """<note> <p>This operation is not supported by directory buckets.</p> </note> <p>Creates a Multi-Region Access Point and associates it with the specified buckets. For more information about creating Multi-Region Access Points, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html">Creating Multi-Region Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>This action will always be routed to the US West (Oregon) Region. For more information about the restrictions around working with Multi-Region Access Points, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRestrictions.html">Multi-Region Access Point restrictions and limitations</a> in the <i>Amazon S3 User Guide</i>.</p> <p>This request is asynchronous, meaning that you might receive a response before the command has completed. When this request provides a response, it provides a token that you can use to monitor the status of the request with <code>DescribeMultiRegionAccessPointOperation</code>.</p> <p>The following actions are related to <code>CreateMultiRegionAccessPoint</code>:</p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteMultiRegionAccessPoint.html">DeleteMultiRegionAccessPoint</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeMultiRegionAccessPointOperation.html">DescribeMultiRegionAccessPointOperation</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPoint.html">GetMultiRegionAccessPoint</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListMultiRegionAccessPoints.html">ListMultiRegionAccessPoints</a> </p> </li> </ul>

    Args:
        account_id: <p>The Amazon Web Services account ID for the owner of the Multi-Region Access Point. The owner of the Multi-Region Access Point also must own the underlying buckets.</p>
        client_token: <p>An idempotency token used to identify the request and guarantee that requests are unique.</p>
        details: <p>A container element containing details about the Multi-Region Access Point.</p>

    Raises:
        capo_s3_control.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_s3_control.types.create_multi_region_access_point_request.CreateMultiRegionAccessPointRequest]",
    ) -> AsyncOperationResponse[
        "capo_s3_control.types.create_multi_region_access_point_result.CreateMultiRegionAccessPointResult"
    ]:
        import capo_s3_control._operations.awss3_control_service_v20180820.create_multi_region_access_point

        (
            output,
            http_response,
        ) = await capo_s3_control._operations.awss3_control_service_v20180820.create_multi_region_access_point.async_create_multi_region_access_point(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateMultiRegionAccessPoint")
    )
    input_: capo_s3_control.types.create_multi_region_access_point_request.CreateMultiRegionAccessPointRequest = {
        "account_id": account_id,
        "client_token": client_token,
        "details": details,
    }

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output

create_multi_region_access_point async ¶

create_multi_region_access_point `async` ¶