Freigeben über


BlockBlobService Klasse

Mit Block-BLOBs können Sie große BLOBs effizient hochladen. Block-BLOBs bestehen aus Blöcken, von denen jeder durch eine Block-ID identifiziert wird. Sie erstellen oder ändern ein Block-BLOB, indem Sie bestimmte Blöcke schreiben und anhand der Block-IDs einen Commit ausführen. Jeder Block kann eine andere Größe haben, bis zu maximal 100 MB, und ein Blockblob kann bis zu 50.000 Blöcke umfassen. Die maximale Größe eines Blockblobs beträgt daher ungefähr 4,75 TB (100 MB x 50.000 Blöcke). Wenn Sie ein Blockblob schreiben, das nicht mehr als 64 MB groß ist, können Sie es mit einem einzelnen Schreibvorgang vollständig hochladen. siehe create_blob_from_bytes.

:type ~azure.storage.common.TokenCredential

Vererbung
BlockBlobService

Konstruktor

BlockBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)

Parameter

account_name
str
Standardwert: None

Der Name des Speicherkontos. Dies wird verwendet, um mit einem Kontoschlüssel signierte Anforderungen zu authentifizieren und den Speicherendpunkt zu erstellen. Dies ist erforderlich, es sei denn, es wird eine Verbindungszeichenfolge angegeben oder wenn eine benutzerdefinierte Domäne mit anonymer Authentifizierung verwendet wird.

account_key
str
Standardwert: None

Der Speicherkontoschlüssel. Dies wird für die Authentifizierung mit gemeinsam genutzten Schlüsseln verwendet. Wenn weder Kontoschlüssel noch SAS-Token angegeben sind, wird anonymer Zugriff verwendet.

sas_token
str
Standardwert: None

Ein Shared Access Signature-Token, das anstelle des Kontoschlüssels zum Authentifizieren von Anforderungen verwendet werden soll. Wenn Kontoschlüssel und SAS-Token angegeben sind, wird der Kontoschlüssel zum Signieren verwendet. Wenn keines angegeben ist, wird anonymer Zugriff verwendet.

is_emulated
bool
Standardwert: False

Gibt an, ob der Emulator verwendet werden soll. Der Standardwert lautet „False“. Wenn angegeben, überschreibt alle anderen Parameter außer Verbindungszeichenfolge und Anforderungssitzung.

protocol
str
Standardwert: https

Das Protokoll, das für Anforderungen verwendet werden soll. Der Standardwert ist https.

endpoint_suffix
str
Standardwert: core.windows.net

Die Hostbasiskomponente der URL, abzüglich des Kontonamens. Der Standardwert ist Azure (core.windows.net). Überschreiben Sie dies, um die China-Cloud (core.chinacloudapi.cn) zu verwenden.

custom_domain
str
Standardwert: None

Die zu verwendende benutzerdefinierte Domäne. Dies kann im Azure-Portal festgelegt werden. Beispiel: "www.mydomain.com".

request_session
<xref:requests.Session>
Standardwert: None

Das Sitzungsobjekt, das für HTTP-Anforderungen verwendet werden soll.

connection_string
str
Standardwert: None

Wenn angegeben, werden alle anderen Parameter außer der Anforderungssitzung überschrieben. Weitere Informationen finden Sie http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ unter Verbindungszeichenfolge Format.

socket_timeout
int
Standardwert: None

Wenn angegeben, überschreibt dies das Standardmäßige Sockettimeout. Das angegebene Timeout ist in Sekunden angegeben. Den Standardwert finden Sie unter DEFAULT_SOCKET_TIMEOUT in _constants.py.

token_credential
Standardwert: None

Tokenanmeldeinformationen, die zum Authentifizieren von HTTPS-Anforderungen verwendet werden. Der Tokenwert sollte vor seinem Ablauf aktualisiert werden.

Variablen

MAX_SINGLE_PUT_SIZE
int

Die größte Uploadgröße, die in einem einzelnen Put-Aufruf unterstützt wird. Dies wird von den create_blob_from_*-Methoden verwendet, wenn die Inhaltslänge bekannt ist und kleiner als dieser Wert ist.

MAX_BLOCK_SIZE
int

Die Größe der von create_blob_from_*-Methoden platzierten Blöcke, wenn die Inhaltslänge unbekannt oder größer als MAX_SINGLE_PUT_SIZE ist. Kleinere Blöcke können platziert werden. Die vom Dienst unterstützte maximale Blockgröße beträgt 100 MB.

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD
int

Die mindeste Blockgröße, bei der der speicheroptimierte Blockuploadalgorithmus berücksichtigt wird. Dieser Algorithmus gilt nur für die Methoden create_blob_from_file und create_blob_from_stream und verhindert das vollständige Puffern von Blöcken. Zusätzlich zur Blockgröße müssen die Überprüfung und Verschlüsselung von ContentMD5 deaktiviert werden, da für diese Optionen die Blöcke gepuffert werden müssen.

Methoden

abort_copy_blob

Bricht einen ausstehenden copy_blob Vorgang ab und belässt ein Zielblob mit der Länge null und vollständigen Metadaten.

acquire_blob_lease

Fordert eine neue Lease an. Wenn das BLOB über keine aktive Lease verfügt, erstellt der Blob-Dienst eine Lease für das BLOB und gibt eine neue Lease-ID zurück.

acquire_container_lease

Fordert eine neue Lease an. Wenn der Container über keine aktive Lease verfügt, erstellt der Blob-Dienst eine Lease für den Container und gibt eine neue Lease-ID zurück.

batch_delete_blobs

Sendet einen Batch mit mehreren Bloblöschanforderungen.

Die Bloblöschmethode löscht das angegebene Blob oder Momentaufnahme. Beachten Sie, dass durch das Löschen eines Blobs auch alle Momentaufnahmen gelöscht werden. Weitere Informationen finden Sie unter https://docs.microsoft.com/rest/api/storageservices/delete-blob.

batch_set_standard_blob_tier

Sendet einen Batch mit Anforderungen für mehrere Blockblobebenen. Diese API wird nur für Blockblobs in Standardspeicherkonten unterstützt.

break_blob_lease

Unterbricht die Lease, wenn das Blob über eine aktive Lease verfügt. Nachdem eine Lease unterbrochen wurde, kann sie nicht verlängert werden. Die Lease kann von jeder autorisierten Anforderung unterbrochen werden. In der Anforderung muss keine übereinstimmende Lease-ID angegeben werden. Wenn eine Lease unterbrochen wird, darf der Leaseunterbrechungszeitraum verstreichen, in dem für das Blob kein Leasevorgang mit Ausnahme von Unterbrechung und Freigabe ausgeführt werden kann. Wenn eine Lease erfolgreich unterbrochen wurde, gibt die Antwort das Intervall in Sekunden an, bis eine neue Lease abgerufen werden kann.

Eine unterbrochene Lease kann auch freigegeben werden. In diesem Fall kann ein anderer Client sofort die Lease für das BLOB abrufen.

break_container_lease

Unterbrechen Sie die Lease, wenn der Container über eine aktive Lease verfügt. Nachdem eine Lease unterbrochen wurde, kann sie nicht verlängert werden. Die Lease kann von jeder autorisierten Anforderung unterbrochen werden. In der Anforderung muss keine übereinstimmende Lease-ID angegeben werden. Wenn eine Lease unterbrochen wird, darf der Leaseunterbrechungszeitraum verstreichen, während der kein Leasevorgang mit Ausnahme von Unterbrechung und Freigabe für den Container ausgeführt werden kann. Wenn eine Lease erfolgreich unterbrochen wurde, gibt die Antwort das Intervall in Sekunden an, bis eine neue Lease abgerufen werden kann.

change_blob_lease

Ändert die Lease-ID einer aktiven Lease. Eine Änderung muss die aktuelle Lease-ID und eine neue Lease-ID enthalten.

change_container_lease

Ändern Sie die Lease-ID einer aktiven Lease. Eine Änderung muss die aktuelle Lease-ID und eine neue Lease-ID enthalten.

copy_blob

Kopiert ein Blob. Dieser Vorgang gibt ein Eigenschaftenobjekt des Kopiervorgangs zurück. Der Kopiervorgang kann entweder als asynchroner Vorgang mit optimalem Aufwand oder als synchroner Vorgang konfiguriert werden.

Die Quelle muss ein Blockblob sein, wenn requires_sync true ist. Ein eventuell vorhandenes Zielblob wird überschrieben. Das Ziel-BLOB kann nicht geändert werden, während ein Kopiervorgang ausgeführt wird.

Beim Kopieren aus einem Blockblob werden alle gebundenen Blöcke und ihre Block-IDs kopiert. Nicht festgeschriebene Blöcke werden nicht kopiert. Am Ende des Kopiervorgangs weist das Zielblob die gleiche Anzahl von Commits wie die Quelle auf.

Sie können get_blob_properties für das Zielblob aufrufen, um die status des Kopiervorgangs zu überprüfen. Das endgültige Blob wird bei Abschluss des Kopiervorgangs committet.

Name des Zielcontainers. Der Container muss vorhanden sein. :p aram str blob_name: Name des Zielblobs. Wenn das Zielblob vorhanden ist, wird es überschrieben. Andernfalls wird sie erstellt. :p aram str copy_source: Eine URL mit einer Länge von bis zu 2 KB, die eine Azure-Datei oder ein Azure-Blob angibt. Der Wert sollte so URL-codiert sein, wie er in einem Anforderungs-URI verwendet wird. Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder über eine Shared Access Signature authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich. Beispiele: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?Momentaufnahme= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram-Metadaten: Name-Wert-Paare, die dem Blob als Metadaten zugeordnet sind. Wenn keine Name-Wert-Paare angegeben werden, kopiert der Vorgang die Metadaten aus dem Quellblob oder der Quelldatei in das Zielblob. Wenn mindestens ein Name-Wert-Paar angegeben wird, wird das Zielblob mit den angegebenen Metadaten erstellt, und Metadaten werden nicht aus dem Quellblob oder der Quelldatei kopiert. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: A DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Quell-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit geändert wurde. :p aram datetime source_if_unmodified_since: Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Quell-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit nicht geändert wurde. :p aram ETag source_if_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen bedingten Header an, um das Quellblob nur dann zu kopieren, wenn dessen ETag mit dem angegebenen Wert übereinstimmt. Wenn die ETag-Werte nicht übereinstimmen, gibt der Blobdienst status Code 412 (Vorbedingung fehlgeschlagen) zurück. Dieser Header kann nicht angegeben werden, wenn es sich bei der Quelle um eine Azure-Datei handelt. :p aram ETag source_if_none_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen bedingten Header an, um das Quell-BLOB nur dann zu kopieren, wenn sein ETag nicht dem angegebenen Wert entspricht. Bei übereinstimmenden Werten gibt der Blob-Dienst den Statuscode 412 (Vorbedingung nicht erfüllt) zurück. Dieser Header kann nicht angegeben werden, wenn es sich bei der Quelle um eine Azure-Datei handelt. :p aram datetime destination_if_modified_since: Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit geändert wurde. Wenn das Ziel-BLOB nicht geändert wurde, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück. :p aram datetime destination_if_unmodified_since: Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit nicht geändert wurde. Wenn das Ziel-BLOB geändert wurde, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück. :p aram ETag destination_if_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie einen ETag-Wert für diesen bedingten Header an, um das Blob nur dann zu kopieren, wenn der angegebene ETag-Wert mit dem ETag-Wert für ein vorhandenes Zielblob übereinstimmt. Wenn das ETag für das Zielblob nicht mit dem für If-Match angegebenen ETag übereinstimmt, gibt der Blob-Dienst status Code 412 (Voraussetzung fehlgeschlagen) zurück. :p aram ETag destination_if_none_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie einen ETag-Wert für diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn der angegebene ETag-Wert nicht dem ETag-Wert für das Ziel-BLOB entspricht. Geben Sie das Platzhalterzeichen (*) an, um den Vorgang nur dann auszuführen, wenn das Ziel-BLOB nicht vorhanden ist. Wenn die angegebene Bedingung nicht erfüllt ist, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück. :p aram str destination_lease_id: Die für diesen Header angegebene Lease-ID muss mit der Lease-ID des Zielblobs übereinstimmen. Wenn die Anforderung nicht die Lease-ID enthält oder diese ungültig ist, schlägt der Vorgang mit Statuscode 412 (Vorbedingung nicht erfüllt) fehl. :p aram str source_lease_id: Geben Sie dies an, um den Kopierblobvorgang nur auszuführen, wenn die angegebene Lease-ID der aktiven Lease-ID des Quellblobs entspricht. :p aram int timeout: Der Timeoutparameter wird in Sekunden ausgedrückt. :p aram bool requires_sync: Erzwingt, dass der Dienst erst dann eine Antwort zurückgibt, wenn die Kopie abgeschlossen ist. :p aram StandardBlobTier standard_blob_tier: Ein Standardblobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten. :p aram RehydratePriority rehydrate_priority: Gibt die Priorität an, mit der ein archiviertes Blob rehydriert werden soll:return: Kopiervorgangseigenschaften wie status, Quelle und ID. :rtype: CopyProperties

create_blob_from_bytes

Erstellt ein neues Blob aus einem Bytearray oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischen Blöcken und Statusbenachrichtigungen.

create_blob_from_path

Erstellt ein neues Blob aus einem Dateipfad oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischen Blöcken und Statusbenachrichtigungen.

create_blob_from_stream

Erstellt ein neues Blob aus einer Datei/einem Stream oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischen Blöcken und Statusbenachrichtigungen.

create_blob_from_text

Erstellt ein neues Blob aus str/unicode oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischer Blockierung und Statusbenachrichtigungen.

create_container

Erstellt einen neuen Container unter dem angegebenen Konto. Wenn der Container mit demselben Namen bereits vorhanden ist, schlägt der Vorgang fehl, wenn fail_on_exist True ist.

delete_blob

Markiert das angegebene Blob oder Momentaufnahme zum Löschen. Das BLOB wird später während der automatischen Speicherbereinigung gelöscht.

Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit dem Vorgang Blob löschen löschen.

Wenn eine Aufbewahrungsrichtlinie für das Löschen für den Dienst aktiviert ist, löscht dieser Vorgang das Blob oder die Momentaufnahme vorläufig und behält das Blob oder die Momentaufnahme für die angegebene Anzahl von Tagen. Nach der angegebenen Anzahl von Tagen werden die Blobdaten während der Garbage Collection aus dem Dienst entfernt. Auf vorläufig gelöschte Blobs oder Momentaufnahme kann über die Listenblob-API zugegriffen werden, die die Option include=Include.Deleted angibt. Vorläufig gelöschte Blobs oder Momentaufnahme können mithilfe der Undelete-API wiederhergestellt werden.

delete_container

Markiert den angegebenen Container zum Löschen. Der Container und alle darin enthaltenen BLOBs werden später während der automatischen Speicherbereinigung gelöscht.

exists

Gibt einen booleschen Wert zurück, der angibt, ob der Container vorhanden ist (wenn blob_name Keine ist), oder andernfalls einen booleschen Wert, der angibt, ob das Blob vorhanden ist.

extract_date_and_request_id
generate_account_shared_access_signature

Generiert eine Shared Access Signature für den Blobdienst. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token eines beliebigen BlobService.Use the returned signature with the sas_token parameter of any BlobService.

generate_blob_shared_access_signature

Generiert eine Shared Access Signature für das Blob oder eine seiner Momentaufnahmen. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token eines beliebigen BlobService.Use the returned signature with the sas_token parameter of any BlobService.

generate_container_shared_access_signature

Generiert eine Shared Access Signature für den Container. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token eines beliebigen BlobService.Use the returned signature with the sas_token parameter of any BlobService.

get_blob_account_information

Ruft Informationen im Zusammenhang mit dem Speicherkonto ab. Die Informationen können auch abgerufen werden, wenn der Benutzer über eine SAS für einen Container oder ein Blob verfügt.

get_blob_metadata

Gibt alle benutzerdefinierten Metadaten für das angegebene Blob oder Momentaufnahme zurück.

get_blob_properties

Gibt alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für das BLOB zurück. Der Inhalt des BLOB wird nicht zurückgegeben. Gibt mit BlobProperties und ein Metadatenedikt zurückBlob.

get_blob_service_properties

Ruft die Eigenschaften des Blobdiensts eines Speicherkontos ab, einschließlich Azure Storage Analytics.

get_blob_service_stats

Ruft Statistiken zur Replikation für den Blob-Dienst ab. Sie ist nur verfügbar, wenn die georedundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

Mit der georedundanten Replikation behält der Azure-Speicher Daten an zwei Standorten permanent bei. An beiden Standorten behält der Azure-Speicher mehrere fehlerfreie Replikate der Daten bei. Der Standort, an dem Sie Daten lesen, erstellen, aktualisieren oder löschen, ist der primäre Speicherkontostandort. Der primäre Standort befindet sich in der Region, die Sie zum Zeitpunkt der Erstellung eines Kontos über das klassische Azure Management-Azure-Portal ausgewählt haben, z. B. USA, Norden, Mitte. Als sekundärer Standort wird der Standort bezeichnet, an dem die Daten repliziert werden. Der sekundäre Standort wird automatisch auf Grundlage des primären Standorts ermittelt und befindet sich in einem zweiten Rechenzentrum in derselben Region wie der primäre Standort. Der schreibgeschützte Zugriff ist über den sekundären Standort verfügbar, wenn die georedundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

get_blob_to_bytes

Lädt ein Blob als Array von Bytes mit automatischen Blöcken und Statusbenachrichtigungen herunter. Gibt eine instance von Blob mit Eigenschaften, Metadaten und Inhalten zurück.

get_blob_to_path

Lädt ein Blob mit automatischen Block- und Statusbenachrichtigungen in einen Dateipfad herunter. Gibt eine instance von Blob mit Eigenschaften und Metadaten zurück.

get_blob_to_stream

Lädt ein Blob mit automatischen Block- und Statusbenachrichtigungen in einen Stream herunter. Gibt eine instance von Blob mit Eigenschaften und Metadaten zurück.

get_blob_to_text

Lädt ein Blob als Unicode-Text mit automatischen Blöcken und Statusbenachrichtigungen herunter. Gibt eine instance von Blob mit Eigenschaften, Metadaten und Inhalten zurück.

get_block_list

Ruft die Liste der Blöcke ab, die als Teil eines Block-BLOB hochgeladen wurden. Für ein BLOB werden zwei Blockierlisten verwaltet:

Gesperrte Blockliste: Die Liste der Blöcke, die erfolgreich für ein bestimmtes Blob mit Put Block List festgelegt wurden.

Nicht festgelegte Blockliste: Die Liste der Blöcke, die mithilfe von Put Block für ein Blob hochgeladen, aber noch nicht committet wurden. Diese Blöcke werden in Azure in Verbindung mit einem BLOB gespeichert, sind aber noch nicht Teil des BLOB.

get_container_acl

Ruft die Berechtigungen für den angegebenen Container ab. Mit den Berechtigungen wird angegeben, ob auf die Containerdaten öffentlich zugegriffen werden kann.

get_container_metadata

Gibt alle benutzerdefinierten Metadaten für den angegebenen Container zurück.

get_container_properties

Gibt alle benutzerdefinierten Metadaten und Systemeigenschaften für den angegebenen Container zurück. Die zurückgegebenen Daten enthalten nicht die Liste von BLOBs des Containers.

get_user_delegation_key

Rufen Sie einen Benutzerdelegierungsschlüssel zum Signieren von SAS-Token ab. Im Dienstobjekt müssen Tokenanmeldeinformationen vorhanden sein, damit diese Anforderung erfolgreich ist.

list_blob_names

Gibt einen Generator zurück, um die Blobnamen unter dem angegebenen Container aufzulisten. Der Generator folgt den vom Dienst zurückgegebenen Fortsetzungstoken und wird beendet, wenn alle Blobs zurückgegeben wurden oder num_results erreicht wurde.

Wenn num_results angegeben ist und das Konto über mehr als diese Anzahl von Blobs verfügt, verfügt der Generator nach Abschluss über ein aufgefülltes next_marker Feld. Dieser Marker kann verwendet werden, um einen neuen Generator zu erstellen, wenn weitere Ergebnisse gewünscht werden.

list_blobs

Gibt einen Generator zurück, der die Blobs unter dem angegebenen Container auflistet. Der Generator folgt den vom Dienst zurückgegebenen Fortsetzungstoken und wird beendet, wenn alle Blobs zurückgegeben wurden oder num_results erreicht wurde.

Wenn num_results angegeben ist und das Konto über mehr als diese Anzahl von Blobs verfügt, verfügt der Generator nach Abschluss über ein aufgefülltes next_marker Feld. Dieser Marker kann verwendet werden, um einen neuen Generator zu erstellen, wenn weitere Ergebnisse gewünscht werden.

list_containers

Gibt einen Generator zurück, um die Container unter dem angegebenen Konto aufzulisten. Der Generator folgt den vom Dienst zurückgegebenen Fortsetzungstoken und wird beendet, wenn alle Container zurückgegeben wurden oder num_results erreicht wurde.

Wenn num_results angegeben ist und das Konto über mehr als diese Anzahl von Containern verfügt, verfügt der Generator nach Abschluss über ein aufgefülltes next_marker Feld. Dieser Marker kann verwendet werden, um einen neuen Generator zu erstellen, wenn weitere Ergebnisse gewünscht werden.

make_blob_url

Erstellt die URL für den Zugriff auf ein Blob.

make_container_url

Erstellt die URL für den Zugriff auf einen Container.

put_block

Erstellt einen neuen Block, für den ein Commit als Teil eines BLOB ausgeführt werden soll.

put_block_from_url

Erstellt einen neuen Block, für den ein Commit als Teil eines BLOB ausgeführt werden soll.

put_block_list

Schreibt ein BLOB, indem die Liste der Block-IDs angegeben wird, aus denen sich das BLOB zusammensetzt. Um als Teil eines Blobs geschrieben zu werden, muss ein Block in einem vorherigen Put Block-Vorgang erfolgreich auf den Server geschrieben worden sein.

Sie können Put Block List aufrufen, um ein Blob zu aktualisieren, indem Sie nur die Blöcke hochladen, die sich geändert haben, und dann die neuen und vorhandenen Blöcke zusammen commitsieren. Dies erreichen Sie, indem Sie angeben, ob für einen Block aus der Liste der Blöcke mit ausgeführtem Commit oder der Liste der Blöcke ohne ausgeführten Commit ein Commit ausgeführt werden soll, oder ob für die zuletzt hochgeladene Version des Blocks ein Commit ausgeführt werden soll, je nachdem, in welcher Liste der Block enthalten ist.

release_blob_lease

Gibt die Lease frei. Die Lease kann freigegeben werden, wenn die in der Anforderung angegebene Lease-ID mit der Lease-ID übereinstimmt, die dem BLOB zugeordnet ist. Durch das Freigeben der Lease kann ein anderer Client die Lease für das BLOB sofort abrufen, sobald die Freigabe abgeschlossen wurde.

release_container_lease

Geben Sie die Lease frei. Die Lease kann freigegeben werden, wenn die angegebene lease_id dem dem Container zugeordneten entspricht. Durch das Freigeben der Lease kann ein anderer Client die Lease für den Container sofort abrufen, sobald die Freigabe abgeschlossen wurde.

renew_blob_lease

Erneuert die Lease. Die Lease kann verlängert werden, wenn die in der Anforderung angegebene Lease-ID mit der Lease-ID übereinstimmt, die dem BLOB zugeordnet ist. Beachten Sie, dass die Lease selbst dann verlängert werden kann, wenn sie abgelaufen ist, falls das BLOB seit dem Ablauf der betreffenden Lease nicht geändert und noch nicht wieder geleast wurde. Beim Verlängern einer Lease wird die Leasedauer zurückgesetzt.

renew_container_lease

Erneuert die Lease. Die Lease kann verlängert werden, wenn die angegebene Lease-ID der dem Container zugeordneten entspricht. Beachten Sie, dass die Lease selbst dann erneuert werden kann, wenn sie abgelaufen ist, falls der Container seit dem Ablauf der betreffenden Lease noch nicht wieder geleast wurde. Beim Verlängern einer Lease wird die Leasedauer zurückgesetzt.

set_blob_metadata

Legt benutzerdefinierte Metadaten für das angegebene Blob als mindestens ein Name-Wert-Paar fest.

set_blob_properties

Legt Systemeigenschaften für den Blob fest. Wenn eine Eigenschaft für die content_settings festgelegt ist, werden alle Eigenschaften überschrieben.

set_blob_service_properties

Legt die Eigenschaften des Blobdiensts eines Speicherkontos fest, einschließlich Azure Storage Analytics. Wenn ein Element (z. B. Protokollierung) als Keine beibehalten wird, werden die vorhandenen Einstellungen für den Dienst für diese Funktionalität beibehalten.

set_container_acl

Legt die Berechtigungen für den angegebenen Container oder die gespeicherten Zugriffsrichtlinien fest, die mit Shared Access Signatures verwendet werden können. Die Berechtigungen geben an, ob öffentlicher Zugriff auf BLOBs in einem Container zulässig ist.

set_container_metadata

Legt mindestens ein benutzerdefiniertes Name-Wert-Paar für den angegebenen Container fest. Bei jedem Aufruf dieses Vorgangs werden alle vorhandenen Metadaten ersetzt, die an den Container angefügt sind. Um alle Metadaten aus dem Container zu entfernen, rufen Sie diesen Vorgang ohne Metadaten-Diktat auf.

set_proxy

Legt den Host und Port des Proxyservers für http CONNECT Tunnelling fest.

set_standard_blob_tier

Legt die Blockblobebenen für das Blob fest. Diese API wird nur für Blockblobs in Standardspeicherkonten unterstützt.

:p aram RehydratePriority rehydrate_priority: Gibt die Priorität an, mit der ein archiviertes Blob rehydriert werden soll.

snapshot_blob

Erstellt eine schreibgeschützte Momentaufnahme eines BLOB.

undelete_blob

Der Vorgang "Blob rückgängig" stellt den Inhalt und die Metadaten von vorläufig gelöschten Blobs oder Momentaufnahme wieder her. Der Versuch, ein Blob oder Momentaufnahme, das nicht vorläufig gelöscht wurde, rückgängig zu machen, ist ohne Änderungen erfolgreich.

abort_copy_blob

Bricht einen ausstehenden copy_blob Vorgang ab und belässt ein Zielblob mit der Länge null und vollständigen Metadaten.

abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des Zielcontainers.

blob_name
str
Erforderlich

Name des Zielblobs.

copy_id
str
Erforderlich

Kopieren Sie den bezeichner, der im copy.id des ursprünglichen copy_blob-Vorgangs angegeben ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das Ziel-BLOB über eine aktive Lease für unbegrenzte Dauer verfügt.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

acquire_blob_lease

Fordert eine neue Lease an. Wenn das BLOB über keine aktive Lease verfügt, erstellt der Blob-Dienst eine Lease für das BLOB und gibt eine neue Lease-ID zurück.

acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

lease_duration
int
Standardwert: -1

Gibt die Dauer der Lease in Sekunden oder als minus eins (-1) für eine nie ablaufende Lease an. Die Dauer einer nicht unendlichen Lease kann zwischen 15 und 60 Sekunden liegen. Eine Leasedauer kann nicht mithilfe von Verlängerung oder Änderung geändert werden. Der Standardwert ist -1 (unbegrenzte Lease).

proposed_lease_id
str
Standardwert: None

Vorgeschlagene Lease-ID in einem GUID-Zeichenfolgenformat. Der Blob-Dienst gibt 400 (Ungültige Anforderung) zurück, wenn die vorgeschlagene Lease-ID nicht das richtige Format aufweist.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls vorhanden.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

str

acquire_container_lease

Fordert eine neue Lease an. Wenn der Container über keine aktive Lease verfügt, erstellt der Blob-Dienst eine Lease für den Container und gibt eine neue Lease-ID zurück.

acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_duration
int
Standardwert: -1

Gibt die Dauer der Lease in Sekunden oder als minus eins (-1) für eine nie ablaufende Lease an. Die Dauer einer nicht unendlichen Lease kann zwischen 15 und 60 Sekunden liegen. Eine Leasedauer kann nicht mithilfe von Verlängerung oder Änderung geändert werden. Der Standardwert ist -1 (unbegrenzte Lease).

proposed_lease_id
str
Standardwert: None

Vorgeschlagene Lease-ID in einem GUID-Zeichenfolgenformat. Der Blob-Dienst gibt 400 (Ungültige Anforderung) zurück, wenn die vorgeschlagene Lease-ID nicht das richtige Format aufweist.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

str

batch_delete_blobs

Sendet einen Batch mit mehreren Bloblöschanforderungen.

Die Bloblöschmethode löscht das angegebene Blob oder Momentaufnahme. Beachten Sie, dass durch das Löschen eines Blobs auch alle Momentaufnahmen gelöscht werden. Weitere Informationen finden Sie unter https://docs.microsoft.com/rest/api/storageservices/delete-blob.

batch_delete_blobs(batch_delete_sub_requests, timeout=None)

Parameter

batch_delete_sub_requests
list(BatchDeleteSubRequest)
Erforderlich

Die Bloblöschanforderungen, die als Batch gesendet werden sollen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

HTTP-Antwort mit analysiertem Batchlöschen

Rückgabetyp

batch_set_standard_blob_tier

Sendet einen Batch mit Anforderungen für mehrere Blockblobebenen. Diese API wird nur für Blockblobs in Standardspeicherkonten unterstützt.

batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)

Parameter

batch_set_blob_tier_sub_requests
list(BatchSetBlobTierSubRequest)
Erforderlich

Der Set block blob tier requests to send as a batch.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe des Azure-Diensts tätigen, und das Timeout gilt für jeden Aufruf einzeln.

Gibt zurück

HTTP-Antwort auf analysierten Batchsatzebenen, die angibt, ob jede Unteranforderung erfolgreich ist.

Rückgabetyp

break_blob_lease

Unterbricht die Lease, wenn das Blob über eine aktive Lease verfügt. Nachdem eine Lease unterbrochen wurde, kann sie nicht verlängert werden. Die Lease kann von jeder autorisierten Anforderung unterbrochen werden. In der Anforderung muss keine übereinstimmende Lease-ID angegeben werden. Wenn eine Lease unterbrochen wird, darf der Leaseunterbrechungszeitraum verstreichen, in dem für das Blob kein Leasevorgang mit Ausnahme von Unterbrechung und Freigabe ausgeführt werden kann. Wenn eine Lease erfolgreich unterbrochen wurde, gibt die Antwort das Intervall in Sekunden an, bis eine neue Lease abgerufen werden kann.

Eine unterbrochene Lease kann auch freigegeben werden. In diesem Fall kann ein anderer Client sofort die Lease für das BLOB abrufen.

break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

lease_break_period
int
Standardwert: None

Für einen Unterbrechungsvorgang ist dies die vorgeschlagene Dauer von Sekunden, die die Lease fortsetzen sollte, bevor sie unterbrochen wird, zwischen 0 und 60 Sekunden. Dieser Unterbrechungszeitraum wird nur verwendet, wenn er kürzer als die verbleibende Zeit für die Lease ist. Ist er länger, wird die verbleibende Zeit für die Lease verwendet. Eine neue Lease ist erst verfügbar, wenn der Unterbrechungszeitraum abgelaufen ist. Allerdings ist es möglich, dass die Lease länger als der Unterbrechungszeitraum beibehalten wird. Wenn dieser Header nicht mit einem Unterbrechungsvorgang angezeigt wird, wird eine Lease mit fester Dauer unterbrochen, nachdem der verbleibende Leasezeitraum abgelaufen ist, und eine unendliche Lease bricht sofort.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

INT

break_container_lease

Unterbrechen Sie die Lease, wenn der Container über eine aktive Lease verfügt. Nachdem eine Lease unterbrochen wurde, kann sie nicht verlängert werden. Die Lease kann von jeder autorisierten Anforderung unterbrochen werden. In der Anforderung muss keine übereinstimmende Lease-ID angegeben werden. Wenn eine Lease unterbrochen wird, darf der Leaseunterbrechungszeitraum verstreichen, während der kein Leasevorgang mit Ausnahme von Unterbrechung und Freigabe für den Container ausgeführt werden kann. Wenn eine Lease erfolgreich unterbrochen wurde, gibt die Antwort das Intervall in Sekunden an, bis eine neue Lease abgerufen werden kann.

break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_break_period
int
Standardwert: None

Dies ist die vorgeschlagene Dauer von Sekunden, die die Lease fortsetzen sollte, bevor sie unterbrochen wird, zwischen 0 und 60 Sekunden. Dieser Unterbrechungszeitraum wird nur verwendet, wenn er kürzer als die verbleibende Zeit für die Lease ist. Ist er länger, wird die verbleibende Zeit für die Lease verwendet. Eine neue Lease ist erst verfügbar, wenn der Unterbrechungszeitraum abgelaufen ist. Allerdings ist es möglich, dass die Lease länger als der Unterbrechungszeitraum beibehalten wird. Wenn dieser Header nicht mit einem Unterbrechungsvorgang angezeigt wird, wird eine Lease mit fester Dauer unterbrochen, nachdem der verbleibende Leasezeitraum abgelaufen ist, und eine unendliche Lease bricht sofort.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

INT

change_blob_lease

Ändert die Lease-ID einer aktiven Lease. Eine Änderung muss die aktuelle Lease-ID und eine neue Lease-ID enthalten.

change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

lease_id
str
Erforderlich

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

proposed_lease_id
str
Erforderlich

Vorgeschlagene Lease-ID in einem GUID-Zeichenfolgenformat. Der Blobdienst gibt 400 (Ungültige Anforderung) zurück, wenn die vorgeschlagene Lease-ID nicht im richtigen Format vorliegt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

change_container_lease

Ändern Sie die Lease-ID einer aktiven Lease. Eine Änderung muss die aktuelle Lease-ID und eine neue Lease-ID enthalten.

change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_id
str
Erforderlich

Lease-ID für aktives Lease.

proposed_lease_id
str
Erforderlich

Vorgeschlagene Lease-ID in einem GUID-Zeichenfolgenformat. Der Blobdienst gibt 400 (Ungültige Anforderung) zurück, wenn die vorgeschlagene Lease-ID nicht im richtigen Format vorliegt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

copy_blob

Kopiert ein Blob. Dieser Vorgang gibt ein Eigenschaftenobjekt des Kopiervorgangs zurück. Der Kopiervorgang kann entweder als asynchroner Vorgang mit optimalem Aufwand oder als synchroner Vorgang konfiguriert werden.

Die Quelle muss ein Blockblob sein, wenn requires_sync true ist. Ein eventuell vorhandenes Zielblob wird überschrieben. Das Ziel-BLOB kann nicht geändert werden, während ein Kopiervorgang ausgeführt wird.

Beim Kopieren aus einem Blockblob werden alle gebundenen Blöcke und ihre Block-IDs kopiert. Nicht festgeschriebene Blöcke werden nicht kopiert. Am Ende des Kopiervorgangs weist das Zielblob die gleiche Anzahl von Commits wie die Quelle auf.

Sie können get_blob_properties für das Zielblob aufrufen, um die status des Kopiervorgangs zu überprüfen. Das endgültige Blob wird bei Abschluss des Kopiervorgangs committet.

Name des Zielcontainers. Der Container muss vorhanden sein. :p aram str blob_name: Name des Zielblobs. Wenn das Zielblob vorhanden ist, wird es überschrieben. Andernfalls wird sie erstellt. :p aram str copy_source: Eine URL mit einer Länge von bis zu 2 KB, die eine Azure-Datei oder ein Azure-Blob angibt. Der Wert sollte so URL-codiert sein, wie er in einem Anforderungs-URI verwendet wird. Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder über eine Shared Access Signature authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich. Beispiele: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?Momentaufnahme= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram-Metadaten: Name-Wert-Paare, die dem Blob als Metadaten zugeordnet sind. Wenn keine Name-Wert-Paare angegeben werden, kopiert der Vorgang die Metadaten aus dem Quellblob oder der Quelldatei in das Zielblob. Wenn mindestens ein Name-Wert-Paar angegeben wird, wird das Zielblob mit den angegebenen Metadaten erstellt, und Metadaten werden nicht aus dem Quellblob oder der Quelldatei kopiert. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: A DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Quell-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit geändert wurde. :p aram datetime source_if_unmodified_since: Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Quell-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit nicht geändert wurde. :p aram ETag source_if_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen bedingten Header an, um das Quellblob nur dann zu kopieren, wenn dessen ETag mit dem angegebenen Wert übereinstimmt. Wenn die ETag-Werte nicht übereinstimmen, gibt der Blobdienst status Code 412 (Vorbedingung fehlgeschlagen) zurück. Dieser Header kann nicht angegeben werden, wenn es sich bei der Quelle um eine Azure-Datei handelt. :p aram ETag source_if_none_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen bedingten Header an, um das Quell-BLOB nur dann zu kopieren, wenn sein ETag nicht dem angegebenen Wert entspricht. Bei übereinstimmenden Werten gibt der Blob-Dienst den Statuscode 412 (Vorbedingung nicht erfüllt) zurück. Dieser Header kann nicht angegeben werden, wenn es sich bei der Quelle um eine Azure-Datei handelt. :p aram datetime destination_if_modified_since: Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit geändert wurde. Wenn das Ziel-BLOB nicht geändert wurde, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück. :p aram datetime destination_if_unmodified_since: Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit nicht geändert wurde. Wenn das Ziel-BLOB geändert wurde, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück. :p aram ETag destination_if_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie einen ETag-Wert für diesen bedingten Header an, um das Blob nur dann zu kopieren, wenn der angegebene ETag-Wert mit dem ETag-Wert für ein vorhandenes Zielblob übereinstimmt. Wenn das ETag für das Zielblob nicht mit dem für If-Match angegebenen ETag übereinstimmt, gibt der Blob-Dienst status Code 412 (Voraussetzung fehlgeschlagen) zurück. :p aram ETag destination_if_none_match: Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie einen ETag-Wert für diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn der angegebene ETag-Wert nicht dem ETag-Wert für das Ziel-BLOB entspricht. Geben Sie das Platzhalterzeichen (*) an, um den Vorgang nur dann auszuführen, wenn das Ziel-BLOB nicht vorhanden ist. Wenn die angegebene Bedingung nicht erfüllt ist, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück. :p aram str destination_lease_id: Die für diesen Header angegebene Lease-ID muss mit der Lease-ID des Zielblobs übereinstimmen. Wenn die Anforderung nicht die Lease-ID enthält oder diese ungültig ist, schlägt der Vorgang mit Statuscode 412 (Vorbedingung nicht erfüllt) fehl. :p aram str source_lease_id: Geben Sie dies an, um den Kopierblobvorgang nur auszuführen, wenn die angegebene Lease-ID der aktiven Lease-ID des Quellblobs entspricht. :p aram int timeout: Der Timeoutparameter wird in Sekunden ausgedrückt. :p aram bool requires_sync: Erzwingt, dass der Dienst erst dann eine Antwort zurückgibt, wenn die Kopie abgeschlossen ist. :p aram StandardBlobTier standard_blob_tier: Ein Standardblobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten. :p aram RehydratePriority rehydrate_priority: Gibt die Priorität an, mit der ein archiviertes Blob rehydriert werden soll:return: Kopiervorgangseigenschaften wie status, Quelle und ID. :rtype: CopyProperties

copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)

Parameter

container_name
str
Erforderlich
blob_name
Erforderlich
copy_source
Erforderlich
metadata
Standardwert: None
source_if_modified_since
Standardwert: None
source_if_unmodified_since
Standardwert: None
source_if_match
Standardwert: None
source_if_none_match
Standardwert: None
destination_if_modified_since
Standardwert: None
destination_if_unmodified_since
Standardwert: None
destination_if_match
Standardwert: None
destination_if_none_match
Standardwert: None
destination_lease_id
Standardwert: None
source_lease_id
Standardwert: None
timeout
Standardwert: None
requires_sync
Standardwert: None
standard_blob_tier
Standardwert: None
rehydrate_priority
Standardwert: None

create_blob_from_bytes

Erstellt ein neues Blob aus einem Bytearray oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischen Blöcken und Statusbenachrichtigungen.

create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des zu erstellenden oder zu aktualisierenden Blobs.

blob
bytes
Erforderlich

Inhalt des Blobs als Array von Bytes.

index
int
Standardwert: 0

Starten Sie den Index im Bytearray.

count
int
Standardwert: None

Anzahl der hochzuladenden Bytes. Legen Sie auf Keinen oder negativen Wert fest, um alle Bytes ab dem Index hochzuladen.

content_settings
ContentSettings
Standardwert: None

ContentSettings-Objekt, das zum Festlegen von Blobeigenschaften verwendet wird.

metadata
dict(str, str)
Standardwert: None

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

validate_content
bool
Standardwert: False

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.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei "current" die Anzahl der bisher übertragenen Bytes und "total" die Größe des Blobs ist, oder "None", wenn die Gesamtgröße unbekannt ist.

max_connections
int
Standardwert: 2

Maximale Anzahl paralleler Verbindungen, die verwendet werden sollen, wenn die Blobgröße 64 MB überschreitet.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe des Azure-Diensts tätigen, und das Timeout gilt für jeden Aufruf einzeln.

standard_blob_tier
StandardBlobTier
Standardwert: None

Ein Standardblobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für das Blockblob

Rückgabetyp

create_blob_from_path

Erstellt ein neues Blob aus einem Dateipfad oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischen Blöcken und Statusbenachrichtigungen.

create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des zu erstellenden oder zu aktualisierenden Blobs.

file_path
str
Erforderlich

Pfad der Datei, die als Blobinhalt hochgeladen werden soll.

content_settings
ContentSettings
Standardwert: None

ContentSettings-Objekt, das zum Festlegen von Blobeigenschaften verwendet wird.

metadata
dict(str, str)
Standardwert: None

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

validate_content
bool
Standardwert: False

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.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei "current" die Anzahl der bisher übertragenen Bytes und "total" die Größe des Blobs ist, oder "None", wenn die Gesamtgröße unbekannt ist.

max_connections
int
Standardwert: 2

Maximale Anzahl paralleler Verbindungen, die verwendet werden sollen, wenn die Blobgröße 64 MB überschreitet.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe des Azure-Diensts tätigen, und das Timeout gilt für jeden Aufruf einzeln.

standard_blob_tier
StandardBlobTier
Standardwert: None

Ein Standardblobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für das Blockblob

Rückgabetyp

create_blob_from_stream

Erstellt ein neues Blob aus einer Datei/einem Stream oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischen Blöcken und Statusbenachrichtigungen.

create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, use_byte_buffer=False, standard_blob_tier=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des zu erstellenden oder zu aktualisierenden Blobs.

stream
IOBase
Erforderlich

Datei/Stream zum Hochladen als Blobinhalt geöffnet.

count
int
Standardwert: None

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

content_settings
ContentSettings
Standardwert: None

ContentSettings-Objekt, das zum Festlegen von Blobeigenschaften verwendet wird.

metadata
dict(str, str)
Standardwert: None

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

validate_content
bool
Standardwert: False

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.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei "current" die Anzahl der bisher übertragenen Bytes und "total" die Größe des Blobs ist, oder "None", wenn die Gesamtgröße unbekannt ist.

max_connections
int
Standardwert: 2

Maximale Anzahl paralleler Verbindungen, die verwendet werden sollen, wenn die Blobgröße 64 MB überschreitet. Beachten Sie, dass für den parallelen Upload der Datenstrom suchbar ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe des Azure-Diensts tätigen, und das Timeout gilt für jeden Aufruf einzeln.

use_byte_buffer
bool
Standardwert: False

Bei True erzwingt dies die Verwendung des ursprünglichen vollständigen Blockpufferuploadpfads. Standardmäßig ist dieser Wert False und verwendet unter den folgenden Bedingungen einen speichereffizienten Streaminguploadalgorithmus: Der bereitgestellte Stream ist suchbar, "require_encryption" ist False und MAX_BLOCK_SIZE >= MIN_LARGE_BLOCK_UPLOAD_THRESHOLD. Man sollte die Nachteile dieser Vorgehensweise berücksichtigen. Um die Speichereffizienz zu erzielen, wird ein IOBase-Stream oder ein dateiähnliches Objekt mithilfe eines SubStream-Wrappers in logische Blöcke segmentiert. Um die richtigen Daten zu lesen, muss jeder SubStream eine Sperre abrufen, damit er sicher die richtige Position im freigegebenen, zugrunde liegenden Stream suchen kann. Wenn max_connections > 1, führt die Parallelität zu einer beträchtlichen Anzahl von Suchvorgängen für den zugrunde liegenden Stream. Für die häufigsten Eingaben wie ein dateiähnliches Streamobjekt ist die Suche ein kostengünstiger Vorgang, und dies ist kein großes Problem. Für andere Varianten von Streams ist dies jedoch möglicherweise nicht der Fall. Der Kompromiss für die Speichereffizienz muss mit den Kosten für die Suche mit Ihrem Eingabedatenstrom abgewogen werden. Die SubStream-Klasse versucht, intern bis zu 4 MB zu puffern, um die Anzahl der Such- und Leseaufrufe für den zugrunde liegenden Stream zu reduzieren. Dies ist besonders vorteilhaft beim Hochladen größerer Blöcke.

standard_blob_tier
StandardBlobTier
Standardwert: None

Ein Standardblobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für das Blockblob

Rückgabetyp

create_blob_from_text

Erstellt ein neues Blob aus str/unicode oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischer Blockierung und Statusbenachrichtigungen.

create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des zu erstellenden oder zu aktualisierenden Blobs.

text
str
Erforderlich

Text, der in das Blob hochgeladen werden soll.

encoding
str
Standardwert: utf-8

Python-Codierung, die zum Konvertieren des Texts in Bytes verwendet werden soll.

content_settings
ContentSettings
Standardwert: None

ContentSettings-Objekt, das zum Festlegen von Blobeigenschaften verwendet wird.

metadata
dict(str, str)
Standardwert: None

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

validate_content
bool
Standardwert: False

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.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei "current" die Anzahl der bisher übertragenen Bytes und "total" die Größe des Blobs ist, oder "None", wenn die Gesamtgröße unbekannt ist.

max_connections
int
Standardwert: 2

Maximale Anzahl paralleler Verbindungen, die verwendet werden sollen, wenn die Blobgröße 64 MB überschreitet.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe des Azure-Diensts tätigen, und das Timeout gilt für jeden Aufruf einzeln.

standard_blob_tier
StandardBlobTier
Standardwert: None

Ein Standardblobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für das Blockblob

Rückgabetyp

create_container

Erstellt einen neuen Container unter dem angegebenen Konto. Wenn der Container mit demselben Namen bereits vorhanden ist, schlägt der Vorgang fehl, wenn fail_on_exist True ist.

create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)

Parameter

container_name
str
Erforderlich

Name des zu erstellenden Containers. Der Containername darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten und muss mit einem Buchstaben oder einer Zahl beginnen. Vor und nach jedem Bindestrich muss ein Zeichen stehen, das kein Bindestrich ist. Der Name muss außerdem zwischen 3 und 63 Zeichen lang sein.

metadata
dict(str, str)
Standardwert: None

Ein Diktat mit name_value Paaren, die dem Container als Metadaten zugeordnet werden sollen. Beispiel:{'Category':'test'}

public_access
PublicAccess
Standardwert: None

Mögliche Werte sind: Container, Blob.

fail_on_exist
bool
Standardwert: False

Geben Sie an, ob eine Ausnahme ausgelöst werden soll, wenn der Container vorhanden ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

True, wenn der Container erstellt wird, False, wenn der Container bereits vorhanden ist.

Rückgabetyp

delete_blob

Markiert das angegebene Blob oder Momentaufnahme zum Löschen. Das BLOB wird später während der automatischen Speicherbereinigung gelöscht.

Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit dem Vorgang Blob löschen löschen.

Wenn eine Aufbewahrungsrichtlinie für das Löschen für den Dienst aktiviert ist, löscht dieser Vorgang das Blob oder die Momentaufnahme vorläufig und behält das Blob oder die Momentaufnahme für die angegebene Anzahl von Tagen. Nach der angegebenen Anzahl von Tagen werden die Blobdaten während der Garbage Collection aus dem Dienst entfernt. Auf vorläufig gelöschte Blobs oder Momentaufnahme kann über die Listenblob-API zugegriffen werden, die die Option include=Include.Deleted angibt. Vorläufig gelöschte Blobs oder Momentaufnahme können mithilfe der Undelete-API wiederhergestellt werden.

delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

snapshot
str
Standardwert: None

Der Momentaufnahme-Parameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, den zu löschenden Blob-Momentaufnahme angibt.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

delete_snapshots
DeleteSnapshot
Standardwert: None

Erforderlich, wenn dem BLOB Momentaufnahmen zugeordnet sind.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

delete_container

Markiert den angegebenen Container zum Löschen. Der Container und alle darin enthaltenen BLOBs werden später während der automatischen Speicherbereinigung gelöscht.

delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des zu löschenden Containers.

fail_not_exist
bool
Standardwert: False

Geben Sie an, ob eine Ausnahme ausgelöst werden soll, wenn der Container nicht vorhanden ist.

lease_id
str
Standardwert: None

Wenn angegeben, ist delete_container nur erfolgreich, wenn die Lease des Containers aktiv ist und dieser ID entspricht. Erforderlich, wenn der Container über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

True, wenn der Container gelöscht wird, ist kein falscher Container vorhanden.

Rückgabetyp

exists

Gibt einen booleschen Wert zurück, der angibt, ob der Container vorhanden ist (wenn blob_name Keine ist), oder andernfalls einen booleschen Wert, der angibt, ob das Blob vorhanden ist.

exists(container_name, blob_name=None, snapshot=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name eines Containers.

blob_name
str
Standardwert: None

Name eines Blobs. Wenn Keine vorhanden ist, wird der Container auf Existenz überprüft.

snapshot
str
Standardwert: None

Der Momentaufnahme-Parameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, den Momentaufnahme angibt.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Ein boolescher Wert, der angibt, ob die Ressource vorhanden ist.

Rückgabetyp

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Parameter

retry_context
Erforderlich

generate_account_shared_access_signature

Generiert eine Shared Access Signature für den Blobdienst. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token eines beliebigen BlobService.Use the returned signature with the sas_token parameter of any BlobService.

generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)

Parameter

resource_types
<xref:ResourceTypes>
Erforderlich

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

permission
<xref:AccountPermissions>
Erforderlich

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
Erforderlich

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
Standardwert: None

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
Standardwert: None

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 sip=168.1.5.65 oder sip=168.1.5.60-168.1.5.70 auf der SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol
str
Standardwert: None

Gibt das zulässige Protokoll für eine durchgeführte Anforderung an. Der Standardwert ist https,http. Unter Protocol finden Sie mögliche Werte.

Gibt zurück

Ein Sas-Token (Shared Access Signature).

Rückgabetyp

str

generate_blob_shared_access_signature

Generiert eine Shared Access Signature für das Blob oder eine seiner Momentaufnahmen. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token eines beliebigen BlobService.Use the returned signature with the sas_token parameter of any BlobService.

generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parameter

container_name
str
Erforderlich

Name des Containers.

blob_name
str
Erforderlich

Name des Blobs.

snapshot
str
Standardwert: None

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die Blob-Momentaufnahme angibt, die Berechtigung erteilt werden soll.

permission
BlobPermissions
Standardwert: None

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 nach Lese-, Schreib-, Lösch- und Listenberechtigungen 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
Standardwert: None

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
Standardwert: None

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.

id
str
Standardwert: None

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

ip
str
Standardwert: None

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 sip=168.1.5.65 oder sip=168.1.5.60-168.1.5.70 auf der SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol
str
Standardwert: None

Gibt das zulässige Protokoll für eine durchgeführte Anforderung an. Der Standardwert ist https,http. Unter Protocol finden Sie mögliche Werte.

cache_control
str
Standardwert: None

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

content_disposition
str
Standardwert: None

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

content_encoding
str
Standardwert: None

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

content_language
str
Standardwert: None

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

content_type
str
Standardwert: None

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

user_delegation_key
UserDelegationKey
Standardwert: None

Anstelle eines 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 durch Aufrufen von get_user_delegation_key erreicht werden. Wenn vorhanden, wird die SAS stattdessen mit dem Benutzerdelegierungsschlüssel signiert.

Gibt zurück

Ein Sas-Token (Shared Access Signature).

Rückgabetyp

str

generate_container_shared_access_signature

Generiert eine Shared Access Signature für den Container. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token eines beliebigen BlobService.Use the returned signature with the sas_token parameter of any BlobService.

generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parameter

container_name
str
Erforderlich

Name des Containers.

permission
ContainerPermissions
Standardwert: None

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 nach Lese-, Schreib-, Lösch- und Listenberechtigungen 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
Standardwert: None

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
Standardwert: None

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.

id
str
Standardwert: None

Ein eindeutiger Wert mit einer Länge von bis zu 64 Zeichen, der mit einer gespeicherten Zugriffsrichtlinie korreliert. Verwenden Sie set_blob_service_properties, um eine gespeicherte Zugriffsrichtlinie zu erstellen.

ip
str
Standardwert: None

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 sip=168.1.5.65 oder sip=168.1.5.60-168.1.5.70 auf der SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol
str
Standardwert: None

Gibt das zulässige Protokoll für eine durchgeführte Anforderung an. Der Standardwert ist https,http. Unter Protocol finden Sie mögliche Werte.

cache_control
str
Standardwert: None

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

content_disposition
str
Standardwert: None

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

content_encoding
str
Standardwert: None

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

content_language
str
Standardwert: None

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

content_type
str
Standardwert: None

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

user_delegation_key
UserDelegationKey
Standardwert: None

Anstelle eines 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 durch Aufrufen von get_user_delegation_key erreicht werden. Wenn vorhanden, wird die SAS stattdessen mit dem Benutzerdelegierungsschlüssel signiert.

Gibt zurück

Ein Sas-Token (Shared Access Signature).

Rückgabetyp

str

get_blob_account_information

Ruft Informationen im Zusammenhang mit dem Speicherkonto ab. Die Informationen können auch abgerufen werden, wenn der Benutzer über eine SAS für einen Container oder ein Blob verfügt.

get_blob_account_information(container_name=None, blob_name=None, timeout=None)

Parameter

container_name
str
Standardwert: None

Name des vorhandenen Containers. Optional, es sei denn, es wird ein SAS-Token für einen bestimmten Container oder Blob verwendet. In diesem Fall ist dies erforderlich.

blob_name
str
Standardwert: None

Name des vorhandenen Blobs. Optional, es sei denn, es wird ein SAS-Token für ein bestimmtes Blob verwendet. In diesem Fall ist dies erforderlich.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Das AccountInformation.

get_blob_metadata

Gibt alle benutzerdefinierten Metadaten für das angegebene Blob oder Momentaufnahme zurück.

get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

snapshot
str
Standardwert: None

Der parameter Momentaufnahme ist ein undurchsichtiger Wert, der, sofern vorhanden, die abzurufende Blob-Momentaufnahme angibt.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Entschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Ein Wörterbuch, das die Blobmetadatennamen und -wertpaare darstellt.

Rückgabetyp

get_blob_properties

Gibt alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für das BLOB zurück. Der Inhalt des BLOB wird nicht zurückgegeben. Gibt mit BlobProperties und ein Metadatenedikt zurückBlob.

get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

snapshot
str
Standardwert: None

Der Momentaufnahme-Parameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, den abzurufenden Blob-Momentaufnahme angibt.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Entschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

ein Blobobjekt, das Eigenschaften und Metadaten enthält.

Rückgabetyp

get_blob_service_properties

Ruft die Eigenschaften des Blobdiensts eines Speicherkontos ab, einschließlich Azure Storage Analytics.

get_blob_service_properties(timeout=None)

Parameter

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Das Blob ServiceProperties mit einer angefügten target_version-Eigenschaft.

get_blob_service_stats

Ruft Statistiken zur Replikation für den Blob-Dienst ab. Sie ist nur verfügbar, wenn die georedundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

Mit der georedundanten Replikation behält der Azure-Speicher Daten an zwei Standorten permanent bei. An beiden Standorten behält der Azure-Speicher mehrere fehlerfreie Replikate der Daten bei. Der Standort, an dem Sie Daten lesen, erstellen, aktualisieren oder löschen, ist der primäre Speicherkontostandort. Der primäre Standort befindet sich in der Region, die Sie zum Zeitpunkt der Erstellung eines Kontos über das klassische Azure Management-Azure-Portal ausgewählt haben, z. B. USA, Norden, Mitte. Als sekundärer Standort wird der Standort bezeichnet, an dem die Daten repliziert werden. Der sekundäre Standort wird automatisch auf Grundlage des primären Standorts ermittelt und befindet sich in einem zweiten Rechenzentrum in derselben Region wie der primäre Standort. Der schreibgeschützte Zugriff ist über den sekundären Standort verfügbar, wenn die georedundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

get_blob_service_stats(timeout=None)

Parameter

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Die Blob-Dienststatistiken.

Rückgabetyp

get_blob_to_bytes

Lädt ein Blob als Array von Bytes mit automatischen Blöcken und Statusbenachrichtigungen herunter. Gibt eine instance von Blob mit Eigenschaften, Metadaten und Inhalten zurück.

get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

snapshot
str
Standardwert: None

Der Momentaufnahme-Parameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, den abzurufenden Blob-Momentaufnahme angibt.

start_range
int
Standardwert: None

Start des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn kein end_range angegeben wird, werden alle Bytes nach dem start_range heruntergeladen. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

end_range
int
Standardwert: None

Ende des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn end_range angegeben ist, muss start_range bereitgestellt werden. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

validate_content
bool
Standardwert: False

Wenn auf true festgelegt ist, wird ein MD5-Hash für jeden abgerufenen Teil des Blobs überprüft. 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 der Dienst nur transaktionsale MD5s für Blöcke mit einer Größe von 4 MB oder weniger zurückgibt, sodass die erste Anforderung selbst groß ist. MAX_CHUNK_GET_SIZE statt selbst. MAX_SINGLE_GET_SIZE. Wenn selbst. MAX_CHUNK_GET_SIZE auf größer als 4 MB festgelegt wurde, wird ein Fehler ausgelöst. Da die Berechnung des MD5 Verarbeitungszeit benötigt und aufgrund der reduzierten Blockgröße mehr Anforderungen ausgeführt werden müssen, kann die Latenz etwas erhöht werden.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei current die Anzahl der bisher übertragenen Bytes ist, und total ist die Größe des Blobs, sofern bekannt.

max_connections
int
Standardwert: 2

Wenn sie auf 2 oder höher festgelegt ist, wird ein anfänglicher Get für das erste Selbst ausgeführt. MAX_SINGLE_GET_SIZE Bytes des Blobs. Wenn dies das gesamte Blob ist, gibt die -Methode an diesem Punkt zurück. Andernfalls werden die restlichen Daten parallel heruntergeladen, wobei die Anzahl von Threads gleich max_connections. Jeder Blöcke hat eine Eigene Größe. MAX_CHUNK_GET_SIZE. Wenn auf 1 festgelegt ist, wird eine einzelne große Get-Anforderung ausgeführt. Dies wird nicht allgemein empfohlen, ist aber verfügbar, wenn nur sehr wenige Threads verwendet werden sollen, Netzwerkanforderungen sehr teuer sind oder ein nicht suchbarer Stream den parallelen Download verhindert. Dies kann auch nützlich sein, wenn von vielen Blobs erwartet wird, dass sie leer sind, da eine zusätzliche Anforderung für leere Blobs erforderlich ist, wenn max_connections größer als 1 ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Entschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe des Azure-Diensts tätigen, und das Timeout gilt für jeden Aufruf einzeln.

Gibt zurück

Ein Blob mit Eigenschaften und Metadaten. Wenn max_connections größer als 1 ist, wird der content_md5 (sofern für das Blob festgelegt) nicht zurückgegeben. Wenn Sie diesen Wert benötigen, verwenden Sie entweder get_blob_properties, oder legen Sie max_connections auf 1 fest.

Rückgabetyp

get_blob_to_path

Lädt ein Blob mit automatischen Block- und Statusbenachrichtigungen in einen Dateipfad herunter. Gibt eine instance von Blob mit Eigenschaften und Metadaten zurück.

get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

file_path
str
Erforderlich

Pfad der Datei, in die geschrieben werden soll.

open_mode
str
Standardwert: wb

Modus, der beim Öffnen der Datei verwendet werden soll. Beachten Sie, dass die Angabe von append nur open_mode das parallele Herunterladen verhindert. Daher muss max_connections auf 1 festgelegt werden, wenn diese open_mode verwendet wird.

snapshot
str
Standardwert: None

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die abzurufende Blob-Momentaufnahme angibt.

start_range
int
Standardwert: None

Anfang des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn kein end_range angegeben wird, werden alle Bytes nach dem start_range heruntergeladen. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

end_range
int
Standardwert: None

Ende des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn end_range gegeben ist, muss start_range angegeben werden. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

validate_content
bool
Standardwert: False

Wenn dieser Wert auf true festgelegt ist, wird ein MD5-Hash für jeden abgerufenen Teil des Blobs überprüft. 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 der Dienst nur transaktionale MD5s für Blöcke mit einer Größe von 4 MB oder weniger zurückgibt, sodass die erste Get-Anforderung die Größe selbst aufweist. MAX_CHUNK_GET_SIZE statt sich selbst. MAX_SINGLE_GET_SIZE. Wenn sich selbst. MAX_CHUNK_GET_SIZE auf größer als 4 MB festgelegt wurde, wird ein Fehler ausgelöst. Da das Berechnen des MD5 Verarbeitungszeit in Anspruch nimmt und aufgrund der geringeren Blockgröße mehr Anforderungen ausgeführt werden müssen, kann die Latenz etwas erhöht werden.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei current die Anzahl der bisher übertragenen Bytes und gesamt die Größe des Blobs ist, sofern bekannt.

max_connections
int
Standardwert: 2

Wenn dieser Wert auf 2 oder höher festgelegt ist, erfolgt ein erster Get für das erste Selbst. MAX_SINGLE_GET_SIZE Bytes des Blobs. Wenn dies das gesamte Blob ist, gibt die Methode an diesem Punkt zurück. Andernfalls werden die verbleibenden Daten parallel heruntergeladen, wobei die Anzahl der Threads gleich max_connections wird. Jeder Block ist selbst groß. MAX_CHUNK_GET_SIZE. Wenn dieser Wert auf 1 festgelegt ist, wird eine einzelne große Get-Anforderung ausgeführt. Dies wird im Allgemeinen nicht empfohlen, ist aber verfügbar, wenn nur sehr wenige Threads verwendet werden sollen, Netzwerkanforderungen sehr teuer sind oder ein nicht suchbarer Stream den parallelen Download verhindert. Dies kann auch hilfreich sein, wenn erwartet wird, dass viele Blobs leer sind, da eine zusätzliche Anforderung für leere Blobs erforderlich ist, wenn max_connections größer als 1 ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls vorhanden.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Entschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung von kundenseitig bereitgestellten Schlüsseln muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung bereitgestellt wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe an den Azure-Dienst ausführen, und das Timeout gilt für jeden Aufruf einzeln.

Gibt zurück

Ein Blob mit Eigenschaften und Metadaten. Wenn max_connections größer als 1 ist, wird der content_md5 (sofern für das Blob festgelegt) nicht zurückgegeben. Wenn Sie diesen Wert benötigen, verwenden Sie entweder get_blob_properties, oder legen Sie max_connections auf 1 fest.

Rückgabetyp

get_blob_to_stream

Lädt ein Blob mit automatischen Block- und Statusbenachrichtigungen in einen Stream herunter. Gibt eine instance von Blob mit Eigenschaften und Metadaten zurück.

get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

stream
IOBase
Erforderlich

Geöffneter Stream zum Schreiben.

snapshot
str
Standardwert: None

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die abzurufende Blob-Momentaufnahme angibt.

start_range
int
Standardwert: None

Anfang des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn kein end_range angegeben wird, werden alle Bytes nach dem start_range heruntergeladen. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

end_range
int
Standardwert: None

Ende des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn end_range gegeben ist, muss start_range angegeben werden. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

validate_content
bool
Standardwert: False

Wenn dieser Wert auf true festgelegt ist, wird ein MD5-Hash für jeden abgerufenen Teil des Blobs überprüft. 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 der Dienst nur transaktionale MD5s für Blöcke mit einer Größe von 4 MB oder weniger zurückgibt, sodass die erste Get-Anforderung die Größe selbst aufweist. MAX_CHUNK_GET_SIZE statt sich selbst. MAX_SINGLE_GET_SIZE. Wenn sich selbst. MAX_CHUNK_GET_SIZE auf größer als 4 MB festgelegt wurde, wird ein Fehler ausgelöst. Da das Berechnen des MD5 Verarbeitungszeit in Anspruch nimmt und aufgrund der geringeren Blockgröße mehr Anforderungen ausgeführt werden müssen, kann die Latenz etwas erhöht werden.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei current die Anzahl der bisher übertragenen Bytes und gesamt die Größe des Blobs ist, sofern bekannt.

max_connections
int
Standardwert: 2

Wenn dieser Wert auf 2 oder höher festgelegt ist, erfolgt ein erster Get für das erste Selbst. MAX_SINGLE_GET_SIZE Bytes des Blobs. Wenn dies das gesamte Blob ist, gibt die Methode an diesem Punkt zurück. Andernfalls werden die verbleibenden Daten parallel heruntergeladen, wobei die Anzahl der Threads gleich max_connections wird. Jeder Block ist selbst groß. MAX_CHUNK_GET_SIZE. Wenn dieser Wert auf 1 festgelegt ist, wird eine einzelne große Get-Anforderung ausgeführt. Dies wird im Allgemeinen nicht empfohlen, ist aber verfügbar, wenn nur sehr wenige Threads verwendet werden sollen, Netzwerkanforderungen sehr teuer sind oder ein nicht suchbarer Stream den parallelen Download verhindert. Dies kann auch hilfreich sein, wenn erwartet wird, dass viele Blobs leer sind, da eine zusätzliche Anforderung für leere Blobs erforderlich ist, wenn max_connections größer als 1 ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls vorhanden.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Entschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung von kundenseitig bereitgestellten Schlüsseln muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung bereitgestellt wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe an den Azure-Dienst ausführen, und das Timeout gilt für jeden Aufruf einzeln.

Gibt zurück

Ein Blob mit Eigenschaften und Metadaten. Wenn max_connections größer als 1 ist, wird der content_md5 (sofern für das Blob festgelegt) nicht zurückgegeben. Wenn Sie diesen Wert benötigen, verwenden Sie entweder get_blob_properties, oder legen Sie max_connections auf 1 fest.

Rückgabetyp

get_blob_to_text

Lädt ein Blob als Unicode-Text mit automatischen Blöcken und Statusbenachrichtigungen herunter. Gibt eine instance von Blob mit Eigenschaften, Metadaten und Inhalten zurück.

get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

encoding
str
Standardwert: utf-8

Python-Codierung, die beim Decodieren der Blobdaten verwendet werden soll.

snapshot
str
Standardwert: None

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die abzurufende Blob-Momentaufnahme angibt.

start_range
int
Standardwert: None

Start des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn kein end_range angegeben wird, werden alle Bytes nach dem start_range heruntergeladen. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

end_range
int
Standardwert: None

Ende des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn end_range angegeben ist, muss start_range bereitgestellt werden. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

validate_content
bool
Standardwert: False

Wenn auf true festgelegt ist, wird ein MD5-Hash für jeden abgerufenen Teil des Blobs überprüft. 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 der Dienst nur transaktionsale MD5s für Blöcke mit einer Größe von 4 MB oder weniger zurückgibt, sodass die erste Anforderung selbst groß ist. MAX_CHUNK_GET_SIZE statt selbst. MAX_SINGLE_GET_SIZE. Wenn selbst. MAX_CHUNK_GET_SIZE auf größer als 4 MB festgelegt wurde, wird ein Fehler ausgelöst. Da die Berechnung des MD5 Verarbeitungszeit benötigt und aufgrund der reduzierten Blockgröße mehr Anforderungen ausgeführt werden müssen, kann die Latenz etwas erhöht werden.

progress_callback
<xref:func>(<xref:current>, <xref:total>)
Standardwert: None

Rückruf für den Fortschritt mit der Signaturfunktion (current, total), wobei current die Anzahl der bisher übertragenen Bytes ist, und total ist die Größe des Blobs, sofern bekannt.

max_connections
int
Standardwert: 2

Wenn sie auf 2 oder höher festgelegt ist, wird ein anfänglicher Get für das erste Selbst ausgeführt. MAX_SINGLE_GET_SIZE Bytes des Blobs. Wenn dies das gesamte Blob ist, gibt die -Methode an diesem Punkt zurück. Andernfalls werden die restlichen Daten parallel heruntergeladen, wobei die Anzahl von Threads gleich max_connections. Jeder Blöcke hat eine Eigene Größe. MAX_CHUNK_GET_SIZE. Wenn auf 1 festgelegt ist, wird eine einzelne große Get-Anforderung ausgeführt. Dies wird nicht allgemein empfohlen, ist aber verfügbar, wenn nur sehr wenige Threads verwendet werden sollen, Netzwerkanforderungen sehr teuer sind oder ein nicht suchbarer Stream den parallelen Download verhindert. Dies kann auch nützlich sein, wenn von vielen Blobs erwartet wird, dass sie leer sind, da eine zusätzliche Anforderung für leere Blobs erforderlich ist, wenn max_connections größer als 1 ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Entschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe des Azure-Diensts tätigen, und das Timeout gilt für jeden Aufruf einzeln.

Gibt zurück

Ein Blob mit Eigenschaften und Metadaten. Wenn max_connections größer als 1 ist, wird der content_md5 (sofern für das Blob festgelegt) nicht zurückgegeben. Wenn Sie diesen Wert benötigen, verwenden Sie entweder get_blob_properties, oder legen Sie max_connections auf 1 fest.

Rückgabetyp

get_block_list

Ruft die Liste der Blöcke ab, die als Teil eines Block-BLOB hochgeladen wurden. Für ein BLOB werden zwei Blockierlisten verwaltet:

Gesperrte Blockliste: Die Liste der Blöcke, die erfolgreich für ein bestimmtes Blob mit Put Block List festgelegt wurden.

Nicht festgelegte Blockliste: Die Liste der Blöcke, die mithilfe von Put Block für ein Blob hochgeladen, aber noch nicht committet wurden. Diese Blöcke werden in Azure in Verbindung mit einem BLOB gespeichert, sind aber noch nicht Teil des BLOB.

get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

snapshot
str
Standardwert: None

Datetime, um die Uhrzeit zum Abrufen der Blöcke zu bestimmen.

block_list_type
str
Standardwert: None

Gibt an, ob die Liste der Blöcke mit ausgeführtem Commit, die Liste der Blöcke ohne ausgeführten Commit oder beide Listen zusammen zurückgegeben werden. Gültige Werte sind: commit, nicht gebunden oder alle.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Auflisten von committeten und/oder nicht festgeschriebenen Blöcken für Blockblob

Rückgabetyp

get_container_acl

Ruft die Berechtigungen für den angegebenen Container ab. Mit den Berechtigungen wird angegeben, ob auf die Containerdaten öffentlich zugegriffen werden kann.

get_container_acl(container_name, lease_id=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_id
Standardwert: None

Wenn angegeben, ist get_container_acl nur erfolgreich, wenn die Lease des Containers aktiv ist und dieser ID entspricht.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Ein Wörterbuch mit Zugriffsrichtlinien, die dem Container zugeordnet sind. dict of str to AccessPolicy and a public_access property if public access is on

get_container_metadata

Gibt alle benutzerdefinierten Metadaten für den angegebenen Container zurück.

get_container_metadata(container_name, lease_id=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_id
str
Standardwert: None

Wenn angegeben, ist get_container_metadata nur erfolgreich, wenn die Lease des Containers aktiv ist und dieser ID entspricht.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Ein Wörterbuch, das den Namen und die Wertepaare der Containermetadaten darstellt.

Rückgabetyp

get_container_properties

Gibt alle benutzerdefinierten Metadaten und Systemeigenschaften für den angegebenen Container zurück. Die zurückgegebenen Daten enthalten nicht die Liste von BLOBs des Containers.

get_container_properties(container_name, lease_id=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_id
str
Standardwert: None

Wenn angegeben, ist get_container_properties nur erfolgreich, wenn die Lease des Containers aktiv ist und dieser ID entspricht.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

-Eigenschaften für den angegebenen Container in einem Containerobjekt.

Rückgabetyp

get_user_delegation_key

Rufen Sie einen Benutzerdelegierungsschlüssel zum Signieren von SAS-Token ab. Im Dienstobjekt müssen Tokenanmeldeinformationen vorhanden sein, damit diese Anforderung erfolgreich ist.

get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)

Parameter

key_start_time
datetime
Erforderlich

Ein DateTime-Wert Gibt an, wann der Schlüssel gültig wird.

key_expiry_time
datetime
Erforderlich

Ein DateTime-Wert Gibt an, wenn der Schlüssel nicht mehr gültig ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Der Benutzerdelegierungsschlüssel.

Rückgabetyp

list_blob_names

Gibt einen Generator zurück, um die Blobnamen unter dem angegebenen Container aufzulisten. Der Generator folgt den vom Dienst zurückgegebenen Fortsetzungstoken und wird beendet, wenn alle Blobs zurückgegeben wurden oder num_results erreicht wurde.

Wenn num_results angegeben ist und das Konto über mehr als diese Anzahl von Blobs verfügt, verfügt der Generator nach Abschluss über ein aufgefülltes next_marker Feld. Dieser Marker kann verwendet werden, um einen neuen Generator zu erstellen, wenn weitere Ergebnisse gewünscht werden.

list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

prefix
str
Standardwert: None

Filtert die Ergebnisse, um nur BLOBs zurückgegeben, deren Namen mit dem angegebenen Präfix beginnen.

num_results
int
Standardwert: None

Gibt die maximale Anzahl zurückzugebender BLOBs an, einschließlich aller <xref:azure.storage.blob.blockblobservice.BlobPrefix>-Elemente. Wenn die Anforderung nicht num_results oder einen Wert größer als 5.000 angibt, gibt der Server bis zu 5.000 Elemente zurück. Das Festlegen num_results auf einen Wert kleiner oder gleich 0 führt zum Fehlerantwortcode 400 (Ungültige Anforderung).

include
Include
Standardwert: None

Gibt mindestens ein zusätzliches Dataset an, das in die Antwort eingeschlossen werden soll.

delimiter
str
Standardwert: None

Wenn die Anforderung diesen Parameter enthält, gibt der Vorgang ein BlobPrefix Element in der Ergebnisliste zurück, das als Platzhalter für alle Blobs fungiert, deren Namen mit derselben Teilzeichenfolge beginnen, bis zur Darstellung des Trennzeichens. Das Trennzeichen kann ein einzelnes Zeichen oder eine Zeichenfolge sein.

marker
str
Standardwert: None

Ein undurchsichtiges Fortsetzungstoken. Dieser Wert kann aus dem next_marker Feld eines vorherigen Generatorobjekts abgerufen werden, wenn num_results angegeben wurde und der Generator die Aufzählung der Ergebnisse abgeschlossen hat. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen an dem Punkt, an dem der vorherige Generator angehalten wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

list_blobs

Gibt einen Generator zurück, der die Blobs unter dem angegebenen Container auflistet. Der Generator folgt den vom Dienst zurückgegebenen Fortsetzungstoken und wird beendet, wenn alle Blobs zurückgegeben wurden oder num_results erreicht wurde.

Wenn num_results angegeben ist und das Konto über mehr als diese Anzahl von Blobs verfügt, verfügt der Generator nach Abschluss über ein aufgefülltes next_marker Feld. Dieser Marker kann verwendet werden, um einen neuen Generator zu erstellen, wenn weitere Ergebnisse gewünscht werden.

list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

prefix
str
Standardwert: None

Filtert die Ergebnisse, um nur BLOBs zurückgegeben, deren Namen mit dem angegebenen Präfix beginnen.

num_results
int
Standardwert: None

Gibt die maximale Anzahl zurückzugebender BLOBs an, einschließlich aller <xref:azure.storage.blob.blockblobservice.BlobPrefix>-Elemente. Wenn die Anforderung nicht num_results oder einen Wert größer als 5.000 angibt, gibt der Server bis zu 5.000 Elemente zurück. Das Festlegen num_results auf einen Wert kleiner oder gleich 0 führt zum Fehlerantwortcode 400 (Ungültige Anforderung).

include
Include
Standardwert: None

Gibt mindestens ein zusätzliches Dataset an, das in die Antwort eingeschlossen werden soll.

delimiter
str
Standardwert: None

Wenn die Anforderung diesen Parameter enthält, gibt der Vorgang ein BlobPrefix Element in der Ergebnisliste zurück, das als Platzhalter für alle Blobs fungiert, deren Namen mit derselben Teilzeichenfolge beginnen, bis zur Darstellung des Trennzeichens. Das Trennzeichen kann ein einzelnes Zeichen oder eine Zeichenfolge sein.

marker
str
Standardwert: None

Ein undurchsichtiges Fortsetzungstoken. Dieser Wert kann aus dem next_marker Feld eines vorherigen Generatorobjekts abgerufen werden, wenn num_results angegeben wurde und der Generator die Aufzählung der Ergebnisse abgeschlossen hat. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen an dem Punkt, an dem der vorherige Generator angehalten wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

list_containers

Gibt einen Generator zurück, um die Container unter dem angegebenen Konto aufzulisten. Der Generator folgt den vom Dienst zurückgegebenen Fortsetzungstoken und wird beendet, wenn alle Container zurückgegeben wurden oder num_results erreicht wurde.

Wenn num_results angegeben ist und das Konto über mehr als diese Anzahl von Containern verfügt, verfügt der Generator nach Abschluss über ein aufgefülltes next_marker Feld. Dieser Marker kann verwendet werden, um einen neuen Generator zu erstellen, wenn weitere Ergebnisse gewünscht werden.

list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)

Parameter

prefix
str
Standardwert: None

Filtert die Ergebnisse so, dass nur Container zurückgegeben werden, deren Namen mit dem angegebenen Präfix beginnen.

num_results
int
Standardwert: None

Gibt die maximale Anzahl von Containern an, die zurückgegeben werden sollen. Eine einzelne Listenanforderung kann bis zu 1.000 Contianer und möglicherweise ein Fortsetzungstoken zurückgeben, das befolgt werden sollte, um zusätzliche Resutls zu erhalten.

include_metadata
bool
Standardwert: False

Gibt an, dass Containermetadaten in der Antwort zurückgegeben werden.

marker
str
Standardwert: None

Ein undurchsichtiges Fortsetzungstoken. Dieser Wert kann aus dem next_marker Feld eines vorherigen Generatorobjekts abgerufen werden, wenn num_results angegeben wurde und der Generator die Aufzählung der Ergebnisse abgeschlossen hat. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen an dem Punkt, an dem der vorherige Generator angehalten wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

make_blob_url

Erstellt die URL für den Zugriff auf ein Blob.

make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)

Parameter

container_name
str
Erforderlich

Name des Containers.

blob_name
str
Erforderlich

Name des Blobs.

protocol
str
Standardwert: None

Zu verwendende Protokoll: "http" oder "https". Wenn nicht angegeben, verwendet das Protokoll, das bei der Initialisierung von BaseBlobService angegeben wurde.

sas_token
str
Standardwert: None

Mit generate_shared_access_signature erstelltes Shared Access Signature-Token.

snapshot
str
Standardwert: None

Ein Zeichenfolgenwert, der die Momentaufnahme eindeutig identifiziert. Der Wert dieses Abfrageparameters gibt die Momentaufnahme Version an.

Gibt zurück

Blobzugriffs-URL.

Rückgabetyp

str

make_container_url

Erstellt die URL für den Zugriff auf einen Container.

make_container_url(container_name, protocol=None, sas_token=None)

Parameter

container_name
str
Erforderlich

Name des Containers.

protocol
str
Standardwert: None

Zu verwendende Protokoll: "http" oder "https". Wenn nicht angegeben, verwendet das Protokoll, das bei der Initialisierung von BaseBlobService angegeben wurde.

sas_token
str
Standardwert: None

Mit generate_shared_access_signature erstelltes Shared Access Signature-Token.

Gibt zurück

Containerzugriffs-URL.

Rückgabetyp

str

put_block

Erstellt einen neuen Block, für den ein Commit als Teil eines BLOB ausgeführt werden soll.

put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des Blobs.

block
IOBase oder <xref:<xref:bytes Content> of <xref:the block.>>
Erforderlich

Inhalt des Blocks.

block_id
str
Erforderlich

Ein Zeichenfolgenwert, der den Block identifiziert. Die Zeichenfolge sollte kleiner oder gleich 64 Bytes sein. Für ein bestimmtes Blob muss die block_id für jeden Block die gleiche Größe aufweisen.

validate_content
bool
Standardwert: False

Wenn true, berechnet einen MD5-Hash des Blockinhalts. 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.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

put_block_from_url

Erstellt einen neuen Block, für den ein Commit als Teil eines BLOB ausgeführt werden soll.

put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des Blobs.

copy_source_url
str
Erforderlich

Die URL der Quelldaten. Es kann auf ein beliebiges Azure-Blob oder eine Beliebige Datei verweisen, die entweder öffentlich ist oder eine freigegebene Zugriffssignatur angefügt ist.

source_range_start
int
Standardwert: None

Dies gibt den Beginn des Bytesbereichs (einschließlich) an, der aus der Kopierquelle entnommen werden muss.

source_range_end
int
Standardwert: None

Dies gibt das Ende des Bytebereichs (einschließlich) an, der aus der Kopierquelle entnommen werden muss.

block_id
str
Erforderlich

Ein Zeichenfolgenwert, der den Block identifiziert. Die Zeichenfolge sollte kleiner oder gleich 64 Bytes sein. Für ein bestimmtes Blob muss die block_id für jeden Block die gleiche Größe aufweisen.

source_content_md5
str
Standardwert: None

Falls angegeben, berechnet der Dienst den MD5-Hash des Blockinhalts und vergleicht mit diesem Wert.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

put_block_list

Schreibt ein BLOB, indem die Liste der Block-IDs angegeben wird, aus denen sich das BLOB zusammensetzt. Um als Teil eines Blobs geschrieben zu werden, muss ein Block in einem vorherigen Put Block-Vorgang erfolgreich auf den Server geschrieben worden sein.

Sie können Put Block List aufrufen, um ein Blob zu aktualisieren, indem Sie nur die Blöcke hochladen, die sich geändert haben, und dann die neuen und vorhandenen Blöcke zusammen commitsieren. Dies erreichen Sie, indem Sie angeben, ob für einen Block aus der Liste der Blöcke mit ausgeführtem Commit oder der Liste der Blöcke ohne ausgeführten Commit ein Commit ausgeführt werden soll, oder ob für die zuletzt hochgeladene Version des Blocks ein Commit ausgeführt werden soll, je nachdem, in welcher Liste der Block enthalten ist.

put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

block_list
list(BlobBlock)
Erforderlich

Eine Liste von <xref:azure.storeage.blob.models.BlobBlock> , die die Block-IDs und den Blockstatus enthält.

content_settings
ContentSettings
Standardwert: None

ContentSettings-Objekt, das zum Festlegen von Eigenschaften für das Blob verwendet wird.

metadata
dict(str, str)
Standardwert: None

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

validate_content
bool
Standardwert: False

Wenn true, berechnet einen MD5-Hash des Blocklisteninhalts. Der Speicherdienst überprüft den Hash des Blocklisteninhalts, der mit dem gesendeten Hash eingegangen 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 diese Überprüfung dem Inhalt der Blockliste und nicht dem Inhalt des Blobs selbst zugeordnet ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

standard_blob_tier
StandardBlobTier
Standardwert: None

Ein Standardblobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für das aktualisierte Blockblob

Rückgabetyp

release_blob_lease

Gibt die Lease frei. Die Lease kann freigegeben werden, wenn die in der Anforderung angegebene Lease-ID mit der Lease-ID übereinstimmt, die dem BLOB zugeordnet ist. Durch das Freigeben der Lease kann ein anderer Client die Lease für das BLOB sofort abrufen, sobald die Freigabe abgeschlossen wurde.

release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

lease_id
str
Erforderlich

Lease-ID für aktives Lease.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

release_container_lease

Geben Sie die Lease frei. Die Lease kann freigegeben werden, wenn die angegebene lease_id dem dem Container zugeordneten entspricht. Durch das Freigeben der Lease kann ein anderer Client die Lease für den Container sofort abrufen, sobald die Freigabe abgeschlossen wurde.

release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_id
str
Erforderlich

Lease-ID für aktives Lease.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

renew_blob_lease

Erneuert die Lease. Die Lease kann verlängert werden, wenn die in der Anforderung angegebene Lease-ID mit der Lease-ID übereinstimmt, die dem BLOB zugeordnet ist. Beachten Sie, dass die Lease selbst dann verlängert werden kann, wenn sie abgelaufen ist, falls das BLOB seit dem Ablauf der betreffenden Lease nicht geändert und noch nicht wieder geleast wurde. Beim Verlängern einer Lease wird die Leasedauer zurückgesetzt.

renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

lease_id
str
Erforderlich

Lease-ID für aktives Lease.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

str

renew_container_lease

Erneuert die Lease. Die Lease kann verlängert werden, wenn die angegebene Lease-ID der dem Container zugeordneten entspricht. Beachten Sie, dass die Lease selbst dann erneuert werden kann, wenn sie abgelaufen ist, falls der Container seit dem Ablauf der betreffenden Lease noch nicht wieder geleast wurde. Beim Verlängern einer Lease wird die Leasedauer zurückgesetzt.

renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

lease_id
str
Erforderlich

Lease-ID für aktives Lease.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

str

set_blob_metadata

Legt benutzerdefinierte Metadaten für das angegebene Blob als mindestens ein Name-Wert-Paar fest.

set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

metadata
dict(str, str)
Standardwert: None

Dict, das Name- und Wertpaare enthält. Bei jedem Aufruf dieses Vorgangs werden alle vorhandenen Metadaten ersetzt, die an das BLOB angefügt sind. Um alle Metadaten aus dem BLOB zu entfernen, rufen Sie diesen Vorgang ohne Metadatenheader auf.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls vorhanden.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung von kundenseitig bereitgestellten Schlüsseln muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung bereitgestellt wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für das aktualisierte Blob

Rückgabetyp

set_blob_properties

Legt Systemeigenschaften für den Blob fest. Wenn eine Eigenschaft für die content_settings festgelegt ist, werden alle Eigenschaften überschrieben.

set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

content_settings
ContentSettings
Standardwert: None

ContentSettings-Objekt, das zum Festlegen von Blobeigenschaften verwendet wird.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls vorhanden.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung von kundenseitig bereitgestellten Schlüsseln muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung bereitgestellt wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für das aktualisierte Blob

Rückgabetyp

set_blob_service_properties

Legt die Eigenschaften des Blobdiensts eines Speicherkontos fest, einschließlich Azure Storage Analytics. Wenn ein Element (z. B. Protokollierung) als Keine beibehalten wird, werden die vorhandenen Einstellungen für den Dienst für diese Funktionalität beibehalten.

set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)

Parameter

logging
Logging
Standardwert: None

Gruppiert die Logging-Einstellungen für Azure-Analysen.

hour_metrics
Metrics
Standardwert: None

Die Stundenmetrikeneinstellungen bieten eine Zusammenfassung der Anforderungsstatistiken, die nach DER API in stündliche Aggregate für Blobs gruppiert sind.

minute_metrics
Metrics
Standardwert: None

Die Minutenmetrikeneinstellungen stellen Anforderungsstatistiken für jede Minute für Blobs bereit.

cors
list(CorsRule)
Standardwert: None

Sie können bis zu fünf CorsRule-Elemente in die Liste aufnehmen. Wenn eine leere Liste angegeben wird, werden alle CORS-Regeln gelöscht, und CORS wird für den Dienst deaktiviert.

target_version
str
Standardwert: None

Gibt die Standardversion an, die für Anforderungen verwendet werden soll, wenn die Version einer eingehenden Anforderung nicht angegeben ist.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

delete_retention_policy
DeleteRetentionPolicy
Standardwert: None

Die Aufbewahrungsrichtlinie zum Löschen gibt an, ob gelöschte Blobs beibehalten werden sollen. Außerdem wird die Anzahl der Tage und Versionen des Blobs angegeben, die beibehalten werden sollen.

static_website
StaticWebsite
Standardwert: None

Gibt an, ob das Feature für statische Websites aktiviert ist, und gibt, falls ja, das zu verwendende Indexdokument und das 404-Fehlerdokument an.

set_container_acl

Legt die Berechtigungen für den angegebenen Container oder die gespeicherten Zugriffsrichtlinien fest, die mit Shared Access Signatures verwendet werden können. Die Berechtigungen geben an, ob öffentlicher Zugriff auf BLOBs in einem Container zulässig ist.

set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

signed_identifiers
dict(str, AccessPolicy)
Standardwert: None

Ein Wörterbuch mit Zugriffsrichtlinien, die dem Container zugeordnet werden sollen. Das Wörterbuch kann bis zu 5 Elemente enthalten. Ein leeres Wörterbuch löscht die zugriffsrichtlinien, die für den Dienst festgelegt sind.

public_access
PublicAccess
Standardwert: None

Mögliche Werte sind: container, blob.

lease_id
str
Standardwert: None

Wenn angegeben, set_container_acl nur erfolgreich, wenn die Lease des Containers aktiv ist und dieser ID entspricht.

if_modified_since
datetime
Standardwert: None

Ein datetime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein datetime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für den aktualisierten Container

Rückgabetyp

set_container_metadata

Legt mindestens ein benutzerdefiniertes Name-Wert-Paar für den angegebenen Container fest. Bei jedem Aufruf dieses Vorgangs werden alle vorhandenen Metadaten ersetzt, die an den Container angefügt sind. Um alle Metadaten aus dem Container zu entfernen, rufen Sie diesen Vorgang ohne Metadaten-Diktat auf.

set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

metadata
dict(str, str)
Standardwert: None

Ein Diktat, das Name-Wert-Paare enthält, die dem Container als Metadaten zugeordnet werden sollen. Beispiel: {'category':'test'}

lease_id
str
Standardwert: None

Wenn angegeben, ist set_container_metadata nur erfolgreich, wenn die Lease des Containers aktiv ist und dieser ID entspricht.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle datumstimen, die nicht utc sind, in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

ETag- und zuletzt geänderte Eigenschaften für den aktualisierten Container

Rückgabetyp

set_proxy

Legt den Host und Port des Proxyservers für http CONNECT Tunnelling fest.

set_proxy(host, port, user=None, password=None)

Parameter

host
str
Erforderlich

Adresse des Proxys. Beispiel: '192.168.0.100'

port
int
Erforderlich

Port des Proxys. Beispiel: 6000

user
str
Standardwert: None

Benutzer für Proxyautorisierung.

password
str
Standardwert: None

Kennwort für die Proxyautorisierung.

set_standard_blob_tier

Legt die Blockblobebenen für das Blob fest. Diese API wird nur für Blockblobs in Standardspeicherkonten unterstützt.

:p aram RehydratePriority rehydrate_priority: Gibt die Priorität an, mit der ein archiviertes Blob rehydriert werden soll.

set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des zu aktualisierenden Blobs.

standard_blob_tier
StandardBlobTier
Erforderlich

Ein Standard-Blobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe an den Azure-Dienst ausführen, und das Timeout gilt für jeden Aufruf einzeln.

rehydrate_priority
Standardwert: None

snapshot_blob

Erstellt eine schreibgeschützte Momentaufnahme eines BLOB.

snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

metadata
dict(str, str)
Standardwert: None

Gibt ein benutzerdefiniertes Name-Wert-Paar an, das dem BLOB zugeordnet ist. Wenn keine Name-Wert-Paare angegeben sind, werden vom Vorgang die Metadaten des zugrunde liegenden BLOB in die Momentaufnahme kopiert. Wenn ein oder mehrere Name-Wert-Paare angegeben sind, wird die Momentaufnahme mit den angegebenen Metadaten erstellt, und die Metadaten werden nicht aus dem zugrunde liegenden BLOB kopiert.

if_modified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde.

if_unmodified_since
datetime
Standardwert: None

Ein DateTime-Wert Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn Zeitzone enthalten ist, werden alle Datumstimes ohne UTC in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

if_match
str
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

if_none_match
str
Standardwert: None

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

lease_id
str
Standardwert: None

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

cpk
CustomerProvidedEncryptionKey
Standardwert: None

Verschlüsselt die Daten auf der Dienstseite mit dem angegebenen Schlüssel. Die Verwendung der vom Kunden bereitgestellten Schlüssel muss über HTTPS erfolgen. Da der Verschlüsselungsschlüssel selbst in der Anforderung angegeben wird, muss eine sichere Verbindung hergestellt werden, um den Schlüssel zu übertragen.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Momentaufnahme Eigenschaften

Rückgabetyp

undelete_blob

Der Vorgang "Blob rückgängig" stellt den Inhalt und die Metadaten von vorläufig gelöschten Blobs oder Momentaufnahme wieder her. Der Versuch, ein Blob oder Momentaufnahme, das nicht vorläufig gelöscht wurde, rückgängig zu machen, ist ohne Änderungen erfolgreich.

undelete_blob(container_name, blob_name, timeout=None)

Parameter

container_name
str
Erforderlich

Name des vorhandenen Containers.

blob_name
str
Erforderlich

Name des vorhandenen Blobs.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Attribute

protocol

request_session

socket_timeout

MAX_BLOCK_SIZE

MAX_BLOCK_SIZE = 4194304

MAX_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432

MAX_SINGLE_PUT_SIZE

MAX_SINGLE_PUT_SIZE = 67108864

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305