VERTRIEB: 1-800-867-1380

Dateidienst-REST-API

Letzte Aktualisierung: November 2014

Das SMB (Server Message Block)-Protokoll ist derzeit das bevorzugt für lokale Dateifreigaben verwendete Protokoll. Dank dem Microsoft Azure-Dateidienst können Kunden die Verfügbarkeit und Skalierbarkeit des IaaS (Infrastructure as a Service)-SMBs der Azure-Cloud nutzen, ohne dass SMB-Clientanwendungen umgeschrieben werden müssen.

noteHinweis
Der Azure-Dateidienst befindet sich derzeit in der Vorschauphase. Wenn Sie Zugriff anzufordern möchten, wechseln Sie zur Azure-Vorschauseite.

Der Azure-Dateidienst bietet zudem eine attraktive Alternative zu herkömmlichen DAS (Direct Attached Storage)- und SAN (Storage Area Network)-Lösungen, deren Installation, Konfiguration und Ausführung häufig komplex und teuer ist. Die Preisgestaltung für den neuen Azure-Dateidienst erfolgt analog zu den vorhandenen Azure-Speicherdiensten, und die Preise werden in Einheiten von Speicherkapazität und Transaktionen berechnet. Ausführliche Informationen finden Sie über die Seite "Azure-Preise".

Dateien, die in Azure-Dateidienstfreigaben gespeichert sind, sind am Endpunkt http|https://<account>.file.core.window.net über das SMB-Protokoll sowie über REST-APIs verfügbar. Beachten Sie, dass HTTPS empfohlen wird.

Die Azure-Dateidienst-REST-APIs sind den Azure-Blob-Dienst-REST-APIs sehr ähnlich, es gibt aber geringfügige Unterschiede hinsichtlich der Art und Weise, wie der Dienst das zugrunde liegenden Dateisystem modelliert. Diese Unterschiede sind in der folgenden Vorgangstabelle aufgeführt.

Der Azure-Dateidienst stellt die folgenden vier Ressourcen bereit: Speicherkonto, Freigaben, Verzeichnisse und Dateien. Freigaben bieten die Möglichkeit, Dateisätze zu organisieren und können außerdem als SMB-Dateifreigabe bereitgestellt werden, die in der Cloud gehostet wird.

Die Dateidienst-REST-API ermöglicht es, über HTTP/HTTPS-Vorgänge mit Freigabe-, Verzeichnis- und Dateiressourcen zu arbeiten. Dateidienstvorgänge sind erst ab Version 2014-02-14 der Speicherdienste verfügbar.

Der Dateidienst-REST-API umfasst die Vorgänge, die in der folgenden Tabelle aufgelistet sind.

 

Vorgang Ressourcentyp REST-Verb Beschreibung Unterschiede zu Blob-Dienstvorgang

Freigaben auflisten

Speicherkonto

GET

Listet alle Dateifreigaben auf, die es in einem Speicherkonto gibt

Keine

Create Share

Freigeben

PUT

Erstellt eine neue Freigabe in einem Speicherkonto.

Anforderungsheader

Get Share Properties

Freigeben

GET HEAD

Gibt alle benutzerdefinierten Metadaten und Systemeigenschaften einer Freigabe zurück.

Keine

Set Share Metadata

Freigeben

PUT

Legt benutzerdefinierte Metadaten einer Freigabe fest.

Keine

Get Share Metadata

Freigeben

GET HEAD

Gibt nur benutzerdefinierte Metadaten einer Freigabe zurück.

Keine

Delete Share

Freigeben

LÖSCHEN

Löscht die Freigabe und jegliche Dateien und Verzeichnisse, die sie enthält.

Keine

List Directories and Files

Verzeichnis

GET

Listet Dateien und Verzeichnisse auf, die sich in der Freigabe oder im angegebenen Verzeichnis befinden.

Abfragezeichenfolgeparam., Antworttext

Create Directory

Verzeichnis

PUT

Erstellt ein Verzeichnis in der Freigabe oder im übergeordneten Verzeichnis.

Neu

Get Directory Properties

Verzeichnis

GET HEAD

Gibt systemdefinierte Eigenschaften eines Verzeichnisses zurück. Damit können Benutzer prüfen, ob ein Verzeichnis vorhanden ist. Nur LMT, d. h., es wird das Erstellungsdatum zurückgegeben.

Neu

Löschen von Verzeichnissen

Verzeichnis

LÖSCHEN

Löscht das Verzeichnis. Wird nur für leere Verzeichnisse unterstützt.

Neu

Create File

Datei

PUT

Erstellt eine neue Datei oder ersetzt eine vorhandene Datei in einem Verzeichnis oder in einer Freigabe.

Name

Anforderungsheader

Get File

Datei

GET

Liest eine Datei aus dem Dateidienst, einschließlich ihrer benutzerdefinierten Metadaten und Systemeigenschaften, oder lädt diese herunter.

Name, Antwortheader

Set File Properties

Datei

PUT

Legt die Systemeinstellungen fest, die für eine vorhandene Datei definiert sind.

Name,

Anforderung und Antwortheader

Abrufen von Dateieigenschaften

Datei

HEAD

Gibt alle Systemeigenschaften und benutzerdefinierten Metadaten für die Datei zurück.

Name, Antwortheader

Get File Metadata

Datei

GET

HEAD

Ruft alle benutzerdefinierten Metadaten für die Datei ab.

Nur Name

Set File Metadata

Datei

PUT

Legt benutzerdefinierte Metadaten einer vorhandenen Datei fest.

Nur Name

Delete File

Datei

LÖSCHEN

Die Datei wird dauerhaft gelöscht.

Nur Name

Put Range

Datei

PUT

Schreibt einen Bereich von Daten in eine Datei oder löscht einen Bereich in der Datei.

Name,

Abfragezeichenfolgeparam., Antwortheader und Hauptteil

List Ranges

Datei

GET

Gibt eine Liste der aktiven Bereiche für die Datei zurück. Aktive Bereiche sind diejenigen Bereiche, die über die Put Range-API mit Daten ausgefüllt wurden.

Name,

Abfragezeichenfolgeparam., Antworttext

Siehe auch

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.
Anzeigen:
© 2015 Microsoft