Etichettare le risorse di Amazon Braket

Un tag è un'etichetta di attributi personalizzata assegnata dall'utente o da AWS a una risorsa AWS. Un tag è un insieme di metadati che forniscono ulteriori informazioni 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.

Nella console Amazon Braket, puoi accedere a un'attività quantistica o a un taccuino e visualizzare l'elenco dei tag ad esso associati. È possibile aggiungere un tag, rimuovere un tag o modificare un tag. È possibile etichettare un'attività quantistica o un taccuino al momento della creazione e quindi gestire i tag associati tramite la consoleAWS CLI, oppureAPI.

Utilizzo dei tag

I tag possono organizzare le tue risorse in categorie che ti sono utili. Ad esempio, puoi assegnare un tag «Dipartimento» per specificare il dipartimento che possiede questa risorsa.

Ogni tag è costituito da due parti:

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

• Un campo opzionale noto come valore di tag (ad esempio, 111122223333 o Production). 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 ti aiutano a fare le seguenti cose:

• Identifica e organizza AWS le tue risorse. Molti Servizi AWSsupportano l'assegnazione di tag, perciò è possibile assegnare lo stesso tag a risorse di diversi servizi per indicare che queste sono correlate.

• Tieni traccia AWS dei costi. Questi tag vengono attivati nel pannello di controllo AWS Billing and Cost Management. AWSusa i tag per categorizzare i costi e fornire un report di allocazione dei costi mensili. Per ulteriori informazioni, consulta la pagina sull'utilizzo dei tag per l'allocazione dei costi nella AWS Billing and Cost ManagementGuida per l'utente.

• Controlla l'accesso alle tue AWS risorse. Per ulteriori informazioni, consulta Controllo dell'accesso tramite tag.

Ulteriori informazioni AWS e tag

• Per informazioni generali sull'etichettatura, incluse le convenzioni di denominazione e utilizzo, consulta Tagging AWS Resources nella Guida generale. AWS

• Per informazioni sulle restrizioni relative all'etichettatura, consulta Limiti e requisiti di denominazione dei tag nel Riferimento generale. AWS

• Per le migliori pratiche e le strategie di tagging, consulta Best practice di tagging e Tagging Strategies. AWS

• Per un elenco dei servizi che supportano l'utilizzo dei tag, consulta l'argomento della documentazione di riferimento delle API per l'applicazione di tag a Resource Groups.

Le sezioni seguenti forniscono informazioni più specifiche sui tag per Braket. Amazon

Risorse supportate in Amazon Braket

Il seguente tipo di risorsa in Amazon Braket supporta l'etichettatura:

• Risorsa quantum-task

• Nome della risorsa: AWS::Service::Braket

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

Nota: puoi applicare e gestire i tag per i tuoi notebook Amazon Braket nella console Amazon Braket, utilizzando la console per accedere alla risorsa notebook, sebbene i notebook siano effettivamente risorse Amazon. SageMaker Per ulteriori informazioni, consulta Notebook Instance Metadata nella documentazione. SageMaker

Limitazioni applicate ai tag

Le seguenti restrizioni di base si applicano ai tag sulle risorse Amazon Braket:

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

• lunghezza massima della chiave: 128 caratteri Unicode;

• lunghezza massima del valore: 256 caratteri Unicode;

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

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

• Non utilizzare aws come prefisso per le chiavi; è riservato all'AWSuso.

Gestione dei tag in Amazon Braket

I tag vengono impostati come proprietà su una risorsa. È possibile visualizzare, aggiungere, modificare, elencare ed eliminare i tag tramite la console Amazon Braket, Amazon Braket API o. AWS CLI Per ulteriori informazioni, consulta il riferimento all'API Amazon Braket.

Aggiunta di tag

Puoi aggiungere tag alle risorse taggabili nei seguenti orari:

• Quando crei la risorsa: utilizza la console o includi il Tags parametro con l'Createoperazione nell'AWSAPI.

• Dopo aver creato la risorsa: utilizza la console per accedere alla risorsa Quantum Task o Notebook oppure richiama l'TagResourceoperazione nell'AWSAPI.

Per aggiungere tag a una risorsa al momento della creazione, è inoltre necessaria l'autorizzazione per creare una risorsa del tipo specificato.

Visualizzazione dei tag

È possibile visualizzare i tag su qualsiasi risorsa taggabile in Amazon Braket utilizzando la console per accedere all'attività o alla risorsa del notebook o chiamando l'operazione. AWS ListTagsForResource API

È possibile utilizzare il seguente AWS API comando per visualizzare i tag su una risorsa:

• AWS API: ListTagsForResource

Modifica dei tag

È possibile modificare i tag utilizzando la console per accedere alla risorsa Quantum Task o Notebook oppure è possibile utilizzare il seguente comando per modificare il valore di un tag allegato a una risorsa etichettabile. Quando specificate una chiave di tag già esistente, il valore di quella chiave viene sovrascritto:

• AWS API: TagResource

Rimuovi i tag

È possibile rimuovere i tag da una risorsa specificando le chiavi da rimuovere, utilizzando la console per accedere alla risorsa Quantum Task o Notebook oppure quando si richiama l'UntagResourceoperazione.

• AWS API: UntagResource

Esempio di etichettatura CLI in Amazon Braket

Se stai lavorando con la AWS CLI, ecco un comando di esempio che mostra come creare un tag che si applica a un'attività quantistica per cui crei SV1 con le impostazioni dei parametri della QPU. Rigetti Notate che il tag è specificato alla fine del comando di esempio. In questo caso, a Key viene assegnato il valore state e a Value viene assegnato 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 Amazon Braket API

• Se utilizzi Amazon Braket API per configurare i tag su una risorsa, chiama il. TagResourceAPI

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

• Per rimuovere i tag da una risorsa, chiama il UntagResourceAPI.

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

• Per elencare tutti i tag associati a una particolare risorsa, chiama il ListTagsForResourceAPI.

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