本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 标注 Amazon Braket 资源
<a name="braket-tagging-resources"></a>

*标签*是您分配或分配给 AWS 资源的自定义属性标签。 AWS 标签是*元数据*，可详细介绍您的资源。每个标签均包含一个*键* 和一个*值*。这些被统称为*键/值对*。对于您分配的标签，需要定义键和值。

在 Amazon Braket 控制台中，您可以导航到量子任务或 Notebook 并查看与之相关的标签列表。您可以添加标签、移除标签或修改标签。可以在创建量子任务或笔记本时对其进行标记，然后通过控制台 AWS CLI、或管理关联的标签API。

**更多关于 AWS 和标签**
+ 有关标签的一般信息，包括命名和使用惯例，请参阅[什么是标签编辑器](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)？ 在《*标签 AWS 资源和标签编辑器*用户指南》中。
+ 有关标签限制的信息，请参阅《标签* 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 Brake AWS CLI t 中添加标签的示例](braket-tags-example.md)

## 使用标签
<a name="tags"></a>

标签可以将您的资源组织成对您有用的类别。例如，您可以分配一个指定拥有该资源的部门的“Department”标签。

每个 标签具有两个部分：
+ 标签密钥（例如 *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 中支持的标注资源
<a name="tag-supported-resources"></a>

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 正则表达式：**`arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}`

 **注意：**尽管笔记本实际上是 Amazon A SageMaker I 资源，但您可以在 Amazon Braket 控制台中为自己Amazon的 Braket 笔记本电脑应用和管理，方法是使用控制台导航到笔记本资源。有关更多信息，请参阅 SageMaker 文档中的[笔记本实例元数据](https://docs.aws.amazon.com/sagemaker/latest/dg/nbi-metadata.html)。

## 使用 Amazon Braket API 进行标注
<a name="braket-cli-tagging"></a>
+ 如果您使用 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\"]"`