blob Pacchetto

Pacchetti

aio

Classi

AccessPolicy	Classe Criteri di accesso utilizzata dal set e ottenere i metodi dei criteri di accesso in ogni servizio. I criteri di accesso archiviati possono specificare l'ora di inizio, l'ora di scadenza e le autorizzazioni per le firme di accesso condiviso a cui sono associati. A seconda del modo in cui si vuole controllare l'accesso alla risorsa, è possibile specificare tutti questi parametri all'interno dei criteri di accesso archiviati e ometterli dall'URL per la firma di accesso condiviso. In questo modo, è possibile modificare il comportamento della firma associata in qualsiasi momento, nonché revocarla. In alternativa, è possibile specificare uno o più parametri dei criteri di accesso nei criteri di accesso archiviati e gli altri nell'URL. Infine, è possibile specificare tutti i parametri nell'URL. In questo caso, è possibile usare i criteri di accesso archiviati per revocare la firma, ma non per modificarne il comportamento. Insieme, la firma di accesso condiviso e i criteri di accesso archiviati devono includere tutti i campi necessari per autenticare la firma. Se uno o più campi obbligatori sono mancanti, la richiesta avrà esito negativo. Analogamente, se un campo è specificato sia nell'URL della firma di accesso condiviso sia nei criteri di accesso archiviati, la richiesta avrà esito negativo e verrà restituito il codice di stato 400 (Richiesta non valida).
AccountSasPermissions	ResourceTypes classe da usare con la funzione generate_account_sas e per gli AccessPolicies usati con set_*_acl. Esistono due tipi di firma di accesso condiviso che possono essere usati per concedere l'accesso alle risorse. Uno consiste nel concedere l'accesso a una risorsa specifica (specifica della risorsa). Un altro consiste nel concedere l'accesso all'intero servizio per un account specifico e consentire determinate operazioni basate su perms disponibili qui.
ArrowDialect	campo di uno schema freccia. Tutti i parametri obbligatori devono essere popolati per inviare ad Azure.
BlobAnalyticsLogging	Impostazioni di registrazione di Analisi di Azure.
BlobBlock	Classe BlockBlob Block.
BlobClient	Un client per interagire con un BLOB specifico, anche se tale BLOB potrebbe non esistere ancora. Per altre configurazioni facoltative, fare clic qui.
BlobLeaseClient	Crea un nuovo BLOBLeaseClient. Questo client fornisce operazioni di lease su un BLOBClient o containerClient.
BlobPrefix	Iterabile delle proprietà BLOB. Restituito da walk_blobs quando viene usato un delimitatore. Può essere considerato come una directory BLOB virtuale.
BlobProperties	Proprietà BLOB.
BlobQueryError	Errore durante l'operazione di query rapida.
BlobQueryReader	Oggetto di streaming per leggere i risultati delle query.
BlobSasPermissions	Classe BLOBSasPermissions da usare con la generate_blob_sas funzione.
BlobServiceClient	Un client per interagire con il servizio BLOB a livello di account. Questo client fornisce operazioni per recuperare e configurare le proprietà dell'account e l'elenco, creare ed eliminare contenitori all'interno dell'account. Per le operazioni relative a un contenitore o BLOB specifico, i client per tali entità possono essere recuperati anche usando le funzioni di get_client . Per altre configurazioni facoltative, fare clic qui.
ContainerClient	Un client per interagire con un contenitore specifico, anche se tale contenitore potrebbe non esistere ancora. Per le operazioni relative a un BLOB specifico all'interno di questo contenitore, è possibile recuperare un client BLOB usando la get_blob_client funzione. Per altre configurazioni facoltative, fare clic qui.
ContainerEncryptionScope	Configurazione dell'ambito di crittografia predefinita per un contenitore. Questo ambito viene usato in modo implicito per tutte le scritture future all'interno del contenitore, ma può essere sottoposto a override per ogni operazione BLOB. Novità nella versione 12.2.0.
ContainerProperties	Classe proprietà del contenitore BLOB. Le istanze restituite ContainerProperties espongono questi valori tramite un'interfaccia del dizionario, ad esempio: container_props["last_modified"]. Inoltre, il nome del contenitore è disponibile come container_props["name"].
ContainerSasPermissions	Classe ContainerSasPermissions da usare con la generate_container_sas funzione e per gli AccessPolicies usati con set_container_access_policy.
ContentSettings	Impostazioni del contenuto di un BLOB.
CopyProperties	Proprietà di copia BLOB. Queste proprietà saranno None se questo BLOB non è mai stato la destinazione in un'operazione di copia BLOB o se questo BLOB è stato modificato dopo un'operazione di copia BLOB completata, ad esempio usando Imposta proprietà BLOB, Carica BLOB o Elenco blocchi di commit.
CorsRule	CORS è una funzionalità HTTP che consente a un'applicazione Web in esecuzione in un dominio di accedere alle risorse in un altro dominio. Nei browser web è implementata una restrizione di sicurezza detta regola della stessa origine che impedisce a una pagina web di chiamare API in un dominio diverso. La condivisione CORS offre una modalità sicura per consentire a un dominio (quello di origine) di chiamare API in un altro dominio.
CustomerProvidedEncryptionKey	Tutti i dati in Archiviazione di Azure vengono crittografati inattivi usando una chiave di crittografia a livello di account. Nelle versioni 2018-06-17 e versioni successive è possibile gestire la chiave usata per crittografare il contenuto dei BLOB e i metadati dell'applicazione per BLOB fornendo una chiave di crittografia AES-256 nelle richieste al servizio di archiviazione. Quando si usa una chiave fornita dal cliente, Archiviazione di Azure non gestisce o mantiene la chiave. Quando si scrivono dati in un BLOB, la chiave specificata viene usata per crittografare i dati prima di scriverlo su disco. Un hash SHA-256 della chiave di crittografia viene scritto insieme al contenuto del BLOB e viene usato per verificare che tutte le operazioni successive sul BLOB usino la stessa chiave di crittografia. Questo hash non può essere usato per recuperare la chiave di crittografia o decrittografare il contenuto del BLOB. Quando si legge un BLOB, la chiave specificata viene usata per decrittografare i dati dopo averlo letto dal disco. In entrambi i casi, la chiave di crittografia fornita viene eliminata in modo sicuro non appena viene completato il processo di crittografia o decrittografia.
DelimitedJsonDialect	Definisce la serializzazione JSON di input o output per una query di dati BLOB. delimitatore str parola chiave: il carattere separatore di riga, il valore predefinito è ' '
DelimitedTextDialect	Definisce la serializzazione di input o output delimitata (CSV) per una richiesta di query BLOB.
ExponentialRetry	Ripetizione esponenziale dei tentativi. Costruisce un oggetto ripetizione dei tentativi esponenziale. Il initial_backoff viene usato per il primo tentativo. I tentativi successivi vengono riprovati dopo initial_backoff + increment_power^retry_count secondi.
FilteredBlob	Informazioni SUI BLOB da una chiamata API Blob di filtro.
ImmutabilityPolicy	Parametri facoltativi per impostare i criteri di non modificabilità di un BLOB, uno snapshot BLOB o una versione BLOB. Novità nella versione 12.10.0: è stata introdotta nella versione api '2020-10-02'.
LeaseProperties	Proprietà del lease BLOB.
LinearRetry	Ripetizione lineare. Costruisce un oggetto di ripetizione dei tentativi lineare.
LocationMode	Specifica il percorso a cui deve essere inviata la richiesta. Questa modalità si applica solo agli account RA-GRS che consentono l'accesso in lettura secondario. Tutti gli altri tipi di account devono usare PRIMARY.
Metrics	Riepilogo delle statistiche richieste raggruppate dall'API in aggregazioni orarie o minuti per i BLOB.
ObjectReplicationPolicy	ID criterio e ID regola applicati a un BLOB.
ObjectReplicationRule	ID criterio e ID regola applicati a un BLOB.
PageRange	Intervallo di pagine per BLOB di pagine.
PartialBatchErrorException	Si verifica un errore parziale nelle operazioni batch.
ResourceTypes	Specifica i tipi di risorse accessibili con la firma di accesso condiviso dell'account.
RetentionPolicy	I criteri di conservazione che determinano il tempo di conservazione dei dati associati devono essere persistenti.
StaticWebsite	Proprietà che consentono a un account di ospitare un sito Web statico.
StorageStreamDownloader	Oggetto di streaming da scaricare da Archiviazione di Azure.
UserDelegationKey	Rappresenta una chiave di delega utente, fornita all'utente da Archiviazione di Azure in base al token di accesso di Azure Active Directory. I campi vengono salvati come stringhe semplici poiché l'utente non deve interagire con questo oggetto; per generare una firma di accesso condiviso di identificazione, l'utente può semplicemente passarlo all'API corretta.

Enumerazioni

ArrowType
BlobImmutabilityPolicyMode	Specifica la modalità dei criteri di non modificabilità da impostare nel BLOB. "Mutable" può essere restituito solo dal servizio, non impostare su "Mutable".
BlobType
BlockState	Blocca tipi di blocchi BLOB.
PremiumPageBlobTier	Specifica il livello BLOB di pagina su cui impostare il BLOB. Questa operazione è applicabile solo ai BLOB di pagine in account di archiviazione Premium. Esaminare: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets per informazioni dettagliate sulle operazioni di I/O al secondo e velocità effettiva corrispondenti per PageBlobTier.
PublicAccess	Specifica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso.
QuickQueryDialect	Specifica il dialetto di input/output di query rapido.
RehydratePriority	Se un oggetto si trova nello stato in sospeso, questa intestazione viene restituita con priorità di reidratazione. I valori validi sono High e Standard.
SequenceNumberAction	Azioni del numero di sequenza.
StandardBlobTier	Specifica il livello BLOB su cui impostare il BLOB. Questo è applicabile solo per i BLOB a blocchi in account di archiviazione standard.
StorageErrorCode

Funzioni

download_blob_from_url

Scaricare il contenuto di un BLOB in un file o un flusso locale.

download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

Parametri

blob_url

str

Necessario

URI completo nel BLOB. Ciò può includere anche un token di firma di accesso condiviso.

output

str oppure <xref:<xref:writable stream.>>

Necessario

Dove scaricare i dati. Potrebbe trattarsi di un percorso di file da scrivere in o di un handle di I/O aperto a cui scrivere.

credential

valore predefinito: None

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

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

overwrite

bool

Indica se il file locale deve essere sovrascritto se esiste già. Il valore predefinito è False , nel qual caso verrà generato un valore ValueError se il file esiste già. Se impostato su True, verrà effettuato un tentativo di scrittura nel file esistente. Se viene passato un handle di flusso, questo valore viene ignorato.

max_concurrency

int

Numero di connessioni parallele da scaricare.

offset

int

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

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

validate_content

bool

Se true, calcola un hash MD5 per ogni blocco del BLOB. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è particolarmente utile per rilevare bitflips in transito se si usa http anziché https come https (impostazione predefinita) verrà già convalidata. Si noti che questo hash MD5 non viene archiviato con il Blob. Si noti anche che, se abilitato, l'algoritmo di caricamento efficiente per la 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.

Tipo restituito

None

generate_account_sas

Genera una firma di accesso condiviso per il servizio BLOB.

Usare la firma restituita con il parametro delle credenziali di qualsiasi BlobServiceClient, ContainerClient o BlobClient.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

Parametri

account_name

str

Necessario

Nome dell'account di archiviazione usato per generare la firma di accesso condiviso.

account_key

str

Necessario

La chiave dell'account, detta anche chiave condivisa o chiave di accesso, per generare la firma di accesso condiviso.

resource_types

str oppure ResourceTypes

Necessario

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

permission

str oppure AccountSasPermissions

Necessario

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

expiry

datetime oppure str

Necessario

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

start

datetime oppure str

valore predefinito: None

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

ip

str

valore predefinito: None

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

protocol

str

Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https.

encryption_scope

str

Specifica l'ambito di crittografia per una richiesta effettuata in modo che tutte le operazioni di scrittura vengano crittografate dal servizio.

Restituisce

Token di firma di accesso condiviso (sas).

Tipo restituito

str

generate_blob_sas

Genera una firma di accesso condiviso per un BLOB.

Usare la firma restituita con il parametro delle credenziali di qualsiasi BlobServiceClient, ContainerClient o BlobClient.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parametri

account_name

str

Necessario

Nome dell'account di archiviazione usato per generare la firma di accesso condiviso.

container_name

str

Necessario

Nome del contenitore.

blob_name

str

Necessario

Nome del BLOB.

snapshot

str

valore predefinito: None

ID snapshot BLOB facoltativo.

account_key

str

valore predefinito: None

La chiave dell'account, detta anche chiave condivisa o chiave di accesso, per generare la firma di accesso condiviso. È necessario specificare account_key o user_delegation_key .

user_delegation_key

UserDelegationKey

valore predefinito: None

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

permission

str oppure BlobSasPermissions

valore predefinito: None

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

expiry

datetime oppure str

valore predefinito: None

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

start

datetime oppure str

valore predefinito: None

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

policy_id

str

valore predefinito: None

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

ip

str

valore predefinito: None

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

version_id

str

ID versione DEL BLOB facoltativo. Questo parametro è applicabile solo per gli account di archiviazione abilitati per il controllo delle versioni. Si noti che il parametro di query 'versionid' non è incluso nella firma di accesso condiviso di output. Specificare quindi il parametro "version_id" per qualsiasi API quando si usa la firma di accesso condiviso di output per operare su una versione specifica.

Novità della versione 12.4.0: questo argomento di parola chiave è stato introdotto nella versione API '2019-12-12'.

protocol

str

Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https.

cache_control

str

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

content_disposition

str

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

content_encoding

str

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

content_language

str

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

content_type

str

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

encryption_scope

str

Specifica l'ambito di crittografia per una richiesta effettuata in modo che tutte le operazioni di scrittura vengano crittografate dal servizio.

correlation_id

str

ID di correlazione per correlare i log di controllo di archiviazione con i log di controllo usati dall'entità che genera e distribuisce la firma di accesso condiviso. Questa operazione può essere usata solo quando si genera una firma di accesso condiviso con chiave di delega.

Restituisce

Token di firma di accesso condiviso (sas).

Tipo restituito

str

generate_container_sas

Genera una firma di accesso condiviso per un contenitore.

Usare la firma restituita con il parametro credenziale di qualsiasi BLOBServiceClient, ContainerClient o BLOBClient.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parametri

account_name

str

Necessario

Nome dell'account di archiviazione usato per generare la firma di accesso condiviso.

container_name

str

Necessario

Nome del contenitore.

account_key

str

valore predefinito: None

La chiave dell'account, detta anche chiave condivisa o chiave di accesso, per generare la firma di accesso condiviso. È necessario specificare account_key o user_delegation_key .

user_delegation_key

UserDelegationKey

valore predefinito: None

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

permission

str oppure ContainerSasPermissions

valore predefinito: None

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

expiry

datetime oppure str

valore predefinito: None

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

start

datetime oppure str

valore predefinito: None

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

policy_id

str

valore predefinito: None

Valore univoco fino a 64 caratteri di lunghezza che correla a un criterio di accesso archiviato. Per creare criteri di accesso archiviati, usare set_container_access_policy.

ip

str

valore predefinito: None

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

protocol

str

Specifica il protocollo consentito per una richiesta effettuata. Il valore predefinito è https.

cache_control

str

Valore dell'intestazione di risposta per Cache-Control quando la risorsa viene accessibile usando questa firma di accesso condiviso.

content_disposition

str

Valore dell'intestazione di risposta per Content-Disposition quando la risorsa viene accessibile usando questa firma di accesso condiviso.

content_encoding

str

Valore dell'intestazione di risposta per Codifica contenuto quando la risorsa viene accessibile usando questa firma di accesso condiviso.

content_language

str

Valore dell'intestazione di risposta per Content-Language quando la risorsa viene accessibile usando questa firma di accesso condiviso.

content_type

str

Valore dell'intestazione di risposta per Content-Type quando la risorsa viene accessibile usando questa firma di accesso condiviso.

encryption_scope

str

Specifica l'ambito di crittografia per una richiesta effettuata in modo che tutte le operazioni di scrittura vengano crittografate.

correlation_id

str

ID correlazione per correlare i log di controllo di archiviazione con i log di controllo usati dall'entità che genera e distribuisce la firma di accesso condiviso. Questa operazione può essere usata solo quando si genera una firma di accesso condiviso con chiave di delega.

Restituisce

Token firma di accesso condiviso (sas).

Tipo restituito

str

upload_blob_to_url

Caricare i dati in un determinato URL

I dati verranno caricati come BLOB a blocchi.

upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> Dict[str, Any]

Parametri

blob_url

str

Necessario

URI completo nel BLOB. Ciò può includere anche un token di firma di accesso condiviso.

data

bytes oppure str oppure Iterable

Necessario

Dati da caricare. Può essere byte, testo, iterabile o un oggetto simile a un file.

credential

valore predefinito: None

Credenziali con cui eseguire l'autenticazione. Questo è facoltativo se l'URL BLOB ha già un token di firma 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.

overwrite

bool

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

max_concurrency

int

Numero di connessioni parallele con cui scaricare.

length

int

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

metadata

dict(str,str)

Coppie nome-valore associate al Blob come metadati.

validate_content

bool

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

encoding

str

Codifica da usare se il testo viene fornito come input. Impostazione predefinita su UTF-8.

Restituisce

Proprietà aggiornata del BLOB (Etag e ultima modifica)

Tipo restituito

dict(str, Any)