Verzeichnis erstellen
Der Vorgang Create Directory erstellt ein neues Verzeichnis in der angegebenen Freigabe oder im übergeordneten Verzeichnis. Die Verzeichnisressource enthält die Eigenschaften für dieses Verzeichnis. Es enthält keine Liste der Dateien oder Unterverzeichnisse, die im Verzeichnis enthalten sind.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |  |
| NFS |  |
Anforderung
Sie können die Create Directory Anforderung wie folgt erstellen. Es wird empfohlen, HTTPS zu verwenden.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
Ersetzen Sie die Pfadkomponenten im Anforderungs-URI durch Ihre eigenen, wie in der folgenden Tabelle gezeigt:
| Pfadkomponente | Beschreibung |
|---|---|
myaccount |
Der Name Ihres Speicherkontos. |
myshare |
Der Name der Dateifreigabe. |
myparentdirectorypath |
Optional. Der Pfad zum übergeordneten Verzeichnis, in dem mydirectory erstellt werden soll. Wenn der Pfad zum übergeordneten Verzeichnis weggelassen wird, wird das Verzeichnis in der angegebenen Freigabe erstellt. Wenn das übergeordnete Verzeichnis angegeben ist, muss es bereits innerhalb der Freigabe vorhanden sein, bevor Sie mydirectory erstellen können. |
mydirectory |
Der Name des zu erstellenden Verzeichnisses. |
Weitere Informationen zu Einschränkungen bei der Pfadbenennung finden Sie unter Namens- und Verweisfreigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
Sie können die 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 Dateidienstvorgänge. |
Anforderungstext
Keine.
Anforderungsheader
Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle beschrieben:
| Parameter | 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. Version 2015-02-21 oder höher. Ein Name-Wert-Paar, das dem Verzeichnis als Metadaten zugeordnet werden soll. Metadatennamen müssen den Benennungsregeln für C#-Bezeichner entsprechen. |
x-ms-file-permission: { inherit ¦ <SDDL> } |
In Version 2019-02-02 bis 2021-04-10 ist dieser Header erforderlich, wenn x-ms-file-permission-key nicht angegeben ist. Ab Version 2021-06-08 sind beide Header optional. Diese Berechtigung ist der Sicherheitsdeskriptor für das Verzeichnis, das in der SDDL (Security Descriptor Definition Language) angegeben ist. Dieser Header kann verwendet werden, wenn die Berechtigungsgröße über 8 Kibibyte (KiB) liegt. Andernfalls können Sie verwenden x-ms-file-permission-key. Wenn es angegeben ist, muss es über einen Besitzer, eine Gruppe und eine daCL (Discretionary Access Control List) verfügen. Sie können einen Wert von inherit übergeben, um vom übergeordneten Verzeichnis zu erben.Hinweis: Sie können entweder x-ms-file-permission oder x-ms-file-permission-keyangeben. Wenn keiner der Header angegeben ist, wird der Standardwert von inherit verwendet. |
x-ms-file-permission-key: <PermissionKey> |
Der Schlüssel der Berechtigung, die für das Verzeichnis festgelegt werden soll. In Version 2019-02-02 bis 2021-04-10 ist dieser Header erforderlich, wenn x-ms-file-permission nicht angegeben ist. Ab Version 2021-06-08 sind beide Header optional. Sie können diesen Schlüssel mithilfe der Create-Permission API erstellen.Hinweis: Sie können entweder x-ms-file-permission oder x-ms-file-permission-keyangeben. Wenn keiner der Header angegeben ist, wird der Standardwert von inherit für den x-ms-file-permission Header verwendet. |
x-ms-file-attributes |
Erforderlich: Version 2019-02-02 bis 2021-04-10. Optional: Version 2021-06-08 und höher. Die Dateisystemattribute, die im Verzeichnis festgelegt werden sollen. Weitere Informationen finden Sie in der Liste der verfügbaren Attribute. Der Standardwert ist Directory. |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Erforderlich: Version 2019-02-02 bis 2021-04-10. Optional: Version 2021-06-08 und höher. Die UTC-Erstellungszeit (Coordinated Universal Time) für das Verzeichnis. Sie können den Wert von now verwenden, um die Uhrzeit der Anforderung anzugeben. Der Standardwert ist now. |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Erforderlich: Version 2019-02-02 bis 2021-04-10. Optional: Version 2021-06-08 oder höher. Die UTC-Eigenschaft (Coordinated Universal Time) beim letzten Schreibvorgang für das Verzeichnis. Sie können den Wert von now verwenden, um die Uhrzeit der Anforderung anzugeben. Der Standardwert ist now. |
x-ms-client-request-id |
Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit 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 Azure Files. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Optional. Die UTC-Eigenschaft (Coordinated Universal Time) ändert die Zeit für das Verzeichnis im ISO 8601-Format. Version 2021-06-08 und höher. Sie können den Wert von now verwenden, um die Uhrzeit der Anforderung anzugeben. Der Standardwert ist now. |
x-ms-file-request-intent |
Erforderlich, wenn Authorization der Header ein OAuth-Token angibt. Zulässiger Wert ist backup. Dieser Header gibt an, dass oder Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/actionMicrosoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action gewährt werden soll, wenn sie in der RBAC-Richtlinie enthalten sind, die der Identität zugewiesen ist, die mithilfe des Authorization Headers autorisiert ist. Verfügbar für Version 2022-11-02 und höher. |
x-ms-allow-trailing-dot: { <Boolean> } |
Optional. Version 2022-11-02 und höher. Der boolesche Wert gibt an, ob ein in der Anforderungs-URL vorhandener nachgestellter Punkt gekürzt werden soll oder nicht. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten. |
Beispiel für eine Anforderung
PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1
Request headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
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.
Weitere Informationen zu status Codes finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang umfasst die Header, die in der folgenden Tabelle beschrieben werden. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
| Antwortheader | BESCHREIBUNG |
|---|---|
ETag |
Enthält einen Wert, der die Version des Verzeichnisses darstellt, in Anführungszeichen eingeschlossen. |
Last-Modified |
Gibt das Datum und die Uhrzeit der letzten Änderung des Verzeichnisses zurück. Das Datumsformat entspricht RFC 1123. Weitere Informationen finden Sie unter Darstellen von Datums-/Uhrzeitwerten in Headern. Bei jedem Vorgang, durch den das Verzeichnis, seine Eigenschaften oder seine Metadaten geändert werden, wird der Zeitpunkt der letzten Änderung aktualisiert. Vorgänge für Dateien wirken sich nicht auf den Zeitpunkt der letzten Änderung des Verzeichnisses 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 bei API-Vorgängen. |
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-request-server-encrypted: true/false |
Version 2017-04-17 oder höher. Der Wert dieses Headers wird auf true festgelegt, wenn der Inhalt der Anforderung erfolgreich mit dem angegebenen Algorithmus verschlüsselt wurde, andernfalls false . |
x-ms-file-permission-key |
Der Schlüssel der Berechtigung des Verzeichnisses. |
x-ms-file-attributes |
Die Dateisystemattribute im Verzeichnis. Sehen Sie sich die Liste der verfügbaren Attribute an. |
x-ms-file-creation-time |
Der UTC-Datums-/Uhrzeitwert, der die Erstellungszeiteigenschaft für das Verzeichnis darstellt. |
x-ms-file-last-write-time |
Der UTC-Datums-/Uhrzeitwert, der die Eigenschaft der letzten Schreibzeit für das Verzeichnis darstellt. |
x-ms-file-change-time |
Der UTC-Datum/Uhrzeit-Wert, der die Änderungszeiteigenschaft für das Verzeichnis darstellt. |
x-ms-file-file-id |
Die Datei-ID des Verzeichnisses. |
x-ms-file-parent-id |
Die übergeordnete Datei-ID des Verzeichnisses. |
x-ms-client-request-id |
Kann zum Behandeln 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 und der Wert nicht mehr als 1024 sichtbare ASCII-Zeichen enthält. Wenn der x-ms-client-request-id Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden. |
Antworttext
Keine.
Beispiel für eine Antwort
Response status:
HTTP/1.1 201 Created
Response headers:
Transfer-Encoding: chunked
Date: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorisierung
Dieser Vorgang kann nur vom Kontobesitzer aufgerufen werden.
Dateisystemattribute
| attribute | Win32-Dateiattribute | Definition |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | Ein verzeichnis, das schreibgeschützt ist. |
| Ausgeblendet | FILE_ATTRIBUTE_HIDDEN | Das Verzeichnis ist ausgeblendet. Es ist nicht in einer normalen Verzeichnisliste enthalten. |
| System | FILE_ATTRIBUTE_SYSTEM | Ein Verzeichnis, von dem das Betriebssystem einen Teil oder ausschließlich verwendet. |
| Keine | FILE_ATTRIBUTE_NORMAL | Ein Verzeichnis, in dem keine anderen Attribute festgelegt sind. Dieses Attribut ist nur gültig, wenn es allein verwendet wird. |
| Verzeichnis | FILE_ATTRIBUTE_DIRECTORY | Das Handle, das ein Verzeichnis identifiziert. |
| Archivieren | FILE_ATTRIBUTE_ARCHIVE | Ein Verzeichnis, das ein Archivverzeichnis ist. Anwendungen verwenden dieses Attribut normalerweise, um Dateien für die Sicherung oder Entfernung zu markieren. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Die Daten eines Verzeichnisses sind nicht sofort verfügbar. Dieses Dateisystemattribute wird in erster Linie angezeigt, um die Kompatibilität mit Windows zu gewährleisten. Azure Files unterstützt es nicht mit Offlinespeicheroptionen. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Das Verzeichnis soll nicht vom Inhaltsindizierungsdienst indiziert werden. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Der Benutzerdatenstrom, der nicht vom Hintergrunddatenintegritätsscanner gelesen werden soll. Dieses Dateisystemattribute wird in erster Linie angezeigt, um die Kompatibilität mit Windows zu gewährleisten. |
Hinweise
Wenn ein Verzeichnis mit demselben Namen beim Create Directory Aufruf gelöscht wird, gibt der Server status Code 409 (Konflikt) zurück und stellt zusätzliche Fehlerinformationen bereit, die angibt, dass das Verzeichnis gelöscht wird.
Wenn ein Verzeichnis oder eine Datei mit dem gleichen Namen bereits vorhanden ist, schlägt der Vorgang mit Statuscode 409 (Konflikt) fehl. Wenn das übergeordnete Verzeichnis nicht vorhanden ist, schlägt der Vorgang mit status Code 412 (Vorbedingung fehlgeschlagen) fehl.
Es ist nicht möglich, eine Verzeichnishierarchie mit einem einzelnen Create Directory Vorgang zu erstellen. Sie können das Verzeichnis nur erstellen, wenn das unmittelbare übergeordnete Verzeichnis bereits vorhanden ist, wie im Pfad angegeben. Wenn das übergeordnete Verzeichnis nicht vorhanden ist, schlägt der Vorgang mit status Code 412 (Vorbedingung fehlgeschlagen) fehl.
Create Directorywird nicht für eine Freigabe Momentaufnahme unterstützt, bei der es sich um eine schreibgeschützte Kopie einer Freigabe handelt. Ein Versuch, diesen Vorgang für eine Freigabe auszuführen, Momentaufnahme schlägt mit 400 (InvalidQueryParameterValue) fehl.