# Tag
<a name="API_Tag"></a>

A structure containing a tag. A tag is metadata that you can attach to your resources to help organize and categorize them. You can also use them to help you secure your resources. For more information, see [Controlling access to Amazon resources using tags](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_tags.html).

For more information about tags, see [Tagging Amazon resources](https://docs.amazonaws.cn/general/latest/gr/aws_tagging.html) in the * Amazon General Reference Guide*.

## Contents
<a name="API_Tag_Contents"></a>

**Note**  
In the following list, the required parameters are described first.

 ** key **   <a name="ram-Type-Tag-key"></a>
The key, or name, attached to the tag. Every tag must have a key. Key names are case sensitive.  
Type: String  
Required: No

 ** value **   <a name="ram-Type-Tag-value"></a>
The string value attached to the tag. The value can be an empty string. Key values are case sensitive.  
Type: String  
Required: No

## See Also
<a name="API_Tag_SeeAlso"></a>

For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/ram-2018-01-04/Tag) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/ram-2018-01-04/Tag) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/ram-2018-01-04/Tag)