本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 AWS Elemental MediaConvert 作业中使用元数据标签
<a name="user-metadata-tags"></a>

除非您的现有集成或工作流程依赖于元数据 (`userMetadata`) 标签，否则我们建议您使用标准 Amazon 标签来实现与 Amazon 服务的自动集成以及自定义集成和工作流程。有关更多信息，请参阅 [为资源添加标签 AWS Elemental MediaConvert](tagging-mediaconvert-resources.md)。

*标签*是您分配或分配给 Amazon 资源的标签。 Amazon 每个标签均包含一个*键* 和一个*值*。对于您分配的标签，需要定义键和值。例如，您可以将键定义为“stage”，将值定义为“test”。标签可帮助您识别和整理 Amazon 资源。您分配给 AWS Elemental MediaConvert 任务的元数据标签会显示在 Amazon EventBridge 通知中。

您可以通过以下方式之一向任务添加元数据标签：
+ 通过 **Job 设置**页面上的 MediaConvert 控制台在 “**元数据**” 窗格中。
+ 通过任务设置中的 MediaConvert API JSON 有效负载。在 `userMetadata` 中包含如以下 JSON 代码段中所示的标签。有关更多信息，请参阅《*MediaConvert API 参考*》的 “[任务](https://docs.amazonaws.cn/mediaconvert/latest/apireference/jobs.html)端点” 部分。

  ```
  {
  	"name": "Job Template Test with Resource Tags",
  	"description": "Job Template Test",
  	"userMetadata":{
  		"Company": "Banana",
  		"Stage": "Production"		
  	},
  	"settings":{
  ```

 

## AWS Elemental MediaConvert 职位标签限制
<a name="job-tagging-restrictions"></a>

下面是适用于任务标签的基本限制：
+ 每个任务的标签数上限 – 10。
+ 最大 **Key**（键）长度 - 128 个 Unicode 字符。
+ 最大 **Value**（值）长度 - 256 个 Unicode 字符。
+ **键** 和 **值** 的有效值 任意语言的大写和小写 Unicode 字符、数字、空格及以下字符：\_ . : / = \+ - 和 @。
+ 标签键和值区分大小写。
+ 请不要使用 `aws:` 作为键或值的前缀。它是保留供 Amazon 使用的。