Path - Create
Datei erstellen | Verzeichnis erstellen | Datei umbenennen | Verzeichnis umbenennen
Erstellen oder Umbenennen einer Datei oder eines Verzeichnisses. Standardmäßig wird das Ziel überschrieben, und wenn das Ziel bereits vorhanden ist und über eine Lease verfügt, ist die Lease unterbrochen. Beachten Sie, dass das Umbenennen einer Datei oder eines Verzeichnisses in einen Container mit einer erzwungenen Containerverschlüsselungsrichtlinie nicht zulässig ist, es sei denn, der Quellcontainer verfügt auch über eine erzwungene Containerverschlüsselungsrichtlinie, die übereinstimmt. Dieser Vorgang unterstützt bedingte HTTP-Anforderungen. Weitere Informationen finden Sie unter Specifying Conditional Headers for Blob Service Operations (Angeben von bedingten Headern für Vorgänge des Blob-Diensts). Wenn das Ziel bereits vorhanden ist, verwenden Sie eine bedingte Anforderung mit If-None-Match: "*".
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Azure Storage-Kontos. |
dns
|
path | True |
string |
Das DNS-Suffix für den Azure Data Lake Storage-Endpunkt. |
filesystem
|
path | True |
string |
Der Dateisystembezeichner. RegEx-Muster: |
path
|
path | True |
string |
Der Datei- oder Verzeichnispfad. |
continuation
|
query |
string |
Optional. Beim Umbenennen eines Verzeichnisses ist die Anzahl der Pfade, die mit jedem Aufruf umbenannt werden, begrenzt. Wenn die Anzahl der umzubenennenden Pfade diesen Grenzwert überschreitet, wird in diesem Antwortheader ein Fortsetzungstoken zurückgegeben. Wenn ein Fortsetzungstoken in der Antwort zurückgegeben wird, muss es in einem nachfolgenden Aufruf des Umbenennungsvorgangs angegeben werden, um die Umbenennung des Verzeichnisses fortzusetzen. |
|
mode
|
query |
Optional. Nur gültig, wenn der Namespace aktiviert ist. Dieser Parameter bestimmt das Verhalten des Umbenennungsvorgangs. Der Wert muss "legacy" oder "posix" sein, und der Standardwert lautet "posix". |
||
resource
|
query |
Ist nur für "Datei erstellen" und "Verzeichnis erstellen" erforderlich. Der Wert muss "file" oder "directory" sein. |
||
timeout
|
query |
integer int32 |
Ein optionaler Vorgangstimeoutwert in Sekunden. Der Zeitraum beginnt, wenn die Anforderung vom Dienst empfangen wird. Wenn der Timeoutwert verstrichen ist, bevor der Vorgang abgeschlossen ist, schlägt der Vorgang fehl. |
Anforderungsheader
Media Types: "application/octet-stream"
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Cache-Control |
string |
Optional. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Cache-Control" für Vorgänge "Datei lesen" für "Datei lesen" ein. |
|
Content-Encoding |
string |
Optional. Gibt an, welche Inhaltscodierungen auf die Datei angewendet wurden. Dieser Wert wird an den Client zurückgegeben, wenn der Vorgang "Datei lesen" ausgeführt wird. |
|
Content-Language |
string |
Optional. Gibt die natürliche Sprache an, die von der beabsichtigten Zielgruppe für die Datei verwendet wird. |
|
Content-Disposition |
string |
Optional. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Disposition" für Vorgänge "Datei lesen" ein. |
|
x-ms-cache-control |
string |
Optional. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Cache-Control" für Vorgänge "Datei lesen" ein. |
|
x-ms-content-type |
string |
Optional. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Type" für Vorgänge "Datei lesen" ein. |
|
x-ms-content-encoding |
string |
Optional. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Encoding" für Vorgänge "Datei lesen" ein. |
|
x-ms-content-language |
string |
Optional. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Language" für Vorgänge "Datei lesen" ein. |
|
x-ms-content-disposition |
string |
Optional. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Disposition" für Vorgänge "Datei lesen" ein. |
|
x-ms-rename-source |
string |
Eine optionale Datei oder ein Verzeichnis, das umbenannt werden soll. Der Wert muss das folgende Format aufweisen: "/{filesystem}/{path}" oder "/{filesystem}/{path}?sastoken", wenn ein SAS-Token verwendet wird. Wenn "x-ms-properties" angegeben wird, überschreiben die Eigenschaften die vorhandenen Eigenschaften. andernfalls werden die vorhandenen Eigenschaften beibehalten. Dieser Wert muss eine prozentcodierte URL-Zeichenfolge sein. Beachten Sie, dass die Zeichenfolge nur ASCII-Zeichen im ZEICHENSATZ ISO-8859-1 enthalten darf. |
|
x-ms-lease-id |
string |
Optional. Eine Lease-ID für den im URI angegebenen Pfad. Der zu überschreibende Pfad muss über eine aktive Lease verfügen, und die Lease-ID muss übereinstimmen. RegEx-Muster: |
|
x-ms-source-lease-id |
string |
Optional für Umbenennungsvorgänge. Eine Lease-ID für den Quellpfad. Der Quellpfad muss über eine aktive Lease verfügen, und die Lease-ID muss übereinstimmen. RegEx-Muster: |
|
x-ms-properties |
string |
Optional. Benutzerdefinierte Eigenschaften, die mit der Datei oder dem Verzeichnis im Format einer durch Trennzeichen getrennten Liste von Namens- und Wertpaaren "n1=v1, n2=v2, ..." gespeichert werden sollen, wobei jeder Wert eine base64-codierte Zeichenfolge ist. Beachten Sie, dass die Zeichenfolge nur ASCII-Zeichen im ZEICHENSATZ ISO-8859-1 enthalten darf. |
|
x-ms-permissions |
string |
Optional und nur gültig, wenn hierarchischer Namespace für das Konto aktiviert ist. Legt POSIX-Zugriffsberechtigungen für den Dateibesitzer, die Dateibesitzergruppe und andere fest. Jeder Klasse kann die Berechtigung Lesen (4), Schreiben (2) oder Ausführen (1) gewährt werden. Sowohl symbolische (rwxrw-rw-) als auch 4-stellige oktale Notation (z. B. 0766) werden unterstützt. Das klebrige Bit wird auch unterstützt und in symbolischer Notation, es wird entweder durch den Buchstaben t oder T an der endgültigen Zeichenstelle dargestellt, je nachdem, ob das Ausführungsbit für die Andere Kategorie festgelegt oder nicht festgelegt ist (z. B. rwxrw-rw- mit klebrigem Bit wird als rwxrw-rwT dargestellt. Ein rwxrw-rwx mit klebrigem Bit wird als rwxrw-rwt dargestellt, das Fehlen von t oder T bedeutet, dass klebriges Bit nicht festgelegt ist. In der 4-stelligen oktalen Notation wird es durch eine 1. Ziffer dargestellt (z. B. 1766 steht für rwxrw-rw- mit klebrigem Bit und 0766 für rwxrw-rw- ohne klebriges Bit). Ungültig in Verbindung mit x-ms-acl. |
|
x-ms-umask |
string |
Optional und nur gültig, wenn hierarchischer Namespace für das Konto aktiviert ist. Wenn Sie eine Datei oder ein Verzeichnis erstellen und der übergeordnete Ordner keine Standard-ACL aufweist, schränkt der Umask die Berechtigungen der zu erstellenden Datei oder des Verzeichnisses ein. Die resultierende Berechtigung wird von p & ^u erteilt, wobei p die Berechtigung und Sie der Umask sind. Wenn p beispielsweise 0777 ist und Sie 0057 sind, ist die resultierende Berechtigung 0720. Die Standardberechtigung ist 0777 für ein Verzeichnis und 0666 für eine Datei. Der Standardumask ist 0027. Der Umask muss in 4-stelliger oktaler Notation angegeben werden (z. B. 0766). |
|
x-ms-owner |
string |
Optional und nur gültig, wenn hierarchischer Namespace für das Konto aktiviert ist. Legt den Besitzer der Datei oder des Verzeichnisses fest. |
|
x-ms-group |
string |
Optional und nur gültig, wenn hierarchischer Namespace für das Konto aktiviert ist. Legt die Besitzergruppe der Datei oder des Verzeichnisses fest. |
|
x-ms-acl |
string |
Optional und nur gültig, wenn hierarchischer Namespace für das Konto aktiviert ist. Legt POSIX-Zugriffssteuerungsrechte für Dateien und Verzeichnisse fest. Jeder Zugriffssteuerungseintrag (Access Control Entry, ACE) besteht aus einem Bereich, einem Typ, einem Benutzer- oder Gruppenbezeichner und Berechtigungen im Format "[scope:][type]:[id]:[permissions]". Der Bereich muss "Standard" sein, um anzugeben, dass der ACE zur Standard-ACL für ein Verzeichnis gehört. andernfalls ist der Bereich implizit, und der ACE gehört zur Zugriffs-ACL. Es gibt vier ACE-Typen: "Benutzer" gewährt Rechte für den Besitzer oder einen benannten Benutzer, "Gruppe" gewährt Rechte für die besitzende Gruppe oder eine benannte Gruppe, "mask" schränkt rechte ein, die benannten Benutzern und den Mitgliedern von Gruppen gewährt werden, und "andere" gewährt Allen Benutzern Rechte, die sich nicht in einem der anderen Einträge befinden. Der Benutzer- oder Gruppenbezeichner wird für Einträge vom Typ "mask" und "other" nicht angegeben. Der Benutzer- oder Gruppenbezeichner wird auch für den Besitzer und die besitzernde Gruppe weggelassen. Das Berechtigungsfeld ist eine 3-stellige Sequenz, bei der das erste Zeichen "r" ist, um Lesezugriff zu gewähren, das zweite Zeichen ist "w", um Schreibzugriff zu gewähren, und das dritte Zeichen ist "x", um die Ausführungsberechtigung zu erteilen. Wenn der Zugriff nicht gewährt wird, wird das Zeichen "-" verwendet, um anzugeben, dass die Berechtigung verweigert wird. Die folgende ACL gewährt beispielsweise Lese-, Schreib- und Ausführungsrechte an den Dateibesitzer und john.doe@contoso, das Leserecht für die besitzende Gruppe und nichts für alle anderen: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Ungültig in Verbindung mit x-ms-berechtigungen. |
|
x-ms-proposed-lease-id |
string |
Optional. Geben Sie eine vorgeschlagene Lease-ID an, wenn Sie während der Erstellung einer Datei oder eines Verzeichnisses eine Lease erwerben möchten. Bei erfolgreicher Erstellung wird eine Lease mit dieser Lease-ID erworben. RegEx-Muster: |
|
x-ms-expiry-option |
string |
Optional und nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist und nur für Dateien unterstützt wird. Geben Sie eine der folgenden Ablaufoptionen an, wenn Sie die Ablaufzeit für eine Datei während der Erstellung festlegen möchten. "RelativeToNow" Legen Sie den Ablauf relativ zur aktuellen Zeit fest. Der Benutzer übergibt die Anzahl der millisekunden, die ab jetzt verstrichen sind. Absolute Absolute Zeit im RFC 1123-Format. "Neverexpire" Legen Sie fest, dass die Datei niemals abläuft. Die Ablaufzeit muss mit dieser Option nicht angegeben werden. |
|
x-ms-expiry-time |
string |
Optional und nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist und nur für Dateien unterstützt wird. Geben Sie den Ablaufzeitpunkt an, zu dem die Datei abläuft. Angegeben als RFC 1123 HTTP-Zeitzeichenfolge oder Anzahl von Millisekunden gemäß der Ablaufoption. |
|
If-Match |
string |
Optional. Ein ETag-Wert. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-None-Match |
string |
Optional. Ein ETag-Wert oder der spezielle Platzhalterwert ("*"). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-Modified-Since |
string |
Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Ressource seit dem angegebenen Datum und der angegebenen Uhrzeit geändert wurde. |
|
If-Unmodified-Since |
string |
Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Ressource seit dem angegebenen Datum und der angegebenen Uhrzeit nicht geändert wurde. |
|
x-ms-source-if-match |
string |
Optional. Ein ETag-Wert. Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn das ETag der Quelle mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
x-ms-source-if-none-match |
string |
Optional. Ein ETag-Wert oder der spezielle Platzhalterwert ("*"). Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn das ETag der Quelle nicht mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
x-ms-source-if-modified-since |
string |
Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn die Quelle seit dem angegebenen Datum und der angegebenen Uhrzeit geändert wurde. |
|
x-ms-source-if-unmodified-since |
string |
Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn die Quelle seit dem angegebenen Datum und der angegebenen Uhrzeit nicht geändert wurde. |
|
x-ms-encryption-key |
string |
Optional. Der Base64-codierte AES-256-Verschlüsselungsschlüssel. |
|
x-ms-encryption-key-sha256 |
string |
Optional. Der Base64-codierte SHA256-Hash des Verschlüsselungsschlüssels. |
|
x-ms-encryption-algorithm: AES256 |
string |
Optional. Gibt den Algorithmus an, der für die Verschlüsselung verwendet werden soll. Der Wert dieses Headers muss AES256 sein. |
|
x-ms-encryption-context |
string |
Optional. Der Standardwert ist "Leer". Wenn der Wert festgelegt ist, werden Blob-/Dateisystemmetadaten festgelegt. Maximale Länge: 1024. Gültig nur, wenn hierarchischer Namespace für das Konto aktiviert ist. |
|
x-ms-client-request-id |
string |
Eine in den Analyseprotokollen aufgezeichnete UUID zur Problembehandlung und Korrelation. RegEx-Muster: |
|
x-ms-date |
string |
Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Dies ist erforderlich, wenn die Autorisierung mit freigegebenem Schlüssel verwendet wird. |
|
x-ms-version |
string |
Gibt die Version des REST-Protokolls an, das für die Verarbeitung der Anforderung verwendet wird. Dies ist erforderlich, wenn die Autorisierung mit freigegebenem Schlüssel verwendet wird. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
201 Created |
Die Datei oder das Verzeichnis wurde erstellt. Header
|
|
Other Status Codes |
Ein Fehler ist aufgetreten. Die möglichen HTTP-status, Code- und Nachrichtenzeichenfolgen sind unten aufgeführt:
Header
|
Definitionen
Name | Beschreibung |
---|---|
Data |
|
Error |
Das Dienstfehlerantwortobjekt. |
Path |
Optional. Nur gültig, wenn der Namespace aktiviert ist. Dieser Parameter bestimmt das Verhalten des Umbenennungsvorgangs. Der Wert muss "legacy" oder "posix" sein, und der Standardwert lautet "posix". |
Path |
Ist nur für "Datei erstellen" und "Verzeichnis erstellen" erforderlich. Der Wert muss "file" oder "directory" sein. |
DataLakeStorageError
Name | Typ | Beschreibung |
---|---|---|
error |
Das Dienstfehlerantwortobjekt. |
Error
Das Dienstfehlerantwortobjekt.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Dienstfehlercode. |
message |
string |
Die Dienstfehlermeldung. |
PathRenameMode
Optional. Nur gültig, wenn der Namespace aktiviert ist. Dieser Parameter bestimmt das Verhalten des Umbenennungsvorgangs. Der Wert muss "legacy" oder "posix" sein, und der Standardwert lautet "posix".
Name | Typ | Beschreibung |
---|---|---|
legacy |
string |
|
posix |
string |
PathResourceType
Ist nur für "Datei erstellen" und "Verzeichnis erstellen" erforderlich. Der Wert muss "file" oder "directory" sein.
Name | Typ | Beschreibung |
---|---|---|
directory |
string |
|
file |
string |