azure.storage.blob.BlobClient class

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

None

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

BlobLeaseClient

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

dict(str, Any)

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.

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

dict(str, Any)

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

close()

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

dict(str, Any)

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

dict[str, Any]

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

dict[str, Any]

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

dict[str, Any]

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

None

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

Dict[str, str]

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

StorageStreamDownloader

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

bool

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

BlobClient

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

BlobClient

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

dict(str, str)

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

BlobProperties

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

Dict[str, str]

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

tuple(list(BlobBlock), list(BlobBlock))

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

tuple(list(dict(str, str), list(dict(str, str))

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

tuple(list(dict(str, str), list(dict(str, str))

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

ItemPaged[PageRange]

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

BlobQueryReader

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

dict(str, Any)

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

dict(str, Any)

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)

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

Dict[str, Any]

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

Dict[str, Any]

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

Dict[str, str]

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

Dict[str, Union[str, datetime, bool]]

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

None

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

dict(str, Any)

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

None

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

dict[str, Any]

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

dict[str, Any]

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

dict[str, Union[str, datetime]]

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

None

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

dict[str, Any]

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.

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

dict(str, Any)

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.

Versione dell'API di archiviazione usata per le richieste.

Modalità di posizione attualmente usata dal client.

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

URL completo dell'endpoint primario.

Nome host dell'endpoint primario.

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

ValueError

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

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.

Condividi tramite

BlobClient Classe

Costruttore

Parametri

Metodi

abort_copy

Parametri

Tipo restituito

acquire_lease

Parametri

Restituisce

Tipo restituito

append_block

Parametri

Restituisce

Tipo restituito

append_block_from_url

Parametri

clear_page

Parametri

Restituisce

Tipo restituito

close

commit_block_list

Parametri

Restituisce

Tipo restituito

create_append_blob

Parametri

Restituisce

Tipo restituito

create_page_blob

Parametri

Restituisce

Tipo restituito

create_snapshot

Parametri

Restituisce

Tipo restituito

delete_blob

Parametri

Tipo restituito

delete_immutability_policy

Parametri

Restituisce

Tipo restituito

download_blob

Parametri

Restituisce

Tipo restituito

exists

Parametri

Restituisce

Tipo restituito

from_blob_url

Parametri

Restituisce

Tipo restituito

from_connection_string

Parametri

Restituisce

Tipo restituito

get_account_information

Restituisce

Tipo restituito

get_blob_properties

Parametri

Restituisce

Tipo restituito

get_blob_tags

Parametri

Restituisce

Tipo restituito

get_block_list

Parametri

Restituisce

Tipo restituito

get_page_range_diff_for_managed_disk

Parametri

Restituisce