本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
標記 Amazon Braket 資源
標籤是您指派或 AWS 指派給 AWS 資源的自訂屬性標籤。標籤是說明資源詳細資訊的中繼資料。每個標籤皆包含鍵與值。這些合稱為鍵值組。對於您指派的標籤，您可以定義鍵與值。
在 Amazon Braket 主控台中，您可以導覽至量子任務或筆記本，並檢視與其相關聯的標籤清單。您可以新增標籤、移除標籤或修改標籤。您可以在建立時標記量子任務或筆記本，然後透過主控台 AWS CLI或 管理相關聯的標籤API。
有關 AWS 和 標籤的詳細資訊
-
如需標記的一般資訊，包括命名和使用慣例，請參閱《標記 AWS 資源和標籤編輯器使用者指南》中的什麼是標籤編輯器？。
-
如需有關標記限制的資訊，請參閱《標記 AWS 資源和標籤編輯器使用者指南》中的標籤命名限制和要求。
-
如需最佳實務和標記策略，請參閱標記 AWS 資源的最佳實務。
-
關於支援標記的服務清單，請參閱Resource Groups 標記 API 參考。
以下各節提供有關 Amazon Braket 標籤的更具體資訊。
在本節中：
使用標籤
標籤可以將資源組織成對您有用的類別。例如，您可以指派「部門」標籤來指定擁有此資源的部門。
每個標籤有兩個部分：
-
標籤金鑰 （例如 CostCenter、環境或專案)。標籤鍵會區分大小寫。
-
稱為標籤值的選用欄位 （例如 111122223333 或 Production)。忽略標籤值基本上等同於使用空字串。與標籤鍵相同，標籤值會區分大小寫。
標籤可協助您執行下列動作：
-
識別和組織您的 AWS 資源。許多 AWS 服務 支援標記，因此您可以將相同的標籤指派給來自不同 服務的資源，以指出資源相關。
-
追蹤您的 AWS 成本。您可以在 AWS 帳單與成本管理 儀表板上啟用這些標籤。 AWS 會使用標籤來分類您的成本，並傳送每月成本分配報告給您。如需詳細資訊，請參閱 AWS 帳單與成本管理 使用者指南中的使用成本配置標籤。
-
控制對 AWS 資源的存取。如需詳細資訊，請參閱使用標籤控制存取。
Amazon Braket 中用於標記的支援資源
Amazon Braket 中的下列資源類型支援標記：
-
quantum-task資源 -
資源名稱：
AWS::Service::Braket -
ARN Regex：
arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}
注意：雖然Amazon筆記本實際上是 Amazon SageMaker AI 資源，但您可以使用主控台導覽至筆記本資源，在 Amazon Braket 主控台中套用和管理 Braket 筆記本的標籤。如需詳細資訊，請參閱 SageMaker 文件中的筆記本執行個體中繼資料。
使用 Amazon Braket API標記
-
如果您使用 Amazon Braket 在資源上API設定標籤，請呼叫
TagResourceAPI。
aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tags {\"city\":\"Seattle\"}
-
若要從資源中移除標籤，請呼叫
UntagResourceAPI。
aws braket list-tags-for-resource --resource-arn $YOUR_TASK_ARN
-
若要列出連接至特定資源的所有標籤，請呼叫
ListTagsForResourceAPI。
aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tag-keys "[\"city\",\"state\"]"
