Verzeichnis erstellen

Artikel
08/07/2024

Der vorgang Create Directory erstellt ein neues Verzeichnis unter dem angegebenen Freigabe- oder übergeordneten Verzeichnis. Die Verzeichnisressource enthält die Eigenschaften für dieses Verzeichnis. Sie enthält keine Liste der Dateien oder Unterverzeichnisse, die im Verzeichnis enthalten sind.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll	Verfügbar
SMB
NFS

Bitten

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 Ihren eigenen, wie in der folgenden Tabelle dargestellt:

Pfadkomponente	Beschreibung
`myaccount`	Der Name Ihres Speicherkontos.
`myshare`	Der Name Ihrer Dateifreigabe.
`myparentdirectorypath`	Wahlfrei. Der Pfad zum übergeordneten Verzeichnis, in dem mydirectory erstellt werden soll. Wenn der übergeordnete Verzeichnispfad nicht angegeben wird, wird das Verzeichnis innerhalb der angegebenen Freigabe erstellt. Wenn das übergeordnete Verzeichnis angegeben ist, muss es bereits innerhalb der Freigabe vorhanden sein, bevor Sie mydirectoryerstellen können.
`mydirectory`	Der Name des zu erstellenden Verzeichnisses.

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 parameter `timeout` wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Dateidienstvorgänge.

Anforderungstext

Nichts.

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 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 die Azure Storage-Dienste.
`x-ms-meta-name:value`	Wahlfrei. 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#-Bezeichnerentsprechen.
`x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> }`	In Version 2019-02-02 bis 2021-04-10 ist diese Kopfzeile 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 im Security Descriptor Definition Language (SDDL) oder (Version 2024-11-04 oder höher) im base64-codierten binären Sicherheitsdeskriptorformatangegeben ist. Sie können angeben, welches Format mit der `x-ms-file-permission-format` Kopfzeile verwendet werden soll. Dieser Header kann verwendet werden, wenn die Berechtigungsgröße über 8 Kibibyte (KiB) liegt. Andernfalls können Sie `x-ms-file-permission-key`verwenden. Wenn er angegeben ist, muss er über einen Besitzer, eine Gruppe und diskretionäre Zugriffssteuerungsliste (DACL)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-key`angeben. Wenn keines der Kopfzeilen angegeben ist, wird der Standardwert von `inherit` verwendet.
`x-ms-file-permission-format: { sddl ¦ binary }`	Wahlfrei. Version 2024-11-04 oder höher. Gibt an, ob sich der in `x-ms-file-permission` übergebene Wert in SDDL oder im Binärformat befindet. Wenn `x-ms-file-permission-key` auf `inherit`festgelegt ist, sollte diese Kopfzeile nicht festgelegt werden. Wenn `x-ms-file-permission-key` auf einen anderen Wert als `inherit`festgelegt ist und wenn dieser Header nicht festgelegt ist, wird der Standardwert `sddl` 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 diese Kopfzeile 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-key`angeben. Wenn keines der Kopfzeilen angegeben ist, wird der Standardwert von `inherit` für die `x-ms-file-permission` Kopfzeile 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 für das Verzeichnis festgelegt werden sollen. Sehen Sie sich die Liste der verfügbaren Attributean. 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-Erstellungszeiteigenschaft (Coordinated Universal Time) für das Verzeichnis. Sie können einen Wert von `now` verwenden, um den Zeitpunkt 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 koordinierte Weltzeit (COORDINATED Universal Time, UTC) letzte Schreibeigenschaft für das Verzeichnis. Sie können einen Wert von `now` verwenden, um den Zeitpunkt der Anforderung anzugeben. Der Standardwert ist `now`.
`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-file-change-time: { now ¦ <DateTime> }`	Wahlfrei. Die UTC-Eigenschaft (Coordinated Universal Time) ändert die Zeiteigenschaft für das Verzeichnis im ISO 8601-Format. Version 2021-06-08 und höher. Sie können einen Wert von `now` verwenden, um den Zeitpunkt der Anforderung anzugeben. Der Standardwert ist `now`.
`x-ms-file-request-intent`	Erforderlich, wenn `Authorization` Header ein OAuth-Token angibt. Zulässiger Wert ist `backup`. Dieser Header gibt an, dass die `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` oder `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` gewährt werden sollen, 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> }`	Wahlfrei. Version 2022-11-02 und höher. Der boolesche Wert gibt an, ob ein nachgestellter Punkt in der Anforderungs-URL gekürzt werden soll. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten.

Beispielanforderung

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 einen HTTP-Statuscode und eine Reihe von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 201 (Erstellt) zurück.

Weitere Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang enthält die Überschriften, die in der folgenden Tabelle beschrieben werden. 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 des Verzeichnisses darstellt, die in Anführungszeichen eingeschlossen ist.
`Last-Modified`	Gibt das Datum und die Uhrzeit der letzten Änderung des Verzeichnisses zurück. Das Datumsformat folgt RFC 1123. Weitere Informationen finden Sie unter Darstellen von Datums-/Uhrzeitwerten in Kopfzeilen. Jeder Vorgang, der das Verzeichnis oder seine Eigenschaften ändert, aktualisiert den Zeitpunkt der letzten Änderung. Vorgänge für Dateien wirken sich nicht auf die Uhrzeit der letzten Änderung des Verzeichnisses aus.
`x-ms-request-id`	Identifiziert die 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 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 und 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 Attributean.
`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 letzte Schreibzeiteigenschaft für das Verzeichnis darstellt.
`x-ms-file-change-time`	Der UTC-Datums-/Uhrzeitwert, 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 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 maximal 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

Nichts.

Beispielantwort

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

Ermächtigung

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Dateisystemattribute

Attribut	Win32-Dateiattribute	Definition
ReadOnly	FILE_ATTRIBUTE_READONLY	Ein Schreibgeschütztes Verzeichnis.
Versteckt	FILE_ATTRIBUTE_HIDDEN	Das Verzeichnis ist ausgeblendet. Sie ist nicht in einer normalen Verzeichnisauflistung enthalten.
System	FILE_ATTRIBUTE_SYSTEM	Ein Verzeichnis, von dem das Betriebssystem ausschließlich einen Teil oder ausschließlich verwendet.
Nichts	FILE_ATTRIBUTE_NORMAL	Ein Verzeichnis, das keine anderen Attribute festgelegt hat. Dieses Attribut ist nur gültig, wenn es allein verwendet wird.
Verzeichnis	FILE_ATTRIBUTE_DIRECTORY	Das Handle, das ein Verzeichnis identifiziert.
Archiv	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 Dateisystem-Attribut wird in erster Linie zur Bereitstellung der Kompatibilität mit Windows dargestellt. Azure Files unterstützt sie nicht mit Offlinespeicheroptionen.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	Das Verzeichnis muss nicht vom Inhaltsindizierungsdienst indiziert werden.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	Der Benutzerdatenstrom, der nicht, vom Scanner für die Hintergrunddatenintegrität gelesen zu werden. Dieses Dateisystem-Attribut wird in erster Linie zur Bereitstellung der Kompatibilität mit Windows dargestellt.

Bemerkungen

Wenn ein Verzeichnis mit demselben Namen gelöscht wird, wenn Create Directory aufgerufen wird, gibt der Server statuscode 409 (Conflict) zurück und stellt zusätzliche Fehlerinformationen bereit, die darauf hindeuten, dass das Verzeichnis gelöscht wird.

Wenn bereits ein Verzeichnis oder eine Datei mit demselben Namen vorhanden ist, schlägt der Vorgang mit dem Statuscode 409 (Conflict) fehl. Wenn das übergeordnete Verzeichnis nicht vorhanden ist, schlägt der Vorgang mit dem Statuscode 412 fehl (Vorbedingung fehlgeschlagen).

Es ist nicht möglich, eine Verzeichnishierarchie mit einem einzelnen Create Directory Vorgang zu erstellen. Sie können das Verzeichnis nur erstellen, wenn das direkte übergeordnete Element bereits vorhanden ist, wie im Pfad angegeben. Wenn das übergeordnete Verzeichnis nicht vorhanden ist, schlägt der Vorgang mit dem Statuscode 412 fehl (Vorbedingung fehlgeschlagen).

Create Directory wird für eine Freigabemomentaufnahme nicht unterstützt, bei der es sich um eine schreibgeschützte Kopie einer Freigabe handelt. Ein Versuch, diesen Vorgang für eine Freigabemomentaufnahme auszuführen, schlägt mit 400 fehl (InvalidQueryParameterValue)

Siehe auch

Vorgänge in Verzeichnissen

Freigeben über