Administración de áreas de trabajo cuánticas con la CLI de Azure

2025-04-24

En esta guía, aprenderá a usar la interfaz de Azure Command-Line (CLI de Azure) para crear áreas de trabajo de Azure Quantum y los grupos de recursos y las cuentas de almacenamiento necesarios y empezar a ejecutar las aplicaciones cuánticas en Azure Quantum.

Prerrequisitos

Para usar el servicio Azure Quantum, necesita lo siguiente:

Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, regístrese gratuitamente y regístrese para obtener una suscripción de pago por uso.
Un grupo de recursos de Azure donde reside el área de trabajo cuántica.
Una cuenta de almacenamiento en el grupo de recursos que se va a asociar al espacio de trabajo cuántico. Se pueden asociar varias áreas de trabajo a la misma cuenta.
LaCLI de Azure.
El Microsoft Quantum Development Kit.

Configuración del entorno

Instale la extensión de la CLI quantum de Azure. Abra un símbolo del sistema y ejecute el siguiente comando, que también actualiza la extensión si ya está instalada una versión anterior:
```
az extension add --upgrade -n quantum
```
Inicie sesión en Azure con sus credenciales. Verá una lista de suscripciones asociadas a su cuenta.
```
az login
```
Especifique la suscripción que desea usar.
```
az account set -s <Your subscription ID>
```
Si es la primera vez que se crean áreas de trabajo cuánticas en la suscripción, registre el proveedor de recursos con este comando:
```
az provider register --namespace Microsoft.Quantum
```

Creación de un área de trabajo de Azure Quantum

Para crear un área de trabajo de Azure Quantum, debe saber lo siguiente:

La ubicación o el nombre de la región de Azure para crear el recurso. Puede usar la lista de regiones y sus códigos de Resource Manager compatibles con la herramienta de la CLI de Azure, por ejemplo, westus.
El grupo de recursos asociado al nuevo área de trabajo, por ejemplo, MyResourceGroup.
Una cuenta de almacenamiento en el mismo grupo de recursos y la misma suscripción que el área de trabajo cuántica. Es posible crear una nueva cuenta de almacenamiento desde la herramienta Az CLI, por ejemplo, MyStorageAccount.
Nombre del área de trabajo cuántica que se va a crear, por ejemplo, MyQuantumWorkspace.
Lista de proveedores de Azure Quantum que se van a usar en el área de trabajo. Un proveedor ofrece un conjunto de planes, cada uno de ellos que representa un plan con términos y condiciones asociados, costos y cuotas. Para crear áreas de trabajo, debe especificar el plan correspondiente junto con los proveedores.

Si ya conoce los nombres de proveedor y plan que se van a usar en el área de trabajo, puede ir directamente al paso cuatro, a continuación. Si desea empezar con los proveedores que ofrecen crédito gratuito, puede escribir el siguiente comando:

az quantum workspace create \
   -l MyLocation \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyStorageAccount

Es posible que se le pida que acepte los términos de uso. Escriba Y para aceptar los términos. Tenga en cuenta que el parámetro que se muestra en el -r paso cuatro, a continuación, no era necesario.

Si necesita determinar qué proveedores y planes usar, siga estos pasos:

Para recuperar la lista de proveedores cuánticos disponibles, use el list comando (en este ejemplo se usa westus como ubicación):
```
az quantum offerings list \
     -l westus \
     -o table
```
Sugerencia

Si desea ver qué proveedores proporcionan crédito gratuito, use el --autoadd-only parámetro , por ejemplo:
az quantum offerings list --autoadd-only -l westus -o table
Como se mencionó anteriormente, esos proveedores se agregan automáticamente al área de trabajo. No es necesario especificarlos con el -r parámetro .
Una vez que determine el proveedor y planee incluir en el área de trabajo, puede revisar los términos mediante el show-terms comando (agregando myProviderID y MyPlan como valores de ejemplo):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
La salida del show-terms comando incluye un campo accepted booleano que muestra si los términos de este proveedor se han aceptado ya o no, así como un vínculo a los términos de licencia que se van a revisar. Si decide aceptar esos términos, use el accept-terms comando para registrar su aceptación.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Una vez que haya revisado y aceptado todos los términos y condiciones necesarios, puede crear el área de trabajo mediante el create comando , especificando una lista de combinaciones de proveedor y plan separadas por comas, como en el ejemplo siguiente:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Una vez creado un área de trabajo, puede agregar o quitar proveedores mediante Azure Portal.

Cambio de la cuenta de almacenamiento predeterminada para un área de trabajo cuántica

Si necesita cambiar la cuenta de almacenamiento predeterminada para un área de trabajo existente, puede usar el create comando y especificar todas las propiedades actuales junto con la nueva cuenta de almacenamiento. En el ejemplo siguiente se usa la misma configuración que el área de trabajo creada en el ejemplo anterior:

az quantum workspace create \
   -l westus \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyNEWStorageAccount \
   -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"

Importante

Este procedimiento vuelve a crear el área de trabajo con la nueva cuenta de almacenamiento. Asegúrese de que todas las propiedades que no sean la cuenta de almacenamiento sean exactamente las mismas que la original; de lo contrario, se crea una segunda área de trabajo.

Eliminación de un área de trabajo cuántica

Si conoce el nombre y el grupo de recursos de un área de trabajo cuántica que desea eliminar, puede hacerlo con el delete comando (con los mismos nombres que el ejemplo anterior):

az quantum workspace delete \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

Sugerencia

Si no recuerda el nombre exacto, puede ver la lista completa de áreas de trabajo cuánticas en su suscripción mediante az quantum workspace list -o table.

Después de eliminar un área de trabajo, sigue apareciendo mientras está siendo eliminado en la nube. Sin embargo, la propiedad provisioningState del área de trabajo cambia inmediatamente para indicar que se está eliminando. Puede ver esta información mediante el show comando :

az quantum workspace show \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

Nota:

En caso de que haya usado el az quantum workspace set comando anteriormente para especificar un área de trabajo cuántica predeterminada, puede llamar al delete comando sin parámetros para eliminar (y borrar) el área de trabajo predeterminada.

az quantum workspace delete

Pasos siguientes

Ahora que puede crear y eliminar áreas de trabajo, obtenga información sobre los diferentes targets para ejecutar algoritmos cuánticos en Azure Quantum.