Tagging delle risorse Amazon Braket - Amazon Braket

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tagging delle risorse Amazon Braket

Un tag è un'etichetta di attributi personalizzata assegnata dall'utente o da AWS a una risorsa AWS. Un tag èmetadatache dice di più sulla tua risorsa. Ciascun tag è formato da una chiave e da un valore, Tutti questi sono noti come coppie chiave-valore. Per i tag assegnati da te, puoi definire la chiave e il valore.

NellaAmazon Braketconsole, è possibile passare a un'attività o a un blocco appunti e visualizzare l'elenco dei tag ad essa associati. È possibile aggiungere un tag, rimuovere un tag o modificare un tag. È possibile taggare un'attività o un blocco appunti al momento della creazione e quindi gestire i tag associati tramite la console,AWSCLI oAPI.

Utilizzo dei tag

I tag possono organizzare le tue risorse in categorie che ti sono utili. Ad esempio, è possibile assegnare un tag «Reparto» per specificare il reparto proprietario di questa risorsa.

Ogni tag è costituito da due parti:

  • Una chiave del tag (ad esempio,CostCenter,Ambiente, oppureProgetto). Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole.

  • Un campo facoltativo noto come valore del tag (ad esempio,111122223333oProduzione). Non specificare il valore del tag equivale a utilizzare una stringa vuota. Analogamente alle chiavi dei tag, i valori dei tag prevedono una distinzione tra lettere maiuscole e minuscole.

I tag consentono di eseguire le seguenti operazioni:

Ulteriori informazioni suAWSe tag

Nelle sezioni seguenti vengono fornite informazioni più specifiche sui tagAmazon Braket.

Risorse supportate in AmazonBraket

Il seguente tipo di risorsa inAmazon Braketsupporta il tagging di:

  • Risorsa quantum-task

  • Nome risorsa: AWS::Service::Braket

  • Regex ARN: arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}

Nota: Puoi applicare e gestire i tag per il tuoAmazon Braketnotebook nellaAmazon Braketconsole, utilizzando la console per passare alla risorsa del notebook, anche se i notebook sono effettivamenteAmazon SageMaker risorse AWS. Per ulteriori informazioni, consultaMetadati dell'istanza notebooknella SageMaker documentazione.

Limitazioni applicate ai tag

Si applicano le seguenti limitazioni di base ai tagAmazon BraketRisorse :

  • Numero massimo di tag che è possibile assegnare a una risorsa: 50


  • Lunghezza massima chiave: 128 caratteri Unicode


  • Lunghezza massima del valore: 256 caratteri Unicode


  • Caratteri validi per chiave e valore:a-z, A-Z, 0-9, spacee questi personaggi:_ . : / = + -e@


  • Per chiavi e valori viene fatta distinzione tra maiuscole e minuscole .

  • Non utilizzareawscome prefisso per le chiavi; l'utilizzo di questo prefisso è esclusivo diAWSutilizzare.

Gestione dei tag inAmazonBraket

Hai impostato i tag comeproprietàsu arisorsa. È possibile visualizzare, aggiungere, modificare, elencare ed eliminare i tag tramiteAmazon Braketconsole,Amazon Braket API, o ilAWSCLI. Per ulteriori informazioni, consulta la .Documentazione di riferimento dell'API Amazon Braket.

Aggiunta di tag

Puoi aggiungere tag alle risorse taggabili nei seguenti momenti:

  • Quando si crea la risorsa: Usa la console o includiTagsparametro conCreateoperazione nellaAPI AWS.

  • Dopo aver creato la risorsa: Utilizzare la console per accedere all'attività o alla risorsa del notebook oppure chiamare ilTagResourceoperazione nellaAPI AWS.

Per aggiungere tag a una risorsa quando viene creata, è necessario disporre dell'autorizzazione per creare una risorsa del tipo specificato.


Visualizzazione dei tag

Puoi visualizzare i tag su una delle risorse taggabili inAmazon Braketutilizzando la console per passare all'attività o alla risorsa del notebook o chiamando ilAWS ListTagsForResource APIoperazione.

Puoi utilizzare le informazioni seguenti:AWS APIper visualizzare i tag su una risorsa:

  • AWS API: ListTagsForResource


Modifica dei tag

È possibile modificare i tag utilizzando la console per passare all'attività o alla risorsa del blocco note oppure utilizzare il comando seguente per modificare il valore di un tag associato a una risorsa etichettabile. Quando si specifica una chiave di tag già esistente, il valore di quella chiave viene sovrascritto:

  • AWS API: TagResource


Rimuovi i tag

Puoi rimuovere i tag da una risorsa specificando le chiavi da rimuovere, utilizzando la console per passare all'operazione o alla risorsa notebook o quando si chiamaUntagResourceoperazione.

  • AWS API: UntagResource


Esempio di tag CLI inAmazonBraket

Se si sta lavorando conAWSCLI, ecco un comando di esempio che mostra come creare un tag che si applica a un'attività quantistica creata per ilSV1simulatore, con impostazioni dei parametri delRigettiQPU. Si noti che il tag è specificato alla fine del comando di esempio. In questo caso,Chiaveviene dato il valorestateeValoreviene dato il valoreWashington.

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\"}

Tagging con la AmazonBraketAPI

  • Se si sta utilizzando il campoAmazon Braket APIper impostare i tag su una risorsa, chiama ilTagResourceAPI.

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\"]"