Freigabe erstellen
Der vorgang Create Share
erstellt eine neue Azure Files-Freigabe unter dem angegebenen Konto. Obwohl diese API vollständig unterstützt wird, handelt es sich um eine Legacyverwaltungs-API. Es wird empfohlen, stattdessen Dateifreigaben zu verwenden : Erstellen, das vom Azure Storage-Ressourcenanbieter (Microsoft.Storage) bereitgestellt wird. Weitere Informationen zur programmgesteuerten Interaktion mit FileShare
Ressourcen mithilfe des Azure Storage-Ressourcenanbieters finden Sie unter Operations on FileShares.
Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, schlägt der Vorgang fehl. Die Freigaberessource enthält Metadaten und Eigenschaften für diese Freigabe. Sie enthält keine Liste der Dateien, die in der Freigabe enthalten sind.
Protokollverfügbarkeit
Aktiviertes Dateifreigabeprotokoll | Verfügbar |
---|---|
Server-Nachrichtenblock (SMB) | |
Network File System (NFS) |
Bitten
Sie können die Create Share
Anforderung erstellen, wie hier gezeigt. Es wird empfohlen, HTTPS zu verwenden.
Methode | Anforderungs-URI | HTTP-Version |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Ersetzen Sie die Pfadkomponenten, die im Anforderungs-URI angezeigt werden, wie folgt:
Pfadkomponente | Beschreibung |
---|---|
myaccount |
Der Name Ihres Speicherkontos. |
myshare |
Der Name Ihrer Dateifreigabe. Der Name darf nur Kleinbuchstaben enthalten. |
Weitere Informationen zu Pfadbenennungseinschränkungen finden Sie unter Namen- und Referenzfreigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
Sie können die folgenden zusätzlichen Parameter für den Anforderungs-URI angeben:
Parameter | Beschreibung |
---|---|
timeout |
Wahlfrei. Der Timeoutparameter wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Dateidienstvorgänge. |
Anforderungsheader
Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle 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 UTC-Zeit (Coordinated Universal Time) für die Anforderung 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 Vorgangs an, der für diese Anforderung verwendet werden soll. Weitere Informationen finden Sie unter Versionsverwaltung für Azure Storage-Dienste. |
x-ms-meta-name:value |
Wahlfrei. Ein Name-Wert-Paar, das der Freigabe als Metadaten zugeordnet werden soll. Metadatennamen müssen den Benennungsregeln für C#-Bezeichnerentsprechen. |
x-ms-share-quota |
Wahlfrei. Unterstützt in Version 2015-02-21 und höher. Gibt die maximale Größe der Freigabe in Gibibytes (GiB) an. |
x-ms-access-tier |
Wahlfrei. Unterstützt in Version 2019-12-12 und höher. Gibt die Zugriffsebene der Freigabe an. Gültige Werte sind TransactionOptimized , Hot und Cool . Ausführliche Informationen zu Dateifreigabeebenen finden Sie unter Azure Files-Speicherebenen. |
x-ms-enabled-protocols: <SMB \| NFS> |
Wahlfrei. Unterstützt in Version 2019-07-07 und höher. Gibt die aktivierten Protokolle für die Freigabe an. Wenn sie nicht angegeben sind, ist der Standardwert SMB. - SMB : Auf die Freigabe kann von SMBv3.0, SMBv2.1 und REST zugegriffen werden.- NFS : Auf die Freigabe kann von NFSv4.1 zugegriffen werden. Für diese Option ist ein Premiumkonto erforderlich. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Wahlfrei. Nur NFS. Unterstützt in Version 2019-07-07 und höher. Gibt das Stammverhalten für die Freigabe an, wenn NFS aktiviert ist. Wenn sie nicht angegeben ist, lautet der Standardwert "NoRootSquash". - NoRootSquash : Deaktivieren Sie root rootkging.- RootSquash : Zuordnen von Anforderungen von uid/gid 0 zur anonymen UID/gid.- AllSquash : Ordnen Sie alle Uids und Gids dem anonymen Benutzer zu. |
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Wahlfrei. Unterstützt in Version 2024-08-04 und höher. Gibt an, ob auf das virtuelle Snapshot-Verzeichnis beim Aktivieren von NFS zugegriffen werden soll. Wenn nicht angegeben, ist der Standardwert "true". |
x-ms-client-request-id |
Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (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 Files. |
x-ms-share-paid-bursting-enabled: <true \| false> |
Wahlfrei. Unterstützt in Version 2024-11-04 und höher. Nur für Premium-Dateifreigaben zulässig (Dateifreigaben innerhalb des FileStorage-Speicherkontotyps). Diese Eigenschaft ermöglicht kostenpflichtiges Platzen. Wenn die Eigenschaft nicht angegeben ist, ist der Standardwert "false". |
x-ms-share-paid-bursting-max-iops |
Wahlfrei. Unterstützt in Version 2024-11-04 und höher. Nur für Premium-Dateifreigaben zulässig. Eine ganze Zahl, die die für die Freigabe zulässigen maximal bezahlten Eingabe-/Ausgabevorgänge pro Sekunde (IOPS) darstellt. Der Standardwert, wenn nicht angegeben ist die maximal zulässige IOPS für eine Freigabe. Wenn dieser Header festgelegt ist, muss x-ms-share-paid-bursting-enabled auch auf "true" festgelegt werden. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Wahlfrei. Unterstützt in Version 2024-11-04 und höher. Nur für Premium-Dateifreigaben zulässig. Eine ganze Zahl, die die maximal bezahlten mebibytes pro Sekunde (MiB/s) darstellt, die für die Freigabe zulässig sind. Der Standardwert, wenn nicht angegeben ist die maximal zulässige MiB/s für eine Freigabe. Wenn dieser Header festgelegt ist, muss x-ms-share-paid-bursting-enabled auch auf "true" festgelegt werden. |
Anforderungstext
Nichts.
Beispielanforderung
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
x-ms-meta-Name: StorageSample
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Antwort
Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.
Statuscode
Ein erfolgreicher Vorgang gibt den Statuscode 201 (Erstellt) zurück.
Weitere Informationen finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch zusätzliche Standard-HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
Antwortheader | Beschreibung |
---|---|
ETag |
Enthält einen Wert, der die Version der Freigabe darstellt, die in Anführungszeichen eingeschlossen ist. |
Last-Modified |
Gibt das Datum und die Uhrzeit der letzten Änderung der Freigabe zurück. Das Datumsformat folgt RFC 1123. Weitere Informationen finden Sie unter Darstellen von Datums-/Uhrzeitwerten in Kopfzeilen. Jeder Vorgang, der die Freigabe oder die zugehörigen 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 die Anforderung eindeutig, und Sie können sie verwenden, um die Anforderung zu beheben. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge |
x-ms-version |
Gibt die Azure Files-Version an, die zum Ausführen der Anforderung verwendet wurde. |
Date |
Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. |
x-ms-client-request-id |
Kann verwendet werden, um Anfragen und entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der x-ms-client-request-id -Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden. |
Antworttext
Nichts.
Beispielantwort
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
x-ms-version: 2020-02-10
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Ermächtigung
Nur der Kontobesitzer kann diesen Vorgang aufrufen.
Bemerkungen
Freigaben werden sofort innerhalb des Speicherkontos erstellt. Es ist nicht möglich, eine Freigabe in einer anderen zu verschachteln.
Sie können Metadaten für eine Freigabe angeben, wenn Sie sie erstellen, indem Sie einen oder mehrere Metadatenheader in die Anforderung einschließen. Das Format für den Metadatenheader ist x-ms-meta-name:value
.
Wenn eine Freigabe mit demselben Namen gelöscht wird, wenn Sie Create Share
aufrufen, gibt der Server statuscode 409 (Conflict) zurück, und zusätzliche Fehlerinformationen deuten darauf hin, dass die Freigabe gelöscht wird.
Sie können das Freigabegrößenkontingent verwenden, um die Größe von Dateien einzuschränken, die auf der Freigabe gespeichert sind. Das Kontingent beschränkt nicht die Größe von Momentaufnahmen. Der Aufwand, der dateien zugeordnet ist und zum Berechnen der Rechnungsgröße für das Speicherkonto verwendet wird, wird nicht im Kontingent berücksichtigt.
Wenn die Summe der Dateien in der Freigabe das Kontingent überschreitet, das für die Freigabe festgelegt ist, schlägt die Größe einer Datei fehl, und das Erstellen neuer nicht leerer Dateien (über REST) schlägt fehl. Sie können weiterhin leere Dateien erstellen.
Das Ändern oder Festlegen des Kontingents wirkt sich nicht auf die Abrechnung aus. Sie werden weiterhin für die Größe der Dateien und den Aufwand in Rechnung gestellt.