CREATETABLEBUCKET()`¶

About CreateTableBucket¶

Creates a table bucket. For more information, see Creating a table bucket in the Amazon Simple Storage Service User Guide.

Permissions

You must have the s3tables:CreateTableBucket permission to use this operation.
If you use this operation with the optional encryptionConfiguration parameter you must have the s3tables:PutTableBucketEncryption permission.
You must have the s3tables:TagResource permission in addition to s3tables:CreateTableBucket permission to create a table bucket with tags.

Method Signature¶

METHODS /AWS1/IF_S3T~CREATETABLEBUCKET
  IMPORTING
    !IV_NAME TYPE /AWS1/S3TTABLEBUCKETNAME OPTIONAL
    !IO_ENCRYPTIONCONFIGURATION TYPE REF TO /AWS1/CL_S3TENCRYPTIONCONF OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_S3TTAGS_W=>TT_TAGS OPTIONAL
  PREFERRED PARAMETER iv_name
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_s3tcreatetablebktrsp
  RAISING
    /AWS1/CX_S3TBADREQUESTEX
    /AWS1/CX_S3TCONFLICTEXCEPTION
    /AWS1/CX_S3TFORBIDDENEXCEPTION
    /AWS1/CX_S3TINTERNALSERVERER00
    /AWS1/CX_S3TNOTFOUNDEXCEPTION
    /AWS1/CX_S3TTOOMANYREQUESTSEX
    /AWS1/CX_S3TCLIENTEXC
    /AWS1/CX_S3TSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_name` `TYPE /AWS1/S3TTABLEBUCKETNAME` `/AWS1/S3TTABLEBUCKETNAME`¶

The name for the table bucket.

Optional arguments:¶

`io_encryptionconfiguration` `TYPE REF TO /AWS1/CL_S3TENCRYPTIONCONF` `/AWS1/CL_S3TENCRYPTIONCONF`¶

The encryption configuration to use for the table bucket. This configuration specifies the default encryption settings that will be applied to all tables created in this bucket unless overridden at the table level. The configuration includes the encryption algorithm and, if using SSE-KMS, the KMS key to use.

`it_tags` `TYPE /AWS1/CL_S3TTAGS_W=>TT_TAGS` `TT_TAGS`¶

A map of user-defined tags that you would like to apply to the table bucket that you are creating. A tag is a key-value pair that you apply to your resources. Tags can help you organize and control access to resources. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).

You must have the s3tables:TagResource permission in addition to s3tables:CreateTableBucket permisson to create a table bucket with tags.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_s3tcreatetablebktrsp` `/AWS1/CL_S3TCREATETABLEBKTRSP`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

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.

DATA(lo_result) = lo_client->createtablebucket(
  io_encryptionconfiguration = new /aws1/cl_s3tencryptionconf(
    iv_kmskeyarn = |string|
    iv_ssealgorithm = |string|
  )
  it_tags = VALUE /aws1/cl_s3ttags_w=>tt_tags(
    (
      VALUE /aws1/cl_s3ttags_w=>ts_tags_maprow(
        key = |string|
        value = new /aws1/cl_s3ttags_w( |string| )
      )
    )
  )
  iv_name = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_tablebucketarn = lo_result->get_arn( ).
ENDIF.

/AWS1/IF_S3T=>CREATETABLEBUCKET()¶