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
accountName
path True

string

Der Name des Azure Storage-Kontos.

dnsSuffix
path True

string

Das DNS-Suffix für den Azure Data Lake Storage-Endpunkt.

filesystem
path True

string

Der Dateisystembezeichner.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

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

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".

resource
query

PathResourceType

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 pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

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 pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

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 pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

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 pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

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.

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
  • Content-Length: integer
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
Other Status Codes

DataLakeStorageError

Ein Fehler ist aufgetreten. Die möglichen HTTP-status, Code- und Nachrichtenzeichenfolgen sind unten aufgeführt:

  • 400 Bad Request, ContentLengthMustBeZero, "Der Content-Length-Anforderungsheader muss 0 sein."
  • 400 Bad Request, InvalidAuthenticationInfo, "Authentifizierungsinformationen werden nicht im richtigen Format angegeben. Überprüfen Sie den Wert des Autorisierungsheaders."
  • 400 Bad Request, InvalidFlushPosition, "Die hochgeladenen Daten sind nicht zusammenhängend, oder der Wert des Positionsabfrageparameters entspricht nicht der Länge der Datei nach dem Anfügen der hochgeladenen Daten."
  • 400 Bad Request, InvalidHeaderValue, "Der Wert für einen der HTTP-Header hat nicht das richtige Format."
  • 400 Bad Request, InvalidHttpVerb: "Das angegebene HTTP-Verb ist ungültig – es wird vom Server nicht erkannt."
  • 400 Bad Request, InvalidInput, "Einer der Anforderungseingaben ist ungültig".
  • 400 Bad Request, InvalidPropertyName, "Ein Eigenschaftsname darf nicht leer sein."
  • 400 Bad Request, InvalidPropertyName, "Der Eigenschaftenname enthält ungültige Zeichen".
  • 400 Bad Request, InvalidQueryParameterValue, "Wert für einen der Abfrageparameter, die im Anforderungs-URI angegeben sind, ist ungültig."
  • 400 Bad Request, InvalidResourceName, "Der angegebene Ressourcenname enthält ungültige Zeichen".
  • 400 Bad Request, InvalidSourceUri, "Der Quell-URI ist ungültig".
  • 400 Bad Request, InvalidUri, "Der Anforderungs-URI ist ungültig".
  • 400 Bad Request, MissingRequiredHeader: "Ein HTTP-Header, der für diese Anforderung obligatorisch ist, ist nicht angegeben."
  • 400 Bad Request, MissingRequiredQueryParameter, "Ein Abfrageparameter, der für diese Anforderung obligatorisch ist, ist nicht angegeben."
  • 400 Bad Request, MultipleConditionHeadersNotSupported, "Mehrere Bedingungsheader werden nicht unterstützt."
  • 400 Bad Request, OutOfRangeInput: "Einer der Anforderungseingaben liegt außerhalb des Bereichs."
  • 400 Bad Request, OutOfRangeQueryParameterValue: "Einer der im Anforderungs-URI angegebenen Abfrageparameter liegt außerhalb des zulässigen Bereichs."
  • 400 Bad Request, UnsupportedHeader: "Einer der in der Anforderung angegebenen Header wird nicht unterstützt."
  • 400 Bad Request, UnsupportedQueryParameter: "Einer der Abfrageparameter, die im Anforderungs-URI angegeben sind, wird nicht unterstützt."
  • 400 Bad Request, Nicht unterstütztRestVersion, "Die angegebene Restversion ist nicht unterstützt."
  • 403 Verboten, AccountIsDisabled, "Das angegebene Konto ist deaktiviert".
  • 403 Forbidden, AuthorizationFailure: "Diese Anforderung ist nicht autorisiert, diesen Vorgang auszuführen."
  • 403 Forbidden, InsufficientAccountPermissions: "Das Konto, auf das zugegriffen wird, verfügt nicht über ausreichende Berechtigungen zum Ausführen dieses Vorgangs."
  • 404 Not Found, FilesystemNotFound, "Das angegebene Dateisystem ist nicht vorhanden."
  • 404 Not Found, PathNotFound, "Der angegebene Pfad ist nicht vorhanden."
  • 404 Not Found, RenameDestinationParentPathNotFound, "Das übergeordnete Verzeichnis des Zielpfads ist nicht vorhanden."
  • 404 Not Found, ResourceNotFound, "Die angegebene Ressource ist nicht vorhanden."
  • 404 Not Found, SourcePathNotFound, "Der Quellpfad für einen Umbenennungsvorgang ist nicht vorhanden."
  • 405 Method Not Allowed, UnsupportedHttpVerb, "The resource does't support the specified HTTP verb."
  • 409 Conflict, DestinationPathIsBeingDeleted, "Der angegebene Zielpfad ist zum Löschen markiert."
  • 409 Conflict, DirectoryNotEmpty, "Der rekursive Abfrageparameterwert muss true sein, um ein nicht leeres Verzeichnis zu löschen."
  • 409 Conflict, FilesystemAlreadyExists, "Das angegebene Dateisystem ist bereits vorhanden."
  • 409 Conflict, FilesystemBeingDeleted, "Das angegebene Dateisystem wird gelöscht."
  • 409 Conflict, InvalidDestinationPath, "Der angegebene Pfad oder ein Element des Pfads ist vorhanden, und sein Ressourcentyp ist für diesen Vorgang ungültig." * 409 Conflict, InvalidFlushOperation, "Die Ressource wurde von der Blob Service-API erstellt oder geändert und kann nicht von der Data Lake Storage-Dienst-API geschrieben werden."
  • 409 Conflict, InvalidRenameSourcePath, "Das Quellverzeichnis kann nicht mit dem Zielverzeichnis identisch sein, noch kann das Ziel ein Unterverzeichnis des Quellverzeichnisses sein."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Quell- und Zielressourcentyp müssen identisch sein."
  • 409 Conflict, LeaseAlreadyPresent, "Es ist bereits eine Lease vorhanden."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Die angegebene Lease-ID stimmte nicht mit der Lease-ID für die Ressource mit dem angegebenen Leasevorgang überein."
  • 409 Conflict, LeaseIsAlreadyBroken: "Die Lease wurde bereits unterbrochen und kann nicht erneut gebrochen werden."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired: "Die Lease-ID stimmt überein, aber die Lease befindet sich derzeit in einem Breaking-Zustand und kann erst erworben werden, wenn sie unterbrochen ist."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Die Lease-ID stimmt überein, aber die Lease befindet sich derzeit in einem Breaking-Zustand und kann nicht geändert werden."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "Die Lease-ID wurde übereinstimmend, aber die Lease wurde explizit unterbrochen und kann nicht verlängert werden."
  • 409 Conflict, LeaseNameMismatch, "Der angegebene Leasename stimmte nicht mit dem vorhandenen Leasenamen überein."
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "Die Lease-ID ist beim angegebenen Leasevorgang nicht vorhanden."
  • 409 Conflict, PathAlreadyExists, "Der angegebene Pfad ist bereits vorhanden."
  • 409 Conflict, PathConflict, "Der angegebene Pfad oder ein Element des Pfads ist vorhanden, und sein Ressourcentyp ist für diesen Vorgang ungültig."
  • 409 Conflict, SourcePathIsBeingDeleted, "Der angegebene Quellpfad ist zum Löschen markiert."
  • 409 Conflict, ResourceTypeMismatch, "Der in der Anforderung angegebene Ressourcentyp stimmt nicht mit dem Typ der Ressource überein."
  • 412 Condition Failed, ConditionNotMet, "The condition specified using HTTP conditional header(s) is not erfüllt."
  • 412 Vorbedingung fehlgeschlagen, LeaseIdMismatch, "Die angegebene Lease-ID stimmte nicht mit der Lease-ID für die Ressource überein."
  • 412 Vorbedingung fehlgeschlagen, LeaseIdMissing, "Derzeit ist eine Lease für die Ressource vorhanden, und in der Anforderung wurde keine Lease-ID angegeben."
  • 412 Vorbedingung fehlgeschlagen, LeaseNotPresent, "Derzeit gibt es keine Lease für die Ressource."
  • 412 Voraussetzung fehlgeschlagen, LeaseLost, "Eine Lease-ID wurde angegeben, aber die Lease für die Ressource ist abgelaufen."
  • 412 Voraussetzung fehlgeschlagen, SourceConditionNotMet, "Die Quellbedingung, die mithilfe von bedingten HTTP-Headern angegeben wurde, ist nicht erfüllt."
  • 413 Anforderungsentität zu groß, RequestBodyTooLarge, "Der Anforderungstext ist zu groß und überschreitet den maximal zulässigen Grenzwert."
  • 416 Angeforderter Bereich nicht zufriedenstellend, InvalidRange, "Der angegebene Bereich ist für die aktuelle Größe der Ressource ungültig."
  • 500 Internal Server Error, InternalError, "Der Server hat einen internen Fehler gefunden. Versuchen Sie die Anforderung erneut.“
  • 500 Interner Serverfehler, OperationTimedOut, "Der Vorgang konnte nicht innerhalb der zulässigen Zeit abgeschlossen werden."
  • 503 Dienst nicht verfügbar, ServerBusy, "Egress is over the account limit".
  • 503 Dienst nicht verfügbar, ServerBusy, "Eingehender Wert überschreitet das Kontolimit".
  • 503 Dienst nicht verfügbar, ServerBusy, "Vorgänge pro Sekunde überschreiten das Kontolimit".
  • 503 Dienst nicht verfügbar, ServerBusy, "Der Server kann derzeit keine Anforderungen empfangen. Please retry your request. (Wiederholen Sie die Anforderung.)“

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Definitionen

Name Beschreibung
DataLakeStorageError
Error

Das Dienstfehlerantwortobjekt.

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".

PathResourceType

Ist nur für "Datei erstellen" und "Verzeichnis erstellen" erforderlich. Der Wert muss "file" oder "directory" sein.

DataLakeStorageError

Name Typ Beschreibung
error

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