本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 標記 Amazon Braket 資源
*標籤*是您指派或 AWS 指派給 AWS 資源的自訂屬性標籤。標籤是*中繼資料*，可進一步了解您的資源。每個標籤皆包含*鍵*與*值*。這些合稱為*鍵值組*。對於您指派的標籤，您可以定義索引鍵和值。
在 Amazon Braket 主控台中，您可以導覽至量子任務或筆記本，並檢視與其相關聯的標籤清單。您可以新增標籤、移除標籤或修改標籤。您可以在建立時標記量子任務或筆記本，然後透過主控台 AWS CLI或 管理相關聯的標籤API。
**有關 AWS 和 標籤的詳細資訊**
+ 如需標記的一般資訊，包括命名和使用慣例，請參閱*《標記 AWS 資源和標籤編輯器使用者指南》中的*[什麼是標籤編輯器？](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)。
+ 如需有關標記限制的資訊，請參閱《* AWS *[標記資源和標籤編輯器使用者指南》中的標記命名限制和要求](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices)。
+ 如需最佳實務和標記策略，請參閱[標記 AWS 資源的最佳實務](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html)。
+ 關於支援標記的服務清單，請參閱[https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html)。
以下各節提供有關 Amazon Braket 標籤的更具體資訊。
**Topics**
+ [
## 使用標籤
](#tags)
+ [
## Amazon Braket 中用於標記的支援資源
](#tag-supported-resources)
+ [
## 使用 Amazon Braket API標記
](#braket-cli-tagging)
+ [
# 標記限制
](tag-restrictions.md)
+ [
# 在 Amazon Braket 中管理標籤
](tag-managing.md)
+ [
# Amazon Braket 中的 AWS CLI 標記範例
](braket-tags-example.md)
## 使用標籤
標籤可以將資源組織成對您有用的類別。例如，您可以指派「部門」標籤來指定擁有此資源的部門。
每個 標籤都有兩個部分：
+ 標籤金鑰 （例如 *CostCenter*、*環境*或*專案*)。標籤金鑰會區分大小寫。
+ 稱為標籤值的選用欄位 （例如 *111122223333* 或 *Production*)。忽略標籤值基本上等同於使用空字串。與標籤金鑰相同，標籤值會區分大小寫。
標籤可協助您執行下列動作：
+ **識別和組織您的 AWS 資源。**許多 AWS 服務 支援標記，因此您可以將相同的標籤指派給來自不同 服務的資源，以指出資源相關。
+ **追蹤您的 AWS 成本。**您可以在 AWS 帳單與成本管理 儀表板上啟用這些標籤。 AWS 會使用標籤來分類您的成本，並傳送每月成本分配報告給您。如需詳細資訊，請參閱 [https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html)中的[使用成本配置標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
+ **控制對 AWS 資源的存取。**如需詳細資訊，請參閱[使用標籤控制存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。
## Amazon Braket 中用於標記的支援資源
Amazon Braket 中的下列資源類型支援標記：
+ [https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources](https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources) 資源
+ **資源名稱：** `AWS::Service::Braket`
+ **ARN Regex：** `arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}`
**注意：**您可以在 Amazon Braket 主控台中套用和管理 Amazon Braket 筆記本的標籤，方法是使用主控台導覽至筆記本資源，但筆記本實際上是 Amazon SageMaker AI 資源。如需詳細資訊，請參閱 SageMaker 文件中的[筆記本執行個體中繼資料](https://docs.aws.amazon.com/sagemaker/latest/dg/nbi-metadata.html)。
## 使用 Amazon Braket API標記
+ 如果您使用 Amazon Braket 在資源上API設定標籤，請呼叫 [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html)。
`aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tags {\"city\":\"Seattle\"}`
+ 若要從資源中移除標籤，請呼叫 [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html)。
`aws braket list-tags-for-resource --resource-arn $YOUR_TASK_ARN`
+ 若要列出連接至特定資源的所有標籤，請呼叫 [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html)。
`aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tag-keys "[\"city\",\"state\"]"`
# 標記限制
下列基本限制適用於 Amazon Braket 資源上的標籤：
+ 您可以指派給資源的標籤數量上限：50
+ 索引鍵長度上限：128 個 Unicode 字元
+ 數值長度上限：256 個 Unicode 字元
+ 索引鍵和值的有效字元： `a-z, A-Z, 0-9, space`和這些字元： `_ . : / = + -`和 `@`
+ 索引鍵和值會區分大小寫。
+ 不要使用 `aws`做為金鑰的字首；它保留供 AWS 使用。
# 在 Amazon Braket 中管理標籤
您可以將標籤設定為*資源*上的*屬性*。您可以透過 Amazon Braket 主控台、Amazon Braket 或 來檢視、新增API、修改、列出和刪除標籤 AWS CLI。如需詳細資訊，請參閱 [Amazon Braket API 參考](https://docs.aws.amazon.com/braket/latest/APIReference/Welcome.html)。
**Topics**
+ [
## 新增 標籤
](#add-tags)
+ [
## 檢視標籤
](#view-tags)
+ [
## 編輯標籤
](#edit-tags)
+ [
## 移除標籤
](#remove-tags)
## 新增 標籤
您可以在下列時間將標籤新增至可標記的資源：
+ **當您建立 資源時：**使用 主控台，或在 [AWS API](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html) 中包含 `Tags` 參數與 `Create`操作。
+ **建立資源後：**使用主控台導覽至量子任務或筆記本資源，或在 [AWS API](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html) 中呼叫 `TagResource`操作。
若要在建立資源時新增標籤，您也需要建立指定類型資源的許可。
## 檢視標籤
您可以使用主控台導覽至任務或筆記本資源，或呼叫 `ListTagsForResource`API操作，來檢視 Amazon Braket 中任何可標記資源的 AWS 標籤。
您可以使用下列 AWS API命令來檢視資源上的標籤：
+ ** AWS API:** `ListTagsForResource`
## 編輯標籤
您可以使用 主控台導覽至量子任務或筆記本資源來編輯標籤，或使用下列命令來修改連接至可標記資源之標籤的值。當您指定已存在的標籤金鑰時，會覆寫該金鑰的值：
+ ** AWS API:** `TagResource`
## 移除標籤
您可以透過指定要移除的金鑰、使用主控台導覽至量子任務或筆記本資源，或在呼叫 `UntagResource`操作時，從資源移除標籤。
+ ** AWS API:** `UntagResource`
# Amazon Braket 中的 AWS CLI 標記範例
當您使用 AWS Command Line Interface (AWS CLI) 與 Amazon Braket 互動時，以下程式碼是示範如何建立套用至您建立之量子任務的標籤的範例命令。在此範例中，任務正在SV1量子模擬器上執行，並指定量子處理單元 (QPU) Rigetti 的參數設定。請務必在範例命令中，在所有其他必要參數之後，在最結尾指定標籤。在此情況下，標籤的**索引鍵**為 `state`，**值**為 `Washington`。這些標籤可用來協助分類或識別此特定量子任務。
```
aws braket create-quantum-task --action /
"{\"braketSchemaHeader\": {\"name\": \"braket.ir.jaqcd.program\", /
\"version\": \"1\"}, /
\"instructions\": [{\"angle\": 0.15, \"target\": 0, \"type\": \"rz\"}], /
\"results\": null, /
\"basis_rotation_instructions\": null}" /
--device-arn "arn:aws:braket:::device/quantum-simulator/amazon/sv1" /
--output-s3-bucket "my-example-braket-bucket-name" /
--output-s3-key-prefix "my-example-username" /
--shots 100 /
--device-parameters /
"{\"braketSchemaHeader\": /
{\"name\": \"braket.device_schema.rigetti.rigetti_device_parameters\", /
\"version\": \"1\"}, \"paradigmParameters\": /
{\"braketSchemaHeader\": /
{\"name\": \"braket.device_schema.gate_model_parameters\", /
\"version\": \"1\"}, /
\"qubitCount\": 2}}" /
--tags {\"state\":\”Washington\"}
```
此範例示範如何在透過 執行時將標籤套用至量子任務 AWS CLI，這有助於組織和追蹤您的 Braket 資源。