TAGRESOURCE()`¶

About TagResource¶

Applies one or more user-defined tags to an Amazon S3 Tables resource or updates existing tags. Each tag is a label consisting of a key and value pair. Tags can help you organize, track costs for, and control access to your resources. You can add up to 50 tags for each S3 resource.

For a list of S3 resources that support tagging, see Managing tags for Amazon S3 resources.

Permissions: For tables and table buckets, you must have the s3tables:TagResource permission to use this operation.

Method Signature¶

METHODS /AWS1/IF_S3T~TAGRESOURCE
  IMPORTING
    !IV_RESOURCEARN TYPE /AWS1/S3TRESOURCEARN OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_S3TTAGS_W=>TT_TAGS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_s3ttagresresponse
  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_resourcearn` `TYPE /AWS1/S3TRESOURCEARN` `/AWS1/S3TRESOURCEARN`¶

The Amazon Resource Name (ARN) of the Amazon S3 Tables resource that you're applying tags to. The tagged resource can be a table bucket or a table. For a list of all S3 resources that support tagging, see Managing tags for Amazon S3 resources.

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

The user-defined tag that you want to add to the specified S3 Tables resource. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_s3ttagresresponse` `/AWS1/CL_S3TTAGRESRESPONSE`¶

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->tagresource(
  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_resourcearn = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
ENDIF.

/AWS1/IF_S3T=>TAGRESOURCE()¶