UPDATEBKTMETANNOTTABLECONF()`¶

About UpdateBucketMetadataAnnotationTableConfiguration¶

Updates the annotation table configuration for an Amazon S3 bucket's metadata configuration. Use this operation to enable or disable the annotation table, or to update its associated IAM role.

An annotation table is a queryable Iceberg table that contains records of all annotations attached to objects in the bucket. To use this operation, the bucket must have an existing Amazon S3 Metadata configuration.

To use this operation, you must have the s3:UpdateBucketMetadataAnnotationTableConfiguration permission. If you are specifying or changing the IAM role, you must also have iam:PassRole permission for the role.

The IAM role must have a trust policy that allows the Amazon S3 metadata service to assume it, and a permissions policy that grants the actions needed to read annotations from your bucket. The following examples show a trust policy and a permissions policy that you can adapt for your bucket and account.

The following operations are related to UpdateBucketMetadataAnnotationTableConfiguration:

Method Signature¶

METHODS /AWS1/IF_S3~UPDATEBKTMETANNOTTABLECONF
  IMPORTING
    !IV_BUCKET TYPE /AWS1/S3_BUCKETNAME OPTIONAL
    !IV_CONTENTMD5 TYPE /AWS1/S3_CONTENTMD5 OPTIONAL
    !IV_CHECKSUMALGORITHM TYPE /AWS1/S3_CHECKSUMALGORITHM OPTIONAL
    !IO_ANNOTATIONTABLECONF TYPE REF TO /AWS1/CL_S3_ANNOTTABLECONFUPDS OPTIONAL
    !IV_EXPECTEDBUCKETOWNER TYPE /AWS1/S3_ACCOUNTID OPTIONAL
  RAISING
    /AWS1/CX_S3_CLIENTEXC
    /AWS1/CX_S3_SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_bucket` `TYPE /AWS1/S3_BUCKETNAME` `/AWS1/S3_BUCKETNAME`¶

The name of the bucket whose annotation table configuration to update.

`io_annotationtableconf` `TYPE REF TO /AWS1/CL_S3_ANNOTTABLECONFUPDS` `/AWS1/CL_S3_ANNOTTABLECONFUPDS`¶

The annotation table configuration updates to apply.

Optional arguments:¶

`iv_contentmd5` `TYPE /AWS1/S3_CONTENTMD5` `/AWS1/S3_CONTENTMD5`¶

Base64-encoded MD5 digest of the message body.

`iv_checksumalgorithm` `TYPE /AWS1/S3_CHECKSUMALGORITHM` `/AWS1/S3_CHECKSUMALGORITHM`¶

Checksum algorithm for the request payload.

`iv_expectedbucketowner` `TYPE /AWS1/S3_ACCOUNTID` `/AWS1/S3_ACCOUNTID`¶

The account ID of the expected bucket owner.

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

lo_client->updatebktmetannottableconf(
  io_annotationtableconf = new /aws1/cl_s3_annottableconfupds(
    io_encryptionconfiguration = new /aws1/cl_s3_mettableencconf(
      iv_kmskeyarn = |string|
      iv_ssealgorithm = |string|
    )
    iv_configurationstate = |string|
    iv_role = |string|
  )
  iv_bucket = |string|
  iv_checksumalgorithm = |string|
  iv_contentmd5 = |string|
  iv_expectedbucketowner = |string|
).

/AWS1/IF_S3=>UPDATEBKTMETANNOTTABLECONF()¶