Momentaufnahmefreigabe (FileREST-API): Azure Files

Artikel
06/13/2024

Ab Version 2017-04-17 erstellt der Snapshot Share Vorgang eine schreibgeschützte Momentaufnahme einer Freigabe.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll	Verfügbar	Status
SMB		Allgemein verfügbar
NFS		Allgemein verfügbar

Anforderung

Sie können die Snapshot Share Anforderung wie folgt erstellen. HTTPS wird empfohlen.

Methode	Anforderungs-URI	HTTP-Version
`PUT`	`https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot`	HTTP/1.1

Ersetzen Sie die im Anforderungs-URI angezeigten Pfadkomponenten wie folgt durch Ihre eigenen Angaben:

Pfadkomponente	BESCHREIBUNG
`myaccount`	Der Name Ihres Speicherkontos.
`myshare`	Der Name der Dateifreigabe.

Ausführliche Informationen zu Einschränkungen bei der Pfadbenennung finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten.

URI-Parameter

Sie können den folgenden zusätzlichen Parameter für den Anforderungs-URI angeben.

Parameter	BESCHREIBUNG
`timeout`	Optional. Der `timeout`-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files-Vorgänge.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
`Authorization`	Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
`Date` oder `x-ms-date`	Erforderlich. Gibt die Uhrzeit der Anforderung in koordinierter Weltzeit (UTC) an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
`x-ms-version`	Erforderlich für alle autorisierten Anforderungen. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
`x-ms-meta-name:value`	Optional. Gibt ein benutzerdefiniertes Name-Wert-Paar an, das der Freigabemomentaufnahme zugeordnet ist. Wenn Sie keine Namen-Wert-Paare angeben, kopiert der Vorgang die Metadaten der Basisfreigabe in die Momentaufnahme. Wenn Sie ein oder mehrere Name-Wert-Paare angeben, wird die Freigabemomentaufnahme mit den angegebenen Metadaten erstellt. In diesem Fall werden Metadaten nicht aus der Basisfreigabe kopiert. Metadatennamen müssen den Benennungsregeln für C#-Bezeichner entsprechen.
`x-ms-client-request-id`	Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichengrenzwert von 1 Kibibyte (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen von Azure Blob Storage.

Anforderungstext

Keine.

Beispiel für eine Anforderung

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1

Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 201 (Erstellt) zurückgegeben. Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann auch zusätzliche HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader	BESCHREIBUNG
`ETag`	Enthält einen Wert, der die Version der Freigabemomentaufnahme in Anführungszeichen darstellt. Eine Freigabemomentaufnahme kann nicht geändert werden, sodass sich die `ETag` einer bestimmten Freigabemomentaufnahme nie ändert. Wenn Sie jedoch neue Metadaten mit der `Snapshot Share` Anforderung angegeben haben, unterscheidet sich die `ETag` der Freigabemomentaufnahme von der der Basisfreigabe. Wenn Sie keine Metadaten mit der Anforderung angegeben haben, ist die `ETag` der Freigabemomentaufnahme identisch mit der der Basisfreigabe zum Zeitpunkt der Erstellung der Freigabemomentaufnahme.
`Last-Modified`	Gibt das Datum und die Uhrzeit der letzten Änderung der Freigabe zurück. Weitere Informationen finden Sie unter Darstellung von Datums-/Uhrzeitwerten in Headern. Eine Freigabemomentaufnahme kann nicht geändert werden, sodass sich der Zeitpunkt der letzten Änderung einer bestimmten Freigabemomentaufnahme nie ändert. Wenn Sie jedoch neue Metadaten mit der `Snapshot Share` Anforderung angegeben haben, unterscheidet sich der Zeitpunkt der letzten Änderung der Freigabemomentaufnahme von dem der Basisfreigabe. Wenn Sie keine Metadaten mit der Anforderung angegeben haben, ist der Zeitpunkt der letzten Änderung der Freigabemomentaufnahme identisch mit der der Basisfreigabe, zum Zeitpunkt der Erstellung der Freigabemomentaufnahme.
`x-ms-request-id`	Identifiziert die durchgeführte Anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
`x-ms-version`	Gibt die Version von Azure Files an, die zum Ausführen der Anforderung verwendet wird.
`Date` oder `x-ms-date`	Ein UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem die Antwort initiiert wurde. Der Dienst generiert diesen Wert.
`x-ms-snapshot`	Ein `DateTime` -Wert, der die Freigabemomentaufnahme eindeutig identifiziert. Sie können den Wert dieses Headers in nachfolgenden Anforderungen verwenden, um auf die Freigabemomentaufnahme zuzugreifen. Dieser Wert ist undurchsichtig.
`x-ms-client-request-id`	Kann zur Problembehandlung von Anforderungen und entsprechenden Antworten verwendet werden. Der Wert dieses Headers ist gleich dem Wert des `x-ms-client-request-id` Headers, wenn er in der Anforderung vorhanden ist. Der Wert beträgt höchstens 1.024 sichtbare ASCII-Zeichen. Wenn der `x-ms-client-request-id` Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden.

Antworttext

Keine.

Beispiel für eine Antwort

Response Status:
HTTP/1.1 201 Created

Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Authorization

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Hinweise

Freigabemomentaufnahmen bieten schreibgeschützte Versionen von Freigaben. Nachdem Sie eine Freigabemomentaufnahme erstellt haben, können Sie sie nicht mehr ändern. Eine Freigabemomentaufnahme bietet eine bequeme Möglichkeit, eine konsistente Sicherung aller Dateien auf einer Freigabe zu erstellen.

Jedes Mal, wenn Sie den Snapshot Share Vorgang aufrufen, wird eine neue Freigabemomentaufnahme mit einem eindeutigen DateTime Wert erstellt, der die Freigabemomentaufnahme relativ zur Basisfreigabe identifiziert. Sie können diesen DateTime Wert verwenden, um weitere Vorgänge für die Freigabemomentaufnahme und ihren Inhalt auszuführen. Sie sollten diesen DateTime Wert als undurchsichtig behandeln.

Der DateTime Wert identifiziert die Freigabemomentaufnahme für den Anforderungs-URI. Beispielsweise weist eine Datei auf der Basisfreigabe und deren Momentaufnahmen URIs auf, die den folgenden Beispielen ähneln:

Datei auf der Freigabe: http://myaccount.file.core.windows.net/myshare/myfile
Datei auf der Freigabemomentaufnahme: http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>

Eine Freigabe kann die Erstellung von 200 Freigabemomentaufnahmen unterstützen. Wenn Sie versuchen, mehr als 200 Freigabemomentaufnahmen zu erstellen, gibt der Dienst den Fehlercode 409 (Konflikt) zurück. Wenn Sie versuchen, eine Freigabemomentaufnahme zu erstellen, während ein vorheriger Snapshot Share Vorgang ausgeführt wird, gibt der Dienst auch den Fehlercode 409 (Konflikt) zurück.

Vorhandene Freigabemomentaufnahmen werden nie überschrieben. Sie müssen explizit gelöscht werden. Um Freigabemomentaufnahmen explizit zu löschen, rufen Sie Freigabe löschen auf, und legen Sie den x-ms-include-snapshots Header zusammen mit dem sharesnapshot Abfrageparameter auf den entsprechenden Wert fest.

Sie können NFS-Freigabemomentaufnahmen auf einem NFS-Client mithilfe des virtuellen Momentaufnahmeverzeichnisses (MOMENTAUFNAHME) anzeigen, das sich normalerweise im Stamm des Freigabebereitstellungspunkts befindet. Der Zugriff auf dieses Verzeichnis kann deaktiviert werden, indem Sie den Header in der x-ms-enable-snapshot-virtual-directory-access Api zum Festlegen von Freigabeeigenschaften auf false festlegen. Sie können diesen Header auch zum Zeitpunkt der Freigabeerstellung im Rahmen des Vorgangs Freigabe erstellen festlegen.

Freigeben über