Freigeben über


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

Blob Storage-Konzepte

Vorgänge für das Konto (Blob Storage)

Vorgänge für Container

Vorgänge für Blobs

Vorgänge für Blobs (hierarchische Namespace-aktivierte Konten)

Weitere Informationen

Rest der Speicherdienste