Azure Blob Storage-REST-API
Azure Blob Storage speichert Text- und Binärdaten als Objekte in der Cloud. Blob Storage bietet die folgenden Ressourcen: das Speicherkonto, Container und Blobs. Im Speicherkonto stellen Container eine Möglichkeit dar, Gruppen von BLOBs zu organisieren.
Sie können Text und Binärdaten in BLOBs speichern, die einen der folgenden Typen haben:
Block-BLOBs, die zum Streamen optimiert sind.
Anfügeblobs, die für Anfügevorgänge optimiert sind.
Seitenblobs, die für zufällige Lese-/Schreibvorgänge optimiert sind und die die Möglichkeit bieten, in einen Bytebereich in einem Blob zu schreiben.
Weitere Informationen finden Sie unter Grundlegendes zu Blockblobs, Anfügeblobs und Seitenblobs.
Die REST-API für Blob Storage definiert HTTP-Vorgänge für das Speicherkonto, container und Blobs. Die API umfasst die in der folgenden Tabelle aufgeführten Vorgänge.
| Vorgang | Ressourcentyp | BESCHREIBUNG |
|---|---|---|
| Auflisten von Containern | Konto | Führt alle Container in einem Speicherkonto auf. |
| Festlegen von Blob Storage-Eigenschaften | Konto | Legt die Eigenschaften von Blob Storage fest, einschließlich Protokollierung und Metrikeinstellungen sowie die Standardversion des Diensts. |
| Abrufen von Blob Storage-Eigenschaften | Konto | Ruft die Eigenschaften Blob Storage, einschließlich Protokollierungs- und Metrikeinstellungen, und die Standarddienstversion ab. |
| Preflight-Blobanforderung | Konto | Fragt die CORS-Regeln (Cross-Origin Resource Sharing) für Blob Storage ab, bevor die tatsächliche Anforderung gesendet wird. |
| Abrufen von Blob Storage-Statistiken | Konto | Ruft Statistiken im Zusammenhang mit der Replikation für Blob Storage ab. Dieser Vorgang ist nur über den sekundären Standortendpunkt verfügbar, wenn die georedundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist. |
| Abrufen von Kontoinformationen | Konto | Gibt den SKU-Namen und die Kontoart für das angegebene Konto zurück. |
| Abrufen des Benutzerdelegierungsschlüssels | Konto | Ruft einen Schlüssel ab, der zum Signieren einer Shared Access Signature für die Benutzerdelegierung verwendet werden kann. Diese Signatur gewährt Mithilfe von Microsoft Entra Anmeldeinformationen Zugriff auf Ressourcen in Blob Storage. |
| Erstellen eines Containers | Container | Erstellen eines neuen Containers in einem Speicherkonto |
| Get Container Properties | Container | Gibt alle benutzerdefinierten Metadaten und Systemeigenschaften eines Containers zurück. |
| Get Container Metadata | Container | Gibt nur benutzerdefinierte Metadaten eines Containers zurück. |
| Festlegen von Containermetadaten | Container | Legt benutzerdefinierte Metadaten eines Containers fest. |
| Get Container ACL | Container | Ruft die Richtlinie für den öffentlichen Zugriff und alle gespeicherten Zugriffsrichtlinien für den Container ab. |
| Set Container ACL | Container | Legt die Richtlinie für den öffentlichen Zugriff und alle gespeicherten Zugriffsrichtlinien für den Container fest. |
| Lease Container | Container | Richtet für einen Container eine Sperre für Löschvorgänge ein und verwaltet diese. |
| Delete Container | Container | Löscht den Container und alle BLOBs, die dieser enthält. |
| Auflisten von Blobs | Container | Führt alle BLOBs in einem Container auf. |
| Put Blob | Block-, Anfüge- und Seitenblobs | Erstellt ein neues BLOB oder ersetzt ein vorhandenes BLOB in einem Container. |
| Get Blob | Block-, Anfüge- und Seitenblobs | Liest oder lädt ein Blob aus Blob Storage herunter, einschließlich der benutzerdefinierten Metadaten und Systemeigenschaften. |
| Get Blob Properties | Block-, Anfüge- und Seitenblobs | Gibt alle Systemeigenschaften und benutzerdefinierten Metadaten auf dem BLOB zurück. |
| Set Blob Properties | Block-, Anfüge- und Seitenblobs | Legt die Systemeinstellungen fest, die für ein vorhandenes BLOB definiert sind. |
| Festlegen des Blobablaufs | Blockblobs | Legt die Ablaufzeit für ein vorhandenes Blob fest. |
| Get Blob Metadata | Block-, Anfüge- und Seitenblobs | Ruft alle benutzerdefinierten Metadaten eines vorhandenen BLOB oder der Momentaufnahme ab. |
| Set Blob Metadata | Block-, Anfüge- und Seitenblobs | Legt benutzerdefinierte Metadaten eines vorhandenen BLOB fest. |
| Abrufen von Blobtags | Block-, Anfüge- und Seitenblobs | Ruft benutzerdefinierte Tags eines vorhandenen Blobs ab. |
| Festlegen von Blobtags | Block-, Anfüge- und Seitenblobs | Legt benutzerdefinierte Tags eines vorhandenen Blobs fest, das einen sekundären Index bildet. |
| Suchen von Blobs nach Tags | Block-, Anfüge- und Seitenblobs | Listen Blobs anhand ihrer benutzerdefinierten Tags. |
| Delete Blob | Block-, Anfüge- und Seitenblobs | Markiert ein BLOB zum Löschen. |
| Wiederherstellen von Blobs | Block-, Anfüge- und Seitenblobs | Stellt den Inhalt und die Metadaten eines vorläufig gelöschten Blobs oder aller zugeordneten vorläufig gelöschten Momentaufnahmen wieder her. |
| Lease Blob | Block-, Anfüge- und Seitenblobs | Legt eine Sperre für Lese- und Löschvorgänge fest und verwaltet die Sperre. Um ein gesperrtes BLOB zu löschen oder in dieses zu schreiben, muss der Client die Lease-ID bereitstellen. |
| Snapshot Blob | Block-, Anfüge- und Seitenblobs | Erstellt eine schreibgeschützte Momentaufnahme eines BLOB. |
| Copy Blob | Block-, Anfüge- und Seitenblobs | Kopiert ein Quell-BLOB in ein Ziel-BLOB in diesem Speicherkonto oder in einem anderen Speicherkonto. |
| Abort Copy Blob | Block-, Anfüge- und Seitenblobs | Beendet einen ausstehenden Copy Blob Vorgang und belässt ein Zielblob mit null Länge und vollständigen Metadaten. |
| Put Block | Nur Blockblobs | Erstellt einen neuen Block, der als Teil eines Blockblobs committet werden soll. |
| Put Block From URL | Nur Blockblobs | Erstellt einen neuen Block, der als Teil eines Blockblobs committet werden soll, in dem der Inhalt aus einer URL gelesen wird. |
| Put Block List | Nur Blockblobs | Committet ein Blob, indem die Sammlung der Block-IDs angegeben wird, aus denen ein Blockblob besteht. |
| Get Block List | Nur Blockblobs | Ruft die Liste der Blöcke ab, die als Teil eines Block-BLOB hochgeladen wurden. |
| Abfragen von Blobinhalten | Nur Blockblobs | Wendet eine einfache strukturierte Abfragesprache -Anweisung (SQL) auf den Inhalt eines Blobs an und gibt nur die abgefragte Teilmenge der Daten zurück. |
| Set Blob Tier | Block- und Seiten-BLOBs | Legt die Ebene eines Blobs fest. |
| Put Page | Nur Seiten-BLOBs | Schreibt einen Bereich von Seiten in ein Seiten-BLOB. |
| Get Page Ranges | Nur Seiten-BLOBs | Gibt eine Liste der gültigen Seitenbereiche für ein Seiten-BLOB oder eine Momentaufnahme eines Seiten-BLOB zurück. |
| Incremental Copy Blob | Nur Seiten-BLOBs | Kopiert einen Momentaufnahme eines Quellseitenblobs in ein Zielseitenblob. Es werden nur differenzielle Änderungen übertragen. |
| Append Block | Nur Anfüge-BLOBs | Schreibt einen Datenblock an das Ende eines Anfügeblobs. |
In diesem Abschnitt
Vorgänge für das Konto (Blob Storage)
Vorgänge für Blobs (hierarchische Namespace-aktivierte Konten)