Tag Resource

s3control_tag_resource

R Documentation

Creates a new Amazon Web Services resource tag or updates an existing resource tag¶

Description¶

Creates a new Amazon Web Services resource tag or updates an existing resource tag. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources. You can add up to 50 Amazon Web Services resource tags for each S3 resource.

This operation is only supported for S3 Storage Lens groups and for S3 Access Grants. The tagged resource can be an S3 Storage Lens group or S3 Access Grants instance, registered location, or grant.

Permissions¶

You must have the s3:TagResource permission to use this operation.

For more information about the required Storage Lens Groups permissions, see Setting account permissions to use S3 Storage Lens groups.

For information about S3 Tagging errors, see List of Amazon S3 Tagging error codes.

Usage¶

s3control_tag_resource(AccountId, ResourceArn, Tags)

Arguments¶

AccountId: [required] The Amazon Web Services account ID that created the S3 resource that you're trying to add tags to or the requester's account ID.
ResourceArn: [required] The Amazon Resource Name (ARN) of the S3 resource that you're trying to add tags to. The tagged resource can be an S3 Storage Lens group or S3 Access Grants instance, registered location, or grant.
Tags: [required] The Amazon Web Services resource tags that you want to add to the specified S3 resource.

Value¶

An empty list.

Request syntax¶

svc$tag_resource(
  AccountId = "string",
  ResourceArn = "string",
  Tags = list(
    list(
      Key = "string",
      Value = "string"
    )
  )
)