Condividi tramite


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

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