az managedcleanroom frontend
Annotazioni
Questo riferimento fa parte dell'estensione managedcleanroom per l'interfaccia della riga di comando di Azure (versione 2.75.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az managedcleanroom frontend . Altre informazioni sulle estensioni.
Comandi per interagire con l'API Front-end di Analytics.
Questi comandi supportano due metodi di autenticazione:
- Flusso del codice del dispositivo MSAL (az managedcleanroom frontend login)
- Autenticazione dell'interfaccia della riga di comando di Azure (az login)
È necessario configurare l'URL dell'endpoint dell'API Front-end di Analytics prima di usare questi comandi.
Tutti i comandi front-end supportano il parametro --api-version per specificare la versione dell'API. Impostazione predefinita: 2026-03-01-preview
Versioni supportate:
- 2026-03-01-preview.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az managedcleanroom frontend analytics |
Gestire l'analisi della collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics auditevent |
Visualizzare gli eventi di controllo. |
Extension | GA |
| az managedcleanroom frontend analytics auditevent list |
Elencare gli eventi di controllo per una collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics dataset |
Gestire i set di dati di collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics dataset list |
Elencare i set di dati per una collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics dataset publish |
Pubblicare un set di dati nella collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics dataset queries |
Elencare le query che usano un set di dati specifico. |
Extension | GA |
| az managedcleanroom frontend analytics dataset show |
Mostra i dettagli del set di dati. |
Extension | GA |
| az managedcleanroom frontend analytics query |
Gestire le query di collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics query list |
Elencare le query per una collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics query publish |
Pubblicare una query nella collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics query run |
Eseguire una query nella collaborazione. |
Extension | GA |
| az managedcleanroom frontend analytics query runhistory |
Visualizzare la cronologia di esecuzione delle query. |
Extension | GA |
| az managedcleanroom frontend analytics query runhistory list |
Elencare la cronologia di esecuzione delle query. |
Extension | GA |
| az managedcleanroom frontend analytics query runresult |
Visualizzare i risultati dell'esecuzione della query. |
Extension | GA |
| az managedcleanroom frontend analytics query runresult show |
Visualizzare i dettagli del risultato dell'esecuzione di una query. |
Extension | GA |
| az managedcleanroom frontend analytics query show |
Mostra i dettagli della query. |
Extension | GA |
| az managedcleanroom frontend analytics query vote |
Votare su una query (accettare o rifiutare). |
Extension | GA |
| az managedcleanroom frontend analytics secret |
Gestire i segreti di analisi. |
Extension | GA |
| az managedcleanroom frontend analytics secret set |
Impostare un segreto di analisi. |
Extension | GA |
| az managedcleanroom frontend analytics show |
Visualizzare le informazioni di analisi. |
Extension | GA |
| az managedcleanroom frontend analytics skr-policy |
Ottenere i criteri SKR per un set di dati. |
Extension | GA |
| az managedcleanroom frontend collaboration |
Gestire le collaborazioni front-end. |
Extension | GA |
| az managedcleanroom frontend collaboration list |
Elencare tutte le collaborazioni. |
Extension | GA |
| az managedcleanroom frontend configure |
Configurare o visualizzare le impostazioni dell'API Front-end di Analisi. |
Extension | GA |
| az managedcleanroom frontend consent |
Gestire i documenti di consenso. |
Extension | GA |
| az managedcleanroom frontend consent check |
Controllare lo stato del documento di consenso. |
Extension | GA |
| az managedcleanroom frontend consent set |
Impostare l'azione del documento di consenso. |
Extension | GA |
| az managedcleanroom frontend invitation |
Gestire gli inviti di collaborazione. |
Extension | GA |
| az managedcleanroom frontend invitation accept |
Accettare un invito. |
Extension | GA |
| az managedcleanroom frontend invitation list |
Elencare gli inviti per una collaborazione. |
Extension | GA |
| az managedcleanroom frontend invitation show |
Mostra i dettagli dell'invito. |
Extension | GA |
| az managedcleanroom frontend login |
Eseguire l'autenticazione con il flusso del codice del dispositivo Microsoft. |
Extension | GA |
| az managedcleanroom frontend logout |
Disconnettersi e cancellare le credenziali memorizzate nella cache. |
Extension | GA |
| az managedcleanroom frontend oidc |
Gestire la configurazione OIDC. |
Extension | GA |
| az managedcleanroom frontend oidc issuerinfo |
Gestire le informazioni dell'autorità emittente OIDC. |
Extension | GA |
| az managedcleanroom frontend oidc issuerinfo show |
Mostra le informazioni dell'autorità emittente OIDC. |
Extension | GA |
| az managedcleanroom frontend oidc keys |
Ottenere le chiavi di firma OIDC (JWKS). |
Extension | GA |
| az managedcleanroom frontend oidc set-issuer-url |
Impostare l'URL dell'autorità di certificazione OIDC per una collaborazione. |
Extension | GA |
| az managedcleanroom frontend report |
Ottenere un report completo sull'attestazione. |
Extension | GA |
| az managedcleanroom frontend show |
Mostra i dettagli della collaborazione. |
Extension | GA |
az managedcleanroom frontend configure
Configurare o visualizzare le impostazioni dell'API Front-end di Analisi.
Configurare l'URL dell'endpoint API o visualizzare la configurazione corrente, inclusi il metodo di autenticazione, l'identità utente e la configurazione MSAL.
Priorità di autenticazione:
- Token MSAL (da 'az managedcleanroom frontend login') - verificato per primo
- Token dell'interfaccia della riga di comando di Azure (da 'az login') - fallback
Opzioni di configurazione:
Variabili di ambiente (priorità più alta):
- MANAGEDCLEANROOM_CLIENT_ID
- MANAGEDCLEANROOM_TENANT_ID
- MANAGEDCLEANROOM_SCOPES
- MANAGEDCLEANROOM_AUTH_SCOPE
- MANAGEDCLEANROOM_ENDPOINT
Configurazione dell'interfaccia della riga di comando di Azure (persistente):
- managedcleanroom-frontend.client_id
- managedcleanroom-frontend.tenant_id
- managedcleanroom-frontend.scopes
- managedcleanroom-frontend.auth_scope
- managedcleanroom-frontend.endpoint.
az managedcleanroom frontend configure [--auth-scope]
[--endpoint]
Esempio
Visualizzare la configurazione corrente e lo stato di autenticazione
az managedcleanroom frontend configure
Impostare l'URL dell'endpoint API
az managedcleanroom frontend configure --endpoint https://api.example.com
Impostare l'ambito di autenticazione personalizzato
az managedcleanroom frontend configure --auth-scope https://cleanroom.azure.net/
Impostare l'endpoint di sviluppo locale
az managedcleanroom frontend configure --endpoint http://localhost:61001
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
URL della risorsa OAuth2 per le richieste di token dell'interfaccia della riga di comando di Azure.
URL dell'endpoint dell'API front-end di Analisi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az managedcleanroom frontend login
Eseguire l'autenticazione con il flusso del codice del dispositivo Microsoft.
Esegue l'autenticazione interattiva del codice del dispositivo usando MSAL (Microsoft Authentication Library).
Verrà richiesto di visitare https://microsoft.com/devicelogin e immettere un codice per completare l'autenticazione. Al termine, il token viene memorizzato nella cache in locale per i comandi successivi.
Usare 'az managedcleanroom frontnd logout' per cancellare il token memorizzato nella cache.
az managedcleanroom frontend login [--use-microsoft-identity]
Esempio
Accedere con il flusso del codice del dispositivo
az managedcleanroom frontend login
Accedere con flag esplicito (uguale a quello precedente)
az managedcleanroom frontend login --use-microsoft-identity
Configurare l'ID client personalizzato prima dell'accesso
az config set managedcleanroom-frontend.client_id="your-client-id"
az managedcleanroom frontend login
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Usare l'autenticazione del flusso di codice del dispositivo Microsoft (comportamento predefinito).
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az managedcleanroom frontend logout
Disconnettersi e cancellare le credenziali memorizzate nella cache.
Cancella il token di autenticazione MSAL memorizzato nella cache locale. Per usare i comandi front-end, è necessario eseguire di nuovo l'accesso usando "az managedcleanroom frontend login".
Nota: questo non influisce sull'autenticazione dell'interfaccia della riga di comando di Azure (az login). Se si usa l'autenticazione dell'interfaccia della riga di comando di Azure, usare invece "az logout".
Percorso cache: ~/.managedcleanroom/msal_cache/token_cache.json.
az managedcleanroom frontend logout
Esempio
Disconnettersi e cancellare la cache MSAL
az managedcleanroom frontend logout
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az managedcleanroom frontend report
Ottenere un report completo sull'attestazione.
Recupera un report di attestazione completo per una collaborazione, incluse le informazioni sull'attestazione CGS e sull'attestazione della camera pulita.
Questo comando sostituisce i comandi deprecati "attestation cgs" e "attestationreport cleanroom", fornendo un endpoint di report unificato.
az managedcleanroom frontend report --collaboration-id
[--api-version {2026-03-01-preview}]
Esempio
Ottenere un report di attestazione per una collaborazione
az managedcleanroom frontend report --collaboration-id <id>
Ottenere il report di attestazione (forma breve)
az managedcleanroom frontend report -c <id>
Parametri necessari
Identificatore di collaborazione.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Versione api da usare per questa richiesta. Impostazione predefinita: 2026-03-01-preview.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | 2026-03-01-preview |
| Valori accettati: | 2026-03-01-preview |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az managedcleanroom frontend show
Mostra i dettagli della collaborazione.
az managedcleanroom frontend show --collaboration-id
[--active-only]
[--api-version {2026-03-01-preview}]
Esempio
Mostra i dettagli della collaborazione
az managedcleanroom frontend show --collaboration-id <id>
Mostra dettagli di collaborazione (solo collaborazioni attive)
az managedcleanroom frontend show --collaboration-id <id> --active-only
Parametri necessari
Identificatore di collaborazione.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Eseguire query solo sulle collaborazioni attive.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Versione api da usare per questa richiesta. Impostazione predefinita: 2026-03-01-preview.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | 2026-03-01-preview |
| Valori accettati: | 2026-03-01-preview |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |