Freigeben über


BaseBlobService Klasse

Dies ist die Standard Klasse, die Blobressourcen verwaltet.

Der Blob-Dienst speichert Text und Binärdaten als Blobs in der Cloud. Der Blob-Dienst bietet die folgenden drei Ressourcen: Speicherkonto, Container und Blobs. Im Speicherkonto stellen Container eine Möglichkeit dar, Gruppen von BLOBs zu organisieren. Weitere Informationen finden Sie unter: https://msdn.microsoft.com/en-us/library/azure/ee691964.aspx

:type ~azure.storage.common.TokenCredential

Vererbung
BaseBlobService

Konstruktor

BaseBlobService(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 ein 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 freigegebenem Schlüssel 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, werden alle anderen Parameter außer Verbindungszeichenfolge- und Anforderungssitzung überschrieben.

protocol
str
Standardwert: https

Das Protokoll, das für Anforderungen verwendet werden soll. Standardmäßig wird https verwendet.

endpoint_suffix
str
Standardwert: core.windows.net

Die Hostbasiskomponente der URL abzüglich des Kontonamens. Standardmäßig wird Azure (core.windows.net) verwendet. Ü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, überschreibt dies alle anderen Parameter außer der Anforderungssitzung. Siehe http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ Verbindungszeichenfolge Format

socket_timeout
int
Standardwert: None

Falls 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_GET_SIZE
int

Die Größe des ersten Bereichs wird von get_blob_to_*-Methoden ausgeführt, wenn max_connections größer als 1 ist. Wenn das Blob kleiner ist, werden weniger Daten zurückgegeben.

MAX_CHUNK_GET_SIZE
int

Die Größe des nachfolgenden Bereichs wird von get_blob_to_*-Methoden ausgeführt, wenn max_connections größer als 1 und das Blob größer als MAX_SINGLE_GET_SIZE ist. Wenn der Rest des Blobs kleiner ist, werden weniger Daten zurückgegeben. Wenn dies auf größer als 4 MB festgelegt ist, löst content_validation bei Aktivierung einen Fehler aus. Wenn jedoch content_validation nicht gewünscht ist, kann eine Größe von mehr als 4 MB optimal sein. Es wird nicht empfohlen, dies unter 4 MB festzulegen.

key_encryption_key
object

Der schlüssel-encryption-key, der optional vom Benutzer bereitgestellt wird. Wenn angegeben, wird zum Verschlüsseln/Entschlüsseln in unterstützten Methoden verwendet. Für Methoden, die entschlüsselt werden müssen, muss entweder der key_encryption_key ODER der Resolver bereitgestellt werden. Wenn beide angegeben sind, hat der Resolver Vorrang. Muss die folgenden Methoden für APIs implementieren, die eine Verschlüsselung erfordern: wrap_key(Schlüssel) – umschließt den angegebenen Schlüssel (Bytes) mithilfe eines Algorithmus der Wahl des Benutzers. Gibt den verschlüsselten Schlüssel als Bytes zurück. get_key_wrap_algorithm() – gibt den Algorithmus zurück, der zum Umschließen des angegebenen symmetrischen Schlüssels verwendet wird. get_kid() – gibt eine Zeichenfolgenschlüssel-ID für diesen Schlüssel-Verschlüsselungsschlüssel zurück. Muss die folgenden Methoden für APIs implementieren, die entschlüsselt werden müssen: unwrap_key(Schlüssel, Algorithmus) – gibt die unverschlüsselte Form des angegebenen symmetrischen Schlüssels mithilfe des Zeichenfolgen-angegebenen Algorithmus zurück. get_kid() – gibt eine Zeichenfolgenschlüssel-ID für diesen Schlüssel-Verschlüsselungsschlüssel zurück.

key_resolver_function
kid) (<xref:function>

Eine Funktion zum Auflösen von Schlüsseln, die optional vom Benutzer bereitgestellt werden. Wenn angegeben, wird zum Entschlüsseln in unterstützten Methoden verwendet. Für Methoden, die entschlüsselt werden müssen, muss entweder der key_encryption_key ODER der Resolver bereitgestellt werden. Wenn beide angegeben sind, hat der Resolver Vorrang. Es verwendet die kid-Zeichenfolge, um einen Schlüssel-Verschlüsselung-Schlüssel zurückzugeben, der die oben definierte Schnittstelle implementiert.

require_encryption
bool

Ein Flag, das festgelegt werden kann, um sicherzustellen, dass alle Nachrichten, die erfolgreich in die Warteschlange hochgeladen wurden, und alle heruntergeladenen und erfolgreich aus der Warteschlange gelesenen Nachrichten auf dem Server verschlüsselt wurden/wurden. Wenn dieses Flag festgelegt ist, müssen alle erforderlichen Parameter für die Ver-/Entschlüsselung angegeben werden. Weitere Informationen finden Sie in den obigen Kommentaren zum key_encryption_key und Resolver.

Methoden

abort_copy_blob

Bricht einen ausstehenden copy_blob-Vorgang ab und hinterlässt ein Zielblob mit null Länge 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.

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 asynchron. Dieser Vorgang gibt ein Objekt mit den Eigenschaften des Kopiervorgangs zurück, einschließlich einer Kopier-ID, die Sie zum Überprüfen oder Abbrechen des Kopiervorgangs verwenden können. Der Blob-Dienst kopiert BLOBs auf Grundlage der besten Leistung.

Das Quellblob für einen Kopiervorgang kann ein Blockblob, ein Anfügeblob oder ein Seitenblob sein. Wenn das Zielblob bereits vorhanden ist, muss es von demselben Blobtyp wie das Quellblob sein. 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 Seitenblob erstellt der Blobdienst ein Zielseitenblob der Länge des Quellblobs, das zunächst alle Nullen enthält. Anschließend werden die Quellseitenbereiche aufgezählt, und nicht leere Bereiche werden kopiert.

Für ein Blockblob oder ein Anfügeblob erstellt der Blob-Dienst ein committetes Blob mit der Länge null, bevor er von diesem Vorgang zurückgibt. 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.

Beim Kopieren aus einem Anfügeblob werden alle gebundenen Blöcke kopiert. Am Ende des Kopiervorgangs weist das Zielblob die gleiche Anzahl von Commits wie die Quelle auf.

Für alle Blobtypen können Sie 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.

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 sas_token-Parameter 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 sas_token-Parameter eines beliebigen BlobService.Use the returned signature with the sas_token parameter of any BlobService.

generate_container_shared_access_signature

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

get_blob_account_information

Ruft Informationen ab, die sich auf das Speicherkonto beziehen. Die Informationen können auch abgerufen werden, wenn der Benutzer über eine SAS für einen Container oder 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 Bytearray mit automatischen Block- 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 Blöcken 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_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.

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.

snapshot_blob

Erstellt eine schreibgeschützte Momentaufnahme eines BLOB.

undelete_blob

Der Vorgang "Blob wiederherstellen" stellt den Inhalt und die Metadaten eines vorläufig gelöschten Blobs oder Momentaufnahme wieder her. Der Versuch, ein Blob oder eine Momentaufnahme, die nicht vorläufig gelöscht wurde, wiederherstellen, ist ohne Änderungen erfolgreich.

abort_copy_blob

Bricht einen ausstehenden copy_blob-Vorgang ab und hinterlässt ein Zielblob mit null Länge 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

Kopierbezeichner, 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 mit Verlängerung oder Änderung geändert werden. Der Standardwert ist -1 (unendliche Lease).

proposed_lease_id
str
Standardwert: None

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.

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 mit Verlängerung oder Änderung geändert werden. Der Standardwert ist -1 (unendliche Lease).

proposed_lease_id
str
Standardwert: None

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.

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

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 asynchron. Dieser Vorgang gibt ein Objekt mit den Eigenschaften des Kopiervorgangs zurück, einschließlich einer Kopier-ID, die Sie zum Überprüfen oder Abbrechen des Kopiervorgangs verwenden können. Der Blob-Dienst kopiert BLOBs auf Grundlage der besten Leistung.

Das Quellblob für einen Kopiervorgang kann ein Blockblob, ein Anfügeblob oder ein Seitenblob sein. Wenn das Zielblob bereits vorhanden ist, muss es von demselben Blobtyp wie das Quellblob sein. 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 Seitenblob erstellt der Blobdienst ein Zielseitenblob der Länge des Quellblobs, das zunächst alle Nullen enthält. Anschließend werden die Quellseitenbereiche aufgezählt, und nicht leere Bereiche werden kopiert.

Für ein Blockblob oder ein Anfügeblob erstellt der Blob-Dienst ein committetes Blob mit der Länge null, bevor er von diesem Vorgang zurückgibt. 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.

Beim Kopieren aus einem Anfügeblob werden alle gebundenen Blöcke kopiert. Am Ende des Kopiervorgangs weist das Zielblob die gleiche Anzahl von Commits wie die Quelle auf.

Für alle Blobtypen können Sie 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.

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)

Parameter

container_name
str
Erforderlich

Name des Zielcontainers. Der Container muss vorhanden sein.

blob_name
str
Erforderlich

Name des Zielblobs. Wenn das Zielblob vorhanden ist, wird es überschrieben. Andernfalls wird sie erstellt.

copy_source
str
Erforderlich

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

metadata
dict(str, str)
Standardwert: None

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.

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

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

source_if_match
<xref:ETag>
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). Geben Sie diesen bedingten Header an, um das Quell-BLOB nur dann zu kopieren, wenn sein ETag dem angegebenen Wert entspricht. Bei nicht übereinstimmenden ETag-Werten gibt der Blob-Dienst 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.

source_if_none_match
<xref:ETag>
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). 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.

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

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

destination_if_match
<xref:ETag>
Standardwert: None

Ein ETag-Wert oder das Platzhalterzeichen (*). 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 Blobdienst status Code 412 (Vorbedingung fehlgeschlagen) zurück.

destination_if_none_match
<xref:ETag>
Standardwert: None

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 mit dem ETag-Wert für das Zielblob übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn das Zielblob nicht vorhanden ist. Wenn die angegebene Bedingung nicht erfüllt ist, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück.

destination_lease_id
str
Standardwert: None

Die für diesen Header angegebene Lease-ID muss mit der Lease-ID des Ziel-BLOB ü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.

source_lease_id
str
Standardwert: None

Geben Sie dies an, um den Kopierblobvorgang nur auszuführen, wenn die angegebene Lease-ID mit der aktiven Lease-ID des Quellblobs übereinstimmt.

timeout
int
Standardwert: None

Der timeout-Parameter wird in Sekunden angegeben.

Gibt zurück

Kopiervorgangseigenschaften wie status, Quelle und ID.

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 sas_token-Parameter 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 für die SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol
str
Standardwert: None

Gibt das für eine anforderung zulässige Protokoll 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 sas_token-Parameter 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 Momentaufnahme-Parameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, die Blob-Momentaufnahme angibt, um die Berechtigung zu erteilen.

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

id
str
Standardwert: None

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

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 für die SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol
str
Standardwert: None

Gibt das für eine anforderung zulässige Protokoll 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 eine Ressource zugegriffen wird.

content_disposition
str
Standardwert: None

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

content_encoding
str
Standardwert: None

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

content_language
str
Standardwert: None

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

content_type
str
Standardwert: None

Antwortheaderwert für Content-Type, wenn mithilfe dieser Shared Access Signature auf eine Ressource 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 freigegebene Zugriffssignatur für den Container. Verwenden Sie die zurückgegebene Signatur mit dem sas_token-Parameter 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 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.

id
str
Standardwert: None

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

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 für die SAS angeben, wird die Anforderung auf diese IP-Adressen beschränkt.

protocol
str
Standardwert: None

Gibt das für eine anforderung zulässige Protokoll 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 eine Ressource zugegriffen wird.

content_disposition
str
Standardwert: None

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

content_encoding
str
Standardwert: None

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

content_language
str
Standardwert: None

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

content_type
str
Standardwert: None

Antwortheaderwert für Content-Type, wenn mithilfe dieser Shared Access Signature auf eine Ressource 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 ab, die sich auf das Speicherkonto beziehen. Die Informationen können auch abgerufen werden, wenn der Benutzer über eine SAS für einen Container oder 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 es 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, wenn vorhanden, das abzurufende Blob angibt Momentaufnahme.

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 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 Bytearray mit automatischen Block- 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 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_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 only open_mode den parallelen Download 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 Blöcken 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 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_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 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_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.baseblobservice.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.baseblobservice.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

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

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

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 Einstellungen für Stundenmetriken bieten eine Zusammenfassung der Anforderungsstatistiken, die nach API gruppiert sind, in Stündchenaggregaten für Blobs.

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.

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

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

Momentaufnahme Eigenschaften

Rückgabetyp

undelete_blob

Der Vorgang "Blob wiederherstellen" stellt den Inhalt und die Metadaten eines vorläufig gelöschten Blobs oder Momentaufnahme wieder her. Der Versuch, ein Blob oder eine Momentaufnahme, die nicht vorläufig gelöscht wurde, wiederherstellen, 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_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432