Skip to content

put_table_bucket_policy 

put_table_bucket_policy(
    table_bucket_arn: TableBucketARN,
    resource_policy: ResourcePolicy,
    *,
    config_overrides: Optional[S3TablesClientConfig] = None,
) -> None

Creates a new table bucket policy or replaces an existing table bucket policy for a table bucket. For more information, see Adding a table bucket policy in the Amazon Simple Storage Service User Guide.

Permissions

You must have the s3tables:PutTableBucketPolicy permission to use this operation.

Parameters:

  • table_bucket_arn (TableBucketARN) –

    The Amazon Resource Name (ARN) of the table bucket.

  • resource_policy (ResourcePolicy) –

    The JSON that defines the policy.

Raises:

Source code in docs_src/capo_s3tables/_services/s3_tables.py 
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
def put_table_bucket_policy(
    self,
    table_bucket_arn: "capo_s3tables.types.table_bucket_arn.TableBucketARN",
    resource_policy: "capo_s3tables.types.resource_policy.ResourcePolicy",
    *,
    config_overrides: Optional[S3TablesClientConfig] = None,
) -> None:
    """<p>Creates a new table bucket policy or replaces an existing table bucket policy for a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-add">Adding a table bucket policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableBucketPolicy</code> permission to use this operation. </p> </dd> </dl>

    Args:
        table_bucket_arn: <p>The Amazon Resource Name (ARN) of the table bucket.</p>
        resource_policy: <p>The <code>JSON</code> that defines the policy.</p>

    Raises:
        capo_s3tables.errors.bad_request_exception.BadRequestException: <p>The request is invalid or malformed.</p>
        capo_s3tables.errors.conflict_exception.ConflictException: <p>The request failed because there is a conflict with a previous write. You can retry the request.</p>
        capo_s3tables.errors.forbidden_exception.ForbiddenException: <p>The caller isn't authorized to make the request.</p>
        capo_s3tables.errors.internal_server_error_exception.InternalServerErrorException: <p>The request failed due to an internal server error.</p>
        capo_s3tables.errors.not_found_exception.NotFoundException: <p>The request was rejected because the specified resource could not be found.</p>
        capo_s3tables.errors.too_many_requests_exception.TooManyRequestsException: <p>The limit on the number of requests per second was exceeded.</p>
        capo_s3tables.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_s3tables.types.put_table_bucket_policy_request.PutTableBucketPolicyRequest]",
    ) -> OperationResponse[None]:
        import capo_s3tables._operations.s3_table_buckets.put_table_bucket_policy

        output, http_response = (
            capo_s3tables._operations.s3_table_buckets.put_table_bucket_policy.put_table_bucket_policy(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("PutTableBucketPolicy")
    )
    input_: capo_s3tables.types.put_table_bucket_policy_request.PutTableBucketPolicyRequest = {
        "table_bucket_arn": table_bucket_arn,
        "resource_policy": resource_policy,
    }

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