BaseBlobService Classe

Si tratta della classe principale che gestisce le risorse BLOB.

Il servizio BLOB archivia dati di testo e binari come BLOB nel cloud. Il servizio Blob offre le tre risorse seguenti: l'account di archiviazione, i contenitori e i Blob. All'interno dell'account di archiviazione, i contenitori consentono di organizzare set di BLOB. Per altre informazioni, vedere: https://msdn.microsoft.com/en-us/library/azure/ee691964.aspx

:type ~azure.storage.common.TokenCredential

Ereditarietà

StorageClient

BaseBlobService

Costruttore

BaseBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)

Parametri

account_name

str

valore predefinito: None

nome dell'account di archiviazione. Viene usato per autenticare le richieste firmate con una chiave dell'account e per costruire l'endpoint di archiviazione. È obbligatorio, a meno che non venga specificato un stringa di connessione o se un dominio personalizzato viene usato con l'autenticazione anonima.

account_key

str

valore predefinito: None

Chiave dell'account di archiviazione. Viene usato per l'autenticazione con chiave condivisa. Se non viene specificata alcuna chiave dell'account o token di firma di accesso condiviso, verrà usato l'accesso anonimo.

sas_token

str

valore predefinito: None

Token di firma di accesso condiviso da usare per autenticare le richieste anziché la chiave dell'account. Se la chiave dell'account e il token di firma di accesso condiviso sono entrambi specificati, la chiave dell'account verrà usata per firmare. Se nessuno dei due viene specificato, verrà usato l'accesso anonimo.

is_emulated

bool

valore predefinito: False

Indica se usare l'emulatore. Il valore predefinito è False. Se specificato, eseguirà l'override di tutti gli altri parametri oltre a stringa di connessione e alla sessione di richiesta.

protocol

str

valore predefinito: https

Protocollo da usare per le richieste. Il valore predefinito è https.

endpoint_suffix

str

valore predefinito: core.windows.net

Componente di base host dell'URL, meno il nome dell'account. Il valore predefinito è Azure (core.windows.net). Eseguire l'override di questa opzione per usare il cloud cina (core.chinacloudapi.cn).

custom_domain

str

valore predefinito: None

Dominio personalizzato da usare. Questa impostazione può essere impostata nel portale di Azure. Ad esempio, "www.mydomain.com".

request_session

<xref:requests.Session>

valore predefinito: None

Oggetto sessione da utilizzare per le richieste HTTP.

connection_string

str

valore predefinito: None

Se specificato, verrà eseguito l'override di tutti gli altri parametri oltre alla sessione di richiesta. Vedere http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ per il formato di stringa di connessione

socket_timeout

int

valore predefinito: None

Se specificato, verrà eseguito l'override del timeout del socket predefinito. Il timeout specificato è espresso in secondi. Vedere DEFAULT_SOCKET_TIMEOUT in _constants.py per il valore predefinito.

token_credential

valore predefinito: None

Credenziali del token usate per autenticare le richieste HTTPS. Il valore del token deve essere aggiornato prima della scadenza.

Variabili

MAX_SINGLE_GET_SIZE

int

Le dimensioni del primo intervallo vengono eseguite dai metodi get_blob_to_* se max_connections è maggiore di 1. Meno dati verranno restituiti se il BLOB è più piccolo di questo.

MAX_CHUNK_GET_SIZE

int

La dimensione dell'intervallo successivo viene eseguita dai metodi get_blob_to_* se max_connections è maggiore di 1 e il BLOB è maggiore di MAX_SINGLE_GET_SIZE. Meno dati verranno restituiti se il resto del BLOB è minore di questo. Se questo valore è impostato su più di 4 MB, content_validation genererà un errore se abilitato. Tuttavia, se content_validation non è desiderato una dimensione maggiore di 4 MB potrebbe essere ottimale. L'impostazione di questo valore inferiore a 4 MB non è consigliata.

key_encryption_key

object

Chiave di crittografia della chiave fornita facoltativamente dall'utente. Se specificato, verrà usato per crittografare/decrittografare nei metodi supportati. Per i metodi che richiedono la decrittografia, è necessario specificare il key_encryption_key OR del resolver. Se vengono forniti entrambi, il resolver avrà la precedenza. Deve implementare i metodi seguenti per le API che richiedono la crittografia: wrap_key(key)-esegue il wrapping della chiave specificata (byte) usando un algoritmo di scelta dell'utente. Restituisce la chiave crittografata come byte. get_key_wrap_algorithm()–restituisce l'algoritmo usato per eseguire il wrapping della chiave simmetrica specificata. get_kid()–restituisce un ID chiave stringa per questa chiave-crittografia-chiave. Deve implementare i metodi seguenti per le API che richiedono la decrittografia: unwrap_key(key, algoritmo)-restituisce la forma nonwrapped della chiave simmetrica specificata usando l'algoritmo specificato dalla stringa. get_kid()–restituisce un ID chiave stringa per questa chiave-crittografia-chiave.

key_resolver_function

kid) (<xref:function>

Funzione per risolvere le chiavi facoltativamente fornite dall'utente. Se specificato, verrà usato per decrittografare nei metodi supportati. Per i metodi che richiedono la decrittografia, è necessario specificare il key_encryption_key OR del resolver. Se vengono forniti entrambi, il resolver avrà la precedenza. Usa la stringa kid per restituire una chiave-crittografia chiave che implementa l'interfaccia definita in precedenza.

require_encryption

bool

Flag che può essere impostato per assicurarsi che tutti i messaggi caricati correttamente nella coda e tutti i messaggi scaricati e letti correttamente dalla coda siano/sono stati crittografati durante il server. Se questo flag è impostato, è necessario specificare tutti i parametri necessari per la crittografia o la decrittografia. Vedere i commenti precedenti sul key_encryption_key e il resolver.

Metodi

abort_copy_blob	Interrompe un'operazione di copy_blob in sospeso e lascia un BLOB di destinazione con lunghezza zero e metadati completi.
acquire_blob_lease	Richiede un nuovo lease. Se il Blob non presenta un lease attivo, il servizio Blob crea un lease sul Blob e restituisce un nuovo ID lease.
acquire_container_lease	Richiede un nuovo lease. Se il contenitore non dispone di un lease attivo, il servizio Blob crea un lease sul contenitore e restituisce un nuovo ID lease.
batch_delete_blobs	Invia un batch di più richieste di eliminazione BLOB. Il metodo di eliminazione del BLOB elimina il BLOB o lo snapshot specificato. Si noti che l'eliminazione di un BLOB comporta anche l'eliminazione di tutti i relativi snapshot. Per altre informazioni, vedere https://docs.microsoft.com/rest/api/storageservices/delete-blob.
break_blob_lease	Interrompe il lease, se il BLOB ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato 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 dell'interruzione e del rilascio nel BLOB. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease. Anche un lease interrotto può essere rilasciato, nel qual caso un altro client può immediatamente acquisire il lease sul Blob.
break_container_lease	Interrompere il lease, se il contenitore ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato 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. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease.
change_blob_lease	Modifica l'ID lease di un lease attivo. Una modifica deve includere l'ID lease corrente e un nuovo ID lease.
change_container_lease	Modificare l'ID lease di un lease attivo. Una modifica deve includere l'ID lease corrente e un nuovo ID lease.
copy_blob	Copia un BLOB in modo asincrono. Questa operazione restituisce un oggetto proprietà dell'operazione di copia, incluso un ID di copia che è possibile usare per controllare o interrompere l'operazione di copia. Il servizio Blob viene copiato secondo il principio del best effort. Il BLOB di origine per un'operazione di copia può essere un BLOB a blocchi, un BLOB di accodamento o un BLOB di pagine. Se il Blob di destinazione esiste già, deve essere dello stesso tipo del Blob di origine. Eventuali Blob di destinazione esistenti verranno sovrascritti. Non è possibile modificare il Blob di destinazione se è in corso un'operazione di copia. Quando si copia da un BLOB di pagine, il servizio BLOB crea un BLOB di pagine di destinazione della lunghezza del BLOB di origine, inizialmente contenente tutti gli zero. Verranno enumerati gli intervalli di pagine di origine e verranno copiati gli intervalli non vuoti. Per un BLOB a blocchi o un BLOB di accodamento, il servizio BLOB crea un BLOB commit di lunghezza zero prima di restituire da questa operazione. Quando si copia da un BLOB a blocchi, vengono copiati tutti i blocchi di commit e i relativi ID di blocco. I blocchi non inviati non vengono copiati. Alla fine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi commit dell'origine. Quando si copia da un BLOB di accodamento, tutti i blocchi di commit vengono copiati. Alla fine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi commit dell'origine. Per tutti i tipi di BLOB, è possibile chiamare get_blob_properties nel BLOB di destinazione per controllare lo stato dell'operazione di copia. Al termine della copia, verrà eseguito il commit del Blob finale.
create_container	Crea un nuovo contenitore nell'account specificato. Se il contenitore con lo stesso nome esiste già, l'operazione ha esito negativo se fail_on_exist è True.
delete_blob	Contrassegna il BLOB o lo snapshot specificati per l'eliminazione. Il Blob verrà eliminato in seguito durante un'operazione di Garbage Collection. Si noti che per eliminare un Blob, è necessario eliminare tutti i relativi snapshot. È possibile eliminare entrambi contemporaneamente con l'operazione Elimina BLOB. Se un criterio di conservazione di eliminazione è abilitato per il servizio, questa operazione elimina il BLOB o lo snapshot e mantiene il BLOB o lo snapshot per il numero specificato di giorni. Dopo il numero specificato di giorni, i dati del BLOB vengono rimossi dal servizio durante la Garbage Collection. Blob o snapshot eliminati temporanea è accessibile tramite l'API List BLOBs che specifica l'opzione include=Include.Deleted. È possibile ripristinare un BLOB o uno snapshot eliminati tramite l'API Undelete.
delete_container	Contrassegna il contenitore specificato per l'eliminazione. Il contenitore e tutti i BLOB in esso contenuti verranno eliminati in seguito durante un'operazione di Garbage Collection.
exists	Restituisce un valore booleano che indica se il contenitore esiste (se blob_name è None) o un valore booleano che indica se il BLOB esiste.
extract_date_and_request_id
generate_account_shared_access_signature	Genera una firma di accesso condiviso per il servizio BLOB. Usare la firma restituita con il parametro sas_token di qualsiasi BlobService.
generate_blob_shared_access_signature	Genera una firma di accesso condiviso per il BLOB o uno dei relativi snapshot. Usare la firma restituita con il parametro sas_token di qualsiasi BlobService.
generate_container_shared_access_signature	Genera una firma di accesso condiviso per il contenitore. Usare la firma restituita con il parametro sas_token di qualsiasi BlobService.
get_blob_account_information	Ottiene informazioni correlate all'account di archiviazione. Le informazioni possono essere recuperate anche se l'utente ha una firma di accesso condiviso a un contenitore o a un BLOB.
get_blob_metadata	Restituisce tutti i metadati definiti dall'utente per il BLOB o lo snapshot specificati.
get_blob_properties	Restituisce tutti i metadati definiti dall'utente, le proprietà HTTP standard e le proprietà di sistema per il Blob. Non restituisce il contenuto del Blob. Restituisce Blob con BlobProperties e un dict di metadati.
get_blob_service_properties	Ottiene le proprietà del servizio BLOB di un account di archiviazione, incluso Azure Analisi archiviazione.
get_blob_service_stats	Recupera le statistiche correlate alla replica per il servizio BLOB. È disponibile solo quando la replica con ridondanza geografica e accesso in lettura è abilitata per l'account di archiviazione. Con la replica geograficamente ridondante, Archiviazione di Azure mantiene i dati durevoli in due posizioni. In entrambe le posizioni Archiviazione di Azure gestisce costantemente più repliche integre dei dati. La posizione in cui si leggono, creano, aggiornano o eliminano i dati è la posizione dell'account di archiviazione primaria. La posizione primaria esiste nell'area scelta al momento della creazione di un account tramite il portale di Azure classico di Gestione di Azure, ad esempio Stati Uniti centro-settentrionali. La posizione in cui i dati vengono replicati è la posizione secondaria. La posizione secondaria viene determinata automaticamente in base alla posizione primaria. Si tratta di un secondo data center che risiede nella stessa area geografica della posizione primaria. Dalla posizione secondaria è disponibile l'accesso in sola lettura se la replica geograficamente ridondante con accesso in lettura è abilitata per l'account di archiviazione.
get_blob_to_bytes	Scarica un BLOB come matrice di byte, con notifiche automatiche di blocchi e stato. Restituisce un'istanza di Blob con proprietà, metadati e contenuto.
get_blob_to_path	Scarica un BLOB in un percorso di file, con notifiche automatiche di blocco e stato. Restituisce un'istanza di Blob con proprietà e metadati.
get_blob_to_stream	Scarica un BLOB in un flusso, con notifiche automatiche di suddivisione in blocchi e stato. Restituisce un'istanza di Blob con proprietà e metadati.
get_blob_to_text	Scarica un BLOB come testo Unicode, con notifiche automatiche di suddivisione in blocchi e stato. Restituisce un'istanza di Blob con proprietà, metadati e contenuto.
get_container_acl	Ottiene le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i dati del contenitore sono accessibili pubblicamente.
get_container_metadata	Restituisce tutti i metadati definiti dall'utente per il contenitore specificato.
get_container_properties	Restituisce tutti i metadati definiti dall'utente e le proprietà di sistema per il contenitore specificato. I dati restituiti non includono l'elenco di BLOB del contenitore.
get_user_delegation_key	Ottenere una chiave di delega utente allo scopo di firmare i token di firma di accesso condiviso. Una credenziale del token deve essere presente nell'oggetto servizio affinché la richiesta abbia esito positivo.
list_blob_names	Restituisce un generatore per elencare i nomi dei BLOB nel contenitore specificato. Il generatore seguirà in modo differimento i token di continuazione restituiti dal servizio e si arresterà quando vengono restituiti tutti i BLOB o num_results viene raggiunto. Se viene specificato num_results e l'account ha più di tale numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se si desiderano altri risultati.
list_blobs	Restituisce un generatore per elencare i BLOB nel contenitore specificato. Il generatore seguirà in modo differimento i token di continuazione restituiti dal servizio e si arresterà quando vengono restituiti tutti i BLOB o num_results viene raggiunto. Se viene specificato num_results e l'account ha più di tale numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se si desiderano altri risultati.
list_containers	Restituisce un generatore per elencare i contenitori nell'account specificato. Il generatore seguirà in modo differibile i token di continuazione restituiti dal servizio e si arresterà quando tutti i contenitori sono stati restituiti o num_results viene raggiunto. Se viene specificato num_results e l'account ha più di tale numero di contenitori, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se si desiderano altri risultati.
make_blob_url	Crea l'URL per accedere a un BLOB.
make_container_url	Crea l'URL per accedere a un contenitore.
release_blob_lease	Rilascia il lease. Il lease può essere rilasciato se l'ID specificato nella richiesta corrisponde a quello associato al Blob. In seguito al rilascio del lease un altro client può immediatamente acquisire il lease del Blob al termine del rilascio.
release_container_lease	Rilascia il lease. Il lease può essere rilasciato se il lease_id specificato corrisponde a quello associato al contenitore. In seguito al rilascio del lease un altro client può immediatamente acquisire il lease del contenitore al termine del rilascio.
renew_blob_lease	Rinnova il lease. Il lease può essere rinnovato se l'ID specificato nella richiesta corrisponde a quello associato al Blob. Si noti che il lease può essere rinnovato anche se è scaduto, purché il Blob non sia stato modificato o non sia stato associato a un nuovo lease dopo la scadenza di quello corrente. Quando si rinnova un lease, la durata del lease viene reimpostata.
renew_container_lease	Rinnova il lease. Il lease può essere rinnovato se l'ID lease specificato corrisponde a quello associato al contenitore. Si noti che il lease può essere rinnovato anche se è scaduto, purché il contenitore non sia stato associato a un nuovo lease dopo la scadenza di quello corrente. Quando si rinnova un lease, la durata del lease viene reimpostata.
set_blob_metadata	Imposta i metadati definiti dall'utente per il BLOB specificato come una o più coppie nome-valore.
set_blob_properties	Imposta le proprietà di sistema nel BLOB. Se per la content_settings è impostata una proprietà, tutte le proprietà verranno sostituite.
set_blob_service_properties	Imposta le proprietà del servizio BLOB di un account di archiviazione, tra cui Azure Analisi archiviazione. Se un elemento (ex Logging) viene lasciato come None, le impostazioni esistenti nel servizio per tale funzionalità vengono mantenute.
set_container_acl	Imposta le autorizzazioni per il contenitore specificato o i criteri di accesso archiviati che possono essere usati con firme di accesso condiviso. Le autorizzazioni indicano se i BLOB di un contenitore sono accessibili pubblicamente.
set_container_metadata	Imposta una o più coppie nome-valore definite dall'utente per il contenitore specificato. Ogni chiamata a questa operazione sostituisce tutti i metadati esistenti collegati al contenitore. Per rimuovere tutti i metadati dal contenitore, chiamare questa operazione senza metadati.
set_proxy	Imposta l'host del server proxy e la porta per http CONNECT Tunnelling.
snapshot_blob	Crea uno snapshot di sola lettura di un BLOB.
undelete_blob	L'operazione BLOB annulla il ripristino del contenuto e dei metadati di BLOB o snapshot eliminati temporanea. Il tentativo di annullare l'eliminazione di un BLOB o di uno snapshot non temporanea avrà esito positivo senza modifiche.

abort_copy_blob

Interrompe un'operazione di copy_blob in sospeso e lascia un BLOB di destinazione con lunghezza zero e metadati completi.

abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore di destinazione.

blob_name

str

Necessario

Nome del BLOB di destinazione.

copy_id

str

Necessario

Copiare l'identificatore fornito nella copy.id dell'operazione di copy_blob originale.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob di destinazione presenta un lease infinito attivo.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

acquire_blob_lease

Richiede un nuovo lease. Se il Blob non presenta un lease attivo, il servizio Blob crea un lease sul Blob e restituisce un nuovo ID lease.

acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

lease_duration

int

valore predefinito: -1

Specifica la durata del lease, in secondi, o un uno negativo (-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).

proposed_lease_id

str

valore predefinito: None

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

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

str

acquire_container_lease

Richiede un nuovo lease. Se il contenitore non dispone di un lease attivo, il servizio Blob crea un lease sul contenitore e restituisce un nuovo ID lease.

acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_duration

int

valore predefinito: -1

Specifica la durata del lease, in secondi, o un uno negativo (-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).

proposed_lease_id

str

valore predefinito: None

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

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

str

batch_delete_blobs

Invia un batch di più richieste di eliminazione BLOB.

Il metodo di eliminazione del BLOB elimina il BLOB o lo snapshot specificato. Si noti che l'eliminazione di un BLOB comporta anche l'eliminazione di tutti i relativi snapshot. Per altre informazioni, vedere https://docs.microsoft.com/rest/api/storageservices/delete-blob.

batch_delete_blobs(batch_delete_sub_requests, timeout=None)

Parametri

batch_delete_sub_requests

list(BatchDeleteSubRequest)

Necessario

Richieste di eliminazione del BLOB da inviare come batch.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

risposta HTTP di eliminazione batch analizzata

Tipo restituito

list <xref:of> BatchSubResponse

break_blob_lease

Interrompe il lease, se il BLOB ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato 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 dell'interruzione e del rilascio nel BLOB. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease.

Anche un lease interrotto può essere rilasciato, nel qual caso un altro client può immediatamente acquisire il lease sul Blob.

break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

lease_break_period

int

valore predefinito: None

Per un'operazione di interruzione, 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 utilizzato solo se è più breve del tempo rimanente sul lease. Se più lungo, viene utilizzato il tempo rimanente sul lease. Un nuovo lease sarà disponibile solo dopo la scadenza del periodo di interruzione, è tuttavia possibile che il lease venga mantenuto anche oltre il periodo di interruzione. Se questa intestazione non viene visualizzata con un'operazione di interruzione, un lease a durata fissa si interrompe dopo il periodo di lease rimanente e un lease infinito si interrompe immediatamente.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

INT

break_container_lease

Interrompere il lease, se il contenitore ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato 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. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease.

break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_break_period

int

valore predefinito: None

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 utilizzato solo se è più breve del tempo rimanente sul lease. Se più lungo, viene utilizzato il tempo rimanente sul lease. Un nuovo lease sarà disponibile solo dopo la scadenza del periodo di interruzione, è tuttavia possibile che il lease venga mantenuto anche oltre il periodo di interruzione. Se questa intestazione non viene visualizzata con un'operazione di interruzione, un lease a durata fissa si interrompe dopo il periodo di lease rimanente e un lease infinito si interrompe immediatamente.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

INT

change_blob_lease

Modifica l'ID lease di un lease attivo. Una modifica deve includere l'ID lease corrente e un nuovo ID lease.

change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

lease_id

str

Necessario

Obbligatoria se il Blob presenta un lease attivo.

proposed_lease_id

str

Necessario

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

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

change_container_lease

Modificare l'ID lease di un lease attivo. Una modifica deve includere l'ID lease corrente e un nuovo ID lease.

change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_id

str

Necessario

ID lease per il lease attivo.

proposed_lease_id

str

Necessario

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

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

copy_blob

Copia un BLOB in modo asincrono. Questa operazione restituisce un oggetto proprietà dell'operazione di copia, incluso un ID di copia che è possibile usare per controllare o interrompere l'operazione di copia. Il servizio Blob viene copiato secondo il principio del best effort.

Il BLOB di origine per un'operazione di copia può essere un BLOB a blocchi, un BLOB di accodamento o un BLOB di pagine. Se il Blob di destinazione esiste già, deve essere dello stesso tipo del Blob di origine. Eventuali Blob di destinazione esistenti verranno sovrascritti. Non è possibile modificare il Blob di destinazione se è in corso un'operazione di copia.

Quando si copia da un BLOB di pagine, il servizio BLOB crea un BLOB di pagine di destinazione della lunghezza del BLOB di origine, inizialmente contenente tutti gli zero. Verranno enumerati gli intervalli di pagine di origine e verranno copiati gli intervalli non vuoti.

Per un BLOB a blocchi o un BLOB di accodamento, il servizio BLOB crea un BLOB commit di lunghezza zero prima di restituire da questa operazione. Quando si copia da un BLOB a blocchi, vengono copiati tutti i blocchi di commit e i relativi ID di blocco. I blocchi non inviati non vengono copiati. Alla fine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi commit dell'origine.

Quando si copia da un BLOB di accodamento, tutti i blocchi di commit vengono copiati. Alla fine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi commit dell'origine.

Per tutti i tipi di BLOB, è possibile chiamare get_blob_properties nel BLOB di destinazione per controllare lo stato dell'operazione di copia. Al termine della copia, verrà eseguito il commit del Blob finale.

copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore di destinazione. Il contenitore deve esistere.

blob_name

str

Necessario

Nome del BLOB di destinazione. Se il BLOB di destinazione esiste, verrà sovrascritto. In caso contrario, verrà creato.

copy_source

str

Necessario

URL di lunghezza massima di 2 KB che specifica un file o un BLOB di Azure. La codifica del valore deve essere di tipo URL in quanto viene visualizzato in un URI di richiesta. Se l'origine si trova in un altro account, l'origine deve essere pubblica o deve essere autenticata tramite una firma di accesso condiviso. Se l'origine è pubblica, non è necessaria alcuna autenticazione. Esempi: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

metadata

dict(str, str)

valore predefinito: None

Coppie nome-valore associate al Blob come metadati. Se non vengono specificate coppie nome-valore, l'operazione copia i metadati dal BLOB di origine o dal file di origine al BLOB di destinazione. Se vengono specificate una o più coppie nome-valore, il BLOB di destinazione viene creato con i metadati specificati e i metadati non vengono copiati dal BLOB o dal file di origine.

source_if_modified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 condizionale per copiare il Blob solo se il Blob di origine è stato modificato dopo la data e l'ora specificate.

source_if_unmodified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 condizionale per copiare il Blob solo se il Blob di origine non è stato modificato dopo la data e l'ora specificate.

source_if_match

<xref:ETag>

valore predefinito: None

Valore ETag o il carattere jolly (*). Specificare questa intestazione condizionale per copiare il Blob di origine solo se il relativo valore ETag corrisponde al valore specificato. Se i valori ETag non corrispondono, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita). Questa intestazione non può essere specificata se l'origine è un file di Azure.

source_if_none_match

<xref:ETag>

valore predefinito: None

Valore ETag o il carattere jolly (*). Specificare questa intestazione condizionale per copiare il Blob di origine solo se il relativo valore ETag non corrisponde al valore specificato. Se i valori sono identici, tramite il servizio Blob viene restituito il codice di stato 412 (Condizione preliminare non riuscita). Questa intestazione non può essere specificata se l'origine è un file di Azure.

destination_if_modified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 condizionale per copiare il Blob solo se il Blob di destinazione è stato modificato dopo la data e l'ora specificate. Se il Blob di destinazione non è stato modificato, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita).

destination_if_unmodified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 condizionale per copiare il Blob solo se il Blob di destinazione non è stato modificato dopo la data e l'ora specificate. Se il Blob di destinazione è stato modificato, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita).

destination_if_match

<xref:ETag>

valore predefinito: None

Valore ETag o il carattere jolly (*). Specificare un valore ETag per questa intestazione condizionale per copiare il BLOB solo se il valore ETag specificato corrisponde al valore ETag per un BLOB di destinazione esistente. Se L'ETag per il BLOB di destinazione non corrisponde all'ETag specificato per If-Match, il servizio BLOB restituisce il codice di stato 412 (Precondizione non riuscita).

destination_if_none_match

<xref:ETag>

valore predefinito: None

Valore ETag o carattere jolly (). Specificare un valore ETag per questa intestazione condizionale per copiare il BLOB solo se il valore ETag specificato non corrisponde al valore ETag per il BLOB di destinazione. Specificare il carattere jolly () per eseguire l'operazione solo se il BLOB di destinazione non esiste. Se la condizione specificata non viene soddisfatta, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita).

destination_lease_id

str

valore predefinito: None

L'ID lease specificato per questa intestazione deve corrispondere all'ID lease del Blob di destinazione. Se la richiesta non include l'ID lease o non è valida, l'operazione ha esito negativo e restituisce il codice di stato 412 (Condizione preliminare non riuscita).

source_lease_id

str

valore predefinito: None

Specificare questa operazione per eseguire l'operazione Copy BLOB solo se l'ID lease specificato corrisponde all'ID lease attivo del BLOB di origine.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Copiare le proprietà dell'operazione, ad esempio stato, origine e ID.

Tipo restituito

CopyProperties

create_container

Crea un nuovo contenitore nell'account specificato. Se il contenitore con lo stesso nome esiste già, l'operazione ha esito negativo se fail_on_exist è True.

create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore da creare. Il nome del contenitore può contenere solo lettere minuscole, numeri e trattini e deve iniziare con una lettera o un numero. Ogni trattino deve essere preceduto e seguito da un carattere diverso da un trattino. Il nome deve inoltre avere una lunghezza compresa fra 3 e 63 caratteri.

metadata

dict(str, str)

valore predefinito: None

Una dict con coppie name_value da associare al contenitore come metadati. Esempio:{'Category':'test'}

public_access

PublicAccess

valore predefinito: None

I valori possibili includono: contenitore, BLOB.

fail_on_exist

bool

valore predefinito: False

Specificare se generare un'eccezione quando esiste il contenitore.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

True se il contenitore viene creato, False se il contenitore esiste già.

Tipo restituito

bool

delete_blob

Contrassegna il BLOB o lo snapshot specificati per l'eliminazione. Il Blob verrà eliminato in seguito durante un'operazione di Garbage Collection.

Si noti che per eliminare un Blob, è necessario eliminare tutti i relativi snapshot. È possibile eliminare entrambi contemporaneamente con l'operazione Elimina BLOB.

Se un criterio di conservazione di eliminazione è abilitato per il servizio, questa operazione elimina il BLOB o lo snapshot e mantiene il BLOB o lo snapshot per il numero specificato di giorni. Dopo il numero specificato di giorni, i dati del BLOB vengono rimossi dal servizio durante la Garbage Collection. Blob o snapshot eliminati temporanea è accessibile tramite l'API List BLOBs che specifica l'opzione include=Include.Deleted. È possibile ripristinare un BLOB o uno snapshot eliminati tramite l'API Undelete.

delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot BLOB da eliminare.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

delete_snapshots

DeleteSnapshot

valore predefinito: None

Obbligatoria se al Blob sono associati snapshot.

if_modified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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 ed eseguire l'operazione se esiste.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

delete_container

Contrassegna il contenitore specificato per l'eliminazione. Il contenitore e tutti i BLOB in esso contenuti verranno eliminati in seguito durante un'operazione di Garbage Collection.

delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore da eliminare.

fail_not_exist

bool

valore predefinito: False

Specificare se generare un'eccezione quando il contenitore non esiste.

lease_id

str

valore predefinito: None

Se specificato, delete_container ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID. Obbligatorio se il contenitore ha un lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

True se il contenitore viene eliminato, il contenitore False non esiste.

Tipo restituito

bool

exists

Restituisce un valore booleano che indica se il contenitore esiste (se blob_name è None) o un valore booleano che indica se il BLOB esiste.

exists(container_name, blob_name=None, snapshot=None, timeout=None)

Parametri

container_name

str

Necessario

Nome di un contenitore.

blob_name

str

valore predefinito: None

Nome di un BLOB. Se Nessuno, il contenitore verrà controllato per l'esistenza.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Valore booleano che indica se la risorsa esiste.

Tipo restituito

bool

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Parametri

retry_context

Necessario

generate_account_shared_access_signature

Genera una firma di accesso condiviso per il servizio BLOB. Usare la firma restituita con il parametro sas_token di qualsiasi BlobService.

generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)

Parametri

resource_types

<xref:ResourceTypes>

Necessario

Specifica i tipi di risorsa accessibili con la firma di accesso condiviso dell'account.

permission

<xref:AccountPermissions>

Necessario

Le autorizzazioni associate alla firma di accesso condiviso. L'utente può eseguire solo le operazioni consentite dalle autorizzazioni. Obbligatorio a meno che non venga specificato un ID che fa riferimento a un criterio di accesso archiviato che contiene questo campo. Questo campo deve essere omesso se è stato specificato nei criteri di accesso archiviati associati.

expiry

datetime oppure str

Necessario

Ora in cui la firma di accesso condiviso non è valida. Obbligatorio a meno che non venga specificato un ID che fa riferimento a un criterio di accesso archiviato che contiene questo campo. Questo campo deve essere omesso se è stato specificato nei criteri di accesso archiviati associati. Azure convertirà sempre i valori in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC.

start

datetime oppure str

valore predefinito: None

Ora in cui la firma di accesso condiviso diventa valida. Se omesso, come ora di inizio di questa chiamata verrà considerata l'ora in cui il servizio di archiviazione riceve la richiesta. Azure convertirà sempre i valori in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC.

ip

str

valore predefinito: None

Specifica un indirizzo IP o un intervallo di indirizzi IP da cui accettare le richieste. Se l'indirizzo IP da cui ha origine la richiesta non corrisponde all'indirizzo IP o all'intervallo di indirizzi specificato nel token di firma di accesso condiviso, la richiesta non viene autenticata. Ad esempio, specificando sip=168.1.5.65 o sip=168.1.5.60-168.1.5.70 nella firma di accesso condiviso limita la richiesta a tali indirizzi IP.

protocol

str

valore predefinito: None

Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https,http. Per i valori possibili, vedere Protocol.

Restituisce

Token di firma di accesso condiviso (sas).

Tipo restituito

str

generate_blob_shared_access_signature

Genera una firma di accesso condiviso per il BLOB o uno dei relativi snapshot. Usare la firma restituita con il parametro sas_token di qualsiasi BlobService.

generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parametri

container_name

str

Necessario

Nome del contenitore.

blob_name

str

Necessario

Nome del BLOB.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB per concedere l'autorizzazione.

permission

BlobPermissions

valore predefinito: None

Le autorizzazioni associate alla firma di accesso condiviso. L'utente può eseguire solo le operazioni consentite dalle autorizzazioni. Le autorizzazioni devono essere ordinate in lettura, scrittura, eliminazione, elenco. Obbligatorio a meno che non venga specificato un ID che fa riferimento a un criterio di accesso archiviato che contiene questo campo. Questo campo deve essere omesso se è stato specificato nei criteri di accesso archiviati associati.

expiry

datetime oppure str

valore predefinito: None

Ora in cui la firma di accesso condiviso non è valida. Obbligatorio a meno che non venga specificato un ID che fa riferimento a un criterio di accesso archiviato che contiene questo campo. Questo campo deve essere omesso se è stato specificato nei criteri di accesso archiviati associati. Azure convertirà sempre i valori in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC.

start

datetime oppure str

valore predefinito: None

Ora in cui la firma di accesso condiviso diventa valida. Se omesso, come ora di inizio di questa chiamata verrà considerata l'ora in cui il servizio di archiviazione riceve la richiesta. Azure convertirà sempre i valori in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC.

id

str

valore predefinito: None

Valore univoco di lunghezza massima di 64 caratteri correlato a un criterio di accesso archiviato. Per creare un criterio di accesso archiviato, usare set_container_acl.

ip

str

valore predefinito: None

Specifica un indirizzo IP o un intervallo di indirizzi IP da cui accettare le richieste. Se l'indirizzo IP da cui ha origine la richiesta non corrisponde all'indirizzo IP o all'intervallo di indirizzi specificato nel token di firma di accesso condiviso, la richiesta non viene autenticata. Ad esempio, specificando sip=168.1.5.65 o sip=168.1.5.60-168.1.5.70 nella firma di accesso condiviso limita la richiesta a tali indirizzi IP.

protocol

str

valore predefinito: None

Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https,http. Per i valori possibili, vedere Protocol.

cache_control

str

valore predefinito: None

Valore dell'intestazione della risposta per Cache-Control quando si accede alla risorsa usando questa firma di accesso condiviso.

content_disposition

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Disposition quando si accede alla risorsa usando questa firma di accesso condiviso.

content_encoding

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Encoding quando si accede alla risorsa usando questa firma di accesso condiviso.

content_language

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Language quando si accede alla risorsa usando questa firma di accesso condiviso.

content_type

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Type quando si accede alla risorsa usando questa firma di accesso condiviso.

user_delegation_key

UserDelegationKey

valore predefinito: None

Anziché una chiave dell'account, l'utente potrebbe passare una chiave di delega utente. È possibile ottenere una chiave di delega utente dal servizio eseguendo l'autenticazione con un'identità AAD; questa operazione può essere eseguita chiamando get_user_delegation_key. Quando presente, la firma di accesso condiviso viene invece firmata con la chiave di delega utente.

Restituisce

Token di firma di accesso condiviso (sas).

Tipo restituito

str

generate_container_shared_access_signature

Genera una firma di accesso condiviso per il contenitore. Usare la firma restituita con il parametro sas_token di qualsiasi BlobService.

generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parametri

container_name

str

Necessario

Nome del contenitore.

permission

ContainerPermissions

valore predefinito: None

Le autorizzazioni associate alla firma di accesso condiviso. L'utente può eseguire solo le operazioni consentite dalle autorizzazioni. Le autorizzazioni devono essere ordinate in lettura, scrittura, eliminazione, elenco. Obbligatorio a meno che non venga specificato un ID che fa riferimento a un criterio di accesso archiviato che contiene questo campo. Questo campo deve essere omesso se è stato specificato nei criteri di accesso archiviati associati.

expiry

datetime oppure str

valore predefinito: None

Ora in cui la firma di accesso condiviso non è valida. Obbligatorio a meno che non venga specificato un ID che fa riferimento a un criterio di accesso archiviato che contiene questo campo. Questo campo deve essere omesso se è stato specificato nei criteri di accesso archiviati associati. Azure convertirà sempre i valori in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC.

start

datetime oppure str

valore predefinito: None

Ora in cui la firma di accesso condiviso diventa valida. Se omesso, come ora di inizio di questa chiamata verrà considerata l'ora in cui il servizio di archiviazione riceve la richiesta. Azure convertirà sempre i valori in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC.

id

str

valore predefinito: None

Valore univoco di lunghezza massima di 64 caratteri correlato a un criterio di accesso archiviato. Per creare un criterio di accesso archiviato, usare set_blob_service_properties.

ip

str

valore predefinito: None

Specifica un indirizzo IP o un intervallo di indirizzi IP da cui accettare le richieste. Se l'indirizzo IP da cui ha origine la richiesta non corrisponde all'indirizzo IP o all'intervallo di indirizzi specificato nel token di firma di accesso condiviso, la richiesta non viene autenticata. Ad esempio, specificando sip=168.1.5.65 o sip=168.1.5.60-168.1.5.70 nella firma di accesso condiviso limita la richiesta a tali indirizzi IP.

protocol

str

valore predefinito: None

Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https,http. Per i valori possibili, vedere Protocol.

cache_control

str

valore predefinito: None

Valore dell'intestazione della risposta per Cache-Control quando si accede alla risorsa usando questa firma di accesso condiviso.

content_disposition

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Disposition quando si accede alla risorsa usando questa firma di accesso condiviso.

content_encoding

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Encoding quando si accede alla risorsa usando questa firma di accesso condiviso.

content_language

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Language quando si accede alla risorsa usando questa firma di accesso condiviso.

content_type

str

valore predefinito: None

Valore dell'intestazione della risposta per Content-Type quando si accede alla risorsa usando questa firma di accesso condiviso.

user_delegation_key

UserDelegationKey

valore predefinito: None

Anziché una chiave dell'account, l'utente potrebbe passare una chiave di delega utente. È possibile ottenere una chiave di delega utente dal servizio eseguendo l'autenticazione con un'identità AAD; questa operazione può essere eseguita chiamando get_user_delegation_key. Quando presente, la firma di accesso condiviso viene invece firmata con la chiave di delega utente.

Restituisce

Token di firma di accesso condiviso (sas).

Tipo restituito

str

get_blob_account_information

Ottiene informazioni correlate all'account di archiviazione. Le informazioni possono essere recuperate anche se l'utente ha una firma di accesso condiviso a un contenitore o a un BLOB.

get_blob_account_information(container_name=None, blob_name=None, timeout=None)

Parametri

container_name

str

valore predefinito: None

Nome del contenitore esistente. Facoltativo, a meno che non si usi un token di firma di accesso condiviso per un contenitore o un BLOB specifico, nel qual caso è necessario.

blob_name

str

valore predefinito: None

Nome del BLOB esistente. Facoltativo, a meno che non si usi un token di firma di accesso condiviso a un BLOB specifico, nel qual caso è necessario.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Oggetto AccountInformation.

get_blob_metadata

Restituisce tutti i metadati definiti dall'utente per il BLOB o lo snapshot specificati.

get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Decrittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito su HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione protetta per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Dizionario che rappresenta il nome dei metadati BLOB, le coppie valore.

Tipo restituito

dict(str, str)

get_blob_properties

Restituisce tutti i metadati definiti dall'utente, le proprietà HTTP standard e le proprietà di sistema per il Blob. Non restituisce il contenuto del Blob. Restituisce Blob con BlobProperties e un dict di metadati.

get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Decrittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito su HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione protetta per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

un oggetto BLOB, incluse proprietà e metadati.

Tipo restituito

Blob

get_blob_service_properties

Ottiene le proprietà del servizio BLOB di un account di archiviazione, incluso Azure Analisi archiviazione.

get_blob_service_properties(timeout=None)

Parametri

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

BLOB ServiceProperties con una proprietà target_version associata.

get_blob_service_stats

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

Con la replica geograficamente ridondante, Archiviazione di Azure mantiene i dati durevoli in due posizioni. In entrambe le posizioni Archiviazione di Azure gestisce costantemente più repliche integre dei dati. La posizione in cui si leggono, creano, aggiornano o eliminano i dati è la posizione dell'account di archiviazione primaria. La posizione primaria esiste nell'area scelta al momento della creazione di un account tramite il portale di Azure classico di Gestione di Azure, ad esempio Stati Uniti centro-settentrionali. La posizione in cui i dati vengono replicati è la posizione secondaria. La posizione secondaria viene determinata automaticamente in base alla posizione primaria. Si tratta di un secondo data center che risiede nella stessa area geografica della posizione primaria. Dalla posizione secondaria è disponibile l'accesso in sola lettura se la replica geograficamente ridondante con accesso in lettura è abilitata per l'account di archiviazione.

get_blob_service_stats(timeout=None)

Parametri

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Statistiche del servizio Blob.

Tipo restituito

ServiceStats

get_blob_to_bytes

Scarica un BLOB come matrice di byte, con notifiche automatiche di blocchi e stato. Restituisce un'istanza di Blob con proprietà, metadati e contenuto.

get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.

start_range

int

valore predefinito: None

Inizio dell'intervallo di byte da usare per il download di una sezione del BLOB. Se non viene specificato alcun end_range, verranno scaricati tutti i byte dopo il start_range. I parametri start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scaricherà i primi 512 byte di BLOB.

end_range

int

valore predefinito: None

Fine dell'intervallo di byte da usare per il download di una sezione del BLOB. Se viene specificato end_range, è necessario specificare start_range. I parametri start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scaricherà i primi 512 byte di BLOB.

validate_content

bool

valore predefinito: False

Se impostato su true, convalida un hash MD5 per ogni parte recuperata del BLOB. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che il servizio restituirà solo MD5 transazionali per blocchi 4 MB o meno in modo che la prima richiesta di recupero sarà di dimensioni self. MAX_CHUNK_GET_SIZE anziché auto. MAX_SINGLE_GET_SIZE. Se si è auto. MAX_CHUNK_GET_SIZE è stato impostato su maggiore di 4 MB di errore. Poiché il calcolo di MD5 richiede tempo di elaborazione e sarà necessario eseguire più richieste a causa della riduzione delle dimensioni del blocco, potrebbe verificarsi un aumento della latenza.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

valore predefinito: None

Callback per lo stato di avanzamento con funzione di firma(corrente, totale) dove corrente è il numero di byte trasferiti finora e il totale è la dimensione del BLOB se noto.

max_connections

int

valore predefinito: 2

Se impostata su 2 o maggiore, verrà eseguita una prima operazione di recupero. MAX_SINGLE_GET_SIZE byte del BLOB. Se si tratta dell'intero BLOB, il metodo restituisce a questo punto. In caso contrario, scarica i dati rimanenti paralleli usando il numero di thread uguali a max_connections. Ogni blocco sarà di dimensioni self. MAX_CHUNK_GET_SIZE. Se impostato su 1, verrà eseguita una singola richiesta get di grandi dimensioni. Questa operazione non è generalmente consigliata, ma disponibile se è consigliabile usare pochissimi thread, le richieste di rete sono molto costose o un flusso non ricercabile impedisce il download parallelo. Ciò può essere utile anche se molti BLOB devono essere vuoti come richiesta aggiuntiva per i BLOB vuoti se max_connections è maggiore di 1.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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 ed eseguire l'operazione se esiste.

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Decrittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito tramite HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione sicura per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

Restituisce

BLOB con proprietà e metadati. Se max_connections è maggiore di 1, il content_md5 (se impostato nel BLOB) non verrà restituito. Se è necessario questo valore, usare get_blob_properties o impostare max_connections su 1.

Tipo restituito

Blob

get_blob_to_path

Scarica un BLOB in un percorso di file, con notifiche automatiche di blocco e stato. Restituisce un'istanza di Blob con proprietà e metadati.

get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

file_path

str

Necessario

Percorso del file da scrivere in.

open_mode

str

valore predefinito: wb

Modalità da usare quando si apre il file. Si noti che specificando l'aggiunta solo open_mode impedisce il download parallelo. Quindi, max_connections deve essere impostato su 1 se questa open_mode viene usata.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot BLOB da recuperare.

start_range

int

valore predefinito: None

Inizio dell'intervallo di byte da usare per il download di una sezione del BLOB. Se non viene specificato alcun end_range, tutti i byte dopo il download del start_range verranno scaricati. I params start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scarica prima 512 byte di BLOB.

end_range

int

valore predefinito: None

Fine dell'intervallo di byte da usare per il download di una sezione del BLOB. Se viene specificato end_range, è necessario specificare start_range. I params start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scarica prima 512 byte di BLOB.

validate_content

bool

valore predefinito: False

Se impostato su true, convalida un hash MD5 per ogni parte recuperata del BLOB. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che il servizio restituirà solo MD5 transazionali per blocchi 4 MB o meno in modo che la prima richiesta di recupero sarà di dimensioni self. MAX_CHUNK_GET_SIZE anziché auto. MAX_SINGLE_GET_SIZE. Se si è auto. MAX_CHUNK_GET_SIZE è stato impostato su maggiore di 4 MB di errore. Poiché il calcolo di MD5 richiede tempo di elaborazione e sarà necessario eseguire più richieste a causa della riduzione delle dimensioni del blocco, potrebbe verificarsi un aumento della latenza.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

valore predefinito: None

Callback per lo stato di avanzamento con funzione di firma(corrente, totale) dove corrente è il numero di byte trasferiti finora e il totale è la dimensione del BLOB se noto.

max_connections

int

valore predefinito: 2

Se impostata su 2 o maggiore, verrà eseguita una prima operazione di recupero. MAX_SINGLE_GET_SIZE byte del BLOB. Se si tratta dell'intero BLOB, il metodo restituisce a questo punto. In caso contrario, scarica i dati rimanenti paralleli usando il numero di thread uguali a max_connections. Ogni blocco sarà di dimensioni self. MAX_CHUNK_GET_SIZE. Se impostato su 1, verrà eseguita una singola richiesta get di grandi dimensioni. Questa operazione non è generalmente consigliata, ma disponibile se è consigliabile usare pochissimi thread, le richieste di rete sono molto costose o un flusso non ricercabile impedisce il download parallelo. Ciò può essere utile anche se molti BLOB devono essere vuoti come richiesta aggiuntiva per i BLOB vuoti se max_connections è maggiore di 1.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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 ed eseguire l'operazione se esiste.

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Decrittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito tramite HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione sicura per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

Restituisce

BLOB con proprietà e metadati. Se max_connections è maggiore di 1, il content_md5 (se impostato nel BLOB) non verrà restituito. Se è necessario questo valore, usare get_blob_properties o impostare max_connections su 1.

Tipo restituito

Blob

get_blob_to_stream

Scarica un BLOB in un flusso, con notifiche automatiche di suddivisione in blocchi e stato. Restituisce un'istanza di Blob con proprietà e metadati.

get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

stream

IOBase

Necessario

Apertura del flusso a cui scrivere.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot BLOB da recuperare.

start_range

int

valore predefinito: None

Inizio dell'intervallo di byte da usare per il download di una sezione del BLOB. Se non viene specificato alcun end_range, tutti i byte dopo il download del start_range verranno scaricati. I params start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scarica prima 512 byte di BLOB.

end_range

int

valore predefinito: None

Fine dell'intervallo di byte da usare per il download di una sezione del BLOB. Se viene specificato end_range, è necessario specificare start_range. I params start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scarica prima 512 byte di BLOB.

validate_content

bool

valore predefinito: False

Se impostato su true, convalida un hash MD5 per ogni parte recuperata del BLOB. Questo è particolarmente utile per rilevare bitflips in transito se si usa http anziché https come https (impostazione predefinita) verrà già convalidata. Si noti che il servizio restituirà solo md5 transazionali per blocchi di 4 MB o meno, quindi la prima richiesta get sarà di dimensioni autonome. MAX_CHUNK_GET_SIZE invece di sé. MAX_SINGLE_GET_SIZE. Se si è auto. MAX_CHUNK_GET_SIZE è stato impostato su un valore maggiore di 4 MB, verrà generato un errore. Poiché l'elaborazione di MD5 richiede tempo di elaborazione e sarà necessario eseguire più richieste a causa della riduzione delle dimensioni del blocco, potrebbe verificarsi un aumento della latenza.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

valore predefinito: None

Callback per lo stato di avanzamento con funzione di firma (corrente, totale) dove corrente è il numero di byte trasferiti finora e il totale è la dimensione del BLOB, se noto.

max_connections

int

valore predefinito: 2

Se impostato su 2 o versione successiva, verrà eseguito un get iniziale per la prima auto. MAX_SINGLE_GET_SIZE byte del BLOB. Se si tratta dell'intero BLOB, il metodo restituisce a questo punto. In caso contrario, scaricherà i dati rimanenti paralleli usando il numero di thread uguali a max_connections. Ogni blocco sarà di dimensioni autonome. MAX_CHUNK_GET_SIZE. Se impostato su 1, verrà eseguita una singola richiesta get di grandi dimensioni. Questo non è generalmente consigliato, ma disponibile se è necessario usare pochissimi thread, le richieste di rete sono molto costose o un flusso non ricercabile impedisce il download parallelo. Questo può essere utile anche se molti BLOB devono essere vuoti perché è necessaria una richiesta aggiuntiva per i BLOB vuoti se max_connections è maggiore di 1.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Decrittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito su HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione protetta per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

Restituisce

BLOB con proprietà e metadati. Se max_connections è maggiore di 1, il content_md5 (se impostato nel BLOB) non verrà restituito. Se è necessario questo valore, usare get_blob_properties o impostare max_connections su 1.

Tipo restituito

Blob

get_blob_to_text

Scarica un BLOB come testo Unicode, con notifiche automatiche di suddivisione in blocchi e stato. Restituisce un'istanza di Blob con proprietà, metadati e contenuto.

get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

encoding

str

valore predefinito: utf-8

Codifica Python da usare per la decodifica dei dati BLOB.

snapshot

str

valore predefinito: None

Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.

start_range

int

valore predefinito: None

Inizio dell'intervallo di byte da usare per il download di una sezione del BLOB. Se non viene specificato alcun end_range, verranno scaricati tutti i byte dopo il start_range. I parametri start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scaricherà i primi 512 byte di BLOB.

end_range

int

valore predefinito: None

Fine dell'intervallo di byte da usare per il download di una sezione del BLOB. Se viene specificato end_range, è necessario specificare start_range. I parametri start_range e end_range sono inclusivi. Ad esempio: start_range=0, end_range=511 scaricherà i primi 512 byte di BLOB.

validate_content

bool

valore predefinito: False

Se impostato su true, convalida un hash MD5 per ogni parte recuperata del BLOB. Questo è particolarmente utile per rilevare bitflips in transito se si usa http anziché https come https (impostazione predefinita) verrà già convalidata. Si noti che il servizio restituirà solo md5 transazionali per blocchi di 4 MB o meno, quindi la prima richiesta get sarà di dimensioni autonome. MAX_CHUNK_GET_SIZE invece di sé. MAX_SINGLE_GET_SIZE. Se si è auto. MAX_CHUNK_GET_SIZE è stato impostato su un valore maggiore di 4 MB, verrà generato un errore. Poiché l'elaborazione di MD5 richiede tempo di elaborazione e sarà necessario eseguire più richieste a causa della riduzione delle dimensioni del blocco, potrebbe verificarsi un aumento della latenza.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

valore predefinito: None

Callback per lo stato di avanzamento con funzione di firma (corrente, totale) dove corrente è il numero di byte trasferiti finora e il totale è la dimensione del BLOB, se noto.

max_connections

int

valore predefinito: 2

Se impostato su 2 o versione successiva, verrà eseguito un get iniziale per la prima auto. MAX_SINGLE_GET_SIZE byte del BLOB. Se si tratta dell'intero BLOB, il metodo restituisce a questo punto. In caso contrario, scaricherà i dati rimanenti paralleli usando il numero di thread uguali a max_connections. Ogni blocco sarà di dimensioni autonome. MAX_CHUNK_GET_SIZE. Se impostato su 1, verrà eseguita una singola richiesta get di grandi dimensioni. Questo non è generalmente consigliato, ma disponibile se è necessario usare pochissimi thread, le richieste di rete sono molto costose o un flusso non ricercabile impedisce il download parallelo. Questo può essere utile anche se molti BLOB devono essere vuoti perché è necessaria una richiesta aggiuntiva per i BLOB vuoti se max_connections è maggiore di 1.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Decrittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito su HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione protetta per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

Restituisce

BLOB con proprietà e metadati. Se max_connections è maggiore di 1, il content_md5 (se impostato nel BLOB) non verrà restituito. Se è necessario questo valore, usare get_blob_properties o impostare max_connections su 1.

Tipo restituito

Blob

get_container_acl

Ottiene le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i dati del contenitore sono accessibili pubblicamente.

get_container_acl(container_name, lease_id=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_id

valore predefinito: None

Se specificato, get_container_acl ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Dizionario dei criteri di accesso associati al contenitore. dict di str a AccessPolicy e una proprietà public_access se l'accesso pubblico è attivato

get_container_metadata

Restituisce tutti i metadati definiti dall'utente per il contenitore specificato.

get_container_metadata(container_name, lease_id=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_id

str

valore predefinito: None

Se specificato, get_container_metadata ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Dizionario che rappresenta il nome dei metadati del contenitore, le coppie valore.

Tipo restituito

dict(str, str)

get_container_properties

Restituisce tutti i metadati definiti dall'utente e le proprietà di sistema per il contenitore specificato. I dati restituiti non includono l'elenco di BLOB del contenitore.

get_container_properties(container_name, lease_id=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_id

str

valore predefinito: None

Se specificato, get_container_properties ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

proprietà per il contenitore specificato all'interno di un oggetto contenitore.

Tipo restituito

Container

get_user_delegation_key

Ottenere una chiave di delega utente allo scopo di firmare i token di firma di accesso condiviso. Una credenziale del token deve essere presente nell'oggetto servizio affinché la richiesta abbia esito positivo.

get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)

Parametri

key_start_time

datetime

Necessario

Valore DateTime. Indica quando la chiave diventa valida.

key_expiry_time

datetime

Necessario

Valore DateTime. Indica quando la chiave smette di essere valida.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

Chiave di delega utente.

Tipo restituito

UserDelegationKey

list_blob_names

Restituisce un generatore per elencare i nomi dei BLOB nel contenitore specificato. Il generatore seguirà in modo differimento i token di continuazione restituiti dal servizio e si arresterà quando vengono restituiti tutti i BLOB o num_results viene raggiunto.

Se viene specificato num_results e l'account ha più di tale numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se si desiderano altri risultati.

list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

prefix

str

valore predefinito: None

Filtra i risultati in modo che vengano restituiti solo i BLOB i cui nomi iniziano con il prefisso specificato.

num_results

int

valore predefinito: None

Specifica il numero massimo di BLOB da restituire, inclusi tutti gli elementi <xref:azure.storage.blob.baseblobservice.BlobPrefix>. Se la richiesta non specifica num_results o specifica un valore maggiore di 5.000, il server restituirà fino a 5.000 elementi. Se si imposta num_results su un valore minore o uguale a zero, viene restituito il codice di risposta di errore 400 (richiesta non valida).

include

Include

valore predefinito: None

Specifica uno o più set di dati aggiuntivi da includere nella risposta.

delimiter

str

valore predefinito: None

Quando la richiesta include questo parametro, l'operazione restituisce un BlobPrefix elemento nell'elenco dei risultati che funge da segnaposto per tutti i BLOB i cui nomi iniziano con la stessa sottostringa fino all'aspetto del carattere delimitatore. Il delimitatore può essere un singolo carattere o una stringa.

marker

str

valore predefinito: None

Token di continuazione opaco. Questo valore può essere recuperato dal campo next_marker di un oggetto generatore precedente se è stato specificato num_results e tale generatore ha completato l'enumerazione dei risultati. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui il generatore precedente è stato arrestato.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

list_blobs

Restituisce un generatore per elencare i BLOB nel contenitore specificato. Il generatore seguirà in modo differimento i token di continuazione restituiti dal servizio e si arresterà quando vengono restituiti tutti i BLOB o num_results viene raggiunto.

Se viene specificato num_results e l'account ha più di tale numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se si desiderano altri risultati.

list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

prefix

str

valore predefinito: None

Filtra i risultati in modo che vengano restituiti solo i BLOB i cui nomi iniziano con il prefisso specificato.

num_results

int

valore predefinito: None

Specifica il numero massimo di BLOB da restituire, inclusi tutti gli elementi <xref:azure.storage.blob.baseblobservice.BlobPrefix>. Se la richiesta non specifica num_results o specifica un valore maggiore di 5.000, il server restituirà fino a 5.000 elementi. Se si imposta num_results su un valore minore o uguale a zero, viene restituito il codice di risposta di errore 400 (richiesta non valida).

include

Include

valore predefinito: None

Specifica uno o più set di dati aggiuntivi da includere nella risposta.

delimiter

str

valore predefinito: None

Quando la richiesta include questo parametro, l'operazione restituisce un BlobPrefix elemento nell'elenco dei risultati che funge da segnaposto per tutti i BLOB i cui nomi iniziano con la stessa sottostringa fino all'aspetto del carattere delimitatore. Il delimitatore può essere un singolo carattere o una stringa.

marker

str

valore predefinito: None

Token di continuazione opaco. Questo valore può essere recuperato dal campo next_marker di un oggetto generatore precedente se è stato specificato num_results e tale generatore ha completato l'enumerazione dei risultati. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui il generatore precedente è stato arrestato.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

list_containers

Restituisce un generatore per elencare i contenitori nell'account specificato. Il generatore seguirà in modo differibile i token di continuazione restituiti dal servizio e si arresterà quando tutti i contenitori sono stati restituiti o num_results viene raggiunto.

Se viene specificato num_results e l'account ha più di tale numero di contenitori, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se si desiderano altri risultati.

list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)

Parametri

prefix

str

valore predefinito: None

Filtra i risultati per restituire solo i contenitori i cui nomi iniziano con il prefisso specificato.

num_results

int

valore predefinito: None

Specifica il numero massimo di contenitori da restituire. Una singola richiesta di elenco può restituire fino a 1000 contianer e potenzialmente un token di continuazione che deve essere seguito per ottenere altri resutls.

include_metadata

bool

valore predefinito: False

Specifica che i metadati del contenitore devono essere restituiti nella risposta.

marker

str

valore predefinito: None

Token di continuazione opaco. Questo valore può essere recuperato dal campo next_marker di un oggetto generatore precedente se è stato specificato num_results e tale generatore ha completato l'enumerazione dei risultati. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui il generatore precedente è stato arrestato.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

make_blob_url

Crea l'URL per accedere a un BLOB.

make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)

Parametri

container_name

str

Necessario

Nome del contenitore.

blob_name

str

Necessario

Nome del BLOB.

protocol

str

valore predefinito: None

Protocollo da usare: 'http' o 'https'. Se non specificato, usa il protocollo specificato quando BaseBlobService è stato inizializzato.

sas_token

str

valore predefinito: None

Token di firma di accesso condiviso creato con generate_shared_access_signature.

snapshot

str

valore predefinito: None

Valore stringa che identifica in modo univoco lo snapshot. Il valore di questo parametro di query indica la versione dello snapshot.

Restituisce

URL di accesso al BLOB.

Tipo restituito

str

make_container_url

Crea l'URL per accedere a un contenitore.

make_container_url(container_name, protocol=None, sas_token=None)

Parametri

container_name

str

Necessario

Nome del contenitore.

protocol

str

valore predefinito: None

Protocollo da usare: 'http' o 'https'. Se non specificato, usa il protocollo specificato quando BaseBlobService è stato inizializzato.

sas_token

str

valore predefinito: None

Token di firma di accesso condiviso creato con generate_shared_access_signature.

Restituisce

URL di accesso al contenitore.

Tipo restituito

str

release_blob_lease

Rilascia il lease. Il lease può essere rilasciato se l'ID specificato nella richiesta corrisponde a quello associato al Blob. In seguito al rilascio del lease un altro client può immediatamente acquisire il lease del Blob al termine del rilascio.

release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

lease_id

str

Necessario

ID lease per il lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

release_container_lease

Rilascia il lease. Il lease può essere rilasciato se il lease_id specificato corrisponde a quello associato al contenitore. In seguito al rilascio del lease un altro client può immediatamente acquisire il lease del contenitore al termine del rilascio.

release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_id

str

Necessario

ID lease per il lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

renew_blob_lease

Rinnova il lease. Il lease può essere rinnovato se l'ID specificato nella richiesta corrisponde a quello associato al Blob. Si noti che il lease può essere rinnovato anche se è scaduto, purché il Blob non sia stato modificato o non sia stato associato a un nuovo lease dopo la scadenza di quello corrente. Quando si rinnova un lease, la durata del lease viene reimpostata.

renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

lease_id

str

Necessario

ID lease per il lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

str

renew_container_lease

Rinnova il lease. Il lease può essere rinnovato se l'ID lease specificato corrisponde a quello associato al contenitore. Si noti che il lease può essere rinnovato anche se è scaduto, purché il contenitore non sia stato associato a un nuovo lease dopo la scadenza di quello corrente. Quando si rinnova un lease, la durata del lease viene reimpostata.

renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

lease_id

str

Necessario

ID lease per il lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

str

set_blob_metadata

Imposta i metadati definiti dall'utente per il BLOB specificato come una o più coppie nome-valore.

set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

metadata

dict(str, str)

valore predefinito: None

Dict contenente coppie nome e valore. Ogni chiamata a questa operazione sostituisce tutti i metadati esistenti collegati al Blob. Per rimuovere tutti i metadati dal Blob, chiamare questa operazione senza intestazioni dei metadati.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Crittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito su HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione protetta per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

ETag e proprietà dell'ultima modifica per il BLOB aggiornato

Tipo restituito

ResourceProperties

set_blob_properties

Imposta le proprietà di sistema nel BLOB. Se per la content_settings è impostata una proprietà, tutte le proprietà verranno sostituite.

set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

content_settings

ContentSettings

valore predefinito: None

Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

if_modified_since

datetime

valore predefinito: None

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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Crittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito su HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione protetta per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

ETag e proprietà dell'ultima modifica per il BLOB aggiornato

Tipo restituito

ResourceProperties

set_blob_service_properties

Imposta le proprietà del servizio BLOB di un account di archiviazione, tra cui Azure Analisi archiviazione. Se un elemento (ex Logging) viene lasciato come None, le impostazioni esistenti nel servizio per tale funzionalità vengono mantenute.

set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)

Parametri

logging

Logging

valore predefinito: None

Raggruppa le impostazioni di registrazione di Azure Analytics.

hour_metrics

Metrics

valore predefinito: None

Le impostazioni delle metriche orarie forniscono un riepilogo delle statistiche delle richieste raggruppate per API in aggregazioni orarie per i BLOB.

minute_metrics

Metrics

valore predefinito: None

Le impostazioni delle metriche minuti forniscono le statistiche delle richieste per ogni minuto per i BLOB.

cors

list(CorsRule)

valore predefinito: None

È possibile includere fino a cinque elementi CorsRule nell'elenco. Se viene specificato un elenco vuoto, tutte le regole CORS verranno eliminate e CORS verrà disabilitata per il servizio.

target_version

str

valore predefinito: None

Indica la versione predefinita da usare per le richieste se non è specificata la versione di una richiesta in ingresso.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

delete_retention_policy

DeleteRetentionPolicy

valore predefinito: None

Il criterio di conservazione elimina specifica se conservare i BLOB eliminati. Specifica anche il numero di giorni e versioni del BLOB da mantenere.

static_website

StaticWebsite

valore predefinito: None

Specifica se la funzionalità del sito Web statico è abilitata e, se sì, indica il documento di errore di indice e 404 da usare.

set_container_acl

Imposta le autorizzazioni per il contenitore specificato o i criteri di accesso archiviati che possono essere usati con firme di accesso condiviso. Le autorizzazioni indicano se i BLOB di un contenitore sono accessibili pubblicamente.

set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

signed_identifiers

dict(str, AccessPolicy)

valore predefinito: None

Dizionario dei criteri di accesso da associare al contenitore. Il dizionario può contenere fino a 5 elementi. Un dizionario vuoto cancella i criteri di accesso impostati nel servizio.

public_access

PublicAccess

valore predefinito: None

I valori possibili includono: contenitore, BLOB.

lease_id

str

valore predefinito: None

Se specificato, set_container_acl ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.

if_modified_since

datetime

valore predefinito: None

Valore datetime. Azure prevede che il valore di 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 dopo la data/ora specificata.

if_unmodified_since

datetime

valore predefinito: None

Valore datetime. Azure prevede che il valore di 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 l'ora e la data specificate.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

ETag e ultime proprietà modificate per il contenitore aggiornato

Tipo restituito

ResourceProperties

set_container_metadata

Imposta una o più coppie nome-valore definite dall'utente per il contenitore specificato. Ogni chiamata a questa operazione sostituisce tutti i metadati esistenti collegati al contenitore. Per rimuovere tutti i metadati dal contenitore, chiamare questa operazione senza metadati.

set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

metadata

dict(str, str)

valore predefinito: None

Un dict contenente coppie nome-valore da associare al contenitore come metadati. Esempio: {'category':'test'}

lease_id

str

valore predefinito: None

Se specificato, set_container_metadata ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.

if_modified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 dopo l'ora specificata.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

ETag e ultime proprietà modificate per il contenitore aggiornato

Tipo restituito

ResourceProperties

set_proxy

Imposta l'host del server proxy e la porta per http CONNECT Tunnelling.

set_proxy(host, port, user=None, password=None)

Parametri

host

str

Necessario

Indirizzo del proxy. Ex: '192.168.0.100'

port

int

Necessario

Porta del proxy. Ex: 6000

user

str

valore predefinito: None

Utente per l'autorizzazione proxy.

password

str

valore predefinito: None

Password per l'autorizzazione proxy.

snapshot_blob

Crea uno snapshot di sola lettura di un BLOB.

snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

metadata

dict(str, str)

valore predefinito: None

Specifica una coppia nome-valore definito dall'utente associata al Blob. Se non vengono specificate coppie nome-valore, i metadati del Blob di base verranno copiati nello snapshot. Se vengono specificate una o più coppie nome-valore, lo snapshot viene creato con i metadati specificati e i metadati non vengono copiati dal Blob di base.

if_modified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 dopo l'ora specificata.

if_unmodified_since

datetime

valore predefinito: None

Valore DateTime. Azure prevede che il valore di 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 l'ora e la data specificate.

if_match

str

valore predefinito: None

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

if_none_match

str

valore predefinito: None

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 ed eseguire l'operazione se esiste.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

cpk

CustomerProvidedEncryptionKey

valore predefinito: None

Crittografa i dati sul lato servizio con la chiave specificata. L'uso delle chiavi fornite dal cliente deve essere eseguito tramite HTTPS. Poiché la chiave di crittografia stessa viene fornita nella richiesta, è necessario stabilire una connessione sicura per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

proprietà snapshot

Tipo restituito

Blob

undelete_blob

L'operazione BLOB annulla il ripristino del contenuto e dei metadati di BLOB o snapshot eliminati temporanea. Il tentativo di annullare l'eliminazione di un BLOB o di uno snapshot non temporanea avrà esito positivo senza modifiche.

undelete_blob(container_name, blob_name, timeout=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Attributi

protocol

request_session

socket_timeout

MAX_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432