This is the new *Amazon CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [Amazon CloudFormation User Guide](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::XRay::Group Tag
<a name="aws-properties-xray-group-tag"></a>

A map that contains tag keys and tag values to attach to an Amazon X-Ray group or sampling rule. For more information about ways to use tags, see [Tagging Amazon resources](https://docs.amazonaws.cn/general/latest/gr/aws_tagging.html) in the *Amazon General Reference*.

The following restrictions apply to tags:
+ Maximum number of user-applied tags per resource: 50
+ Tag keys and values are case sensitive.
+ Don't use `aws:` as a prefix for keys; it's reserved for Amazon use. You cannot edit or delete system tags.

## Syntax
<a name="aws-properties-xray-group-tag-syntax"></a>

To declare this entity in your Amazon CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-xray-group-tag-syntax.json"></a>

```
{
  "[Key](#cfn-xray-group-tag-key)" : {{String}},
  "[Value](#cfn-xray-group-tag-value)" : {{String}}
}
```

### YAML
<a name="aws-properties-xray-group-tag-syntax.yaml"></a>

```
  [Key](#cfn-xray-group-tag-key): {{String}}
  [Value](#cfn-xray-group-tag-value): {{String}}
```

## Properties
<a name="aws-properties-xray-group-tag-properties"></a>

`Key`  <a name="cfn-xray-group-tag-key"></a>
A tag key, such as `Stage` or `Name`. A tag key cannot be empty. The key can be a maximum of 128 characters, and can contain only Unicode letters, numbers, or separators, or the following special characters: `+ - = . _ : /`  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `128`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-xray-group-tag-value"></a>
An optional tag value, such as `Production` or `test-only`. The value can be a maximum of 255 characters, and contain only Unicode letters, numbers, or separators, or the following special characters: `+ - = . _ : /`  
*Required*: Yes  
*Type*: String  
*Minimum*: `0`  
*Maximum*: `256`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)