BlockBlobService Classe

I Blob in blocchi consentono di caricare in modo efficiente Blob di grandi dimensioni. I Blob in blocchi includono blocchi, ognuno dei quali è identificato da un ID di blocco. Per creare o modificare un Blob in blocchi, scrivere un set di blocchi ed eseguirne il commit in base agli ID di blocco. Ogni blocco può avere dimensioni diverse, fino a un massimo di 100 MB e un BLOB in blocchi può includere fino a 50.000 blocchi. La dimensione massima di un BLOB in blocchi è quindi di circa 4,75 TB (100 MB X 50.000 blocchi). Se si scrive un BLOB in blocchi con dimensioni non superiori a 64 MB, è possibile caricarlo interamente con una singola operazione di scrittura; vedere create_blob_from_bytes.

:type ~azure.storage.common.TokenCredential

Ereditarietà

BaseBlobService

BlockBlobService

Costruttore

BlockBlobService(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. Questa operazione viene usata per autenticare le richieste firmate con una chiave account e per costruire l'endpoint di archiviazione. È necessario 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. Questa operazione viene usata per l'autenticazione della chiave condivisa. Se non viene specificato alcun token di firma di accesso condiviso o chiave dell'account, 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 sas sono entrambi specificati, la chiave dell'account verrà usata per firmare. Se non vengono specificati nessuno dei due, verrà usato l'accesso anonimo.

is_emulated

bool

valore predefinito: False

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. Impostazioni predefinite su https.

endpoint_suffix

str

valore predefinito: core.windows.net

Componente di base host dell'URL, meno il nome dell'account. Impostazione predefinita in Azure (core.windows.net). Eseguire l'override di questa opzione per usare il cloud cinese (core.chinacloudapi.cn).

custom_domain

str

valore predefinito: None

Dominio personalizzato da usare. Questo può essere impostato nel portale di Azure. Ad esempio, "www.mydomain.com".

request_session

<xref:requests.Session>

valore predefinito: None

Oggetto sessione da usare 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 stringa di connessione.

socket_timeout

int

valore predefinito: None

Se specificato, verrà eseguito l'override del timeout del socket predefinito. Il timeout specificato è 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_PUT_SIZE

int

Caricamento di dimensioni maggiori supportato in una singola chiamata put. Viene usato dai metodi create_blob_from_* se la lunghezza del contenuto è nota ed è minore di questo valore.

MAX_BLOCK_SIZE

int

Dimensioni dei blocchi inseriti dai metodi create_blob_from_* se la lunghezza del contenuto è sconosciuta o è maggiore di MAX_SINGLE_PUT_SIZE. I blocchi più piccoli possono essere inseriti. La dimensione massima del blocco supportata dal servizio è 100 MB.

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

int

Dimensione minima del blocco in base alla quale viene considerato l'algoritmo di caricamento in blocchi ottimizzato per la memoria. Questo algoritmo è applicabile solo ai metodi create_blob_from_file e create_blob_from_stream e impedirà il buffer completo dei blocchi. Oltre alle dimensioni del blocco, la convalida di ContentMD5 e la crittografia devono essere disabilitate perché queste opzioni richiedono che i blocchi vengano memorizzati nel buffer.

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 BLOB elimina il BLOB o lo snapshot specificati. Si noti che l'eliminazione di un BLOB elimina anche tutti gli snapshot. Per altre informazioni, vedere https://docs.microsoft.com/rest/api/storageservices/delete-blob.
batch_set_standard_blob_tier	Invia un batch di più livelli BLOB a blocchi impostati. Questa API è supportata solo per i BLOB a blocchi in account di archiviazione standard.
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ò essere trascorso, durante il quale non è possibile eseguire alcuna operazione di lease tranne interruzione e 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ò essere trascorso, durante il quale non è possibile eseguire alcuna operazione di lease tranne 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. Questa operazione restituisce un oggetto proprietà dell'operazione di copia. L'operazione di copia può essere configurata per essere un'operazione asincrona, ottimale o un'operazione sincrona. L'origine deve essere un BLOB a blocchi se requires_sync è true. 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 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. È 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. Nome del contenitore di destinazione. Il contenitore deve esistere. :p aram str blob_name: nome del BLOB di destinazione. Se il BLOB di destinazione esiste, verrà sovrascritto. In caso contrario, verrà creato. :p aram str copy_source: 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: ?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram metadati: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblobcoppie 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. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: 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. :p aram datetime source_if_unmodified_since: 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. :p aram ETag source_if_match: valore ETag o carattere jolly (). Specificare questa intestazione condizionale per copiare il BLOB di origine solo se il relativo ETag corrisponde al valore specificato. Se i valori ETag non corrispondono, il servizio BLOB restituisce il codice di stato 412 (Precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è un file di Azure. :p aram ETag source_if_none_match: valore ETag o 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. :p aram datetime destination_if_modified_since: 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). :p aram datetime destination_if_unmodified_since: 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). :p aram ETag destination_if_match: valore ETag o 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). :p aram ETag destination_if_none_match: 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). :p aram str destination_lease_id: 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). :p aram str source_lease_id: specificare questa operazione per eseguire l'operazione Copy BLOB solo se l'ID lease specificato corrisponde all'ID lease attivo del BLOB di origine. :p aram int timeout: il parametro timeout viene espresso in secondi. :p aram bool requires_sync: impone che il servizio non restituirà una risposta fino al completamento della copia. :p aram StandardBlobTier standard_blob_tier: valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, questa operazione è applicabile solo ai BLOB in blocchi negli account di archiviazione standard. :p aram RehydratePriority rehydrate_priority: indica la priorità con cui riattivare un BLOB archiviato :return: Proprietà dell'operazione di copia, ad esempio stato, origine e ID. :rtype: CopyProperties
create_blob_from_bytes	Crea un nuovo BLOB da una matrice di byte o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di blocco e stato.
create_blob_from_path	Crea un nuovo BLOB da un percorso di file o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di blocco e stato.
create_blob_from_stream	Crea un nuovo BLOB da un file/flusso o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di blocco e stato.
create_blob_from_text	Crea un nuovo BLOB da str/unicode o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di suddivisione in blocchi e stato.
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 specificato 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 per il servizio è abilitato un criterio di conservazione di eliminazione, questa operazione elimina softmente il BLOB o lo snapshot e mantiene il BLOB o lo snapshot per il numero di giorni specificato. Dopo il numero specificato di giorni, i dati del BLOB vengono rimossi dal servizio durante l'operazione di Garbage Collection. Blob o snapshot eliminati soft è accessibile tramite l'API List BLOBs specificando l'opzione include=Include.Deleted. È possibile ripristinare un BLOB o uno snapshot eliminati soft usando l'API Annulla eliminazione.
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 suddivisione in 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 blocco 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_block_list	Recupera l'elenco di blocchi caricati come parte di un BLOB in blocchi. Per un Blob vengono mantenuti due elenchi di blocchi: Elenco blocchi di cui è stato eseguito il commit: elenco di blocchi di cui è stato eseguito il commit in un DETERMINATO BLOB con Put Block List. Elenco blocchi di cui non è stato eseguito il commit: elenco di blocchi caricati per un BLOB tramite Put Block, ma che non sono ancora stati sottoposti a commit. Questi blocchi vengono archiviati in Azure in associazione con un Blob, ma non ancora fanno parte di esso.
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.
put_block	Crea un nuovo blocco di cui eseguire il commit come parte di un Blob.
put_block_from_url	Crea un nuovo blocco di cui eseguire il commit come parte di un Blob.
put_block_list	Scrive un Blob specificando l'elenco degli ID blocco che compongono il Blob. Per essere scritto come parte di un BLOB, un blocco deve essere stato scritto correttamente nel server in un'operazione put block precedente. È possibile chiamare Put Block List per aggiornare un BLOB caricando solo i blocchi modificati, quindi eseguendo il commit dei blocchi nuovi e esistenti insieme. È possibile eseguire questa operazione specificando se eseguire il commit di un blocco dall'elenco dei blocchi di cui è stato eseguito il commit o dall'elenco di quelli di cui non è stato eseguito oppure se eseguire il commit della versione del blocco caricata più di recente, indipendentemente dall'elenco a cui appartiene.
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 una proprietà è impostata per la content_settings, 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.
set_standard_blob_tier	Imposta i livelli BLOB a blocchi nel BLOB. Questa API è supportata solo per i BLOB a blocchi in account di archiviazione standard. :p aram RehydratePriority rehydrate_priority: indica la priorità con cui riattivare un BLOB archiviato
snapshot_blob	Crea uno snapshot di sola lettura di un BLOB.
undelete_blob	L'operazione di annullamento dell'eliminazione del BLOB ripristina il contenuto e i metadati del BLOB o dello snapshot eliminati soft. Se si tenta di annullare l'eliminazione di un BLOB o di uno snapshot non eliminato soft, l'operazione 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

Identificatore di copia 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 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.

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

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 BLOB elimina il BLOB o lo snapshot specificati. Si noti che l'eliminazione di un BLOB elimina anche tutti gli 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

Le richieste di eliminazione 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

batch_set_standard_blob_tier

Invia un batch di più livelli BLOB a blocchi impostati. Questa API è supportata solo per i BLOB a blocchi in account di archiviazione standard.

batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)

Parametri

batch_set_blob_tier_sub_requests

list(BatchSetBlobTierSubRequest)

Necessario

La richiesta del livello BLOB in blocchi impostata per l'invio come batch.

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

risposta HTTP del set di batch analizzata che indica se ogni sotto richiesta ha esito positivo.

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ò essere trascorso, durante il quale non è possibile eseguire alcuna operazione di lease tranne interruzione e 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, questa è la 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 di durata fissa si interrompe dopo il periodo di lease rimanente e un'interruzione infinita del lease viene interrotta immediatamente.

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.

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ò essere trascorso, durante il quale non è possibile eseguire alcuna operazione di lease tranne 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 di durata fissa si interrompe dopo il periodo di lease rimanente e un'interruzione infinita del lease viene interrotta immediatamente.

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.

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

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

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

copy_blob

Copia un BLOB. Questa operazione restituisce un oggetto proprietà dell'operazione di copia. L'operazione di copia può essere configurata per essere un'operazione asincrona, ottimale o un'operazione sincrona.

L'origine deve essere un BLOB a blocchi se requires_sync è true. 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 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.

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

Nome del contenitore di destinazione. Il contenitore deve esistere. :p aram str blob_name: nome del BLOB di destinazione. Se il BLOB di destinazione esiste, verrà sovrascritto. In caso contrario, verrà creato. :p aram str copy_source: 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: ?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram metadati: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblobcoppie 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. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: 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. :p aram datetime source_if_unmodified_since: 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. :p aram ETag source_if_match: valore ETag o carattere jolly (). Specificare questa intestazione condizionale per copiare il BLOB di origine solo se il relativo ETag corrisponde al valore specificato. Se i valori ETag non corrispondono, il servizio BLOB restituisce il codice di stato 412 (Precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è un file di Azure. :p aram ETag source_if_none_match: valore ETag o 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. :p aram datetime destination_if_modified_since: 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). :p aram datetime destination_if_unmodified_since: 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). :p aram ETag destination_if_match: valore ETag o 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). :p aram ETag destination_if_none_match: 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). :p aram str destination_lease_id: 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). :p aram str source_lease_id: specificare questa operazione per eseguire l'operazione Copy BLOB solo se l'ID lease specificato corrisponde all'ID lease attivo del BLOB di origine. :p aram int timeout: il parametro timeout viene espresso in secondi. :p aram bool requires_sync: impone che il servizio non restituirà una risposta fino al completamento della copia. :p aram StandardBlobTier standard_blob_tier: valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, questa operazione è applicabile solo ai BLOB in blocchi negli account di archiviazione standard. :p aram RehydratePriority rehydrate_priority: indica la priorità con cui riattivare un BLOB archiviato :return: Proprietà dell'operazione di copia, ad esempio stato, origine e ID. :rtype: CopyProperties

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, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)

Parametri

container_name

str

Necessario

blob_name

Necessario

copy_source

Necessario

metadata

valore predefinito: None

source_if_modified_since

valore predefinito: None

source_if_unmodified_since

valore predefinito: None

source_if_match

valore predefinito: None

source_if_none_match

valore predefinito: None

destination_if_modified_since

valore predefinito: None

destination_if_unmodified_since

valore predefinito: None

destination_if_match

valore predefinito: None

destination_if_none_match

valore predefinito: None

destination_lease_id

valore predefinito: None

source_lease_id

valore predefinito: None

timeout

valore predefinito: None

requires_sync

valore predefinito: None

standard_blob_tier

valore predefinito: None

rehydrate_priority

valore predefinito: None

create_blob_from_bytes

Crea un nuovo BLOB da una matrice di byte o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di blocco e stato.

create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=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, standard_blob_tier=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB da creare o aggiornare.

blob

bytes

Necessario

Contenuto del BLOB come matrice di byte.

index

int

valore predefinito: 0

Avviare l'indice nella matrice di byte.

count

int

valore predefinito: None

Numero di byte da caricare. Impostare su Nessuna o valore negativo per caricare tutti i byte a partire dall'indice.

content_settings

ContentSettings

valore predefinito: None

Oggetto ContentSettings usato per impostare le proprietà BLOB.

metadata

dict(str, str)

valore predefinito: None

Coppie nome-valore associate al Blob come metadati.

validate_content

bool

valore predefinito: False

Se true, calcola un hash MD5 per ogni blocco del BLOB. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che questo hash MD5 non viene archiviato con il Blob.

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 o Nessuno se la dimensione totale è sconosciuta.

max_connections

int

valore predefinito: 2

Numero massimo di connessioni parallele da usare quando la dimensione del BLOB supera 64 MB.

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

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. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

standard_blob_tier

StandardBlobTier

valore predefinito: None

Valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, questa operazione è applicabile solo ai BLOB in blocchi negli account di archiviazione standard.

Restituisce

ETag e ultime proprietà modificate per il BLOB in blocchi

Tipo restituito

ResourceProperties

create_blob_from_path

Crea un nuovo BLOB da un percorso di file o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di blocco e stato.

create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=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, standard_blob_tier=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB da creare o aggiornare.

file_path

str

Necessario

Percorso del file da caricare come contenuto BLOB.

content_settings

ContentSettings

valore predefinito: None

Oggetto ContentSettings usato per impostare le proprietà BLOB.

metadata

dict(str, str)

valore predefinito: None

Coppie nome-valore associate al Blob come metadati.

validate_content

bool

valore predefinito: False

Se true, calcola un hash MD5 per ogni blocco del BLOB. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che questo hash MD5 non viene archiviato con il Blob. Si noti anche che, se abilitato, l'algoritmo di caricamento efficiente per la memoria non verrà usato, perché l'elaborazione dell'hash MD5 richiede il buffering di tutti i blocchi e in questo modo lo scopo dell'algoritmo efficiente per la memoria.

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 o Nessuno se la dimensione totale è sconosciuta.

max_connections

int

valore predefinito: 2

Numero massimo di connessioni parallele da usare quando la dimensione del BLOB supera 64 MB.

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

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. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

standard_blob_tier

StandardBlobTier

valore predefinito: None

Valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, questa operazione è applicabile solo ai BLOB in blocchi negli account di archiviazione standard.

Restituisce

ETag e ultime proprietà modificate per il BLOB in blocchi

Tipo restituito

ResourceProperties

create_blob_from_stream

Crea un nuovo BLOB da un file/flusso o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di blocco e stato.

create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=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, use_byte_buffer=False, standard_blob_tier=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB da creare o aggiornare.

stream

IOBase

Necessario

Apertura del file/flusso per il caricamento come contenuto BLOB.

count

int

valore predefinito: None

Numero di byte da leggere dal flusso. Questo è facoltativo, ma deve essere fornito per prestazioni ottimali.

content_settings

ContentSettings

valore predefinito: None

Oggetto ContentSettings usato per impostare le proprietà BLOB.

metadata

dict(str, str)

valore predefinito: None

Coppie nome-valore associate al Blob come metadati.

validate_content

bool

valore predefinito: False

Se true, calcola un hash MD5 per ogni blocco del BLOB. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che questo hash MD5 non viene archiviato con il Blob. Si noti anche che, se abilitato, l'algoritmo di caricamento efficiente per la memoria non verrà usato, perché l'elaborazione dell'hash MD5 richiede il buffering di tutti i blocchi e in questo modo lo scopo dell'algoritmo efficiente per la memoria.

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 o Nessuno se la dimensione totale è sconosciuta.

max_connections

int

valore predefinito: 2

Numero massimo di connessioni parallele da usare quando la dimensione del BLOB supera 64 MB. Si noti che il caricamento parallelo richiede che il flusso sia ricercabile.

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

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. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

use_byte_buffer

bool

valore predefinito: False

Se True, questo forza l'utilizzo del percorso di caricamento del buffer a blocchi completo originale. Per impostazione predefinita, questo valore è False e utilizza un algoritmo di caricamento di streaming efficiente in base alle condizioni seguenti: il flusso fornito è ricercabile, "require_encryption" è False e MAX_BLOCK_SIZE = MIN_LARGE_BLOCK_UPLOAD_THRESHOLD >. Si considerino gli svantaggi dell'uso di questo approccio. Per ottenere l'efficienza della memoria, un flusso IOBase o un oggetto simile a file viene segmentato in blocchi logici usando un wrapper SubStream. Per leggere i dati corretti, ogni SubStream deve acquisire un blocco in modo che possa cercare in modo sicuro la posizione corretta nel flusso condiviso e sottostante. Se max_connections > 1, la concorrenza comporterà una notevole quantità di ricerca nel flusso sottostante. Per gli input più comuni, ad esempio un oggetto di flusso simile a un file, la ricerca è un'operazione economica e questo non è molto di un problema. Tuttavia, per altre varianti di flussi, questo potrebbe non essere il caso. Il compromesso per l'efficienza della memoria deve essere ponderato sul costo della ricerca con il flusso di input. La classe SubStream tenterà di eseguire il buffer fino a 4 MB internamente per ridurre la quantità di chiamate di ricerca e lettura al flusso sottostante. Ciò è particolarmente utile quando si caricano blocchi più grandi.

standard_blob_tier

StandardBlobTier

valore predefinito: None

Valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, questa operazione è applicabile solo ai BLOB in blocchi negli account di archiviazione standard.

Restituisce

ETag e ultime proprietà modificate per il BLOB in blocchi

Tipo restituito

ResourceProperties

create_blob_from_text

Crea un nuovo BLOB da str/unicode o aggiorna il contenuto di un BLOB esistente, con notifiche automatiche di suddivisione in blocchi e stato.

create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=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, standard_blob_tier=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB da creare o aggiornare.

text

str

Necessario

Testo da caricare nel BLOB.

encoding

str

valore predefinito: utf-8

Codifica Python da usare per convertire il testo in byte.

content_settings

ContentSettings

valore predefinito: None

Oggetto ContentSettings usato per impostare le proprietà BLOB.

metadata

dict(str, str)

valore predefinito: None

Coppie nome-valore associate al Blob come metadati.

validate_content

bool

valore predefinito: False

Se true, calcola un hash MD5 per ogni blocco del BLOB. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che questo hash MD5 non viene archiviato con il Blob.

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 o Nessuno se la dimensione totale è sconosciuta.

max_connections

int

valore predefinito: 2

Numero massimo di connessioni parallele da usare quando la dimensione del BLOB supera 64 MB.

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 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. Questo metodo può effettuare più chiamate al servizio di Azure e il timeout verrà applicato singolarmente a ogni chiamata.

standard_blob_tier

StandardBlobTier

valore predefinito: None

Valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, è applicabile solo ai BLOB in blocchi negli account di archiviazione standard.

Restituisce

ETag e proprietà dell'ultima modifica per il BLOB in blocchi

Tipo restituito

ResourceProperties

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

Dict con name_value coppie 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 il contenitore esiste.

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 specificato 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 per il servizio è abilitato un criterio di conservazione di eliminazione, questa operazione elimina softmente il BLOB o lo snapshot e mantiene il BLOB o lo snapshot per il numero di giorni specificato. Dopo il numero specificato di giorni, i dati del BLOB vengono rimossi dal servizio durante l'operazione di Garbage Collection. Blob o snapshot eliminati soft è accessibile tramite l'API List BLOBs specificando l'opzione include=Include.Deleted. È possibile ripristinare un BLOB o uno snapshot eliminati soft usando l'API Annulla eliminazione.

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

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 suddivisione in 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 è 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_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 in cui scrivere.

open_mode

str

valore predefinito: wb

Modalità da utilizzare 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 blocco 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 è 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_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 quando si decodificano i dati BLOB.

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, 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_block_list

Recupera l'elenco di blocchi caricati come parte di un BLOB in blocchi. Per un Blob vengono mantenuti due elenchi di blocchi:

Elenco blocchi di cui è stato eseguito il commit: elenco di blocchi di cui è stato eseguito il commit in un DETERMINATO BLOB con Put Block List.

Elenco blocchi di cui non è stato eseguito il commit: elenco di blocchi caricati per un BLOB tramite Put Block, ma che non sono ancora stati sottoposti a commit. Questi blocchi vengono archiviati in Azure in associazione con un Blob, ma non ancora fanno parte di esso.

get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=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

Datetime per determinare l'ora di recupero dei blocchi.

block_list_type

str

valore predefinito: None

Specifica se restituire l'elenco dei blocchi di cui è stato eseguito il commit, l'elenco dei blocchi di cui non è stato eseguito il commit o entrambi. I valori validi sono: committed, uncommitted o all.

lease_id

str

valore predefinito: None

Obbligatoria se il Blob presenta un lease attivo.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

Restituisce

list committed e/o blocchi di cui non è stato eseguito il commit per BLOB in blocchi

Tipo restituito

BlobBlockList

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

put_block

Crea un nuovo blocco di cui eseguire il commit come parte di un Blob.

put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB.

block

IOBase oppure <xref:<xref:bytes Content> of <xref:the block.>>

Necessario

Contenuto del blocco.

block_id

str

Necessario

Valore stringa che identifica il blocco. La stringa deve essere minore o uguale a 64 byte. Per un determinato BLOB, il block_id deve avere le stesse dimensioni per ogni blocco.

validate_content

bool

valore predefinito: False

Se true, calcola un hash MD5 del contenuto del blocco. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è particolarmente utile per rilevare bitflips in transito se si usa http anziché https come https (impostazione predefinita) verrà già convalidata. Si noti che questo hash MD5 non viene archiviato con il Blob.

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

put_block_from_url

Crea un nuovo blocco di cui eseguire il commit come parte di un Blob.

put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB.

copy_source_url

str

Necessario

URL dei dati di origine. Può puntare a qualsiasi BLOB o file di Azure, ovvero pubblico o con una firma di accesso condiviso collegata.

source_range_start

int

valore predefinito: None

Indica l'inizio dell'intervallo di byte (inclusi) che deve essere tratto dall'origine della copia.

source_range_end

int

valore predefinito: None

Indica la fine dell'intervallo di byte (inclusi) che deve essere tratto dall'origine della copia.

block_id

str

Necessario

Valore stringa che identifica il blocco. La stringa deve essere minore o uguale a 64 byte. Per un determinato BLOB, il block_id deve avere le stesse dimensioni per ogni blocco.

source_content_md5

str

valore predefinito: None

Se specificato, il servizio calcolerà l'hash MD5 del contenuto del blocco e confronterà con questo valore.

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

put_block_list

Scrive un Blob specificando l'elenco degli ID blocco che compongono il Blob. Per essere scritto come parte di un BLOB, un blocco deve essere stato scritto correttamente nel server in un'operazione put block precedente.

È possibile chiamare Put Block List per aggiornare un BLOB caricando solo i blocchi modificati, quindi eseguendo il commit dei blocchi nuovi e esistenti insieme. È possibile eseguire questa operazione specificando se eseguire il commit di un blocco dall'elenco dei blocchi di cui è stato eseguito il commit o dall'elenco di quelli di cui non è stato eseguito oppure se eseguire il commit della versione del blocco caricata più di recente, indipendentemente dall'elenco a cui appartiene.

put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB esistente.

block_list

list(BlobBlock)

Necessario

Elenco di <xref:azure.storeage.blob.models.BlobBlock> contenente gli ID blocco e lo stato del blocco.

content_settings

ContentSettings

valore predefinito: None

Oggetto ContentSettings utilizzato per impostare le proprietà nel BLOB.

metadata

dict(str, str)

valore predefinito: None

Coppie nome-valore associate al Blob come metadati.

validate_content

bool

valore predefinito: False

Se true, calcola un hash MD5 del contenuto dell'elenco di blocchi. Il servizio di archiviazione controlla l'hash del contenuto dell'elenco di blocchi che è arrivato con l'hash inviato. Questo è particolarmente utile per rilevare bitflips in transito se si usa http anziché https come https (impostazione predefinita) verrà già convalidata. Si noti che questo controllo è associato al contenuto dell'elenco di blocchi e non al contenuto del BLOB stesso.

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 sicura per trasferire la chiave.

timeout

int

valore predefinito: None

Il parametro timeout viene espresso in secondi.

standard_blob_tier

StandardBlobTier

valore predefinito: None

Valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, questa operazione è applicabile solo ai BLOB in blocchi negli account di archiviazione standard.

Restituisce

ETag e ultime proprietà modificate per il BLOB di blocchi aggiornato

Tipo restituito

ResourceProperties

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

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

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

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

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

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

ETag e ultime proprietà modificate per il BLOB aggiornato

Tipo restituito

ResourceProperties

set_blob_properties

Imposta le proprietà di sistema nel BLOB. Se una proprietà è impostata per la content_settings, 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 usato per impostare le proprietà 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 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

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

ETag e ultime proprietà modificate 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 richieste raggruppate dall'API in aggregazioni orarie per i BLOB.

minute_metrics

Metrics

valore predefinito: None

Le impostazioni delle metriche minuti forniscono statistiche di richiesta 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.

set_standard_blob_tier

Imposta i livelli BLOB a blocchi nel BLOB. Questa API è supportata solo per i BLOB a blocchi in account di archiviazione standard.

:p aram RehydratePriority rehydrate_priority: indica la priorità con cui riattivare un BLOB archiviato

set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)

Parametri

container_name

str

Necessario

Nome del contenitore esistente.

blob_name

str

Necessario

Nome del BLOB da aggiornare.

standard_blob_tier

StandardBlobTier

Necessario

Valore del livello BLOB standard su cui impostare il BLOB. Per questa versione della libreria, questa operazione è applicabile solo ai BLOB in blocchi negli account di archiviazione standard.

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.

rehydrate_priority

valore predefinito: None

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

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

proprietà snapshot

Tipo restituito

Blob

undelete_blob

L'operazione di annullamento dell'eliminazione del BLOB ripristina il contenuto e i metadati del BLOB o dello snapshot eliminati soft. Se si tenta di annullare l'eliminazione di un BLOB o di uno snapshot non eliminato soft, l'operazione 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_BLOCK_SIZE

MAX_BLOCK_SIZE = 4194304

MAX_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432

MAX_SINGLE_PUT_SIZE

MAX_SINGLE_PUT_SIZE = 67108864

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305