標記您的 AWS Batch 資源

為協助您管理 AWS Batch 資源，您可以用標籤形式將您自己的中繼資料指派給每個資源。本主題說明標籤並示範如何建立它們。

標籤基本概念

標籤是您指派給 AWS 資源的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。

標籤可讓您分類 AWS 資源，例如依用途、擁有者或環境。當您有許多相同類型的資源時，您可以依據先前指派的標籤，快速識別特定的資源。例如，您可以為 AWS Batch 服務定義一組標籤，協助您追蹤每個服務的擁有者和堆疊層級。建議您為每個資源類型設計一組一致的標籤金鑰。

標籤不會自動指派給您的資源。新增標籤後，您可以隨時編輯標籤索引鍵和值，或從資源移除標籤。如果您刪除資源，也會刪除任何該資源的標籤。

標籤對 AWS Batch 來說不具有任何語意意義，並會嚴格解譯為字元字串。您可以將標籤的值設為空白字串，但您無法將標籤的值設為 Null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫舊值。

您可以使用 AWS Management Console、AWS CLI 和 AWS Batch API 來使用標籤。

若您使用 AWS Identity and Access Management (IAM)，您可以控制您的 AWS 帳戶中的哪些使用者具有建立、編輯和刪除標籤的許可。

標記您的  資源

您可以標記新的或現有的AWS Batch計算環境、工作、工作定義、工作佇列和排程原則。

如果您使用 AWS Batch 主控台，您可以在新資源建立時將標籤套用到新資源，或隨時在相關資源頁面上使用 Tags (標籤) 索引標籤，將標籤套用到現有的資源。

如果您使用的是 AWS Batch API、AWS CLI 或 AWS 開發套件，您可以在相關 API 動作上使用 tags 參數，將標籤套用到新資源，或使用 TagResource API 動作，將標籤套用到現有的資源。如需詳細資訊，請參閱TagResource。

有些資源建立動作可讓您在建立資源時指定資源的標籤。如果無法在資源建立時套用標籤，則資源建立程序會失敗。這可確保您要在建立時標記的資源是以指定的標籤建立，不然就根本不會建立。如果您在建立時標記資源，則不需要在建立資源之後執行自訂標記指令碼。

下表說明可標記的 AWS Batch 資源，以及可在建立時標記的資源。

AWS Batch 資源的標記支援
資源	支援標籤	支援標籤傳播	支援在建立時標記 (AWS Batch API、AWS CLI、AWS 開發套件)
AWS Batch運算環境	是	沒有 計算環境標籤不會傳播到任何其他資源。資源的標籤會在 CreateComputeEnvironmentAPI 作業中傳遞的 ComputeResources 物件的標籤成員中指定。	是
AWS Batch 工作	是	是	是
AWS Batch工作定義	是	否	是
AWS Batch 任務佇列	是	否	是
AWS Batch排程原則	是	否	是

標籤限制

以下基本限制適用於標籤：

• 每一資源最多標籤數 – 50

• 對於每一個資源，每個標籤金鑰必須是唯一的，且每個標籤金鑰只能有一個值。

• 索引鍵長度上限 - 128 個 UTF-8 Unicode 字元

• 值的長度上限 - 256 個 UTF-8 Unicode 字元

• 如果您的標記結構描述用於多個 AWS 服務和資源，請記得，其他服務可能限制允許的字元。通常允許的字元包括：可用 UTF-8 表示的英文字母、數字和空格，還有以下字元：+ - = . _ : / @。

• 標籤鍵與值皆區分大小寫。

• 請勿使用 aws:、AWS: 或其任何大小寫組合做為索引鍵或值的字首，因為這已預留給 AWS 使用。您不可編輯或刪除具此字首的標籤金鑰或值。具有此前置字元的標籤不會計入您的 tags-per-resource 限制。

透過主控台使用標籤

使用主AWS Batch控台，您可以管理與新的或現有運算環境、工作、工作定義和工作佇列相關聯的標籤。

在建立個別資源時新增標籤

您可以在建立AWS Batch運算環境、工作、工作定義、工作佇列和排程原則時新增標籤。

在個別資源上新增和刪除標籤

AWS Batch 可讓您直接從資源的頁面新增或刪除與叢集相關聯的標籤。

在個別資源上新增或刪除標籤

1. 請在以下位置開啟AWS Batch主控台。 https://console.aws.amazon.com/batch/

2. 在導覽列中，選擇要使用的「區域」。

3. 在導覽窗格中，選擇資源類型 (例如，Job 佇列)。

4. 選擇特定資源，然後選擇 「編輯標籤」。

5. 視需要新增或刪除標籤。

   • 若要新增標籤 — 在清單結尾的空白文字方塊中指定鍵和值。

   • 若要刪除標籤，請選擇標籤旁邊的 按鈕。

6. 針對您要新增或刪除的每個標籤重複此程序，然後選擇 [編輯標籤] 以完成。

透過 CLI 或 API 使用標籤

使用下列 AWS CLI 命令或 AWS Batch API 操作來新增、更新、列出及刪除資源的標籤。

AWS Batch 資源的標記支援
任務	API 動作	AWS CLI	AWS Tools for Windows PowerShell
新增或覆寫一或多個標籤。	TagResource	tag-resource	添加蝙蝠 ResourceTag
刪除一或多個標籤。	UntagResource	untag-resource	刪除蝙蝠 ResourceTag
列出資源的標籤	ListTagsForResource	list-tags-for-resource	獲取蝙蝠 ResourceTag

下列範例示範如何使用 AWS CLI 來標記或取消標記資源。

範例 1：標記現有資源

以下命令會標記現有的資源。

aws batch tag-resource --resource-arn resource_ARN --tags team=devs

範例 2：取消標記現有的資源

以下命令會從現有的資源刪除標籤。

aws batch untag-resource --resource-arn resource_ARN --tag-keys tag_key

範例 3：列出資源的標籤

以下命令列出與現有資源相關聯的標籤。

aws batch list-tags-for-resource --resource-arn resource_ARN

有些資源建立動作可讓您在建立資源時指定標籤。下列動作支援在建立時新增標籤。

任務	API 動作	AWS CLI	AWS Tools for Windows PowerShell
建立運算環境	CreateComputeEnvironment	create-compute-environment	新蝙蝠 ComputeEnvironment
建立工作佇列	CreateJobQueue	create-job-queue	新蝙蝠 JobQueue
建立排程原則	CreateSchedulingPolicy	create-scheduling-policy	新蝙蝠 SchedulingPolicy
註冊工作定義	RegisterJobDefinition	register-job-definition	寄存器蝙蝠 JobDefinition
提交任務	SubmitJob	提交工作	提交蝙蝠工作