az storage queue

  • Anteprima
  • Riferimento

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire le code di archiviazione.

Comandi

Nome Descrizione Tipo Stato
az storage queue create

Creare una coda nell'account specificato.

 Memoria centrale Anteprima
az storage queue delete

Eliminare la coda specificata e tutti i messaggi contenuti.

 Memoria centrale Anteprima
az storage queue exists

Restituisce un valore booleano che indica se la coda esiste.

 Memoria centrale Anteprima
az storage queue generate-sas

Generare una firma di accesso condiviso per la coda. Usare la firma restituita con il parametro sas_token di QueueService.

 Memoria centrale Anteprima
az storage queue list

Elencare le code in un account di archiviazione.

 Memoria centrale Anteprima
az storage queue metadata

Gestire i metadati per una coda di archiviazione.

 Memoria centrale Anteprima
az storage queue metadata show

Restituisce tutti i metadati definiti dall'utente per la coda specificata.

 Memoria centrale Anteprima
az storage queue metadata update

Impostare i metadati definiti dall'utente nella coda specificata.

 Memoria centrale Anteprima
az storage queue policy

Gestire i criteri di accesso condiviso per una coda di archiviazione.

 Memoria centrale Anteprima
az storage queue policy create

Creare un criterio di accesso archiviato nell'oggetto contenitore.

 Memoria centrale Anteprima
az storage queue policy delete

Eliminare un criterio di accesso archiviato in un oggetto contenitore.

 Memoria centrale Anteprima
az storage queue policy list

Elencare i criteri di accesso archiviati in un oggetto contenitore.

 Memoria centrale Anteprima
az storage queue policy show

Visualizzare un criterio di accesso archiviato in un oggetto contenitore.

 Memoria centrale Anteprima
az storage queue policy update

Impostare un criterio di accesso archiviato su un oggetto contenitore.

 Memoria centrale Anteprima
az storage queue stats

Recuperare le statistiche correlate alla replica per il servizio di accodamento. È disponibile solo quando la replica con ridondanza geografica dell'accesso in lettura è abilitata per l'account di archiviazione.

 Memoria centrale Anteprima

az storage queue create

Modifica
Anteprima

Il gruppo di comandi 'storage queue' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare una coda nell'account specificato.

az storage queue create --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-on-exist]
                        [--metadata]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

Esempio

Creare una coda nell'account specificato con i metadati.

az storage queue create -n myqueue --metadata key1=value1 key2=value2 --account-name mystorageaccount

Parametri necessari

--name -n

Nome della coda.

Parametri facoltativi

--account-key

Archiviazione chiave dell'account. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

valori accettati: key, login
--connection-string

Archiviazione stringa di connessione account. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--fail-on-exist

Specificare se generare un'eccezione se la coda esiste già.

valore predefinito: False
--metadata

Metadati in coppie chiave=valore separate da spazi. In questo modo vengono sovrascritti tutti i metadati esistenti.

--queue-endpoint

Archiviazione endpoint del servizio dati. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_edizione StandardRVICE_ENDPOINT.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage queue delete

Modifica
Anteprima

Il gruppo di comandi 'storage queue' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare la coda specificata e tutti i messaggi contenuti.

az storage queue delete --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-not-exist]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

Esempio

Eliminare la coda specificata, generare un'eccezione se la coda non esiste.

az storage queue delete -n myqueue --fail-not-exist --account-name mystorageaccount

Parametri necessari

--name -n

Nome della coda.

Parametri facoltativi

--account-key

Archiviazione chiave dell'account. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

valori accettati: key, login
--connection-string

Archiviazione stringa di connessione account. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--fail-not-exist

Specificare se generare un'eccezione se la coda non esiste.

valore predefinito: False
--queue-endpoint

Archiviazione endpoint del servizio dati. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_edizione StandardRVICE_ENDPOINT.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage queue exists

Modifica
Anteprima

Il gruppo di comandi 'storage queue' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Restituisce un valore booleano che indica se la coda esiste.

az storage queue exists --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

Esempio

Controllare se la coda esiste.

az storage queue exists -n myqueue --account-name mystorageaccount

Parametri necessari

--name -n

Nome della coda.

Parametri facoltativi

--account-key

Archiviazione chiave dell'account. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

valori accettati: key, login
--connection-string

Archiviazione stringa di connessione account. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Archiviazione endpoint del servizio dati. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_edizione StandardRVICE_ENDPOINT.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage queue generate-sas

Modifica
Anteprima

Il gruppo di comandi 'storage queue' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Generare una firma di accesso condiviso per la coda. Usare la firma restituita con il parametro sas_token di QueueService.

az storage queue generate-sas --name
                              [--account-key]
                              [--account-name]
                              [--connection-string]
                              [--expiry]
                              [--https-only]
                              [--ip]
                              [--permissions]
                              [--policy-name]
                              [--queue-endpoint]
                              [--start]

Esempio

Generare un token di firma di accesso condiviso per la coda con autorizzazioni di sola lettura.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --permissions r --expiry $end --https-only

Generare un token di firma di accesso condiviso per la coda con l'intervallo ip specificato.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Parametri necessari

--name -n

Nome della coda.

Parametri facoltativi

--account-key

Archiviazione chiave dell'account. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--connection-string

Archiviazione stringa di connessione account. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--expiry

Specifica il valore datetime UTC (Y-m-d'T'H:M'Z') in corrispondenza del quale la firma di accesso condiviso non è valida. Non usare se viene fatto riferimento a un criterio di accesso archiviato con --policy-name che specifica questo valore.

--https-only

Consentire solo le richieste effettuate con il protocollo HTTPS. Se omesso, le richieste provenienti dal protocollo HTTP e HTTPS sono consentite.

--ip

Specifica l'indirizzo IP o l'intervallo di indirizzi IP da cui accettare le richieste. Supporta solo gli indirizzi di stile IPv4.

--permissions

Autorizzazioni concesse dalla firma di accesso condiviso. Valori consentiti: (a)dd (p)rocess (r)ead (u)pdate. Non usare se viene fatto riferimento a un criterio di accesso archiviato con --id che specifica questo valore. Può essere combinato.

--policy-name

Nome di un criterio di accesso archiviato all'interno dell'ACL della condivisione.

--queue-endpoint

Archiviazione endpoint del servizio dati. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_edizione StandardRVICE_ENDPOINT.

--start

Specifica il valore datetime UTC (Y-m-d'H:M'Z') in corrispondenza del quale la firma di accesso condiviso diventa valida. Non usare se viene fatto riferimento a un criterio di accesso archiviato con --policy-name che specifica questo valore. Il valore predefinito è l'ora della richiesta.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage queue list

Modifica
Anteprima

Il gruppo di comandi 'storage queue' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare le code in un account di archiviazione.

az storage queue list [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--connection-string]
                      [--include-metadata]
                      [--marker]
                      [--num-results]
                      [--prefix]
                      [--queue-endpoint]
                      [--sas-token]
                      [--show-next-marker]
                      [--timeout]

Esempio

Elencare le code i cui nomi iniziano con 'myprefix' nell'account di archiviazione 'mystorageaccount'(nome account)

az storage queue list --prefix myprefix --account-name mystorageaccount

Parametri facoltativi

--account-key

Archiviazione chiave dell'account. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

valori accettati: key, login
--connection-string

Archiviazione stringa di connessione account. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--include-metadata

Specificare che i metadati della coda devono essere restituiti nella risposta.

valore predefinito: False
--marker

Valore stringa che identifica la parte dell'elenco di contenitori da restituire con l'operazione di elenco successiva. L'operazione restituisce il valore NextMarker all'interno del corpo della risposta se l'operazione di elenco non ha restituito tutti i contenitori rimanenti da elencare con la pagina corrente. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui il generatore precedente è stato arrestato.

--num-results

Specificare il numero massimo da restituire. Se la richiesta non specifica num_results o specifica un valore maggiore di 5000, il server restituirà fino a 5000 elementi. Si noti che se l'operazione di elenco supera un limite di partizione, il servizio restituirà un token di continuazione per recuperare i risultati rimanenti. Specificare "*" per restituire tutto.

valore predefinito: 5000
--prefix

Filtrare i risultati per restituire solo le code i cui nomi iniziano con il prefisso specificato.

--queue-endpoint

Archiviazione endpoint del servizio dati. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_edizione StandardRVICE_ENDPOINT.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

Mostra nextMarker nel risultato quando specificato.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage queue stats

Modifica
Anteprima

Il gruppo di comandi 'storage queue' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Recuperare le statistiche correlate alla replica per il servizio di accodamento. È disponibile solo quando la replica con ridondanza geografica dell'accesso in lettura è abilitata per l'account di archiviazione.

az storage queue stats [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--queue-endpoint]
                       [--sas-token]
                       [--timeout]

Esempio

Visualizzare le statistiche correlate alla replica per il servizio di accodamento.

az storage queue stats --account-name mystorageaccount

Parametri facoltativi

--account-key

Archiviazione chiave dell'account. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

valori accettati: key, login
--connection-string

Archiviazione stringa di connessione account. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Archiviazione endpoint del servizio dati. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_edizione StandardRVICE_ENDPOINT.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.