本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 为资源添加标签 AWS Elemental MediaConvert
*标签*是您分配或分配给 AWS 资源的标签。 AWS 每个标签均包含一个*键* 和一个*值*。对于您分配的标签，需要定义键和值。例如，您可以将键定义为“stage”，将值定义为“test”。标签可帮助您识别和整理 AWS 资源。您分配给 AWS Elemental MediaConvert 作业、作业模板、队列和预设的标签与跨 AWS 服务的标签集成。
下面是这些标签的常见使用案例：
+ 您可以在 AWS 账单与成本管理 控制面板上激活这些标签，然后设置每月成本分配报告。有关更多信息，请参阅 [通过标记设置资源以进行成本分配](setting-up-resources-for-catt.md)。
+ 您可以允许或拒绝对您的使用 AWS Identity and Access Management (IAM) 的资源进行资源级访问。有关更多信息，请参阅 *IAM 用户指南*中的[使用 AWS 资源标签控制对资源的访问权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。
**Topics**
+ [通过标签设置 AWS Elemental MediaConvert 资源以进行成本分配](setting-up-resources-for-catt.md)
+ [在创建 AWS Elemental MediaConvert 资源时添加标签](add-tags-on-create.md)
+ [为现有 AWS Elemental MediaConvert 资源添加标签](add-tags-to-existing.md)
+ [查看 AWS Elemental MediaConvert 资源上的标签](view-tags-on-resource.md)
+ [编辑 AWS Elemental MediaConvert 资源上的标签](edit-tags-on-resource.md)
+ [从 AWS Elemental MediaConvert 资源中移除标签](remove-tags-from-resource.md)
+ [对 AWS Elemental MediaConvert 资源标签的限制](resource-tagging-restrictions.md)
+ [在 AWS Elemental MediaConvert 作业中使用元数据标签](user-metadata-tags.md)
# 通过标签设置 AWS Elemental MediaConvert 资源以进行成本分配
对于使用按需队列生成的所有输出，您可以使用 AWS 账单与成本管理 控制面板设置每月成本分配报告。此报告显示了按资源排序的转码 AWS 费用。您可以将作业设置为，按作业或用于创建作业的资源上的标签对作业输出进行排序。也就是说，您可以通过放置在作业、将作业提交到的队列、通过其创建作业的作业模板或用于设置作业的各个输出的输出预设上的标签对账单进行排序。
**通过标记费用来设置成本分配 AWS Elemental MediaConvert**
1. 标记计划作为账单排序依据的资源。有关说明，请参阅本章中的其他主题。
1. 创建转码作业，指定希望如何分配成本，如下所示：
1. 在**创建任务**页面中，在左侧的**任务**窗格中，在**任务设置**下，选择**AWS 集成**。
1. 在**AWS integration（集成）**下右侧的**任务设置**部分中，对于** Billing tag source(账单标签源)**，请选择要用于对任务输出进行排序的标签。您可以选择按用于创建任务、任务模板、输出预设或队列的资源上的标签进行排序。或者，您可以选择**作业**以按作业本身上的标签进行排序。
**注意**
作业和作业上的标签仅保留 90 天。如果您的工作流需要在更长的时间内引用标签，请在队列、作业模板或输出预设上使用标签，而不是在作业上使用标签。
1. 在 AWS 账单与成本管理 仪表板上激活这些标签。有关更多信息，请参阅*账单和成本管理用户指南*中的[激活用户定义的成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html)。
1. 设置您的报告。有关更多信息，请参阅*账单和成本管理用户指南*中的[月度成本分配报告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)。
# 在创建 AWS Elemental MediaConvert 资源时添加标签
以下过程说明如何在创建 MediaConvert 队列、作业模板和输出预设时向其添加标签。
**主题**
## 在创建资源时添加标签（控制台）
您可以在创建队列、作业模板或输出预设时添加标签。
**在创建队列、作业模板或输出预设时添加标签（控制台）**
1. 按照以下过程之一中的步骤开始创建资源，但不要保存资源：
+ [教程：配置作业设置](setting-up-a-job.md)
+ [创建队列](creating-queues.md)
+ [创建模板](creating-template-from-scratch.md)
+ [创建预设](creating-preset-from-scratch.md)
+ [基于系统预设创建预设](create-custom-preset-from-system-preset.md)
1. 在相关位置中找到 **Tags (标签)** 部分：
+ 对于任务 – 在**创建任务**页面上，从左侧的**任务**部分中选择**设置**后
+ 对于队列 ，在**创建队列**页面底部
+ 对于输出预设，在**创建预设**页面底部
+ 对于任务模板，在**创建任务模板**页面底部，在从左侧**任务**窗格中选择**设置**后
1. 在**标签**部分中，选择**添加**。
1. 对于 **Tag Key (标签键)**，输入标签的名称。对于 **Tag Value (标签值)**，输入标签的值。
1. 选择 **Create (创建)** 以使用其标签保存新资源。
## 在创建资源时添加标签（API 和 AWS CLI）
使用 AWS Elemental MediaConvert API 或创建作业、作业模板、输出预设或队列时 AWS CLI，请照常提交资源的 JSON 规范。在 `tags` 中包含如以下 JSON 示例中所示的标签：
```
{
"name": "Job Template Test with Resource Tags",
"description": "Job Template Test",
"tags":{
"Company": "Banana",
"Stage": "Production"
},
"settings":{
```
# 为现有 AWS Elemental MediaConvert 资源添加标签
以下过程说明如何使用 AWS Elemental MediaConvert 控制台向现有作业模板、输出预设或队列添加标签。您不能使用控制台向现有任务添加标签。
有关使用 API 添加标签的信息，请参阅《API *参考*》的 “[标签](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags.html)端点” 部分中的`POST`MediaConvert 方法。
**注意**
MediaConvert 资源上的标签不会出现在对资源`GET`请求的 JSON 响应中。对于这种情况，应该向 `Tags` 终端节点发送 `GET` 请求。如果您直接向 API 发送请求，而不是使用 SDK 发送，则必须对资源 ARN 进行 URL 编码。
**将标签添加到作业模板、输出预设和队列中（控制台）**
1. 在 [https://console.aws.amazon.com/medi](https://console.aws.amazon.com/mediaconvert) a MediaConvert Convert 上打开控制台。
1. 选择左侧的三栏图标以访问左侧导航窗格。
1. 选择 **Output presets (输出预设)**、**Job templates (作业模板)** 或 **Queues (队列)**。
1. 选择要向其添加标签的特定资源的名称。
1. 选择右上角的 **Update (更新)**、**Edit queue (编辑队列)** 或 **Update preset (更新预设)** 按钮。
1. 在页面底部的 **Tags (标签)** 部分中，选择 **Add (添加)**。
1. 对于 **Tag Key (标签键)**，输入标签的名称。对于 **Tag Value (标签值)**，输入标签的值。
1. 选择**保存**。
# 查看 AWS Elemental MediaConvert 资源上的标签
以下过程向您展示如何使用 AWS Elemental MediaConvert 控制台查看现有队列上的标签、作业模板和输出预设。
要使用 API 执行此操作，请参阅 API *参考*的 “[标签 arn](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags-arn.html) 端点” 部分中的`GET`MediaConvert 方法。如果您直接向 API 发送请求，而不是使用 SDK 发送，则必须对资源 ARN 进行 URL 编码。
**查看队列、作业模板和输出预设的标签（控制台）**
1. 在 [https://console.aws.amazon.com/medi](https://console.aws.amazon.com/mediaconvert) a MediaConvert Convert 上打开控制台。
1. 选择左侧的三栏图标以访问左侧导航窗格。
1. 选择 **Job templates (作业模板)**、**Output presets (输出预设)** 或 **Queues (队列)**。
1. 选择具有要查看的标签的特定资源的名称。
1. 在页面底部的 **Tags (标签)** 部分中查看资源的标签。
# 编辑 AWS Elemental MediaConvert 资源上的标签
以下过程向您展示如何使用 AWS Elemental MediaConvert 控制台编辑现有作业模板上的标签、输出预设和队列。您不能编辑现有作业上的标签。
要使用 API 执行此操作，请参阅 *MediaConvert API 参考*的 “[标签](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags.html)端点” 部分中的`POST`方法。
**编辑作业模板、输出预设和队列的标签（控制台）**
1. 在 [https://console.aws.amazon.com/medi](https://console.aws.amazon.com/mediaconvert) a MediaConvert Convert 上打开控制台。
1. 选择左侧的三栏图标以访问左侧导航窗格。
1. 选择 **Job templates (作业模板)**、**Output presets (输出预设)** 或 **Queues (队列)**。
1. 选择具有要更改的标签的特定资源的名称。
1. 选择右上角的 **Update (更新)**、**Edit queue (编辑队列)** 或 **Update preset (更新预设)** 按钮。
1. 在页面底部的 **Tags (标签)** 部分中，编辑要更改的 **Tag key (标签键)** 和 **Tag values (标签值)** 的任意值。
1. 选择**保存**。
# 从 AWS Elemental MediaConvert 资源中移除标签
以下过程说明如何使用 AWS Elemental MediaConvert 控制台从现有作业模板、输出预设和队列中移除标签。
要使用 API 执行此操作，请参阅 *MediaConvert API 参考*的 “[标签](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags.html)端点” 部分中的`PUT`方法。
**删除作业模板、输出预设或队列中的标签（控制台）**
1. 在 [https://console.aws.amazon.com/medi](https://console.aws.amazon.com/mediaconvert) a MediaConvert Convert 上打开控制台。
1. 选择左侧的三栏图标以访问左侧导航窗格。
1. 选择 **Job templates (作业模板)**、**Output presets (输出预设)** 或 **Queues (队列)**。
1. 选择具有要更改的标签的特定资源的名称。
1. 选择右上角的 **Update (更新)**、**Edit queue (编辑队列)** 或 **Update preset (更新预设)** 按钮。
1. 在要删除的任何标签的旁边，选择 **Remove (删除)**。
1. 选择**保存**。
# 对 AWS Elemental MediaConvert 资源标签的限制
下面是适用于 标签的基本限制：
+ 每个资源的最大标签数为 50。
+ 最大 **Key**（键）长度 - 128 个 Unicode 字符。
+ 最大 **Value**（值）长度 - 256 个 Unicode 字符。
+ **Key**（键）和 **Value**（值）的有效值 — UTF-8 字符集中的大写和小写字母、数字、空格及以下字符：\$1 . : / = \$1 - and @
+ 标签键和值区分大小写。
+ 请不要使用 `aws:` 作为键或值的前缀。它是保留供 AWS 使用的。
# 在 AWS Elemental MediaConvert 作业中使用元数据标签
除非您的现有集成或工作流程依赖于元数据 (`userMetadata`) 标签，否则我们建议您使用标准 AWS 标签来实现与 AWS 服务的自动集成以及自定义集成和工作流程。有关更多信息，请参阅 [为资源添加标签 AWS Elemental MediaConvert](tagging-mediaconvert-resources.md)。
*标签*是您分配或分配给 AWS 资源的标签。 AWS 每个标签均包含一个*键* 和一个*值*。对于您分配的标签，需要定义键和值。例如，您可以将键定义为“stage”，将值定义为“test”。标签可帮助您识别和整理 AWS 资源。您分配给 AWS Elemental MediaConvert 任务的元数据标签会显示在 Amazon EventBridge 通知中。
您可以通过以下方式之一向任务添加元数据标签：
+ 通过 **Job 设置**页面上的 MediaConvert 控制台在 “**元数据**” 窗格中。
+ 通过任务设置中的 MediaConvert API JSON 有效负载。在 `userMetadata` 中包含如以下 JSON 代码段中所示的标签。有关更多信息，请参阅《*MediaConvert API 参考*》的 “[任务](https://docs.aws.amazon.com/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 职位标签限制
下面是适用于任务标签的基本限制：
+ 每个任务的标签数上限 – 10。
+ 最大 **Key**（键）长度 - 128 个 Unicode 字符。
+ 最大 **Value**（值）长度 - 256 个 Unicode 字符。
+ **键** 和 **值** 的有效值 任意语言的大写和小写 Unicode 字符、数字、空格及以下字符：\$1 . : / = \$1 - 和 @。
+ 标签键和值区分大小写。
+ 请不要使用 `aws:` 作为键或值的前缀。它是保留供 AWS 使用的。