標籤亞馬遜標籤資源

標籤是一種自訂屬性標籤，可讓您指派或由 AWS 指派給 AWS 資源。標籤是元資料告訴更多關於你的資源。每個標籤皆包含鍵與值。這些合稱為鍵值組。對於您指派的標籤，您可以定義鍵與值。

在AmazonBraket 控制台，您可以導航到量子任務或筆記本，並查看與之關聯的標籤列表。您可以新增標籤、移除標籤或修改標籤。您可以在創建時標記量子任務或筆記本，然後通過控制台管理關聯的標籤，AWS CLI，或API。

使用標籤

標籤可以將您的資源組織成對您有用的類別。例如，您可以指定「部門」標籤來指定擁有此資源的部門。

每個標籤有兩個部分：

• 標籤鍵 (例如，CostCenter,環境，或項目). 標籤鍵會區分大小寫。

• 稱為標籤值的選用欄位 (例如，111122223333或者生產). 忽略標籤值基本上等同於使用空字串。與標籤鍵相同，標籤值會區分大小寫。

標籤可以幫助您執行以下操作：

• 識別和組織您的AWS資源。許多 AWS 服務支援標記，因此您可以對來自不同服務的資源指派相同的標籤，指出資源是相關的。

• 追蹤您的AWS成本。您可以在 AWS Billing and Cost Management 儀表板上啟用這些標籤。AWS 會使用標籤分類您的成本，並交付每月成本配置報告給您。如需詳細資訊，請參閱《AWS Billing and Cost Management 使用者指南》中的使用成本配置標籤。

• 控制您的存取權AWS資源。如需詳細資訊，請參閱使用標籤控制存取。

更多關於AWS和標籤

• 如需標籤的一般資訊，包括命名和使用慣例，請參閱標記AWS資源在AWS一般參考。

• 如需標籤限制的資訊，請參閱〈標籤命名限制和需求在AWS一般參考。

• 如需最佳作法和標籤策略，請參閱標籤最佳做法和AWS標籤策略。

• 關於支援標記的服務清單，請參閱Resource Groups 標記 API 參考。

以下各節提供標籤的更具體資訊Amazon布拉基特。

Amazon Braket 標籤中支援的資源

以下資源類型Amazon胸針支持標記：

• quantum-task 資源

• 資源名稱： AWS::Service::Braket

• ARN 正則表達式： arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}

注意：您可以套用和管理您的標籤Amazon在布拉基特筆記本AmazonBraket 控制台，通過使用控制台導航到筆記本資源，儘管筆記本電腦實際上是亞馬遜 SageMaker 資源。如需詳細資訊，請參閱筆記本執行個體在 SageMaker 文件。

標籤限制

下列基本限制適用於標籤Amazon布拉基特資源：

• 您可以指定給資源的標籤數上限：50

• 索引鍵長度上限：128 個 Unicode 字元

• 數值長度上限：256 個 Unicode 字元

• 索引鍵和值的有效字元：a-z, A-Z, 0-9, space，以及這些字元：_ . : / = + -和@

• 金鑰和值會區分大小寫。

• 不要使用aws作為鍵的前綴；它保留給AWS使用。

在 Amazon Braket 標籤管理標籤

您將標籤設定為性能在一個資源。您可以使用標籤檢視、新增、修改、列出和移除標籤。Amazon布拉克特控制台Amazon布拉基API，或AWS CLI。如需詳細資訊，請參閱Amazon Braket API 參考。

新增標籤

您可以在以下時間向可標籤資源中新增標籤：

• 當您建立資源時：使用控制台，或包括Tags參數與Create操作中的AWSAPI。

• 建立資源之後：使用主控台導覽至量子工作或筆記本資源，或呼叫TagResource操作中的AWSAPI。

要在建立資源時向資源中新增標籤，您還需要建立指定類型資源的權限。

檢視標籤

您可以在以下位置中檢視任何可標籤資源中檢視標籤。Amazon使用主控台導覽至工作或筆記本資源，或呼叫AWS ListTagsForResource API操作。

您可以使用以下內容AWS API查看資源標籤的命令：

• AWS API: ListTagsForResource

編輯標籤

您可以使用控制台瀏覽至量子任務或筆記本資源來編輯標籤，或者您可以使用以下命令修改附加到可標記資源的標籤值。當您指定已存在的標籤鍵時，會覆寫該鍵的值：

• AWS API: TagResource

移除標籤

您可以使用主控台導覽至量子工作或筆記本資源指定要移除的鍵，來從資源中移除標籤。UntagResource操作。

• AWS API: UntagResource

Amazon Braket 網頁中的 CLI 標記示例

如果您正在使用AWSCLI，這裡是一個示例命令，顯示瞭如何創建一個適用於您為其創建的量子任務的標籤SV1具有的參數設定RigettiQPU。請注意，標籤是在範例指令的結尾指定的。在這種情況下，關鍵給出了值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\"}

使用 Amazon Braket API標記

• 如果您正在使用Amazon布拉基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\"]"