Skip to content

Untag Role

iam_untag_role R Documentation

Removes the specified tags from the role

Description

Removes the specified tags from the role. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

Usage

iam_untag_role(RoleName, TagKeys)

Arguments

RoleName

[required] The name of the IAM role from which you want to remove tags.

This parameter accepts (through its regex pattern) a string of characters that consist of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

TagKeys

[required] A list of key names as a simple array of strings. The tags with matching keys are removed from the specified role.

Value

An empty list.

Request syntax

svc$untag_role(
  RoleName = "string",
  TagKeys = list(
    "string"
  )
)

Examples

## Not run: 
# The following example shows how to remove a tag with the key 'Dept' from
# a role named 'taggedrole'.
svc$untag_role(
  RoleName = "taggedrole",
  TagKeys = list(
    "Dept"
  )
)

## End(Not run)