Share via

%azure.connect

  • Articolo

Avviso

Questa documentazione fa riferimento alla QDK classica, sostituita dalla QDK moderna.

Il QDK moderno supporta solo il comando magic '%%qsharp'.

Summary

Si connette a un'area di lavoro di Azure Quantum o visualizza lo stato di connessione corrente.

Descrizione

Questo comando magic consente di connettersi a un'area di lavoro di Azure Quantum, come specificato dall'ID risorsa e dalla posizione dell'area di lavoro o da una combinazione di ID sottoscrizione, nome gruppo di risorse, nome dell'area di lavoro e posizione.

Se la connessione ha esito positivo, verrà visualizzato un elenco delle destinazioni di esecuzione Q# disponibili nell'area di lavoro Azure Quantum.

Parametri obbligatori

L'area di lavoro Azure Quantum può essere identificata dall'ID risorsa:

  • resourceId=<string>: ID risorsa dell'area di lavoro Azure Quantum. Questa operazione può essere ottenuta dalla pagina dell'area di lavoro nella portale di Azure. Il resourceId= prefisso è facoltativo per questo parametro, purché l'ID risorsa sia valido.

In alternativa, può essere identificato dall'ID sottoscrizione, dal nome del gruppo di risorse e dal nome dell'area di lavoro:

  • subscription=<string>: ID sottoscrizione di Azure per l'area di lavoro Azure Quantum.
  • resourceGroup=<string>: nome del gruppo di risorse di Azure per l'area di lavoro Azure Quantum.
  • workspace=<string>: nome dell'area di lavoro Azure Quantum.

Oltre agli identificatori precedenti, è necessario un percorso valido.

  • location=<string>: area di Azure in cui viene effettuato il provisioning dell'area di lavoro Azure Quantum. Può essere specificato come nome dell'area, "East US" ad esempio o un nome della posizione, "eastus"ad esempio .

Parametri facoltativi

  • storage=<string>: stringa di connessione all'account di archiviazione di Azure. Obbligatorio se l'area di lavoro Azure Quantum specificata non è stata collegata a un account di archiviazione in fase di creazione dell'area di lavoro.
  • credential=<CredentialType>: tipo di credenziali da usare per l'autenticazione con Azure. NOTA: per eseguire l'autenticazione viene usata la libreria di identità di Azure, in base a questo parametro verrà creata un'istanza di una classe credenziale. Le opzioni possibili sono:
    • Ambiente: autentica un'entità servizio o un utente tramite le informazioni sulle credenziali specificate nelle variabili di ambiente.
    • ManagedIdentity: autentica l'identità gestita di una risorsa di Azure.
    • Interfaccia della riga di comando: eseguire l'autenticazione in un ambiente di sviluppo con l'interfaccia della riga di comando di Azure.
    • SharedToken: eseguire l'autenticazione usando i token nella cache locale condivisa tra le applicazioni Microsoft.
    • VisualStudio: eseguire l'autenticazione usando i dati da Visual Studio.
    • VisualStudioCode: eseguire l'autenticazione in un ambiente di sviluppo con Visual Studio Code.
    • Interattivo: apre una nuova finestra del browser per autenticare in modo interattivo un utente e ottenere un token di accesso.
    • DeviceCode: autentica un utente usando il flusso di codice del dispositivo per ottenere un token di accesso. Se non specificato, prova ogni tipo di credenziale in ordine e seleziona il primo che può eseguire correttamente l'autenticazione con Azure.

Possibili errori

  • WorkspaceNotFound: nessuna area di lavoro di Azure Quantum è stata trovata che corrisponde ai criteri specificati.
  • AuthenticationFailed: impossibile eseguire l'autenticazione nell'area di lavoro Azure Quantum specificata.

Esempi per %azure.connect

Esempio 1

Connettersi a un'area di lavoro Azure Quantum usando l'ID risorsa nell'area "Stati Uniti occidentali":

In []: %azure.connect "/subscriptions/.../Microsoft.Quantum/Workspaces/WORKSPACE_NAME" location="West US"
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location westus.
        <list of Q# execution targets available in the Azure Quantum workspace>

Esempio 2

Connettersi a un'area di lavoro Azure Quantum usando il relativo ID risorsa, un account di archiviazione stringa di connessione e un percorso:

In []: %azure.connect resourceId="/subscriptions/.../Microsoft.Quantum/Workspaces/WORKSPACE_NAME"
                      storage="STORAGE_ACCOUNT_CONNECTION_STRING"
                      location="East US"
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location eastus.
        <list of Q# execution targets available in the Azure Quantum workspace>

Esempio 3

Connettersi a un'area di lavoro di Azure Quantum usando l'ID sottoscrizione singolo, il nome del gruppo di risorse usando un browser per richiedere le credenziali utente con Azure:

In []: %azure.connect subscription="SUBSCRIPTION_ID"
                      resourceGroup="RESOURCE_GROUP_NAME"
                      workspace="WORKSPACE_NAME"
                      location="West US"
                      credential="interactive"
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location westus.
        <list of Q# execution targets available in the Azure Quantum workspace>

Esempio 4

Stampare informazioni sull'area di lavoro Azure Quantum attualmente connessa:

In []: %azure.connect
Out[]: Connected to Azure Quantum workspace WORKSPACE_NAME in location westus.
        <list of Q# execution targets available in the Azure Quantum workspace>