本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 搭配 AWS Elemental MediaConvert 任務使用中繼資料標籤
<a name="user-metadata-tags"></a>

除非您有依賴中繼資料 (`userMetadata`) 標籤的現有整合或工作流程，否則我們建議您使用標準 AWS 標籤來自動整合 AWS 服務和自訂整合和工作流程。如需詳細資訊，請參閱[標記 AWS Elemental MediaConvert 資源](tagging-mediaconvert-resources.md)。

*標籤*是您指派或 AWS 指派給 資源的 AWS 標籤。每個標籤皆包含*鍵*與*值*。對於您指派的標籤，您可以定義索引鍵和值。例如，您可以將鍵定義為「階段」，將值定義為「測試」。標籤可協助您識別和組織 AWS 資源。您指派給 AWS Elemental MediaConvert 任務的中繼資料標籤會顯示在 Amazon EventBridge 通知中。

您可採用下列其中一種方式來新增中繼資料標籤至任務：
+ 透過**任務設定**頁面上的 MediaConvert 主控台，在**中繼資料**窗格中。
+ 透過任務設定 JSON 承載中的 MediaConvert API。包含標籤，如以下 JSON 程式碼片段所示 (在 `userMetadata` 中)。如需詳細資訊，請參閱 *MediaConvert API 參考*的任務[https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html](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 任務標籤限制
<a name="job-tagging-restrictions"></a>

以下基本限制適用於任務上的標籤：
+ 每個任務的標籤數目上限 – 10。
+ **金鑰**長度上限 – 128 個 Unicode 字元。
+ **最大值**長度 – 256 個 Unicode 字元。
+ **索引鍵**和**值**的有效值 – 任何語言、數字、空格和下列字元的大寫和小寫 Unicode 字母：\_ . ： / = \+ - 和 @。
+ 標籤鍵與值皆區分大小寫。
+ 金鑰或值請勿使用 `aws:` 字首。它保留供 AWS 使用。