AppendBlobService Classe
Un BLOB di accodamento è costituito da blocchi ed è ottimizzato per le operazioni di accodamento. Quando si modifica un BLOB di accodamento, i blocchi vengono aggiunti alla fine del BLOB solo tramite l'operazione di append_block. L'aggiornamento o l'eliminazione di blocchi esistenti non sono supportati. A differenza di un BLOB a blocchi, un BLOB di accodamento non espone i relativi ID di blocco.
Ogni blocco in un BLOB di accodamento può essere di dimensioni diverse, fino a un massimo di 4 MB e un BLOB di accodamento può includere fino a 50.000 blocchi. La dimensione massima di un blob di accodamento è pertanto leggermente superiore a 195 GB (4 MB X 50.000 blocchi).
:type ~azure.storage.common.TokenCredential
- Ereditarietà
-
AppendBlobService
Costruttore
AppendBlobService(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
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
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
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
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
Protocollo da usare per le richieste. Impostazioni predefinite su https.
- endpoint_suffix
- str
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
Dominio personalizzato da usare. Questo può essere impostato nel portale di Azure. Ad esempio, "www.mydomain.com".
- request_session
- <xref:requests.Session>
Oggetto sessione da usare per le richieste http.
- connection_string
- str
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
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
Credenziali del token usate per autenticare le richieste HTTPS. Il valore del token deve essere aggiornato prima della scadenza.
Variabili
- MAX_BLOCK_SIZE
- int
Dimensioni dei blocchi inseriti dai metodi append_blob_from_*. I blocchi più piccoli possono essere inseriti se sono disponibili meno dati. La dimensione massima del blocco supportata dal servizio è 4 MB.
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. |
| append_blob_from_bytes |
Aggiunge al contenuto di un BLOB esistente da una matrice di byte, con notifiche automatiche di blocchi e stato. |
| append_blob_from_path |
Aggiunge al contenuto di un BLOB esistente da un percorso file, con notifiche automatiche di blocchi e stato. |
| append_blob_from_stream |
Aggiunge al contenuto di un BLOB esistente da un file/flusso, con notifiche automatiche di blocchi e stato. |
| append_blob_from_text |
Aggiunge al contenuto di un BLOB esistente da str/unicode, con notifiche automatiche di blocchi e stato. |
| append_block |
Esegue il commit di un nuovo blocco di dati alla fine di un BLOB di accodamento esistente. |
| append_block_from_url |
Crea un nuovo blocco di cui eseguire il commit come parte di un BLOB, in cui il contenuto viene letto da un URL di origine. |
| batch_delete_blobs |
Invia un batch di più richieste di eliminazione BLOB. Il metodo di eliminazione del BLOB elimina il BLOB o lo snapshot specificato. Si noti che l'eliminazione di un BLOB comporta anche l'eliminazione di tutti i relativi snapshot. Per altre informazioni, vedere https://docs.microsoft.com/rest/api/storageservices/delete-blob. |
| break_blob_lease |
Interrompe il lease, se il BLOB ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato un ID lease corrispondente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease ad eccezione dell'interruzione e del rilascio nel BLOB. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease. Anche un lease interrotto può essere rilasciato, nel qual caso un altro client può immediatamente acquisire il lease sul Blob. |
| break_container_lease |
Interrompere il lease, se il contenitore ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato un ID lease corrispondente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease ad eccezione di interruzione e rilascio nel contenitore. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease. |
| change_blob_lease |
Modifica l'ID lease di un lease attivo. Una modifica deve includere l'ID lease corrente e un nuovo ID lease. |
| change_container_lease |
Modificare l'ID lease di un lease attivo. Una modifica deve includere l'ID lease corrente e un nuovo ID lease. |
| copy_blob |
Copia un BLOB in modo asincrono. Questa operazione restituisce un oggetto proprietà dell'operazione di copia, incluso un ID copia che è possibile utilizzare per controllare o interrompere l'operazione di copia. Il servizio Blob viene copiato secondo il principio del best effort. Il BLOB di origine per un'operazione di copia può essere un BLOB in blocchi, un BLOB di accodamento o un BLOB di pagine. Se il Blob di destinazione esiste già, deve essere dello stesso tipo del Blob di origine. Eventuali Blob di destinazione esistenti verranno sovrascritti. Non è possibile modificare il Blob di destinazione se è in corso un'operazione di copia. Quando si copia da un BLOB di pagine, il servizio BLOB crea un BLOB di pagine di destinazione della lunghezza del BLOB di origine, che inizialmente contiene tutti gli zere. Verranno enumerati gli intervalli di pagine di origine e verranno copiati gli intervalli non vuoti. Per un BLOB in blocchi o un BLOB di accodamento, il servizio BLOB crea un BLOB di cui è stato eseguito il commit di lunghezza zero prima di restituire da questa operazione. Quando si copia da un BLOB in blocchi, vengono copiati tutti i blocchi di cui è stato eseguito il commit e i relativi ID di blocco. I blocchi di cui non è stato eseguito il commit non vengono copiati. Al termine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi di cui è stato eseguito il commit dell'origine. Quando si copia da un BLOB di accodamento, vengono copiati tutti i blocchi di cui è stato eseguito il commit. Al termine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi di cui è stato eseguito il commit dell'origine. Per tutti i tipi di BLOB, è possibile chiamare get_blob_properties nel BLOB di destinazione per controllare lo stato dell'operazione di copia. Al termine della copia, verrà eseguito il commit del Blob finale. |
| create_blob |
Crea un BLOB o esegue l'override di un BLOB esistente. Usare if_none_match=* per impedire l'override di un BLOB esistente. Vedere create_blob_from_* per le funzioni di alto livello che gestiscono la creazione e il caricamento di BLOB di grandi dimensioni 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 di blocco e stato automatiche. Restituisce un'istanza di Blob con proprietà, metadati e contenuto. |
| get_container_acl |
Ottiene le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i dati del contenitore sono accessibili pubblicamente. |
| get_container_metadata |
Restituisce tutti i metadati definiti dall'utente per il contenitore specificato. |
| get_container_properties |
Restituisce tutti i metadati e le proprietà di sistema definiti dall'utente 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 del servizio per la riuscita della richiesta. |
| list_blob_names |
Restituisce un generatore per elencare i nomi dei BLOB nel contenitore specificato. Il generatore seguirà in modo più pigro i token di continuazione restituiti dal servizio e arresterà quando tutti i BLOB sono stati restituiti o num_results viene raggiunto. Se viene specificato num_results e l'account ha più di quel numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se sono desiderati altri risultati. |
| list_blobs |
Restituisce un generatore per elencare i BLOB nel contenitore specificato. Il generatore seguirà in modo più pigro i token di continuazione restituiti dal servizio e arresterà quando tutti i BLOB sono stati restituiti o num_results viene raggiunto. Se viene specificato num_results e l'account ha più di quel numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se sono desiderati altri risultati. |
| list_containers |
Restituisce un generatore per elencare i contenitori nell'account specificato. Il generatore seguirà in modo più pigro i token di continuazione restituiti dal servizio e arresterà quando tutti i contenitori sono stati restituiti o num_results viene raggiunto. Se viene specificato num_results e l'account ha più di quel numero di contenitori, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se si desiderano altri risultati. |
| make_blob_url |
Crea l'URL per accedere a un BLOB. |
| make_container_url |
Crea l'URL per accedere a un contenitore. |
| release_blob_lease |
Rilascia il lease. Il lease può essere rilasciato se l'ID specificato nella richiesta corrisponde a quello associato al Blob. In seguito al rilascio del lease un altro client può immediatamente acquisire il lease del Blob al termine del rilascio. |
| release_container_lease |
Rilascia il lease. Il lease può essere rilasciato se il lease_id specificato corrisponde a quello associato al contenitore. In seguito al rilascio del lease un altro client può immediatamente acquisire il lease del contenitore al termine del rilascio. |
| renew_blob_lease |
Rinnova il lease. Il lease può essere rinnovato se l'ID specificato nella richiesta corrisponde a quello associato al Blob. Si noti che il lease può essere rinnovato anche se è scaduto, purché il Blob non sia stato modificato o non sia stato associato a un nuovo lease dopo la scadenza di quello corrente. Quando si rinnova un lease, la durata del lease viene reimpostata. |
| renew_container_lease |
Rinnova il lease. Il lease può essere rinnovato se l'ID lease specificato corrisponde a quello associato al contenitore. Si noti che il lease può essere rinnovato anche se è scaduto, purché il contenitore non sia stato associato a un nuovo lease dopo la scadenza di quello corrente. Quando si rinnova un lease, la durata del lease viene reimpostata. |
| set_blob_metadata |
Imposta i metadati definiti dall'utente per il BLOB specificato come una o più coppie nome-valore. |
| set_blob_properties |
Imposta le proprietà di sistema nel BLOB. Se 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. |
| snapshot_blob |
Crea uno snapshot di sola lettura di un BLOB. |
| undelete_blob |
L'operazione BLOB annulla il ripristino del contenuto e dei metadati di BLOB o snapshot eliminati temporanea. Il tentativo di annullare l'eliminazione di un BLOB o di uno snapshot non temporanea avrà esito positivo senza modifiche. |
abort_copy_blob
Interrompe un'operazione di copy_blob in sospeso e lascia un BLOB di destinazione con lunghezza zero e metadati completi.
abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)Parametri
- copy_id
- str
Identificatore di copia fornito nella copy.id dell'operazione di copy_blob originale.
- lease_id
- str
Obbligatoria se il Blob di destinazione presenta un lease infinito attivo.
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
- lease_duration
- int
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
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 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 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 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 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.
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
- lease_duration
- int
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
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 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 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.
Restituisce
str
append_blob_from_bytes
Aggiunge al contenuto di un BLOB esistente da una matrice di byte, con notifiche automatiche di blocchi e stato.
append_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, validate_content=False, maxsize_condition=None, progress_callback=None, lease_id=None, timeout=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, cpk=None)Parametri
- count
- int
Numero di byte da caricare. Impostare su Nessuna o valore negativo per caricare tutti i byte a partire dall'indice.
- validate_content
- bool
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.
- maxsize_condition
- int
Intestazione condizionale facoltativa. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block causa il superamento del limite del BLOB o se la dimensione del BLOB è già maggiore del valore specificato in questa intestazione, la richiesta avrà esito negativo con l'errore MaxBlobSizeConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
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.
- timeout
- int
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.
- if_modified_since
- datetime
Valore DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 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 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.
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.
Restituisce
ETag e ultime proprietà modificate per il BLOB di accodamento
Tipo restituito
append_blob_from_path
Aggiunge al contenuto di un BLOB esistente da un percorso file, con notifiche automatiche di blocchi e stato.
append_blob_from_path(container_name, blob_name, file_path, validate_content=False, maxsize_condition=None, progress_callback=None, lease_id=None, timeout=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, cpk=None)Parametri
- validate_content
- bool
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.
- maxsize_condition
- int
Intestazione condizionale facoltativa. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block causa il superamento del limite del BLOB o se la dimensione del BLOB è già maggiore del valore specificato in questa intestazione, la richiesta avrà esito negativo con l'errore MaxBlobSizeConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
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.
- timeout
- int
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.
- if_modified_since
- datetime
Valore DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 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 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.
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.
Restituisce
ETag e ultime proprietà modificate per il BLOB di accodamento
Tipo restituito
append_blob_from_stream
Aggiunge al contenuto di un BLOB esistente da un file/flusso, con notifiche automatiche di blocchi e stato.
append_blob_from_stream(container_name, blob_name, stream, count=None, validate_content=False, maxsize_condition=None, progress_callback=None, lease_id=None, timeout=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, cpk=None)Parametri
- count
- int
Numero di byte da leggere dal flusso. Questo è facoltativo, ma deve essere fornito per prestazioni ottimali.
- validate_content
- bool
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.
- maxsize_condition
- int
Intestazione condizionale. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block causa il superamento del limite del BLOB o se la dimensione del BLOB è già maggiore del valore specificato in questa intestazione, la richiesta avrà esito negativo con l'errore MaxBlobSizeConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
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.
- timeout
- int
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.
- if_modified_since
- datetime
Valore DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 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 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.
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.
Restituisce
ETag e ultime proprietà modificate per il BLOB di accodamento
Tipo restituito
append_blob_from_text
Aggiunge al contenuto di un BLOB esistente da str/unicode, con notifiche automatiche di blocchi e stato.
append_blob_from_text(container_name, blob_name, text, encoding='utf-8', validate_content=False, maxsize_condition=None, progress_callback=None, lease_id=None, timeout=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, cpk=None)Parametri
- validate_content
- bool
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.
- maxsize_condition
- int
Intestazione condizionale facoltativa. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block causa il superamento del limite del BLOB o se la dimensione del BLOB è già maggiore del valore specificato in questa intestazione, la richiesta avrà esito negativo con l'errore MaxBlobSizeConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
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.
- timeout
- int
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.
- if_modified_since
- datetime
Valore DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 DateTime. Azure prevede che il valore di data passato sia UTC. Se il fuso orario è incluso, qualsiasi datatime non UTC verrà convertito 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 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 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.
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.
Restituisce
ETag e ultime proprietà modificate per il BLOB di accodamento
Tipo restituito
append_block
Esegue il commit di un nuovo blocco di dati alla fine di un BLOB di accodamento esistente.
append_block(container_name, blob_name, block, validate_content=False, maxsize_condition=None, appendpos_condition=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametri
- validate_content
- bool
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 è 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.
- maxsize_condition
- int
Intestazione condizionale facoltativa. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block causa il superamento del limite del BLOB o se la dimensione del BLOB è già maggiore del valore specificato in questa intestazione, la richiesta avrà esito negativo con l'errore MaxBlobSizeConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- appendpos_condition
- int
Intestazione condizionale facoltativa, usata solo per l'operazione Append Block. Numero che indica l'offset di byte da confrontare. Append Block avrà esito positivo solo se la posizione di accodamento è uguale a questo numero. In caso contrario, la richiesta avrà esito negativo con l'errore AppendPositionConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- if_modified_since
- datetime
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 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 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 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.
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.
Restituisce
ETag, ultima modifica, offset di accodamento e proprietà del conteggio dei blocchi commit per il BLOB di accodamento aggiornato
Tipo restituito
append_block_from_url
Crea un nuovo blocco di cui eseguire il commit come parte di un BLOB, in cui il contenuto viene letto da un URL di origine.
append_block_from_url(container_name, blob_name, copy_source_url, source_range_start=None, source_range_end=None, source_content_md5=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, maxsize_condition=None, appendpos_condition=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametri
- copy_source_url
- str
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
Questo indica l'inizio dell'intervallo di byte(inclusivo) che deve essere tratto dall'origine di copia.
- source_range_end
- int
Ciò indica la fine dell'intervallo di byte(inclusivo) che deve essere tratto dall'origine di copia.
- source_content_md5
- str
Se specificato, il servizio calcola l'hash MD5 del contenuto del blocco e confronta con questo valore.
- source_if_modified_since
- datetime
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 di origine è stata modificata dall'ora specificata.
- source_if_unmodified_since
- datetime
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 di origine non è stata modificata dopo la data/ora specificata.
- source_if_match
- str
Valore ETag o il carattere jolly (*). Specificare questa intestazione per eseguire l'operazione solo se la risorsa di origine corrisponde al valore specificato.
- source_if_none_match
- str
Valore ETag o carattere jolly (). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa di origine non corrisponde al valore specificato. Specificare il carattere jolly () per eseguire l'operazione solo se la risorsa di origine non esiste ed eseguire l'operazione se esiste.
- maxsize_condition
- int
Intestazione condizionale facoltativa. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block causa il superamento del limite del BLOB o se la dimensione del BLOB è già maggiore del valore specificato in questa intestazione, la richiesta avrà esito negativo con l'errore MaxBlobSizeConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- appendpos_condition
- int
Intestazione condizionale facoltativa, usata solo per l'operazione Append Block. Numero che indica l'offset di byte da confrontare. Append Block avrà esito positivo solo se la posizione di accodamento è uguale a questo numero. In caso contrario, la richiesta avrà esito negativo con l'errore AppendPositionConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).
- if_modified_since
- datetime
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 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 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 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.
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.
batch_delete_blobs
Invia un batch di più richieste di eliminazione BLOB.
Il metodo di eliminazione del BLOB elimina il BLOB o lo snapshot specificato. Si noti che l'eliminazione di un BLOB comporta anche l'eliminazione di tutti i relativi snapshot. Per altre informazioni, vedere https://docs.microsoft.com/rest/api/storageservices/delete-blob.
batch_delete_blobs(batch_delete_sub_requests, timeout=None)Parametri
- batch_delete_sub_requests
- list(BatchDeleteSubRequest)
Richieste di eliminazione del BLOB da inviare come batch.
Restituisce
risposta HTTP di eliminazione batch analizzata
Tipo restituito
break_blob_lease
Interrompe il lease, se il BLOB ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato un ID lease corrispondente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease ad eccezione dell'interruzione e del rilascio nel BLOB. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease.
Anche un lease interrotto può essere rilasciato, nel qual caso un altro client può immediatamente acquisire il lease sul Blob.
break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametri
- lease_break_period
- int
Per un'operazione di interruzione, si tratta della durata proposta di secondi che il lease deve continuare prima che venga interrotto, tra 0 e 60 secondi. Questo periodo di interruzione viene utilizzato solo se è più breve del tempo rimanente sul lease. Se più lungo, viene utilizzato il tempo rimanente sul lease. Un nuovo lease sarà disponibile solo dopo la scadenza del periodo di interruzione, è tuttavia possibile che il lease venga mantenuto anche oltre il periodo di interruzione. Se questa intestazione non viene visualizzata con un'operazione di interruzione, un lease a durata fissa si interrompe dopo il periodo di lease rimanente e un lease infinito si interrompe immediatamente.
- if_modified_since
- datetime
Valore 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 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 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 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.
Restituisce
INT
break_container_lease
Interrompere il lease, se il contenitore ha un lease attivo. I lease interrotti non possono essere rinnovati. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato un ID lease corrispondente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease ad eccezione di interruzione e rilascio nel contenitore. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi che deve trascorrere prima che possa essere acquisito un nuovo lease.
break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametri
- lease_break_period
- int
Si tratta della durata proposta di secondi che il lease deve continuare prima che venga interrotto, tra 0 e 60 secondi. Questo periodo di interruzione viene utilizzato solo se è più breve del tempo rimanente sul lease. Se più lungo, viene utilizzato il tempo rimanente sul lease. Un nuovo lease sarà disponibile solo dopo la scadenza del periodo di interruzione, è tuttavia possibile che il lease venga mantenuto anche oltre il periodo di interruzione. Se questa intestazione non viene visualizzata con un'operazione di interruzione, un lease a durata fissa si interrompe dopo il periodo di lease rimanente e un lease infinito si interrompe immediatamente.
- if_modified_since
- datetime
Valore 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 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.
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
- proposed_lease_id
- str
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 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 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 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 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.
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
- proposed_lease_id
- str
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 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 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.
copy_blob
Copia un BLOB in modo asincrono. Questa operazione restituisce un oggetto proprietà dell'operazione di copia, incluso un ID copia che è possibile utilizzare per controllare o interrompere l'operazione di copia. Il servizio Blob viene copiato secondo il principio del best effort.
Il BLOB di origine per un'operazione di copia può essere un BLOB in blocchi, un BLOB di accodamento o un BLOB di pagine. Se il Blob di destinazione esiste già, deve essere dello stesso tipo del Blob di origine. Eventuali Blob di destinazione esistenti verranno sovrascritti. Non è possibile modificare il Blob di destinazione se è in corso un'operazione di copia.
Quando si copia da un BLOB di pagine, il servizio BLOB crea un BLOB di pagine di destinazione della lunghezza del BLOB di origine, che inizialmente contiene tutti gli zere. Verranno enumerati gli intervalli di pagine di origine e verranno copiati gli intervalli non vuoti.
Per un BLOB in blocchi o un BLOB di accodamento, il servizio BLOB crea un BLOB di cui è stato eseguito il commit di lunghezza zero prima di restituire da questa operazione. Quando si copia da un BLOB in blocchi, vengono copiati tutti i blocchi di cui è stato eseguito il commit e i relativi ID di blocco. I blocchi di cui non è stato eseguito il commit non vengono copiati. Al termine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi di cui è stato eseguito il commit dell'origine.
Quando si copia da un BLOB di accodamento, vengono copiati tutti i blocchi di cui è stato eseguito il commit. Al termine dell'operazione di copia, il BLOB di destinazione avrà lo stesso numero di blocchi di cui è stato eseguito il commit dell'origine.
Per tutti i tipi di BLOB, è possibile chiamare get_blob_properties nel BLOB di destinazione per controllare lo stato dell'operazione di copia. Al termine della copia, verrà eseguito il commit del Blob finale.
copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None)Parametri
- blob_name
- str
Nome del BLOB di destinazione. Se il BLOB di destinazione esiste, verrà sovrascritto. In caso contrario, verrà creato.
- copy_source
- str
URL di lunghezza massima di 2 KB che specifica un file o un BLOB di Azure. La codifica del valore deve essere di tipo URL in quanto viene visualizzato in un URI di richiesta. Se l'origine si trova in un altro account, l'origine deve essere pubblica o deve essere autenticata tramite una firma di accesso condiviso. Se l'origine è pubblica, non è necessaria alcuna autenticazione. Esempi: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
Coppie nome-valore associate al Blob come metadati. Se non vengono specificate coppie nome-valore, l'operazione copia i metadati dal BLOB o dal file di origine al BLOB di destinazione. Se vengono specificate una o più coppie nome-valore, il BLOB di destinazione viene creato con i metadati specificati e i metadati non vengono copiati dal BLOB o dal file di origine.
- source_if_modified_since
- datetime
Valore 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 condizionale per copiare il Blob solo se il Blob di origine è stato modificato dopo la data e l'ora specificate.
- source_if_unmodified_since
- datetime
Valore 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 condizionale per copiare il Blob solo se il Blob di origine non è stato modificato dopo la data e l'ora specificate.
- source_if_match
- <xref:ETag>
Valore ETag o il carattere jolly (*). Specificare questa intestazione condizionale per copiare il Blob di origine solo se il relativo valore ETag corrisponde al valore specificato. Se i valori ETag non corrispondono, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita). Questa intestazione non può essere specificata se l'origine è un file di Azure.
- source_if_none_match
- <xref:ETag>
Valore ETag o il carattere jolly (*). Specificare questa intestazione condizionale per copiare il Blob di origine solo se il relativo valore ETag non corrisponde al valore specificato. Se i valori sono identici, tramite il servizio Blob viene restituito il codice di stato 412 (Condizione preliminare non riuscita). Questa intestazione non può essere specificata se l'origine è un file di Azure.
- destination_if_modified_since
- datetime
Valore 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 condizionale per copiare il Blob solo se il Blob di destinazione è stato modificato dopo la data e l'ora specificate. Se il Blob di destinazione non è stato modificato, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita).
- destination_if_unmodified_since
- datetime
Valore 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 condizionale per copiare il Blob solo se il Blob di destinazione non è stato modificato dopo la data e l'ora specificate. Se il Blob di destinazione è stato modificato, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita).
- destination_if_match
- <xref:ETag>
Valore ETag o il carattere jolly (*). Specificare un valore ETag per questa intestazione condizionale per copiare il BLOB solo se il valore ETag specificato corrisponde al valore ETag per un BLOB di destinazione esistente. Se l'ETag per il BLOB di destinazione non corrisponde all'ETag specificato per If-Match, il servizio BLOB restituisce il codice di stato 412 (Precondizione non riuscita).
- destination_if_none_match
- <xref:ETag>
Valore ETag o carattere jolly (). Specificare un valore ETag per questa intestazione condizionale per copiare il BLOB solo se il valore ETag specificato non corrisponde al valore ETag per il BLOB di destinazione. Specificare il carattere jolly () per eseguire l'operazione solo se il BLOB di destinazione non esiste. Se la condizione specificata non viene soddisfatta, il servizio Blob restituisce il codice di stato 412 (Condizione preliminare non riuscita).
- destination_lease_id
- str
L'ID lease specificato per questa intestazione deve corrispondere all'ID lease del Blob di destinazione. Se la richiesta non include l'ID lease o non è valida, l'operazione ha esito negativo e restituisce il codice di stato 412 (Condizione preliminare non riuscita).
- source_lease_id
- str
Specificare questa opzione per eseguire l'operazione Copia BLOB solo se l'ID lease specificato corrisponde all'ID lease attivo del BLOB di origine.
Restituisce
Proprietà dell'operazione di copia, ad esempio stato, origine e ID.
Tipo restituito
create_blob
Crea un BLOB o esegue l'override di un BLOB esistente. Usare if_none_match=* per impedire l'override di un BLOB esistente.
Vedere create_blob_from_* per le funzioni di alto livello che gestiscono la creazione e il caricamento di BLOB di grandi dimensioni con notifiche automatiche di suddivisione in blocchi e stato.
create_blob(container_name, blob_name, content_settings=None, 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
- content_settings
- ContentSettings
Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB.
Coppie nome-valore associate al Blob come metadati.
- if_modified_since
- datetime
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 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 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 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.
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.
Restituisce
ETag e proprietà dell'ultima modifica per il BLOB di accodamento aggiornato
Tipo restituito
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
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.
Dict con name_value coppie da associare al contenitore come metadati. Esempio:{'Category':'test'}
- public_access
- PublicAccess
I valori possibili includono: contenitore, BLOB.
- fail_on_exist
- bool
Specificare se generare un'eccezione quando il contenitore esiste.
Restituisce
True se il contenitore viene creato, False se il contenitore esiste già.
Tipo restituito
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
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB da eliminare.
- delete_snapshots
- DeleteSnapshot
Obbligatoria se al Blob sono associati snapshot.
- if_modified_since
- datetime
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 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 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 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.
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
- fail_not_exist
- bool
Specificare se generare un'eccezione quando il contenitore non esiste.
- lease_id
- str
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 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 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.
Restituisce
True se il contenitore viene eliminato, il contenitore False non esiste.
Tipo restituito
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
- blob_name
- str
Nome di un BLOB. Se Nessuno, il contenitore verrà controllato per l'esistenza.
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot.
Restituisce
Valore booleano che indica se la risorsa esiste.
Tipo restituito
extract_date_and_request_id
static extract_date_and_request_id(retry_context)Parametri
- retry_context
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>
Specifica i tipi di risorsa accessibili con la firma di accesso condiviso dell'account.
- permission
- <xref:AccountPermissions>
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.
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.
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
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
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
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
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB per concedere l'autorizzazione.
- permission
- BlobPermissions
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.
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.
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 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
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
Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https,http. Per i valori possibili, vedere Protocol.
- cache_control
- str
Valore dell'intestazione della risposta per Cache-Control quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_disposition
- str
Valore dell'intestazione della risposta per Content-Disposition quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_encoding
- str
Valore dell'intestazione della risposta per Content-Encoding quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_language
- str
Valore dell'intestazione della risposta per Content-Language quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_type
- str
Valore dell'intestazione della risposta per Content-Type quando si accede alla risorsa usando questa firma di accesso condiviso.
- user_delegation_key
- UserDelegationKey
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
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
- permission
- ContainerPermissions
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.
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.
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 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
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
Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https,http. Per i valori possibili, vedere Protocol.
- cache_control
- str
Valore dell'intestazione della risposta per Cache-Control quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_disposition
- str
Valore dell'intestazione della risposta per Content-Disposition quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_encoding
- str
Valore dell'intestazione della risposta per Content-Encoding quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_language
- str
Valore dell'intestazione della risposta per Content-Language quando si accede alla risorsa usando questa firma di accesso condiviso.
- content_type
- str
Valore dell'intestazione della risposta per Content-Type quando si accede alla risorsa usando questa firma di accesso condiviso.
- user_delegation_key
- UserDelegationKey
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
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
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
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.
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
- snapshot
- str
Il parametro snapshot è un valore opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.
- if_modified_since
- datetime
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 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 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 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.
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.
Restituisce
Dizionario che rappresenta il nome dei metadati BLOB, le coppie valore.
Tipo restituito
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
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.
- if_modified_since
- datetime
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 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 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 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.
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.
Restituisce
un oggetto BLOB, incluse proprietà e metadati.
Tipo restituito
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
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
Restituisce
Statistiche del servizio Blob.
Tipo restituito
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
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.
- start_range
- int
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
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
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>)
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
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.
- if_modified_since
- datetime
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 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 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 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.
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
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
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
- open_mode
- str
Modalità da utilizzare quando si apre il file. Si noti che specificando l'aggiunta solo open_mode impedisce il download parallelo. Pertanto, max_connections deve essere impostato su 1 se viene usato questo open_mode.
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot DEL BLOB da recuperare.
- start_range
- int
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
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
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é 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>)
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
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.
- if_modified_since
- datetime
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 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 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 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.
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
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
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
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot BLOB da recuperare.
- start_range
- int
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
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
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>)
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
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.
- if_modified_since
- datetime
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 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 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 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.
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
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
get_blob_to_text
Scarica un BLOB come testo unicode, con notifiche di blocco e stato automatiche. 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
- snapshot
- str
Il parametro snapshot è un valore DateTime opaco che, quando presente, specifica lo snapshot BLOB da recuperare.
- start_range
- int
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
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
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>)
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
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.
- if_modified_since
- datetime
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 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 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 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.
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
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
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
- lease_id
Se specificato, get_container_acl ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.
Restituisce
Dizionario dei criteri di accesso associati al contenitore. dict of str to AccessPolicy e una proprietà public_access se viene attivato l'accesso pubblico
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
- lease_id
- str
Se specificato, get_container_metadata ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.
Restituisce
Dizionario che rappresenta il nome dei metadati del contenitore, le coppie valore.
Tipo restituito
get_container_properties
Restituisce tutti i metadati e le proprietà di sistema definiti dall'utente 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
- lease_id
- str
Se specificato, get_container_properties ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID.
Restituisce
proprietà per il contenitore specificato all'interno di un oggetto contenitore.
Tipo restituito
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 del servizio per la riuscita della richiesta.
get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)Parametri
- key_expiry_time
- datetime
Valore DateTime. Indica quando la chiave smette di essere valida.
Restituisce
Chiave di delega utente.
Tipo restituito
list_blob_names
Restituisce un generatore per elencare i nomi dei BLOB nel contenitore specificato. Il generatore seguirà in modo più pigro i token di continuazione restituiti dal servizio e arresterà quando tutti i BLOB sono stati restituiti o num_results viene raggiunto.
Se viene specificato num_results e l'account ha più di quel numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se sono desiderati altri risultati.
list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parametri
- prefix
- str
Filtra i risultati in modo che vengano restituiti solo i BLOB i cui nomi iniziano con il prefisso specificato.
- num_results
- int
Specifica il numero massimo di BLOB da restituire, inclusi tutti gli elementi <xref:azure.storage.blob.appendblobservice.BlobPrefix>. Se la richiesta non specifica num_results o specifica un valore maggiore di 5.000, il server restituirà fino a 5.000 elementi. L'impostazione di num_results su un valore minore o uguale a zero genera il codice di risposta di errore 400 (richiesta non valida).
- include
- Include
Specifica uno o più set di dati aggiuntivi da includere nella risposta.
- delimiter
- str
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
Token di continuazione opaco. Questo valore può essere recuperato dal campo next_marker di un oggetto generatore precedente se è stato specificato num_results e che il generatore ha completato l'enumerazione dei risultati. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui è stato arrestato il generatore precedente.
list_blobs
Restituisce un generatore per elencare i BLOB nel contenitore specificato. Il generatore seguirà in modo più pigro i token di continuazione restituiti dal servizio e arresterà quando tutti i BLOB sono stati restituiti o num_results viene raggiunto.
Se viene specificato num_results e l'account ha più di quel numero di BLOB, il generatore avrà un campo next_marker popolato al termine. Questo marcatore può essere usato per creare un nuovo generatore se sono desiderati altri risultati.
list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parametri
- prefix
- str
Filtra i risultati in modo che vengano restituiti solo i BLOB i cui nomi iniziano con il prefisso specificato.
- num_results
- int
Specifica il numero massimo di BLOB da restituire, inclusi tutti gli elementi <xref:azure.storage.blob.appendblobservice.BlobPrefix>. Se la richiesta non specifica num_results o specifica un valore maggiore di 5.000, il server restituirà fino a 5.000 elementi. L'impostazione di num_results su un valore minore o uguale a zero genera il codice di risposta di errore 400 (richiesta non valida).
- include
- Include
Specifica uno o più set di dati aggiuntivi da includere nella risposta.
- delimiter
- str
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
Token di continuazione opaco. Questo valore può essere recuperato dal campo next_marker di un oggetto generatore precedente se è stato specificato num_results e che il generatore ha completato l'enumerazione dei risultati. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui è stato arrestato il generatore precedente.
list_containers
Restituisce un generatore per elencare i contenitori nell'account specificato. Il generatore seguirà in modo più pigro i token di continuazione restituiti dal servizio e arresterà quando tutti i contenitori sono stati restituiti o num_results viene raggiunto.
Se viene specificato num_results e l'account ha più di quel 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
Filtra i risultati per restituire solo contenitori i cui nomi iniziano con il prefisso specificato.
- num_results
- int
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 ulteriori resutls.
- include_metadata
- bool
Specifica che i metadati del contenitore vengono restituiti nella risposta.
- marker
- str
Token di continuazione opaco. Questo valore può essere recuperato dal campo next_marker di un oggetto generatore precedente se è stato specificato num_results e che il generatore ha completato l'enumerazione dei risultati. Se specificato, questo generatore inizierà a restituire i risultati dal punto in cui è stato arrestato il generatore precedente.
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
- protocol
- str
Protocollo da usare: 'http' o 'https'. Se non specificato, usa il protocollo specificato quando BaseBlobService è stato inizializzato.
- sas_token
- str
Token di firma di accesso condiviso creato con generate_shared_access_signature.
- snapshot
- str
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
make_container_url
Crea l'URL per accedere a un contenitore.
make_container_url(container_name, protocol=None, sas_token=None)Parametri
- protocol
- str
Protocollo da usare: 'http' o 'https'. Se non specificato, usa il protocollo specificato quando BaseBlobService è stato inizializzato.
- sas_token
- str
Token di firma di accesso condiviso creato con generate_shared_access_signature.
Restituisce
URL di accesso al contenitore.
Tipo restituito
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
- if_modified_since
- datetime
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 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 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 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.
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
- if_modified_since
- datetime
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 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.
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
- if_modified_since
- datetime
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 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 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 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.
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
- if_modified_since
- datetime
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 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.
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
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.
- if_modified_since
- datetime
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 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 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 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.
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.
Restituisce
ETag e ultime proprietà modificate per il BLOB aggiornato
Tipo restituito
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
- content_settings
- ContentSettings
Oggetto ContentSettings usato per impostare le proprietà BLOB.
- if_modified_since
- datetime
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 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 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 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.
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.
Restituisce
ETag e ultime proprietà modificate per il BLOB aggiornato
Tipo restituito
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
Raggruppa le impostazioni di registrazione di Azure Analytics.
- hour_metrics
- Metrics
Le impostazioni delle metriche orarie forniscono un riepilogo delle statistiche richieste raggruppate dall'API in aggregazioni orarie per i BLOB.
- minute_metrics
- Metrics
Le impostazioni delle metriche minuti forniscono statistiche di richiesta per ogni minuto per i BLOB.
- cors
- list(CorsRule)
È 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
Indica la versione predefinita da usare per le richieste se non è specificata la versione di una richiesta in ingresso.
- delete_retention_policy
- DeleteRetentionPolicy
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
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
- signed_identifiers
- dict(str, AccessPolicy)
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
I valori possibili includono: contenitore, BLOB.
- lease_id
- str
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 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 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.
Restituisce
ETag e ultime proprietà modificate per il contenitore aggiornato
Tipo restituito
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
Un dict contenente coppie nome-valore da associare al contenitore come metadati. Esempio: {'category':'test'}
- lease_id
- str
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 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.
Restituisce
ETag e ultime proprietà modificate per il contenitore aggiornato
Tipo restituito
set_proxy
Imposta l'host del server proxy e la porta per http CONNECT Tunnelling.
set_proxy(host, port, user=None, password=None)Parametri
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
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 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 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 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 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.
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.
Restituisce
proprietà snapshot
Tipo restituito
undelete_blob
L'operazione BLOB annulla il ripristino del contenuto e dei metadati di BLOB o snapshot eliminati temporanea. Il tentativo di annullare l'eliminazione di un BLOB o di uno snapshot non temporanea avrà esito positivo senza modifiche.
undelete_blob(container_name, blob_name, timeout=None)Parametri
Attributi
protocol
request_session
socket_timeout
MAX_BLOCK_SIZE
MAX_BLOCK_SIZE = 4194304MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 4194304MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432
Azure SDK for Python