az storage blob lease

  • Riferimento

Gestire i lease dei BLOB di archiviazione.

Comandi

Nome Descrizione Tipo Stato
az storage blob lease acquire

Richiedere un nuovo lease.

 Memoria centrale Disponibilità generale
az storage blob lease break

Interrompere il lease, se il contenitore o il BLOB ha un lease attivo.

 Memoria centrale Disponibilità generale
az storage blob lease change

Modificare l'ID lease di un lease attivo.

 Memoria centrale Disponibilità generale
az storage blob lease release

Rilasciare il lease.

 Memoria centrale Disponibilità generale
az storage blob lease renew

Rinnovare il lease.

 Memoria centrale Disponibilità generale

az storage blob lease acquire

Modifica

Richiedere un nuovo lease.

az storage blob lease acquire --blob-name
                              --container-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--blob-endpoint]
                              [--connection-string]
                              [--if-match]
                              [--if-modified-since]
                              [--if-none-match]
                              [--if-unmodified-since]
                              [--lease-duration]
                              [--proposed-lease-id]
                              [--sas-token]
                              [--tags-condition]
                              [--timeout]

Esempio

Richiedere un nuovo lease.

az storage blob lease acquire -b myblob -c mycontainer --account-name mystorageaccount --account-key 0000-0000

Parametri necessari

--blob-name -b

Nome del BLOB.

--container-name -c

Nome del contenitore.

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
--blob-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.

--connection-string

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

--if-match

Valore ETag o carattere jolly (*). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato.

--if-modified-since

Inizia solo se modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--if-none-match

Valore ETag o carattere jolly (). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. Specificare il carattere jolly () per eseguire l'operazione solo se la risorsa non esiste e non eseguire l'operazione se esiste.

--if-unmodified-since

Inizia solo se non modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--lease-duration

Specificare la durata del lease, in secondi o negativa (-1) per un lease che non scade mai. Un lease non infinito può essere compreso tra 15 e 60 secondi. Non è possibile modificare una durata del lease usando il rinnovo o la modifica. Il valore predefinito è -1 (lease infinito).

valore predefinito: -1
--proposed-lease-id

ID lease proposto, in formato stringa GUID. Il servizio BLOB restituisce 400 (richiesta non valida) se l'ID lease proposto non è nel formato corretto.

--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.

--tags-condition

Specificare una clausola SQL where sui tag BLOB da usare solo nei BLOB con un valore corrispondente.

--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 blob lease break

Modifica

Interrompere il lease, se il contenitore o il BLOB ha un lease attivo.

Una volta interrotto un lease, non può essere rinnovato. Qualsiasi richiesta autorizzata può interrompere il lease; la richiesta non è necessaria per specificare un ID lease corrispondente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease ad eccezione di interruzione e rilascio nel contenitore o nel BLOB. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi fino a quando non è possibile acquisire un nuovo lease.

az storage blob lease break --blob-name
                            --container-name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--if-match]
                            [--if-modified-since]
                            [--if-none-match]
                            [--if-unmodified-since]
                            [--lease-break-period]
                            [--sas-token]
                            [--tags-condition]
                            [--timeout]

Parametri necessari

--blob-name -b

Nome del BLOB.

--container-name -c

Nome del contenitore.

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
--blob-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.

--connection-string

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

--if-match

Valore ETag o carattere jolly (*). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato.

--if-modified-since

Inizia solo se modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--if-none-match

Valore ETag o carattere jolly (). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. Specificare il carattere jolly () per eseguire l'operazione solo se la risorsa non esiste e non eseguire l'operazione se esiste.

--if-unmodified-since

Inizia solo se non modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--lease-break-period

Si tratta della durata proposta di secondi che il lease deve continuare prima che venga interrotto, tra 0 e 60 secondi. Questo periodo di interruzione viene usato solo se è più breve del tempo rimanente nel lease. Se è più lungo, viene usato il tempo rimanente nel lease. Un nuovo lease non sarà disponibile prima che il periodo di interruzione sia scaduto, ma il lease può essere mantenuto per più tempo del periodo di interruzione. Se questa intestazione non viene visualizzata con un'operazione di interruzione, un lease a durata fissa si interrompe dopo la scadenza del periodo di lease rimanente e un lease infinito si interrompe immediatamente.

--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.

--tags-condition

Specificare una clausola SQL where sui tag BLOB da usare solo nei BLOB con un valore corrispondente.

--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 blob lease change

Modifica

Modificare l'ID lease di un lease attivo.

az storage blob lease change --blob-name
                             --container-name
                             --lease-id
                             --proposed-lease-id
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--sas-token]
                             [--tags-condition]
                             [--timeout]

Parametri necessari

--blob-name -b

Nome del BLOB.

--container-name -c

Nome del contenitore.

--lease-id

Obbligatorio se il BLOB ha un lease attivo.

--proposed-lease-id

ID lease proposto, in formato stringa GUID. Il servizio BLOB restituisce 400 (richiesta non valida) se l'ID lease proposto non è nel formato corretto.

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
--blob-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.

--connection-string

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

--if-match

Valore ETag o carattere jolly (*). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato.

--if-modified-since

Inizia solo se modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--if-none-match

Valore ETag o carattere jolly (). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. Specificare il carattere jolly () per eseguire l'operazione solo se la risorsa non esiste e non eseguire l'operazione se esiste.

--if-unmodified-since

Inizia solo se non modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--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.

--tags-condition

Specificare una clausola SQL where sui tag BLOB da usare solo nei BLOB con un valore corrispondente.

--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 blob lease release

Modifica

Rilasciare il lease.

Il lease può essere rilasciato se l'ID lease client specificato corrisponde a quello associato al contenitore o al BLOB. Il rilascio del lease consente a un altro client di acquisire immediatamente il lease per il contenitore o il BLOB non appena viene completata la versione. :keyword ~datetime.datetime if_modified_since: valore DateTime. Azure prevede che il valore della data passato sia UTC. Se il fuso orario è incluso, le datetime non UTC verranno convertite in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC. Specificare questa intestazione per eseguire l'operazione solo se la risorsa è stata modificata dall'ora specificata. :keyword ~datetime.datetime if_unmodified_since: valore DateTime. Azure prevede che il valore della data passato sia UTC. Se il fuso orario è incluso, le datetime non UTC verranno convertite in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC. Specificare questa intestazione per eseguire l'operazione solo se la risorsa non è stata modificata dopo la data/ora specificata. :keyword str etag: valore ETag o carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal match_condition parametro . :keyword ~azure.core.MatchConditions match_condition: condizione di corrispondenza da usare sull'etag. :keyword str if_tags_match_condition: specificare una clausola SQL where sui tag BLOB da usare solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'" .. versionadded:: 12.4.0 :keyword int timeout: imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob #other-client--per-operation-configuration>_. :return: Nessuno.

az storage blob lease release --blob-name
                              --container-name
                              --lease-id
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--blob-endpoint]
                              [--connection-string]
                              [--if-match]
                              [--if-modified-since]
                              [--if-none-match]
                              [--if-unmodified-since]
                              [--sas-token]
                              [--tags-condition]
                              [--timeout]

Parametri necessari

--blob-name -b

Nome del BLOB.

--container-name -c

Nome del contenitore.

--lease-id

Obbligatorio se il BLOB ha un lease attivo.

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
--blob-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.

--connection-string

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

--if-match

Valore ETag o carattere jolly (*). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato.

--if-modified-since

Inizia solo se modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--if-none-match

Valore ETag o carattere jolly (). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. Specificare il carattere jolly () per eseguire l'operazione solo se la risorsa non esiste e non eseguire l'operazione se esiste.

--if-unmodified-since

Inizia solo se non modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--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.

--tags-condition

Specificare una clausola SQL where sui tag BLOB da usare solo nei BLOB con un valore corrispondente.

--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 blob lease renew

Modifica

Rinnovare il lease.

az storage blob lease renew --blob-name
                            --container-name
                            --lease-id
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--if-match]
                            [--if-modified-since]
                            [--if-none-match]
                            [--if-unmodified-since]
                            [--sas-token]
                            [--tags-condition]
                            [--timeout]

Esempio

Rinnovare il lease.

az storage blob lease renew -b myblob -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parametri necessari

--blob-name -b

Nome del BLOB.

--container-name -c

Nome del contenitore.

--lease-id

Obbligatorio se il BLOB ha un lease attivo.

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
--blob-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.

--connection-string

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

--if-match

Valore ETag o carattere jolly (*). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato.

--if-modified-since

Inizia solo se modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--if-none-match

Valore ETag o carattere jolly (). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. Specificare il carattere jolly () per eseguire l'operazione solo se la risorsa non esiste e non eseguire l'operazione se esiste.

--if-unmodified-since

Inizia solo se non modificato dopo l'ora UTC specificata (Y-m-d'T'H:M'Z').

--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.

--tags-condition

Specificare una clausola SQL where sui tag BLOB da usare solo nei BLOB con un valore corrispondente.

--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.