Condividi tramite


BlobClient Classe

Un client per interagire con un BLOB specifico, anche se tale BLOB potrebbe non esistere ancora.

Per altre configurazioni facoltative, fare clic qui.

Ereditarietà
azure.storage.blob._shared.base_client.StorageAccountHostsMixin
BlobClient
azure.storage.blob._encryption.StorageEncryptionMixin
BlobClient

Costruttore

BlobClient(account_url: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)

Parametri

account_url
str
Necessario

URI dell'account di archiviazione. Per creare un client dato l'URI completo al BLOB, usare il from_blob_url classmethod.

container_name
str
Necessario

Nome del contenitore per il BLOB.

blob_name
str
Necessario

Nome del BLOB con cui interagire. Se specificato, questo valore eseguirà l'override di un valore BLOB specificato nell'URL del BLOB.

snapshot
str
valore predefinito: None

Snapshot BLOB facoltativo in cui operare. Può trattarsi della stringa dell'ID snapshot o della risposta restituita da create_snapshot.

credential
valore predefinito: None

Credenziali con cui eseguire l'autenticazione. Questa opzione è facoltativa se l'URL dell'account ha già un token di firma di accesso condiviso. Il valore può essere una stringa di token di firma di accesso condiviso, un'istanza di AzureSasCredential o AzureNamedKeyCredential da azure.core.credentials, una chiave di accesso condiviso dell'account o un'istanza di una classe TokenCredentials da azure.identity. Se l'URI della risorsa contiene già un token di firma di accesso condiviso, verrà ignorato a favore di una credenziale esplicita

  • tranne nel caso di AzureSasCredential, in cui i token di firma di accesso condiviso in conflitto genereranno un ValoreError. Se si usa un'istanza di AzureNamedKeyCredential, "name" deve essere il nome dell'account di archiviazione e "key" deve essere la chiave dell'account di archiviazione.
api_version
str

Versione dell'API di archiviazione da usare per le richieste. Il valore predefinito è la versione del servizio più recente compatibile con l'SDK corrente. L'impostazione su una versione precedente può comportare una riduzione della compatibilità delle funzionalità.

Novità della versione 12.2.0.

secondary_hostname
str

Nome host dell'endpoint secondario.

max_block_size
int

Dimensione massima del blocco per il caricamento di un BLOB in blocchi in blocchi. Il valore predefinito è 41024 1024o 4 MB.

max_single_put_size
int

Se la dimensione del BLOB è minore o uguale a max_single_put_size, il BLOB verrà caricato con una sola richiesta PUT http. Se le dimensioni del BLOB sono maggiori di max_single_put_size, il BLOB verrà caricato in blocchi. Il valore predefinito è 641024 1024o 64 MB.

min_large_block_upload_threshold
int

La dimensione minima del blocco necessaria per usare l'algoritmo efficiente per la memoria durante il caricamento di un BLOB in blocchi. Il valore predefinito è 41024 1024+1.

use_byte_buffer
bool

Usare un buffer di byte per i caricamenti blob in blocchi. Il valore predefinito è False.

max_page_size
int

Dimensione massima del blocco per il caricamento di un BLOB di pagine. Il valore predefinito è 41024 1024o 4 MB.

max_single_get_size
int

Le dimensioni massime per il download di un BLOB in una singola chiamata, la parte superata verrà scaricata in blocchi (potrebbe essere parallela). Il valore predefinito è 321024 1024o 32 MB.

max_chunk_get_size
int

Dimensione massima del blocco usata per il download di un BLOB. Il valore predefinito è 41024 1024o 4 MB.

version_id
str

Il parametro version id è un valore DateTime opaco su cui, se presente, specifica la versione del BLOB su cui operare.

Metodi

abort_copy

Interrompere un'operazione di copia in corso.

In questo modo verrà lasciato un BLOB di destinazione con lunghezza zero e metadati completi. Verrà generato un errore se l'operazione di copia è già terminata.

acquire_lease

Richiede un nuovo lease.

Se il BLOB non ha un lease attivo, il servizio BLOB crea un lease nel BLOB e restituisce un nuovo lease.

append_block

Esegue il commit di un nuovo blocco di dati alla fine del BLOB di accodamento esistente.

append_block_from_url

Crea un nuovo blocco da eseguire come parte di un BLOB, in cui il contenuto viene letto da un URL di origine.

clear_page

Cancella un intervallo di pagine.

close

Questo metodo consiste nel chiudere i socket aperti dal client. Non è necessario usarlo quando si usa con un gestore di contesto.

commit_block_list

L'operazione Commit Block List scrive un BLOB specificando l'elenco di ID blocchi che costituiscono il BLOB.

create_append_blob

Crea un nuovo BLOB di accodamento. Questa operazione crea un nuovo BLOB di accodamento di lunghezza 0. Il contenuto di qualsiasi BLOB esistente viene sovrascritto con il BLOB di accodamento appena inizializzato. Per aggiungere contenuto al BLOB di accodamento, chiamare il append_block metodo o append_block_from_url .

create_page_blob

Crea un nuovo BLOB di pagine delle dimensioni specificate.

create_snapshot

Crea uno snapshot del BLOB.

Uno snapshot è una versione di sola lettura di un BLOB eseguito in un determinato momento. Può essere letto, copiato o eliminato, ma non modificato. Gli snapshot consentono di eseguire il backup di un BLOB così com'è in un determinato momento.

Uno snapshot di un BLOB ha lo stesso nome del BLOB di base da cui viene eseguito lo snapshot, con un valore DateTime aggiunto per indicare l'ora in cui è stato eseguito lo snapshot.

delete_blob

Contrassegna il Blob 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 delete_blob().

Se un criterio di conservazione di eliminazione è abilitato per il servizio, questa operazione elimina il BLOB e mantiene il BLOB per un numero di giorni specificato. Dopo il numero specificato di giorni, i dati del BLOB vengono rimossi dal servizio durante la Garbage Collection. Il BLOB eliminato temporanea è accessibile tramite list_blobs la specifica dell'opzione include=['deleted'] . Il BLOB eliminato temporanea può essere ripristinato usando <xref:azure.storage.blob.undelete> l'operazione.

delete_immutability_policy

L'operazione Delete Immutability Policy elimina i criteri di non modificabilità nel BLOB.

Novità nella versione 12.10.0: questa operazione è stata introdotta nella versione API '2020-10-02'.

download_blob

Scarica un BLOB in StorageStreamDownloader. Il metodo readall() deve essere usato per leggere tutto il contenuto o readinto() deve essere usato per scaricare il BLOB in un flusso. L'uso di blocchi() restituisce un iteratore che consente all'utente di eseguire l'iterazione del contenuto in blocchi.

exists

Restituisce True se esiste un BLOB con i parametri definiti e restituisce False in caso contrario.

from_blob_url

Creare BLOBClient da un URL BLOB. Questo non supporta l'URL BLOB personalizzato con '/' nel nome DEL BLOB.

from_connection_string

Creare BLOBClient da una stringa di connessione.

get_account_information

Ottiene informazioni correlate all'account di archiviazione in cui risiede il BLOB.

Le informazioni possono essere recuperate anche se l'utente ha una firma di accesso condiviso in un contenitore o un BLOB. Le chiavi nel dizionario restituito includono 'sku_name' e 'account_kind'.

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.

get_blob_tags

L'operazione Get Tags consente agli utenti di ottenere tag in un BLOB o in una versione BLOB specifica o in uno snapshot.

Novità nella versione 12.4.0: questa operazione è stata introdotta nella versione API '2019-12-12'.

get_block_list

L'operazione Get Block List recupera l'elenco di blocchi caricati come parte di un BLOB a blocchi.

get_page_range_diff_for_managed_disk

Restituisce l'elenco di intervalli di pagine validi per un disco gestito o uno snapshot.

Nota

Questa operazione è disponibile solo per gli account del disco gestito.

Novità nella versione 12.2.0: questa operazione è stata introdotta nella versione API '2019-07-07'.

get_page_ranges

DEPRECATO: restituisce l'elenco di intervalli di pagine validi per un BLOB di pagine o uno snapshot di un BLOB di pagine.

list_page_ranges

Restituisce l'elenco di intervalli di pagine validi per un BLOB di pagine o uno snapshot di un BLOB di pagine. Se viene specificato previous_snapshot , il risultato sarà un diff delle modifiche tra il BLOB di destinazione e lo snapshot precedente.

query_blob

Consente agli utenti di selezionare/proiettare i dati di snapshot BLOB/o BLOB fornendo espressioni di query semplici. Queste operazioni restituiscono un BLOBQueryReader, gli utenti devono usare readall() o readinto() per ottenere dati di query.

resize_blob

Ridimensiona un Blob di pagine alle dimensioni specificate.

Se il valore specificato è inferiore alle dimensioni correnti del Blob, tutte le pagine che superano il valore specificato vengono cancellate.

seal_append_blob

L'operazione Seal sigilla il BLOB di accodamento per renderlo di sola lettura.

Novità nella versione 12.4.0.

set_blob_metadata

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

set_blob_tags

L'operazione Imposta tag consente agli utenti di impostare tag in un BLOB o in una versione blob specifica, ma non in uno snapshot. Ogni chiamata a questa operazione sostituisce tutti i tag esistenti collegati al BLOB. Per rimuovere tutti i tag dal BLOB, chiamare questa operazione senza tag impostati.

Novità della versione 12.4.0: questa operazione è stata introdotta nella versione DELL'API '2019-12-12'.

set_http_headers

Imposta le proprietà di sistema nel BLOB.

Se viene impostata una proprietà per il content_settings, tutte le proprietà verranno sostituite.

set_immutability_policy

L'operazione Imposta criteri di immutabilità imposta i criteri di immutabilità nel BLOB.

Novità della versione 12.10.0: questa operazione è stata introdotta nella versione API '2020-10-02'.

set_legal_hold

L'operazione Imposta blocco legale imposta un blocco legale nel BLOB.

Novità nella versione 12.10.0: questa operazione è stata introdotta nella versione API '2020-10-02'.

set_premium_page_blob_tier

Imposta i livelli BLOB di pagina nel BLOB. Questa API è supportata solo per i BLOB di pagine in account Premium.

set_sequence_number

Imposta il numero di sequenza BLOB.

set_standard_blob_tier

Questa operazione imposta il livello su un BLOB a blocchi.

Il livello del BLOB a blocchi determina il tipo di archiviazione Hot/Cool/Archive. Questa operazione non aggiorna l'ETag del BLOB.

stage_block

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

stage_block_from_url

Crea un nuovo blocco da eseguire come parte di un BLOB in cui il contenuto viene letto da un URL.

start_copy_from_url

Copia un BLOB dall'URL specificato.

Questa operazione restituisce un dizionario contenente copy_status e copy_id, che può essere utilizzato per controllare lo stato di o interrompere l'operazione di copia. copy_status avrà esito positivo se la copia è stata completata in modo sincrono o 'in sospeso' se la copia è stata avviata in modo asincrono. Per le copie asincrone, è possibile controllare lo stato eseguendo il polling del get_blob_properties metodo e controllando lo stato della copia. Impostare requires_sync su True per forzare la copia in modo sincrono. 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.

undelete_blob

Ripristina BLOB o snapshot eliminati soft-delete.

L'operazione avrà esito positivo solo se viene usato entro il numero di giorni specificato impostato nei criteri di conservazione di eliminazione.

Se il controllo delle versioni dei BLOB è abilitato, il BLOB di base non può essere ripristinato usando questo metodo. Usare invece start_copy_from_url con l'URL della versione del BLOB che si vuole alzare di livello alla versione corrente.

upload_blob

Crea un nuovo BLOB da un'origine dati con suddivisione automatica in blocchi.

upload_blob_from_url

Crea un nuovo BLOB in blocchi in cui il contenuto del BLOB viene letto da un URL specificato. Il contenuto di un BLOB esistente viene sovrascritto con il nuovo BLOB.

upload_page

L'operazione Carica pagine scrive un intervallo di pagine in un BLOB di pagine.

upload_pages_from_url

L'operazione Carica pagine scrive un intervallo di pagine in un BLOB di pagine in cui il contenuto viene letto da un URL.

abort_copy

Interrompere un'operazione di copia in corso.

In questo modo verrà lasciato un BLOB di destinazione con lunghezza zero e metadati completi. Verrà generato un errore se l'operazione di copia è già terminata.

abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None

Parametri

copy_id
str oppure BlobProperties
Necessario

Operazione di copia da interrompere. Può trattarsi di una stringa ID o di un'istanza di BlobProperties.

Tipo restituito

acquire_lease

Richiede un nuovo lease.

Se il BLOB non ha un lease attivo, il servizio BLOB crea un lease nel BLOB e restituisce un nuovo lease.

acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClient

Parametri

lease_duration
int
Necessario

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

lease_id
str
Necessario

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

if_modified_since
datetime

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

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where nei tag BLOB da usare solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Oggetto BlobLeaseClient.

Tipo restituito

append_block

Esegue il commit di un nuovo blocco di dati alla fine del BLOB di accodamento esistente.

append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

Parametri

data
bytes oppure str oppure Iterable
Necessario

Contenuto del blocco. Può trattarsi di byte, testo, iterabile o di un oggetto simile a un file.

length
int
Necessario

Dimensioni del blocco in byte.

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. Ciò è particolarmente utile per rilevare bitflips in rete se si usa http anziché https, come https (impostazione predefinita), verrà già convalidata. Si noti che questo hash MD5 non viene archiviato con il Blob.

maxsize_condition
int

Intestazione condizionale facoltativa. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block fa sì che il BLOB superi tale limite o se le dimensioni del BLOB siano già maggiori 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).

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

encoding
str

Impostazione predefinita su UTF-8.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API Gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore verrà sottoposto a override se l'ambito a livello di contenitore è configurato per consentire l'override. In caso contrario, verrà generato un errore.

Novità nella versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del BLOB (Etag, ultima modifica, offset di accodamento, conteggio blocchi commit).

Tipo restituito

append_block_from_url

Crea un nuovo blocco da eseguire come parte di un BLOB, in cui il contenuto viene letto da un URL di origine.

append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

Parametri

copy_source_url
str
Necessario

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

source_offset
int
Necessario

Questo indica l'inizio dell'intervallo di byte (inclusivo) che deve essere tratto dall'origine della copia.

source_length
int
Necessario

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

source_content_md5
bytearray

Se specificato, il servizio calcola l'hash MD5 del contenuto del blocco e confronta con questo valore.

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

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag di destinazione o carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza di destinazione da usare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

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

Valore ETag di origine o carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

source_match_condition
MatchConditions

Condizione di corrispondenza di origine da usare sul etag.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API Gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore verrà sottoposto a override se l'ambito a livello di contenitore è configurato per consentire l'override. In caso contrario, verrà generato un errore.

Novità nella versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

source_authorization
str

Eseguire l'autenticazione come entità servizio usando un segreto client per accedere a un BLOB di origine. Assicurarsi che "bearer" sia il prefisso della stringa di source_authorization.

clear_page

Cancella un intervallo di pagine.

clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]

Parametri

offset
int
Necessario

Inizio dell'intervallo di byte da usare per la scrittura in una sezione del BLOB. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

length
int
Necessario

Numero di byte da usare per la scrittura in una sezione del BLOB. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

if_sequence_number_lte
int

Se il numero di sequenza del BLOB è minore o uguale al valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

if_sequence_number_lt
int

Se il numero di sequenza del BLOB è minore del valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

if_sequence_number_eq
int

Se il numero di sequenza del BLOB è uguale al valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where nei tag BLOB da usare solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

cpk
CustomerProvidedEncryptionKey

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

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica).

Tipo restituito

close

Questo metodo consiste nel chiudere i socket aperti dal client. Non è necessario usarlo quando si usa con un gestore di contesto.

close()

commit_block_list

L'operazione Commit Block List scrive un BLOB specificando l'elenco di ID blocchi che costituiscono il BLOB.

commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

Parametri

block_list
list
Necessario

Elenco di Blockblobs.

content_settings
ContentSettings
Necessario

Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo della cache.

metadata
dict[str, str]
Necessario

Coppie nome-valore associate al Blob come metadati.

tags
dict(str, str)

Coppie nome-valore associate al BLOB come tag. I tag fanno distinzione tra maiuscole e minuscole. Il set di tag può contenere al massimo 10 tag. I tasti tag devono essere compresi tra 1 e 128 caratteri e i valori dei tag devono essere compresi tra 0 e 256 caratteri. I caratteri validi per chiave e valore del tag includono: lettere minuscole e maiuscole, cifre (0-9), spazio ( >><<), più (+), meno (-), punto (.), solidus (/), due punti (:), uguale a (=), carattere di sottolineatura (_)

Novità nella versione 12.4.0.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

immutability_policy
ImmutabilityPolicy

Specifica i criteri di immutabilità di un BLOB, di uno snapshot BLOB o di una versione del BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

legal_hold
bool

Specificato se deve essere impostato un blocco a fini giudiziari nel BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

validate_content
bool

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

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where per i tag BLOB da usare solo nel BLOB di destinazione con un valore corrispondente.

Novità nella versione 12.4.0.

standard_blob_tier
StandardBlobTier

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

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API di gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore lo sostituirà se l'ambito a livello di contenitore è configurato per consentire le sostituzioni. In caso contrario, verrà generato un errore.

Novità della versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica).

Tipo restituito

create_append_blob

Crea un nuovo BLOB di accodamento. Questa operazione crea un nuovo BLOB di accodamento di lunghezza 0. Il contenuto di qualsiasi BLOB esistente viene sovrascritto con il BLOB di accodamento appena inizializzato. Per aggiungere contenuto al BLOB di accodamento, chiamare il append_block metodo o append_block_from_url .

create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametri

content_settings
ContentSettings
Necessario

Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo della cache.

metadata
dict(str, str)
Necessario

Coppie nome-valore associate al Blob come metadati.

tags
dict(str, str)

Coppie nome-valore associate al BLOB come tag. I tag fanno distinzione tra maiuscole e minuscole. Il set di tag può contenere al massimo 10 tag. I tasti tag devono essere compresi tra 1 e 128 caratteri e i valori dei tag devono essere compresi tra 0 e 256 caratteri. I caratteri validi per chiave e valore del tag includono: lettere minuscole e maiuscole, cifre (0-9), spazio ( >><<), più (+), meno (-), punto (.), solidus (/), due punti (:), uguale a (=), carattere di sottolineatura (_)

Novità nella versione 12.4.0.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

immutability_policy
ImmutabilityPolicy

Specifica i criteri di immutabilità di un BLOB, di uno snapshot BLOB o di una versione del BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

legal_hold
bool

Specificato se deve essere impostato un blocco a fini giudiziari nel BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API di gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore lo sostituirà se l'ambito a livello di contenitore è configurato per consentire le sostituzioni. In caso contrario, verrà generato un errore.

Novità della versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica).

Tipo restituito

create_page_blob

Crea un nuovo BLOB di pagine delle dimensioni specificate.

create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]

Parametri

size
int
Necessario

Specifica le dimensioni massime per il BLOB di pagine, fino a 1 TB. Le dimensioni del Blob di pagine devono essere allineate a un limite di 512 byte.

content_settings
ContentSettings
Necessario

Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo della cache.

metadata
dict(str, str)
Necessario

Coppie nome-valore associate al Blob come metadati.

premium_page_blob_tier
PremiumPageBlobTier
Necessario

Valore del livello BLOB di pagine su cui impostare il BLOB. Il livello è correlato alle dimensioni del BLOB e al numero di operazioni di I/O al secondo consentite. Questo è applicabile solo ai BLOB di pagine per gli account di archiviazione Premium.

tags
dict(str, str)

Coppie nome-valore associate al BLOB come tag. I tag fanno distinzione tra maiuscole e minuscole. Il set di tag può contenere al massimo 10 tag. I tasti tag devono essere compresi tra 1 e 128 caratteri e i valori dei tag devono essere compresi tra 0 e 256 caratteri. I caratteri validi per chiave e valore del tag includono: lettere minuscole e maiuscole, cifre (0-9), spazio ( >><<), più (+), meno (-), punto (.), solidus (/), due punti (:), uguale a (=), carattere di sottolineatura (_)

Novità nella versione 12.4.0.

sequence_number
int

Solo per i BLOB di pagine. Il numero di sequenza è un valore controllato dall'utente che è possibile utilizzare per tenere traccia delle richieste. Il valore del numero di sequenza deve essere compreso tra 0 e 2^63 - 1. Il valore predefinito è 0.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

immutability_policy
ImmutabilityPolicy

Specifica i criteri di immutabilità di un BLOB, di uno snapshot BLOB o di una versione del BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

legal_hold
bool

Specificato se deve essere impostato un blocco a fini giudiziari nel BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API di gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore lo sostituirà se l'ambito a livello di contenitore è configurato per consentire le sostituzioni. In caso contrario, verrà generato un errore.

Novità della versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica).

Tipo restituito

create_snapshot

Crea uno snapshot del BLOB.

Uno snapshot è una versione di sola lettura di un BLOB eseguito in un determinato momento. Può essere letto, copiato o eliminato, ma non modificato. Gli snapshot consentono di eseguire il backup di un BLOB così com'è in un determinato momento.

Uno snapshot di un BLOB ha lo stesso nome del BLOB di base da cui viene eseguito lo snapshot, con un valore DateTime aggiunto per indicare l'ora in cui è stato eseguito lo snapshot.

create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametri

metadata
dict(str, str)
Necessario

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where per i tag BLOB da usare solo nel BLOB di destinazione con un valore corrispondente.

Novità nella versione 12.4.0.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API di gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore lo sostituirà se l'ambito a livello di contenitore è configurato per consentire le sostituzioni. In caso contrario, verrà generato un errore.

Novità nella versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del BLOB (ID snapshot, Etag e ultima modifica).

Tipo restituito

delete_blob

Contrassegna il Blob 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 delete_blob().

Se un criterio di conservazione di eliminazione è abilitato per il servizio, questa operazione elimina il BLOB e mantiene il BLOB per un numero di giorni specificato. Dopo il numero specificato di giorni, i dati del BLOB vengono rimossi dal servizio durante la Garbage Collection. Il BLOB eliminato temporanea è accessibile tramite list_blobs la specifica dell'opzione include=['deleted'] . Il BLOB eliminato temporanea può essere ripristinato usando <xref:azure.storage.blob.undelete> l'operazione.

delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None

Parametri

delete_snapshots
str
Necessario

Obbligatoria se al Blob sono associati snapshot. I possibili valori sono:

  • "only": elimina solo gli snapshot dei BLOB.

  • "include": elimina il BLOB insieme a tutti gli snapshot.

version_id
str

Il parametro ID versione è un valore DateTime opaco che, quando presente, specifica la versione del BLOB da eliminare.

Novità nella versione 12.4.0.

Questo argomento della parola chiave è stato introdotto nella versione api '2019-12-12'.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Se specificato, delete_blob ha esito positivo solo se il lease del BLOB è attivo e corrisponde a questo ID. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Tipo restituito

delete_immutability_policy

L'operazione Delete Immutability Policy elimina i criteri di non modificabilità nel BLOB.

Novità nella versione 12.10.0: questa operazione è stata introdotta nella versione API '2020-10-02'.

delete_immutability_policy(**kwargs: Any) -> None

Parametri

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Coppie di valori chiave dei tag BLOB.

Tipo restituito

download_blob

Scarica un BLOB in StorageStreamDownloader. Il metodo readall() deve essere usato per leggere tutto il contenuto o readinto() deve essere usato per scaricare il BLOB in un flusso. L'uso di blocchi() restituisce un iteratore che consente all'utente di eseguire l'iterazione del contenuto in blocchi.

download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]

Parametri

offset
int
Necessario

Inizio dell'intervallo di byte da usare per il download di una sezione del BLOB. Deve essere impostato se viene specificata la lunghezza.

length
int
Necessario

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

version_id
str

Il parametro ID versione è un valore DateTime opaco che, quando presente, specifica la versione del BLOB da scaricare.

Novità nella versione 12.4.0.

Questo argomento della parola chiave è stato introdotto nella versione api '2019-12-12'.

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. Ciò è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https, come https (impostazione predefinita), sarà già convalidato. Si noti che questo hash MD5 non viene archiviato con il Blob. Si noti anche che, se abilitato, l'algoritmo di caricamento efficiente per la memoria non verrà usato perché l'elaborazione dell'hash MD5 richiede il buffering di interi blocchi e in questo modo lo scopo dell'algoritmo efficiente per la memoria.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Se specificato, download_blob ha esito positivo solo se il lease del BLOB è attivo e corrisponde a questo ID. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

cpk
CustomerProvidedEncryptionKey

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.

max_concurrency
int

Numero di connessioni parallele con cui scaricare.

encoding
str

Codifica per decodificare i byte scaricati. Il valore predefinito è Nessuna, ad esempio nessuna decodifica.

progress_hook
Callable[[int, int], None]

Callback per tenere traccia dello stato di avanzamento di un download a esecuzione prolungata. La firma è function(current: int, total: int) dove corrente è il numero di byte trasferiti finora e il totale è la dimensione totale del download.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui. Questo metodo può effettuare più chiamate al servizio e il timeout verrà applicato singolarmente a ogni chiamata. più chiamate al servizio di Azure e il timeout si applicano singolarmente a ogni chiamata.

Restituisce

Oggetto di streaming (StorageStreamDownloader)

Tipo restituito

exists

Restituisce True se esiste un BLOB con i parametri definiti e restituisce False in caso contrario.

exists(**kwargs: Any) -> bool

Parametri

version_id
str

Il parametro ID versione è un valore DateTime opaco che, quando presente, specifica la versione del BLOB per verificare se esiste.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

boolean

Tipo restituito

from_blob_url

Creare BLOBClient da un URL BLOB. Questo non supporta l'URL BLOB personalizzato con '/' nel nome DEL BLOB.

from_blob_url(blob_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> Self

Parametri

blob_url
str
Necessario

URL completo dell'endpoint nel BLOB, incluso il token di firma di accesso condiviso e lo snapshot se usato. Questo potrebbe essere l'endpoint primario o l'endpoint secondario a seconda dell'location_mode corrente.

credential
Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
valore predefinito: None

Credenziali con cui eseguire l'autenticazione. Questo è facoltativo se l'URL dell'account ha già un token di firma di accesso condiviso o il stringa di connessione ha già valori di chiave di accesso condiviso. Il valore può essere una stringa di token sas, un'istanza di AzureSasCredential o AzureNamedKeyCredential da azure.core.credential, una chiave di accesso condiviso dell'account o un'istanza di una classe TokenCredentials da azure.identity. Se l'URI della risorsa contiene già un token di firma di accesso condiviso, questo verrà ignorato a favore di una credenziale esplicita

  • tranne nel caso di AzureSasCredential, in cui i token sas in conflitto genereranno un valoreError. Se si usa un'istanza di AzureNamedKeyCredential, "name" deve essere il nome dell'account di archiviazione e "key" deve essere la chiave dell'account di archiviazione.
snapshot
str
valore predefinito: None

Snapshot BLOB facoltativo su cui operare. Questa può essere la stringa ID snapshot o la risposta restituita da create_snapshot. Se specificato, questo eseguirà l'override dello snapshot nell'URL.

version_id
str

Il parametro id versione è un valore DateTime opaco su cui, quando presente, specifica la versione del BLOB da usare.

Restituisce

Client BLOB.

Tipo restituito

from_connection_string

Creare BLOBClient da una stringa di connessione.

from_connection_string(conn_str: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

Parametri

conn_str
str
Necessario

Un stringa di connessione a un account di archiviazione di Azure.

container_name
str
Necessario

Nome del contenitore per il BLOB.

blob_name
str
Necessario

Nome del BLOB con cui interagire.

snapshot
str
valore predefinito: None

Snapshot BLOB facoltativo su cui operare. Questa può essere la stringa ID snapshot o la risposta restituita da create_snapshot.

credential
Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
valore predefinito: None

Credenziali con cui eseguire l'autenticazione. Questo è facoltativo se l'URL dell'account ha già un token di firma di accesso condiviso o il stringa di connessione ha già valori di chiave di accesso condiviso. Il valore può essere una stringa di token sas, un'istanza di AzureSasCredential o AzureNamedKeyCredential da azure.core.credential, una chiave di accesso condiviso dell'account o un'istanza di una classe TokenCredentials da azure.identity. Le credenziali fornite qui avranno la precedenza su quelle presenti nel stringa di connessione. Se si usa un'istanza di AzureNamedKeyCredential, "name" deve essere il nome dell'account di archiviazione e "key" deve essere la chiave dell'account di archiviazione.

version_id
str

Il parametro id versione è un valore DateTime opaco su cui, quando presente, specifica la versione del BLOB da usare.

Restituisce

Client BLOB.

Tipo restituito

get_account_information

Ottiene informazioni correlate all'account di archiviazione in cui risiede il BLOB.

Le informazioni possono essere recuperate anche se l'utente ha una firma di accesso condiviso in un contenitore o un BLOB. Le chiavi nel dizionario restituito includono 'sku_name' e 'account_kind'.

get_account_information(**kwargs: Any) -> Dict[str, str]

Restituisce

Una descrizione delle informazioni sull'account (SKU e tipo di account).

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.

get_blob_properties(**kwargs: Any) -> BlobProperties

Parametri

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

version_id
str

Il parametro ID versione è un valore DateTime opaco che, quando presente, specifica la versione del BLOB per ottenere le proprietà.

Novità nella versione 12.4.0.

Questo argomento della parola chiave è stato introdotto nella versione api '2019-12-12'.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

cpk
CustomerProvidedEncryptionKey

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

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

BlobProperties

Tipo restituito

get_blob_tags

L'operazione Get Tags consente agli utenti di ottenere tag in un BLOB o in una versione BLOB specifica o in uno snapshot.

Novità nella versione 12.4.0: questa operazione è stata introdotta nella versione API '2019-12-12'.

get_blob_tags(**kwargs: Any) -> Dict[str, str]

Parametri

version_id
str

Il parametro id versione è un valore DateTime opaco a cui, quando presente, specifica la versione del BLOB a cui aggiungere tag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB di destinazione con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Coppie di valori chiave dei tag BLOB.

Tipo restituito

get_block_list

L'operazione Get Block List recupera l'elenco di blocchi caricati come parte di un BLOB a blocchi.

get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]

Parametri

block_list_type
str
Necessario

Specifica se restituire l'elenco dei blocchi di cui è stato eseguito il commit, l'elenco dei blocchi di cui non è stato eseguito il commit o entrambi. I valori possibili includono: 'commit', 'uncom commit', 'all'

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB di destinazione con un valore corrispondente.

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Tupla di due elenchi : blocchi commit e non commessi

Tipo restituito

get_page_range_diff_for_managed_disk

Restituisce l'elenco di intervalli di pagine validi per un disco gestito o uno snapshot.

Nota

Questa operazione è disponibile solo per gli account del disco gestito.

Novità nella versione 12.2.0: questa operazione è stata introdotta nella versione API '2019-07-07'.

get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

Parametri

previous_snapshot_url
Necessario

Specifica l'URL di uno snapshot precedente del disco gestito. La risposta conterrà solo pagine modificate tra il BLOB di destinazione e il relativo snapshot precedente.

offset
int
Necessario

Inizio dell'intervallo di byte da usare per ottenere intervalli di pagine validi. Se non viene specificata alcuna lunghezza, tutti i byte dopo l'offset verranno cercati. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

length
int
Necessario

Numero di byte da usare per ottenere intervalli di pagine validi. Se viene specificata la lunghezza, è necessario specificare l'offset. Questo intervallo restituirà intervalli di pagina validi dall'avvio dell'offset alla lunghezza specificata. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Una tupla di due elenchi di intervalli di pagine come dizionari con chiavi 'start' e 'end'. Il primo elemento sono intervalli di pagine riempiti, l'elemento 2nd è deselezionato intervalli di pagina.

Tipo restituito

get_page_ranges

DEPRECATO: restituisce l'elenco di intervalli di pagine validi per un BLOB di pagine o uno snapshot di un BLOB di pagine.

get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

Parametri

offset
int
Necessario

Inizio dell'intervallo di byte da usare per ottenere intervalli di pagine validi. Se non viene specificata alcuna lunghezza, tutti i byte dopo l'offset verranno cercati. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

length
int
Necessario

Numero di byte da usare per ottenere intervalli di pagine validi. Se viene specificata la lunghezza, è necessario specificare l'offset. Questo intervallo restituirà intervalli di pagina validi dall'avvio dell'offset alla lunghezza specificata. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

previous_snapshot_diff
str
Necessario

Parametro diff snapshot che contiene un valore DateTime opaco che specifica uno snapshot BLOB precedente da confrontare con uno snapshot più recente o il BLOB corrente.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Una tupla di due elenchi di intervalli di pagine come dizionari con chiavi 'start' e 'end'. Il primo elemento sono intervalli di pagine riempiti, l'elemento 2nd è deselezionato intervalli di pagina.

Tipo restituito

list_page_ranges

Restituisce l'elenco di intervalli di pagine validi per un BLOB di pagine o uno snapshot di un BLOB di pagine. Se viene specificato previous_snapshot , il risultato sarà un diff delle modifiche tra il BLOB di destinazione e lo snapshot precedente.

list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]

Parametri

offset
int

Inizio dell'intervallo di byte da usare per ottenere intervalli di pagine validi. Se non viene specificata alcuna lunghezza, tutti i byte dopo l'offset verranno cercati. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

length
int

Numero di byte da usare per ottenere intervalli di pagine validi. Se viene specificata la lunghezza, è necessario specificare l'offset. Questo intervallo restituirà intervalli di pagina validi dall'avvio dell'offset alla lunghezza specificata. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

previous_snapshot
str oppure Dict[str, Any]

Valore snapshot che specifica che la risposta conterrà solo pagine modificate tra BLOB di destinazione e snapshot precedente. Le pagine modificate includono pagine aggiornate e cancellate. Il BLOB di destinazione può essere uno snapshot, purché lo snapshot specificato da previous_snapshot sia il meno recente dei due.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

results_per_page
int

Numero massimo di intervalli di pagine da recuperare per chiamata API.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Iterabile (paging automatico) di PageRange.

Tipo restituito

query_blob

Consente agli utenti di selezionare/proiettare i dati di snapshot BLOB/o BLOB fornendo espressioni di query semplici. Queste operazioni restituiscono un BLOBQueryReader, gli utenti devono usare readall() o readinto() per ottenere dati di query.

query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReader

Parametri

query_expression
str
Necessario

Obbligatorio. istruzione query. Per informazioni dettagliate, vedere https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

on_error
Callable[BlobQueryError]

Funzione da chiamare su qualsiasi errore di elaborazione restituito dal servizio.

blob_format
DelimitedTextDialect oppure DelimitedJsonDialect oppure QuickQueryDialect oppure str

facoltativo. Definisce la serializzazione dei dati attualmente archiviati nel BLOB. Il valore predefinito consiste nel trattare i dati BLOB come dati CSV formattati nel dialetto predefinito. È possibile eseguire l'override con un oggetto DelimitedTextDialect personalizzato o DelimitedJsonDialect o "ParquetDialect" (passato come stringa o enumerazione). Questi dialetti possono essere passati attraverso le rispettive classi, l'enumerazione quickQueryDialect o come stringa

output_format
DelimitedTextDialect oppure DelimitedJsonDialect oppure list[ArrowDialect] oppure QuickQueryDialect oppure str

facoltativo. Definisce la serializzazione di output per il flusso di dati. Per impostazione predefinita, i dati verranno restituiti come rappresentati nel BLOB (i formati Parquet sono predefiniti delimitatiTextDialect). Fornendo un formato di output, i dati BLOB verranno formattati in base a tale profilo. Questo valore può essere delimitatoTextDialect o delimitatoJsonDialect o ArrowDialect. Questi dialetti possono essere passati attraverso le rispettive classi, l'enumerazione quickQueryDialect o come stringa

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

cpk
CustomerProvidedEncryptionKey

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

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Oggetto di streaming (BLOBQueryReader)

Tipo restituito

resize_blob

Ridimensiona un Blob di pagine alle dimensioni specificate.

Se il valore specificato è inferiore alle dimensioni correnti del Blob, tutte le pagine che superano il valore specificato vengono cancellate.

resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]

Parametri

size
int
Necessario

Dimensioni usate per ridimensionare IL BLOB. Le dimensioni massime per un BLOB di pagine sono fino a 1 TB. Le dimensioni del Blob di pagine devono essere allineate a un limite di 512 byte.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

premium_page_blob_tier
PremiumPageBlobTier

Valore del livello BLOB di pagina su cui impostare il BLOB. Il livello è correlato alle dimensioni del BLOB e al numero di operazioni di I/O al secondo consentite. Questa operazione è applicabile solo ai BLOB di pagine in account di archiviazione Premium.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del BLOB (Etag e ultima modifica).

Tipo restituito

seal_append_blob

L'operazione Seal sigilla il BLOB di accodamento per renderlo di sola lettura.

Novità nella versione 12.4.0.

seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]

Parametri

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

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del BLOB (Etag, ultima modifica, offset di accodamento, conteggio blocchi commit).

Tipo restituito

set_blob_metadata

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

set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametri

metadata
dict(str, str)
Necessario

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

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where nei tag BLOB da usare solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API di gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore lo sostituirà se l'ambito a livello di contenitore è configurato per consentire le sostituzioni. In caso contrario, verrà generato un errore.

Novità della versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica)

set_blob_tags

L'operazione Imposta tag consente agli utenti di impostare tag in un BLOB o in una versione blob specifica, ma non in uno snapshot. Ogni chiamata a questa operazione sostituisce tutti i tag esistenti collegati al BLOB. Per rimuovere tutti i tag dal BLOB, chiamare questa operazione senza tag impostati.

Novità della versione 12.4.0: questa operazione è stata introdotta nella versione DELL'API '2019-12-12'.

set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]

Parametri

tags
dict(str, str)
Necessario

Coppie nome-valore associate al BLOB come tag. I tag fanno distinzione tra maiuscole e minuscole. Il set di tag può contenere al massimo 10 tag. I tasti tag devono essere compresi tra 1 e 128 caratteri e i valori dei tag devono essere compresi tra 0 e 256 caratteri. I caratteri validi per chiave e valore del tag includono: lettere minuscole e maiuscole, cifre (0-9), spazio ( >><<), più (+), meno (-), punto (.), solidus (/), due punti (:), uguale a (=), carattere di sottolineatura (_)

version_id
str

Il parametro version id è un valore DateTime opaco a cui, se presente, specifica la versione del BLOB a cui aggiungere tag.

validate_content
bool

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

if_tags_match_condition
str

Specificare una clausola SQL where per i tag BLOB da usare solo nel BLOB di destinazione con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica)

Tipo restituito

set_http_headers

Imposta le proprietà di sistema nel BLOB.

Se viene impostata una proprietà per il content_settings, tutte le proprietà verranno sostituite.

set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None

Parametri

content_settings
ContentSettings
Necessario

Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo della cache.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where nei tag BLOB da usare solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica)

Tipo restituito

set_immutability_policy

L'operazione Imposta criteri di immutabilità imposta i criteri di immutabilità nel BLOB.

Novità della versione 12.10.0: questa operazione è stata introdotta nella versione API '2020-10-02'.

set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]

Parametri

immutability_policy
ImmutabilityPolicy
Necessario

Specifica i criteri di immutabilità di un BLOB, di uno snapshot BLOB o di una versione del BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Coppie chiave-valore dei tag BLOB.

Tipo restituito

L'operazione Imposta blocco legale imposta un blocco legale nel BLOB.

Novità nella versione 12.10.0: questa operazione è stata introdotta nella versione API '2020-10-02'.

set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]

Parametri

legal_hold
bool
Necessario

Specificato se deve essere impostato un blocco a fini giudiziari nel BLOB.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Coppie di valori chiave dei tag BLOB.

Tipo restituito

set_premium_page_blob_tier

Imposta i livelli BLOB di pagina nel BLOB. Questa API è supportata solo per i BLOB di pagine in account Premium.

set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None

Parametri

premium_page_blob_tier
PremiumPageBlobTier
Necessario

Valore del livello BLOB di pagina su cui impostare il BLOB. Il livello è correlato alle dimensioni del BLOB e al numero di operazioni di I/O al secondo consentite. Questa operazione è applicabile solo ai BLOB di pagine in account di archiviazione Premium.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

Tipo restituito

set_sequence_number

Imposta il numero di sequenza BLOB.

set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametri

sequence_number_action
str
Necessario

Questa proprietà indica il modo in cui il servizio deve modificare il numero di sequenza del Blob. Per altre informazioni, vedere SequenceNumberAction.

sequence_number
str
Necessario

Questa proprietà consente di impostare il numero di sequenza del Blob. Il numero di sequenza è una proprietà controllata dall'utente che è possibile utilizzare per tenere traccia delle richieste e gestire i problemi di concorrenza.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del BLOB (Etag e ultima modifica).

Tipo restituito

set_standard_blob_tier

Questa operazione imposta il livello su un BLOB a blocchi.

Il livello del BLOB a blocchi determina il tipo di archiviazione Hot/Cool/Archive. Questa operazione non aggiorna l'ETag del BLOB.

set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None

Parametri

standard_blob_tier
str oppure StandardBlobTier
Necessario

Indica il livello da impostare nel BLOB. Le opzioni includono 'Hot', 'Cool', 'Archive'. Il livello ad accesso frequente è ottimizzato per l'archiviazione dei dati a cui si accede di frequente. Il livello di archiviazione ad accesso sporadico è ottimizzato per l'archiviazione dei dati a cui si accede raramente e archiviato per almeno un mese. Il livello di archiviazione è ottimizzato per l'archiviazione dei dati a cui si accede raramente e vengono archiviati per almeno sei mesi con requisiti di latenza flessibili.

rehydrate_priority
RehydratePriority

Indica la priorità con cui riattivare un BLOB archiviato

version_id
str

Il parametro ID versione è un valore DateTime opaco che, quando presente, specifica la versione del BLOB da scaricare.

Novità nella versione 12.4.0.

Questo argomento della parola chiave è stato introdotto nella versione api '2019-12-12'.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

Tipo restituito

stage_block

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

stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]

Parametri

block_id
str
Necessario

Valore stringa che identifica il blocco. La stringa deve essere minore o uguale a 64 byte di dimensioni. Per un BLOB specificato, la block_id deve essere la stessa dimensione per ogni blocco.

data
Necessario

Dati BLOB.

length
int
Necessario

Dimensioni del blocco.

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. Ciò è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https, come https (impostazione predefinita), sarà già convalidato. Si noti che questo hash MD5 non viene archiviato con il Blob. Si noti anche che, se abilitato, l'algoritmo di caricamento efficiente per la memoria non verrà usato perché l'elaborazione dell'hash MD5 richiede il buffering di interi blocchi e in questo modo lo scopo dell'algoritmo efficiente per la memoria.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

encoding
str

Impostazione predefinita su UTF-8.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API Gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore verrà sottoposto a override se l'ambito a livello di contenitore è configurato per consentire l'override. In caso contrario, verrà generato un errore.

Novità nella versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà BLOB dict.

Tipo restituito

stage_block_from_url

Crea un nuovo blocco da eseguire come parte di un BLOB in cui il contenuto viene letto da un URL.

stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]

Parametri

block_id
str
Necessario

Valore stringa che identifica il blocco. La stringa deve essere minore o uguale a 64 byte di dimensioni. Per un BLOB specificato, la block_id deve essere la stessa dimensione per ogni blocco.

source_url
str
Necessario

URL.

source_offset
int
Necessario

Inizio dell'intervallo di byte da usare per il blocco. Deve essere impostato se viene specificata la lunghezza dell'origine.

source_length
int
Necessario

Dimensioni del blocco in byte.

source_content_md5
bytearray
Necessario

Specificare il valore md5 calcolato per l'intervallo di byte che devono essere letti dall'origine di copia.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API Gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore verrà sottoposto a override se l'ambito a livello di contenitore è configurato per consentire l'override. In caso contrario, verrà generato un errore.

Novità nella versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

source_authorization
str

Eseguire l'autenticazione come entità servizio usando un segreto client per accedere a un BLOB di origine. Assicurarsi che "bearer" sia il prefisso della stringa di source_authorization.

Restituisce

Proprietà BLOB dict.

Tipo restituito

start_copy_from_url

Copia un BLOB dall'URL specificato.

Questa operazione restituisce un dizionario contenente copy_status e copy_id, che può essere utilizzato per controllare lo stato di o interrompere l'operazione di copia. copy_status avrà esito positivo se la copia è stata completata in modo sincrono o 'in sospeso' se la copia è stata avviata in modo asincrono. Per le copie asincrone, è possibile controllare lo stato eseguendo il polling del get_blob_properties metodo e controllando lo stato della copia. Impostare requires_sync su True per forzare la copia in modo sincrono. 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.

start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]

Parametri

source_url
str
Necessario

URL di fino a 2 KB di lunghezza che specifica un file o un BLOB. 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/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

metadata
dict(str, str)
Necessario

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

incremental_copy
bool
Necessario

Copia lo snapshot del BLOB della pagina di origine in un BLOB di pagine di destinazione. Lo snapshot viene copiato in modo che solo le modifiche differenziali tra lo snapshot copiato in precedenza vengano trasferite alla destinazione. Gli snapshot copiati sono copie complete dello snapshot originale e possono essere letti o copiati da come di consueto. Il valore predefinito è False.

tags
dict(str, str) oppure Literal["COPY"]

Coppie nome-valore associate al BLOB come tag. I tag sono distinzione tra maiuscole e minuscole. Il set di tag può contenere al massimo 10 tag. Le chiavi tag devono essere comprese tra 1 e 128 caratteri e i valori dei tag devono essere compresi tra 0 e 256 caratteri. I caratteri chiave e valore validi includono: lettere minuscole e maiuscole, cifre (0-9 >><<), spazio (), più (+), meno (-), punto (.), solidus (/), punti (:), uguale (=), sottolineatura (_).

Il valore letterale (con distinzione tra maiuscole e minuscole) "COPY" può invece essere passato per copiare i tag dal BLOB di origine. Questa opzione è disponibile solo quando incremental_copy=False e requires_sync=True.

Novità nella versione 12.4.0.

immutability_policy
ImmutabilityPolicy

Specifica i criteri di non modificabilità di una versione BLOB, snapshot BLOB o BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione api '2020-10-02'.

legal_hold
bool

Specificato se un blocco legale deve essere impostato nel BLOB.

Novità nella versione 12.10.0: è stata introdotta nella versione api '2020-10-02'.

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 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 di data passato sia UTC. Se il fuso orario è incluso, le datetime non UTC verranno convertite in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC. Specificare questa intestazione condizionale per copiare il Blob solo se il Blob di origine non è stato modificato dopo la data e l'ora specificate.

source_etag
str

Valore ETag di origine o carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

source_match_condition
MatchConditions

Condizione di corrispondenza di origine da usare sul etag.

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

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

etag
str

Valore ETag di destinazione o carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza di destinazione da usare sul etag.

destination_lease
BlobLeaseClient oppure 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
BlobLeaseClient oppure str

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

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

premium_page_blob_tier
PremiumPageBlobTier

Valore del livello BLOB di pagina su cui impostare il BLOB. Il livello è correlato alle dimensioni del BLOB e al numero di operazioni di I/O al secondo consentite. Questa operazione è applicabile solo ai BLOB di pagine in account di archiviazione Premium.

standard_blob_tier
StandardBlobTier

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

rehydrate_priority
RehydratePriority

Indica la priorità con cui riattivare un BLOB archiviato

seal_destination_blob
bool

Bloccare il BLOB di accodamento di destinazione. Questa operazione è solo per il BLOB di accodamento.

Novità nella versione 12.4.0.

requires_sync
bool

Applica che il servizio non restituirà una risposta fino al completamento della copia.

source_authorization
str

Eseguire l'autenticazione come entità servizio usando un segreto client per accedere a un BLOB di origine. Assicurarsi che "bearer" sia il prefisso della stringa di source_authorization. Questa opzione è disponibile solo quando incremental_copy è impostato su False e requires_sync è impostato su True.

Novità nella versione 12.9.0.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel BLOB copiato dalla sincronizzazione. È possibile creare un ambito di crittografia usando l'API Gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore verrà sottoposto a override se l'ambito a livello di contenitore è configurato per consentire l'override. In caso contrario, verrà generato un errore.

Novità nella versione 12.10.0.

Restituisce

Dizionario delle proprietà di copia (etag, last_modified, copy_id, copy_status).

Tipo restituito

undelete_blob

Ripristina BLOB o snapshot eliminati soft-delete.

L'operazione avrà esito positivo solo se viene usato entro il numero di giorni specificato impostato nei criteri di conservazione di eliminazione.

Se il controllo delle versioni dei BLOB è abilitato, il BLOB di base non può essere ripristinato usando questo metodo. Usare invece start_copy_from_url con l'URL della versione del BLOB che si vuole alzare di livello alla versione corrente.

undelete_blob(**kwargs: Any) -> None

Parametri

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Tipo restituito

upload_blob

Crea un nuovo BLOB da un'origine dati con suddivisione automatica in blocchi.

upload_blob(data: bytes | str | Iterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]

Parametri

data
Necessario

Dati BLOB da caricare.

blob_type
BlobType
Necessario

Tipo dell'oggetto BLOB. Può trattarsi di BlockBlob, PageBlob o AppendBlob. Il valore predefinito è BlockBlob.

length
int
Necessario

Numero di byte da leggere dal flusso. Questa opzione è facoltativa, ma deve essere fornita per ottenere prestazioni ottimali.

metadata
dict(str, str)
Necessario

Coppie nome-valore associate al Blob come metadati.

tags
dict(str, str)

Coppie nome-valore associate al BLOB come tag. I tag fanno distinzione tra maiuscole e minuscole. Il set di tag può contenere al massimo 10 tag. I tasti tag devono essere compresi tra 1 e 128 caratteri e i valori dei tag devono essere compresi tra 0 e 256 caratteri. I caratteri validi per chiave e valore del tag includono: lettere minuscole e maiuscole, cifre (0-9), spazio ( >><<), più (+), meno (-), punto (.), solidus (/), due punti (:), uguale a (=), carattere di sottolineatura (_)

Novità nella versione 12.4.0.

overwrite
bool

Indica se il BLOB da caricare deve sovrascrivere i dati correnti. Se True, upload_blob sovrascriverà i dati esistenti. Se impostato su False, l'operazione avrà esito negativo con ResourceExistsError. L'eccezione a quella precedente è costituita dai tipi di BLOB Append: se è impostata su False e i dati esistono già, non verrà generato un errore e i dati verranno aggiunti al BLOB esistente. Se impostato overwrite=True, il BLOB di accodamento esistente verrà eliminato e ne verrà creato uno nuovo. Il valore predefinito è False.

content_settings
ContentSettings

Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo della cache.

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. Ciò è particolarmente utile per rilevare bitflips in rete se si usa http anziché https, come https (impostazione predefinita), verrà già convalidata. Si noti che questo hash MD5 non viene archiviato con il Blob. Si noti anche che, se abilitato, l'algoritmo di caricamento efficiente della memoria non verrà usato perché il calcolo dell'hash MD5 richiede il buffering di interi blocchi e in questo modo lo scopo dell'algoritmo efficiente per la memoria.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Se specificato, upload_blob ha esito positivo solo se il lease del BLOB è attivo e corrisponde a questo ID. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where nei tag BLOB da usare solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

premium_page_blob_tier
PremiumPageBlobTier

Valore del livello BLOB di pagine su cui impostare il BLOB. Il livello è correlato alle dimensioni del BLOB e al numero di operazioni di I/O al secondo consentite. Questo è applicabile solo ai BLOB di pagine per gli account di archiviazione Premium.

standard_blob_tier
StandardBlobTier

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

immutability_policy
ImmutabilityPolicy

Specifica i criteri di immutabilità di un BLOB, di uno snapshot BLOB o di una versione del BLOB. Attualmente questo parametro dell'API upload_blob() è solo per BlockBlob.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

legal_hold
bool

Specificato se deve essere impostato un blocco a fini giudiziari nel BLOB. Attualmente questo parametro dell'API upload_blob() è solo per BlockBlob.

Novità nella versione 12.10.0: è stata introdotta nella versione DELL'API '2020-10-02'.

maxsize_condition
int

Intestazione condizionale facoltativa. Lunghezza massima in byte consentita per il BLOB di accodamento. Se l'operazione Append Block fa sì che il BLOB superi tale limite o se le dimensioni del BLOB siano già maggiori del valore specificato in questa intestazione, la richiesta avrà esito negativo con l'errore MaxBlobSizeConditionNotMet (codice di stato HTTP 412 - Precondizione non riuscita).

max_concurrency
int

Numero massimo di connessioni parallele da usare quando le dimensioni del BLOB superano 64 MB.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API di gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore lo sostituirà se l'ambito a livello di contenitore è configurato per consentire le sostituzioni. In caso contrario, verrà generato un errore.

Novità della versione 12.2.0.

encoding
str

Il valore predefinito è UTF-8.

progress_hook
Callable[[int, Optional[int]], None]

Callback per tenere traccia dello stato di avanzamento di un caricamento a esecuzione prolungata. La firma è function(current: int, total: Optional[int]) dove current è il numero di byte trasferiti finora e il totale è la dimensione del BLOB o Nessuno se la dimensione è sconosciuta.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui. Questo metodo può effettuare più chiamate al servizio e il timeout verrà applicato singolarmente a ogni chiamata.

Restituisce

Dict della proprietà aggiornata dal BLOB (Etag e ultima modifica)

Tipo restituito

upload_blob_from_url

Crea un nuovo BLOB in blocchi in cui il contenuto del BLOB viene letto da un URL specificato. Il contenuto di un BLOB esistente viene sovrascritto con il nuovo BLOB.

upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]

Parametri

source_url
str
Necessario

URL di lunghezza massima di 2 KB che specifica un file o un BLOB. 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/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

overwrite
bool

Indica se il BLOB da caricare deve sovrascrivere i dati correnti. Se True, upload_blob sovrascriverà i dati esistenti. Se impostato su False, l'operazione avrà esito negativo con ResourceExistsError.

include_source_blob_properties
bool

Indica se le proprietà del BLOB di origine devono essere copiate. Il valore predefinito è True.

tags
dict(str, str)

Coppie nome-valore associate al BLOB come tag. I tag fanno distinzione tra maiuscole e minuscole. Il set di tag può contenere al massimo 10 tag. I tasti tag devono essere compresi tra 1 e 128 caratteri e i valori dei tag devono essere compresi tra 0 e 256 caratteri. I caratteri validi per chiave e valore del tag includono: lettere minuscole e maiuscole, cifre (0-9), spazio ( >><<), più (+), meno (-), punto (.), solidus (/), due punti (:), uguale a (=), carattere di sottolineatura (_)

source_content_md5
bytearray

Specificare l'oggetto md5 utilizzato per verificare l'integrità dei byte 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 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 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 di origine non è stata modificata dopo la data/ora specificata.

source_etag
str

Valore ETag di origine o carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

source_match_condition
MatchConditions

Condizione di corrispondenza di origine da utilizzare sull'etag.

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.

etag
str

Valore ETag di destinazione o carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza di destinazione da utilizzare sull'etag.

destination_lease
BlobLeaseClient oppure 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).

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

content_settings
ContentSettings

Oggetto ContentSettings utilizzato per impostare le proprietà del BLOB. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo della cache.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API di gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore lo sostituirà se l'ambito a livello di contenitore è configurato per consentire le sostituzioni. In caso contrario, verrà generato un errore.

standard_blob_tier
StandardBlobTier

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

source_authorization
str

Eseguire l'autenticazione come entità servizio usando un segreto client per accedere a un BLOB di origine. Assicurarsi che "bearer" sia il prefisso della stringa source_authorization.

upload_page

L'operazione Carica pagine scrive un intervallo di pagine in un BLOB di pagine.

upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]

Parametri

page
bytes
Necessario

Contenuto della pagina.

offset
int
Necessario

Inizio dell'intervallo di byte da usare per la scrittura in una sezione del BLOB. Le pagine devono essere allineate con limiti di 512 byte, l'offset iniziale deve essere un modulo di 512 e la lunghezza deve essere un modulo di 512.

length
int
Necessario

Numero di byte da usare per la scrittura in una sezione del BLOB. Le pagine devono essere allineate con limiti di 512 byte, l'offset iniziale deve essere un modulo di 512 e la lunghezza deve essere un modulo di 512.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BlobLeaseClient o l'ID lease come stringa.

validate_content
bool

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

if_sequence_number_lte
int

Se il numero di sequenza del BLOB è minore o uguale al valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

if_sequence_number_lt
int

Se il numero di sequenza del BLOB è minore del valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

if_sequence_number_eq
int

Se il numero di sequenza del BLOB è uguale al valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

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.

etag
str

Valore ETag o il carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza da utilizzare sull'etag.

if_tags_match_condition
str

Specificare una clausola SQL where nei tag BLOB da usare solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API Gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore verrà sottoposto a override se l'ambito a livello di contenitore è configurato per consentire l'override. In caso contrario, verrà generato un errore.

Novità nella versione 12.2.0.

encoding
str

Impostazione predefinita su UTF-8.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del BLOB (Etag e ultima modifica).

Tipo restituito

upload_pages_from_url

L'operazione Carica pagine scrive un intervallo di pagine in un BLOB di pagine in cui il contenuto viene letto da un URL.

upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]

Parametri

source_url
str
Necessario

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

offset
int
Necessario

Inizio dell'intervallo di byte da usare per la scrittura in una sezione del BLOB. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

length
int
Necessario

Numero di byte da usare per la scrittura in una sezione del BLOB. Le pagine devono essere allineate a 512 byte, l'offset iniziale deve essere un modulo pari a 512 e la lunghezza deve essere un modulo pari a 512.

source_offset
int
Necessario

Questo indica l'inizio dell'intervallo di byte(inclusivo) che deve essere tratto dall'origine di copia. Il servizio leggerà lo stesso numero di byte dell'intervallo di destinazione (offset di lunghezza).

source_content_md5
bytes

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

Valore ETag di origine o carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

source_match_condition
MatchConditions

Condizione di corrispondenza di origine da usare sul etag.

lease
BlobLeaseClient oppure str

Obbligatoria se il Blob presenta un lease attivo. Il valore può essere un oggetto BLOBLeaseClient o l'ID lease come stringa.

if_sequence_number_lte
int

Se il numero di sequenza del BLOB è minore o uguale al valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

if_sequence_number_lt
int

Se il numero di sequenza del BLOB è minore del valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

if_sequence_number_eq
int

Se il numero di sequenza del BLOB è uguale al valore specificato, la richiesta procede; in caso contrario, ha esito negativo.

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.

etag
str

Valore ETag di destinazione o carattere jolly (*). Usato per verificare se la risorsa è cambiata e agire in base alla condizione specificata dal parametro match_condition .

match_condition
MatchConditions

Condizione di corrispondenza di destinazione da usare sul etag.

if_tags_match_condition
str

Specificare una clausola SQL in cui le clausole sui tag BLOB vengono usate solo nel BLOB con un valore corrispondente. Ad esempio: "\"tagname\"='my tag'"

Novità nella versione 12.4.0.

cpk
CustomerProvidedEncryptionKey

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.

encryption_scope
str

Ambito di crittografia predefinito usato per crittografare i dati nel servizio. È possibile creare un ambito di crittografia usando l'API Gestione e fare riferimento qui in base al nome. Se nel contenitore è stato definito un ambito di crittografia predefinito, questo valore verrà sottoposto a override se l'ambito a livello di contenitore è configurato per consentire l'override. In caso contrario, verrà generato un errore.

Novità nella versione 12.2.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

source_authorization
str

Eseguire l'autenticazione come entità servizio usando un segreto client per accedere a un BLOB di origine. Assicurarsi che "bearer" sia il prefisso della stringa di source_authorization.

Attributi

api_version

Versione dell'API di archiviazione usata per le richieste.

location_mode

Modalità di posizione attualmente usata dal client.

Per impostazione predefinita, il valore sarà "primario". Le opzioni includono "primary" e "secondary".

primary_endpoint

URL completo dell'endpoint primario.

primary_hostname

Nome host dell'endpoint primario.

secondary_endpoint

URL dell'endpoint secondario completo, se configurato.

Se non è disponibile, verrà generato un valore ValueError. Per specificare in modo esplicito un nome host secondario, usare l'argomento facoltativo secondary_hostname parola chiave nella creazione di istanze.

Eccezioni

secondary_hostname

Nome host dell'endpoint secondario.

Se non disponibile, non sarà disponibile. Per specificare in modo esplicito un nome host secondario, usare l'argomento facoltativo secondary_hostname parola chiave nella creazione di istanze.

url

URL completo dell'endpoint per questa entità, incluso il token di firma di accesso condiviso, se usato.

Può trattarsi dell'endpoint primario o dell'endpoint secondario a seconda dell'oggetto corrente location_mode. :returns: URL completo dell'endpoint per questa entità, incluso il token di firma di accesso condiviso, se usato. :rtype: str