標記亞馬遜標記資源 - Amazon Braket

了解量子計算的基礎 AWS!註冊 Amazon Braket 數位學習計劃,並在完成一系列學習課程和數位評估後獲得自己的數位徽章。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

標記亞馬遜標記資源

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

在 Amazon Braket 主控台中,您可以瀏覽至量子任務或筆記本,並檢視與其關聯的標籤清單。您可以新增標籤、移除標籤或修改標籤。您可以在建立量子任務或筆記本時標記,然後透過主控台AWS CLI、或管理關聯的標籤API。

使用標籤

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

每個標籤有兩個部分:

  • 標籤鍵 (例如 CostCenter環境專案)。標籤鍵會區分大小寫。

  • 稱為標籤值的選擇性欄位 (例如,111122223 333 或正式作業)。忽略標籤值基本上等同於使用空字串。與標籤鍵相同,標籤值會區分大小寫。

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

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

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

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

更多關於AWS和標籤

以下各節提供有關 Amazon Braket 標籤的更具體資訊。

亞馬遜文字架中支援的資源

AmazonBraket 中的以下資源類型支援標記:

  • quantum-task 資源

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

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

注意:儘管筆記本實際上是 Amazon SageMaker 資源,但您Amazon可以使用控制台導航到筆記本資源,在 Amazon Braket 控制台中應用和管理 Braket 筆記本的標籤。如需詳細資訊,請參閱 SageMaker 文件中的記事本執行個體中繼資料

標籤限制

下列基本限制適用於 Amazon Braket 資源上的標籤:

  • 可指派給資源的標籤數目上限:50

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

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

  • 索引鍵和 value: a-z, A-Z, 0-9, space 和下列字元的有效字元:_ . : / = + -@

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

  • 不要用aws作密鑰的前綴; 它保留供AWS使用。

在 Amazon Braket 標籤管理標籤

您可以將標籤設定為資源上的屬性。您可以透過 Amazon Braket 主控台、Braket 或檢視、新增、修改、列出Amazon和刪除標籤。API AWS CLI如需詳細資訊,請參閱亞馬遜標題 API 參考資料。

新增標籤

您可以在下列時間將標籤新增至可加上標籤的資源:

  • 建立資源時:使用主控台,或將Tags參數與Create作業一起包含在 AWSAPI 中。

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

若要在建立資源時將標籤新增至資源,您還需要建立指定類型資源的權限。

檢視標籤

您可以使用主控台導覽至任務或記事本資源,或呼叫作業,來檢視 Amazon Braket 中任何可加標籤資源上的標籤。AWS ListTagsForResource API

您可以使用以下AWSAPI命令來查看資源上的標籤:

  • AWS API: ListTagsForResource

編輯標籤

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

  • AWS API: TagResource

移除標籤

您可以透過指定要移除的金鑰、使用主控台瀏覽至量子工作或筆記本資源,或在呼叫UntagResource作業時,從資源中移除標籤。

  • AWS API: UntagResource

Amazon Braket 網頁中的 CLI 標記示例

如果您正在使用 AWS CLI,這裡是一個示例命令,顯示如何創建一個標籤,該標籤適用於您使用 Rigetti QPU SV1 的參數設置創建的量子任務。請注意,標籤是在範例指令的結尾指定的。在這種情況下,Key 被賦予的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 Braket API 在資源上設置標籤,請調用 TagResourceAPI.

aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tags {\"city\":\"Seattle\"}

aws braket list-tags-for-resource --resource-arn $YOUR_TASK_ARN

aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tag-keys "[\"city\",\"state\"]"