Freigabe wiederherstellen
Mit Restore Share dem Vorgang wird eine Freigabe wiederhergestellt (oder rückgängig gemacht), die zuvor vorläufig gelöscht wurde. Diese API wird vollständig unterstützt, ist aber eine Legacyverwaltungs-API. Verwenden Sie stattdessen Dateifreigaben – Wiederherstellen, die vom Speicherressourcenanbieter (Microsoft.Storage) bereitgestellt wird. Weitere Informationen zur programmgesteuerten Interaktion mit FileShare Ressourcen mithilfe des Speicherressourcenanbieters finden Sie unter Vorgänge auf FileShares.
Die Freigabe wird zusammen mit allen Daten, Metadaten und Momentaufnahmen wiederhergestellt. Die Freigaberessource enthält Metadaten und Eigenschaften für die Freigabe.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |
|
| NFS |
|
Anforderung
Sie können die Restore Share Anforderung wie folgt erstellen. HTTPS wird empfohlen.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete |
HTTP/1.1 |
Ersetzen Sie die im Anforderungs-URI angezeigten Pfadkomponenten wie folgt durch Ihre eigenen Angaben:
| Pfadkomponente | BESCHREIBUNG |
|---|---|
myaccount |
Der Name Ihres Speicherkontos. |
restoredShareName |
Der Name, der für die wiederhergestellte Freigabe verwendet werden soll. Wenn bereits eine Freigabe mit diesem Namen vorhanden ist, schlägt der Vorgang fehl. |
Ausführliche Informationen zu Pfadbenennungseinschränkungen 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
Die folgende Tabelle beschreibt die erforderlichen und optionalen Anforderungsheader.
| Anforderungsheader | BESCHREIBUNG |
|---|---|
Authorization |
Erforderlich. Gibt das Authentifizierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Authentifizierung für die Azure Storage-Dienste. |
x-ms-date |
Erforderlich. Gibt die Uhrzeit der Anforderung in koordinierter Weltzeit (UTC) an. Weitere Informationen finden Sie unter Authentifizierung für die Azure Storage-Dienste. |
x-ms-version |
Erforderlich für alle authentifizierten 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-deleted-share-name |
Erforderlich. Gibt die vorläufig gelöschte Dateifreigabe an, die wiederhergestellt werden soll. Dieser Wert muss mit dem Wert von restoredShareNameübereinstimmen. |
x-ms-deleted-share-version |
Erforderlich. Identifiziert eindeutig die vorläufig gelöschte Dateifreigabe anhand ihrer Version. |
x-ms-client-request-id |
Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der beim Konfigurieren der Protokollierung in den Protokollen aufgezeichnet wird. 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 Azure Blob Storage. |
Anforderungstext
Keine.
Beispiel für eine Anforderung
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1
Request Headers:
x-ms-version: 2019-12-12
x-ms-deleted-share-name: myshare
x-ms-deleted-share-version: 01D2AC0C18EDFE36
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. Wenn der Name der Zieldateifreigabe von einer gültigen nicht gelöschten Dateifreigabe verwendet wird, schlägt die Anforderung mit 409 (Konflikt) fehl. Wenn die Quelldateifreigabe nicht vorläufig gelöscht, bereits wiederhergestellt wurde oder wenn die Quelldateifreigabe ihren Aufbewahrungszeitraum überschritten hat und abgelaufen ist, schlägt die Anforderung mit 404 (Nicht gefunden) fehl.
Informationen zu status Codes 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 Freigabe in Anführungszeichen darstellt. |
Last-Modified |
Gibt das Datum und die Uhrzeit der letzten Änderung der Freigabe zurück. Weitere Informationen finden Sie unter Darstellung von Datums-Uhrzeit-Werten in Headern. Jeder Vorgang, der die Freigabe oder deren Eigenschaften oder Metadaten ändert, aktualisiert den Zeitpunkt der letzten Änderung. Vorgänge für Dateien wirken sich nicht auf den Zeitpunkt der letzten Änderung der Freigabe aus. |
x-ms-request-id |
Identifiziert eindeutig die Anforderung, die gestellt wurde, 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 |
Ein UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. Der Dienst generiert diesen Wert. |
x-ms-client-request-id |
Kann verwendet werden, um Anforderungen und entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert von x-ms-client-request-id header, wenn er in der Anforderung vorhanden ist. Der Wert ist höchstens 1.024 sichtbare ASCII-Zeichen. Wenn die x-ms-client-request-id header in der Anforderung nicht vorhanden ist, ist es in der Antwort nicht vorhanden. |
Antworttext
Keine.
Beispiel für eine Antwort
Response Status:
HTTP/1.1 201 Created
Response Headers:
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000
x-ms-version: 2019-12-12
Content-Length: 0
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Authorization
Der Besitzer des Speicherkontos kann diesen Vorgang aufrufen. Darüber hinaus können Benutzer mit gültigen Kontosignaturtoken für den freigegebenen Zugriff diesen Vorgang aufrufen. Das Token muss Schreibberechtigungen für die Containerressource enthalten, um diesen Vorgang zu autorisieren.
Hinweise
Sie können eine Freigabe nicht unter einem anderen Namen wiederherstellen. Wenn Sie eine Freigabe wiederherstellen, schlägt der Vorgang mit status Code 409 (Konflikt) fehl, wenn eine andere Freigabe mit demselben Namen vorhanden ist. Die Freigabe mit demselben Namen muss zuerst gelöscht werden, bevor die vorläufig gelöschte Freigabe wieder gelöscht werden kann.
Wenn eine Freigabe gelöscht wird, kann eine Freigabe mit demselben Namen nicht für mindestens 30 Sekunden wiederhergestellt werden. Während die Freigabe gelöscht wird, schlagen Versuche, eine Freigabe desselben Namens wiederherzustellen, mit status Code 409 (Konflikt) fehl. Der Dienst gibt zusätzliche Fehlerinformationen zurück, die angeben, dass die Freigabe gelöscht wird.