blob Paket

output

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

Wo die Daten heruntergeladen werden sollen. Dies kann entweder ein Dateipfad sein, in den geschrieben werden soll, oder ein geöffnetes E/A-Handle, in das geschrieben werden soll.

credential

Die Anmeldeinformationen, mit denen die Authentifizierung erfolgt. Dies ist optional, wenn die Blob-URL bereits über ein SAS-Token verfügt oder das Blob öffentlich ist. Der Wert kann eine SAS-Tokenzeichenfolge, ein instance einer AzureSasCredential- oder AzureNamedKeyCredential-Instanz von azure.core.credentials, ein freigegebener Zugriffsschlüssel für ein Konto oder ein instance einer TokenCredentials-Klasse aus azure.identity sein. Wenn der Ressourcen-URI bereits ein SAS-Token enthält, wird dies zugunsten expliziter Anmeldeinformationen ignoriert.

• außer im Fall von AzureSasCredential, bei dem die in Konflikt stehenden SAS-Token einen ValueError auslösen. Wenn Sie eine instance von AzureNamedKeyCredential verwenden, sollte "name" der Name des Speicherkontos und "key" der Speicherkontoschlüssel sein.

overwrite

bool

Gibt an, ob die lokale Datei überschrieben werden soll, wenn sie bereits vorhanden ist. Der Standardwert ist False . In diesem Fall wird ein ValueError ausgelöst, wenn die Datei bereits vorhanden ist. Wenn sie auf True festgelegt ist, wird versucht, in die vorhandene Datei zu schreiben. Wenn ein Streamhandle übergeben wird, wird dieser Wert ignoriert.

max_concurrency

int

Die Anzahl der parallelen Verbindungen, mit denen heruntergeladen werden soll.

offset

int

Start des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Muss festgelegt werden, wenn die Länge angegeben wird.

length

int

Anzahl der Bytes, die aus dem Stream gelesen werden sollen. Dies ist optional, sollte aber für eine optimale Leistung bereitgestellt werden.

validate_content

bool

Wenn true, berechnet ein MD5-Hash für jeden Block des Blobs. Der Speicherdienst überprüft den Hash des Inhalts, der mit dem gesendeten Hash eingetroffen ist. Dies ist in erster Linie nützlich für die Erkennung von Bitflips im Kabel, wenn die Verwendung von http anstelle von https als https (standard) bereits überprüft wird. Beachten Sie, dass dieser MD5-Hash nicht mit dem BLOB gespeichert wird. Beachten Sie außerdem, dass bei Aktivierung der speichereffiziente Uploadalgorithmus nicht verwendet wird, da für die Berechnung des MD5-Hashs das Puffern ganzer Blöcke erforderlich ist. Dadurch wird der Zweck des speichereffizienten Algorithmus verfehlt.

account_key

str

Der Kontoschlüssel, auch als freigegebener Schlüssel oder Zugriffsschlüssel bezeichnet, um die Shared Access Signature zu generieren.

resource_types

str oder ResourceTypes

Gibt die Ressourcentypen an, auf die mit der Konto-SAS zugegriffen werden kann.

permission

str oder AccountSasPermissions

Die Berechtigungen, die der SAS zugeordnet sind. Der Benutzer ist auf Vorgänge beschränkt, für die er eine Berechtigung besitzt. Erforderlich, es sei denn, es wird eine ID angegeben, die auf eine gespeicherte Zugriffsrichtlinie verweist, die dieses Feld enthält. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde.

expiry

datetime oder str

Der Zeitpunkt, zu dem die Shared Access Signature ungültig wird. Erforderlich, es sei denn, es wird eine ID angegeben, die auf eine gespeicherte Zugriffsrichtlinie verweist, die dieses Feld enthält. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde. Azure konvertiert immer Werte in UTC. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist.

start

datetime oder str

Der Zeitpunkt, zu dem die Shared Access Signature gültig wird. Wenn Sie diesen Wert weglassen, wird als Startzeit dieses Aufrufs die Uhrzeit verwendet, zu der die Anforderung vom Speicherdienst empfangen wird. Azure konvertiert immer Werte in UTC. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist.

ip

str

Gibt eine IP-Adresse oder einen Bereich von IP-Adressen an, von denen Anforderungen akzeptiert werden sollen. Wenn die IP-Adresse, von der die Anforderung stammt, nicht mit der IP-Adresse oder dem Adressbereich übereinstimmt, die im SAS-Token angegeben sind, wird die Anforderung nicht authentifiziert. Wenn Sie beispielsweise ip=168.1.5.65 oder ip=168.1.5.60-168.1.5.70 für die SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol

str

Gibt das für eine anforderung zulässige Protokoll an. Der Standardwert ist https.

encryption_scope

str

Gibt den Verschlüsselungsbereich für eine Anforderung an, die ausgeführt wird, damit alle Schreibvorgänge dienstverschlüsselt werden.

container_name

str

Der Name des Containers,

blob_name

str

Der Name des Blobs.

snapshot

str

Eine optionale Blob-Momentaufnahme-ID.

account_key

str

Der Kontoschlüssel, auch als freigegebener Schlüssel oder Zugriffsschlüssel bezeichnet, um die Shared Access Signature zu generieren. Es müssen account_key oder user_delegation_key angegeben werden.

user_delegation_key

UserDelegationKey

Anstelle eines freigegebenen Kontoschlüssels könnte der Benutzer einen Benutzerdelegierungsschlüssel übergeben. Ein Benutzerdelegierungsschlüssel kann vom Dienst abgerufen werden, indem sie sich mit einer AAD-Identität authentifiziert; Dies kann erreicht werden, indem Sie aufrufen get_user_delegation_key. Wenn vorhanden, wird die SAS stattdessen mit dem Benutzerdelegierungsschlüssel signiert.

permission

str oder BlobSasPermissions

Die Berechtigungen, die der SAS zugeordnet sind. Der Benutzer ist auf Vorgänge beschränkt, für die er eine Berechtigung besitzt. Berechtigungen müssen racwdxytmei angeordnet sein. Erforderlich, es sei denn, es wird eine ID angegeben, die auf eine gespeicherte Zugriffsrichtlinie verweist, die dieses Feld enthält. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde.

expiry

datetime oder str

Der Zeitpunkt, zu dem die Shared Access Signature ungültig wird. Erforderlich, es sei denn, es wird eine ID angegeben, die auf eine gespeicherte Zugriffsrichtlinie verweist, die dieses Feld enthält. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde. Azure konvertiert immer Werte in UTC. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist.

start

datetime oder str

Der Zeitpunkt, zu dem die Shared Access Signature gültig wird. Wenn Sie diesen Wert weglassen, wird als Startzeit dieses Aufrufs die Uhrzeit verwendet, zu der die Anforderung vom Speicherdienst empfangen wird. Azure konvertiert immer Werte in UTC. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist.

policy_id

str

Ein eindeutiger Wert mit einer Länge von bis zu 64 Zeichen, der mit einer gespeicherten Zugriffsrichtlinie korreliert. Verwenden set_container_access_policySie zum Erstellen einer gespeicherten Zugriffsrichtlinie .

ip

str

Gibt eine IP-Adresse oder einen Bereich von IP-Adressen an, von denen Anforderungen akzeptiert werden sollen. Wenn die IP-Adresse, von der die Anforderung stammt, nicht mit der IP-Adresse oder dem Adressbereich übereinstimmt, die im SAS-Token angegeben sind, wird die Anforderung nicht authentifiziert. Wenn Sie beispielsweise ip=168.1.5.65 oder ip=168.1.5.60-168.1.5.70 für die SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

version_id

str

Eine optionale Blobversions-ID. Dieser Parameter gilt nur für Speicherkonten mit Aktivierter Versionskontrolle. Beachten Sie, dass der Abfrageparameter "versionid" nicht in der Ausgabe-SAS enthalten ist. Geben Sie daher den Parameter "version_id" für alle APIs an, wenn Sie die Ausgabe-SAS verwenden, um mit einer bestimmten Version zu arbeiten.

Neu in Version 12.4.0: Dieses Schlüsselwort (keyword) Argument wurde in der API-Version "2019-12-12" eingeführt.

protocol

str

Gibt das für eine anforderung zulässige Protokoll an. Der Standardwert ist https.

cache_control

str

Antwortheaderwert für Cache-Control, wenn mithilfe dieser Shared Access Signature auf eine Ressource zugegriffen wird.

content_disposition

str

Antwortheaderwert für Content-Disposition, wenn mithilfe dieser Shared Access Signature auf eine Ressource zugegriffen wird.

content_encoding

str

Antwortheaderwert für Inhaltscodierung, wenn mithilfe dieser Shared Access Signature auf die Ressource zugegriffen wird.

content_language

str

Antwortheaderwert für Content-Language, wenn mithilfe dieser Shared Access Signature auf eine Ressource zugegriffen wird.

content_type

str

Antwortheaderwert für Content-Type, wenn mithilfe dieser Shared Access Signature auf eine Ressource zugegriffen wird.

encryption_scope

str

Gibt den Verschlüsselungsbereich für eine Anforderung an, die ausgeführt wird, damit alle Schreibvorgänge dienstverschlüsselt werden.

correlation_id

str

Die Korrelations-ID zum Korrelieren der Speicherüberwachungsprotokolle mit den Überwachungsprotokollen, die vom Prinzipal zum Generieren und Verteilen der SAS verwendet werden. Dies kann nur beim Generieren einer SAS mit Delegierungsschlüssel verwendet werden.

container_name

str

Der Name des Containers,

account_key

str

Der Kontoschlüssel, auch als freigegebener Schlüssel oder Zugriffsschlüssel bezeichnet, um die Shared Access Signature zu generieren. Es müssen account_key oder user_delegation_key angegeben werden.

user_delegation_key

UserDelegationKey

Anstelle eines freigegebenen Kontoschlüssels könnte der Benutzer einen Benutzerdelegierungsschlüssel übergeben. Ein Benutzerdelegierungsschlüssel kann vom Dienst abgerufen werden, indem sie sich mit einer AAD-Identität authentifiziert; Dies kann erreicht werden, indem Sie aufrufen get_user_delegation_key. Wenn vorhanden, wird die SAS stattdessen mit dem Benutzerdelegierungsschlüssel signiert.

permission

str oder ContainerSasPermissions

Die Berechtigungen, die der SAS zugeordnet sind. Der Benutzer ist auf Vorgänge beschränkt, für die er eine Berechtigung besitzt. Berechtigungen müssen racwdxyltfmei sortiert werden. Erforderlich, es sei denn, es wird eine ID angegeben, die auf eine gespeicherte Zugriffsrichtlinie verweist, die dieses Feld enthält. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde.

expiry

datetime oder str

Der Zeitpunkt, zu dem die Shared Access Signature ungültig wird. Erforderlich, es sei denn, es wird eine ID angegeben, die auf eine gespeicherte Zugriffsrichtlinie verweist, die dieses Feld enthält. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde. Azure konvertiert Werte immer in UTC. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist.

start

datetime oder str

Der Zeitpunkt, zu dem die Shared Access Signature gültig wird. Wenn Sie diesen Wert weglassen, wird als Startzeit dieses Aufrufs die Uhrzeit verwendet, zu der die Anforderung vom Speicherdienst empfangen wird. Azure konvertiert Werte immer in UTC. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist.

policy_id

str

Ein eindeutiger Wert mit einer Länge von bis zu 64 Zeichen, der mit einer gespeicherten Zugriffsrichtlinie korreliert. Verwenden Sie set_container_access_policyzum Erstellen einer gespeicherten Zugriffsrichtlinie .

ip

str

Gibt eine IP-Adresse oder einen IP-Adressbereich an, von dem Anforderungen akzeptiert werden sollen. Wenn die IP-Adresse, von der die Anforderung stammt, nicht mit der IM SAS-Token angegebenen IP-Adresse oder dem Adressbereich übereinstimmt, wird die Anforderung nicht authentifiziert. Wenn Sie beispielsweise ip=168.1.5.65 oder ip=168.1.5.60-168.1.5.70 auf der SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol

str

Gibt das zulässige Protokoll für eine durchgeführte Anforderung an. Der Standardwert ist https.

cache_control

str

Antwortheaderwert für Cache-Control, wenn mithilfe dieser Shared Access Signature auf die Ressource zugegriffen wird.

content_disposition

str

Antwortheaderwert für Content-Disposition, wenn mithilfe dieser Shared Access Signature auf die Ressource zugegriffen wird.

content_encoding

str

Antwortheaderwert für Content-Encoding, wenn auf die Ressource mithilfe dieser Shared Access Signature zugegriffen wird.

content_language

str

Antwortheaderwert für Content-Language, wenn auf die Ressource mithilfe dieser Shared Access Signature zugegriffen wird.

content_type

str

Antwortheaderwert für Content-Type, wenn auf die Ressource mithilfe dieser Shared Access Signature zugegriffen wird.

encryption_scope

str

Gibt den Verschlüsselungsbereich für eine Anforderung an, damit alle Schreibvorgänge vom Dienst verschlüsselt werden.

correlation_id

str

Die Korrelations-ID zum Korrelieren der Speicherüberwachungsprotokolle mit den Überwachungsprotokollen, die vom Prinzipal verwendet werden, der die SAS generiert und verteilt. Dies kann nur beim Generieren einer SAS mit Delegierungsschlüssel verwendet werden.

data

bytes oder str oder Iterable

Die hochzuladenden Daten. Dies können Bytes, Text, ein iterierbares oder ein dateiähnliches Objekt sein.

credential

Die Anmeldeinformationen, mit denen die Authentifizierung erfolgt. Dies ist optional, wenn die Blob-URL bereits über ein SAS-Token verfügt. Der Wert kann eine SAS-Tokenzeichenfolge, eine instance eines AzureSasCredential- oder AzureNamedKeyCredential-Elements von azure.core.credentials, ein kontofreigaber Zugriffsschlüssel oder ein instance einer TokenCredentials-Klasse aus azure.identity sein. Wenn der Ressourcen-URI bereits ein SAS-Token enthält, wird dies zugunsten einer expliziten Anmeldeinformation ignoriert.

• außer im Fall von AzureSasCredential, bei dem die in Konflikt stehenden SAS-Token einen ValueError auslösen. Wenn Sie eine instance von AzureNamedKeyCredential verwenden, sollte "name" der Name des Speicherkontos und "key" der Speicherkontoschlüssel sein.

overwrite

bool

Gibt an, ob das hochzuladende Blob die aktuellen Daten überschreiben soll. Bei True überschreibt upload_blob_to_url alle vorhandenen Daten. Wenn dieser Wert auf False festgelegt ist, schlägt der Vorgang mit einem ResourceExistsError-Element fehl.

max_concurrency

int

Die Anzahl der parallelen Verbindungen, mit denen heruntergeladen werden soll.

length

int

Anzahl der Bytes, die aus dem Stream gelesen werden sollen. Dies ist optional, sollte aber für eine optimale Leistung bereitgestellt werden.

metadata

dict(str,str)

Name-Wert-Paare, die dem BLOB als Metadaten zugeordnet sind.

validate_content

bool

Wenn true, berechnet einen MD5-Hash für jeden Block des Blobs. Der Speicherdienst überprüft den Hash des Inhalts, der mit dem gesendeten Hash eingetroffen ist. Dies ist in erster Linie hilfreich für die Erkennung von Bitflips im Netzwerk, wenn http anstelle von https als https (standard) bereits überprüft wird. Beachten Sie, dass dieser MD5-Hash nicht mit dem BLOB gespeichert wird. Beachten Sie auch, dass der speichereffiziente Uploadalgorithmus bei Aktivierter nicht verwendet wird, da das Berechnen des MD5-Hashs das Puffern ganzer Blöcke erfordert und dies den Zweck des speichereffizienten Algorithmus verfehlt.

encoding

str

Codierung, die verwendet werden soll, wenn Text als Eingabe bereitgestellt wird. Der Standardwert ist UTF-8.