Freigeben über

Path - Create

  • Referenz
Dienst:
Storage Services
API-Version:
2023-08-03

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 eine Lease vorhanden ist, 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 Angeben von bedingten Headern für Blob-Dienstvorgänge. Wenn das Ziel bereits vorhanden ist, verwenden Sie eine bedingte Anforderung mit If-None-Match: "*".

PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
Mit optionalen Parametern: 
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-Muster: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

Die Datei oder der Verzeichnispfad.
continuation
 query

string

Wahlfrei. Beim Umbenennen eines Verzeichnisses ist die Anzahl der Pfade, die bei 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 das Umbenennen des Verzeichnisses fortzusetzen.
mode
 query

PathRenameMode

Wahlfrei. 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 ist "posix".
resource
 query

PathResourceType

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 vor Abschluss des Vorgangs verstrichen ist, schlägt der Vorgang fehl.

Anforderungsheader

Media Types: "application/octet-stream"

Name Erforderlich Typ Beschreibung
Cache-Control

string

Wahlfrei. Der Dienst speichert diesen Wert und enthält ihn im Antwortheader "Cache-Control" für "Read File"-Vorgänge für "Read File"-Vorgänge.
Content-Encoding

string

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

Wahlfrei. Gibt die natürliche Sprache an, die von der vorgesehenen Zielgruppe für die Datei verwendet wird.
Content-Disposition

string

Wahlfrei. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Disposition" für "Read File"-Vorgänge ein.
x-ms-cache-control

string

Wahlfrei. Der Dienst speichert diesen Wert und enthält ihn im Antwortheader "Cache-Control" für "Read File"-Vorgänge.
x-ms-content-type

string

Wahlfrei. Der Dienst speichert diesen Wert und enthält ihn im Antwortheader "Content-Type" für "Read File"-Vorgänge.
x-ms-content-encoding

string

Wahlfrei. Der Dienst speichert diesen Wert und enthält ihn in den Antwortheader "Content-Encoding" für "Read File"-Vorgänge.
x-ms-content-language

string

Wahlfrei. Der Dienst speichert diesen Wert und enthält ihn im Antwortheader "Content-Language" für "Read File"-Vorgänge.
x-ms-content-disposition

string

Wahlfrei. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Disposition" für "Read File"-Vorgänge ein.
x-ms-rename-source

string

Eine optionale Datei oder ein optionales Verzeichnis, das umbenannt werden soll. Der Wert muss das folgende Format aufweisen: "/{filesystem}/{path}" oder "/{filesystem}/{path}?sastoken" bei Verwendung eines SAS-Tokens. Wenn "x-ms-properties" angegeben wird, überschreiben die Eigenschaften die vorhandenen Eigenschaften; andernfalls werden die vorhandenen Eigenschaften beibehalten. Dieser Wert muss eine URL-prozentcodierte Zeichenfolge sein. Beachten Sie, dass die Zeichenfolge nur ASCII-Zeichen im ISO-8859-1-Zeichensatz enthalten darf.
x-ms-lease-id

string

Wahlfrei. 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: ^[{(]?[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-Muster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-properties

string

Wahlfrei. Benutzerdefinierte Eigenschaften, die mit der Datei oder dem Verzeichnis gespeichert werden sollen, im Format einer durch Trennzeichen getrennten Liste von Namen- und Wertpaaren "n1=v1, n2=v2, ...", wobei jeder Wert eine base64-codierte Zeichenfolge ist. Beachten Sie, dass die Zeichenfolge nur ASCII-Zeichen im ISO-8859-1-Zeichensatz enthalten darf.
x-ms-permissions

string

Optional und nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Legt POSIX-Zugriffsberechtigungen für den Dateibesitzer, die Besitzergruppe der Datei und andere fest. Jeder Klasse kann Leseberechtigung (4), Schreibzugriff (2) oder Ausführungsberechtigung (1) erteilt werden. Sowohl symbolische (rwxrw-rw-) als auch 4-stellige Oktalnotation (z. B. 0766) werden unterstützt. Das klebige Bit wird auch unterstützt und in symbolischer Notation entweder durch den Buchstaben t oder T am endgültigen Zeichenplatz dargestellt, je nachdem, ob das Ausführungsbit für die andere Kategorie festgelegt oder nicht festgelegt ist (z. B. rwxrw-rw- mit Sticky bit wird als rwxrw-rwT dargestellt. Ein rwxrw-rwx mit Sticky-Bit wird als rwxrw-rwt dargestellt, das Fehlen von t oder T zeigt an, dass ein Sticky-Bit nicht festgelegt ist. In der 4-stelligen Oktalnotation wird sie durch 1. Ziffer dargestellt (z. B. 1766 stellt rwxrw-rw- mit Sticky Bit und 0766 rwxrw-rw- ohne Sticky-Bit dar). In Verbindung mit x-ms-acl ungültig.
x-ms-umask

string

Optional und nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Beim Erstellen einer Datei oder eines Verzeichnisses und des übergeordneten Ordners ist keine Standard-ACL vorhanden, 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 ist und Sie die Umask sind. Wenn z. B. p 0777 ist und Sie 0057 sind, lautet 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 Oktalnotation (z. B. 0766) angegeben werden.
x-ms-owner

string

Optional und nur gültig, wenn der hierarchische 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 der hierarchische Namespace für das Konto aktiviert ist. Legt die besitzereigene Gruppe der Datei oder des Verzeichnisses fest.
x-ms-acl

string

Optional und nur gültig, wenn der hierarchische 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 die ACE zur Standard-ACL für ein Verzeichnis gehört. andernfalls ist der Bereich implizit, und die ACE gehört zur Zugriffs-ACL. Es gibt vier ACE-Typen: "Benutzer" gewährt dem Besitzer oder einem benannten Benutzer Rechte, "Gruppe" gewährt Berechtigungen für die besitzereigene 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 Rechten für alle Benutzer, die in keinem der anderen Einträge gefunden wurden. Der Benutzer- oder Gruppenbezeichner wird für Einträge vom Typ "mask" und "other" weggelassen. Der Benutzer- oder Gruppenbezeichner wird auch für den Besitzer und die Besitzergruppe weggelassen. Das Berechtigungsfeld ist eine 3-stellige Sequenz, in der das erste Zeichen "r" ist, um Lesezugriff zu gewähren, das zweite Zeichen "w" ist, um Schreibzugriff zu gewähren, und das dritte Zeichen ist "x", um ausführungsberechtigungen zu erteilen. Wenn kein Zugriff gewährt wird, wird das Zeichen "-" verwendet, um zu kennzeichnen, dass die Berechtigung verweigert wird. Beispielsweise gewährt die folgende ACL Lese-, Schreib- und Ausführungsrechte für den Dateibesitzer und john.doe@contoso, das Leserecht für die besitzereigene Gruppe und nichts für alle anderen: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". In Verbindung mit x-ms-permissions ungültig.
x-ms-proposed-lease-id

string

Wahlfrei. Geben Sie eine vorgeschlagene Lease-ID an, wenn Sie während der Erstellung einer Datei oder eines Verzeichnisses eine Lease erwerben möchten. Eine Lease wird mit dieser Lease-ID erworben, wenn die Erstellung erfolgreich ist.

RegEx-Muster: ^[{(]?[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 und nur für Dateien unterstützt wird. Geben Sie eine der folgenden Ablaufoption an, wenn Sie während der Erstellung eine Ablaufzeit für eine Datei festlegen möchten. "RelativeToNow" Legt den Ablauf relativ zur aktuellen Uhrzeit fest. Der Benutzer übergibt die Anzahl von Millisekunden, die ab jetzt verstrichen sind. Absolute Absolute Zeit im RFC 1123-Format. "Neverexpire" Legen Sie fest, dass die Datei nie abläuft, die Ablaufzeit muss nicht mit dieser Option angegeben werden.
x-ms-expiry-time

string

Optional und nur gültig, wenn der hierarchische Namespace für das Konto aktiviert und nur für Dateien unterstützt wird. Geben Sie den Ablaufzeitpunkt an, an dem die Datei abläuft. Angegeben als RFC 1123 HTTP-Zeitzeichenfolge oder Anzahl von Millisekunden gemäß der Ablaufoption.
If-Match

string

Wahlfrei. Ein ETag-Wert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden.
If-None-Match

string

Wahlfrei. Ein ETag-Wert oder der spezielle Wildcardwert ("*") Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden.
If-Modified-Since

string

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

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

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

Wahlfrei. Ein ETag-Wert oder der spezielle Wildcardwert ("*") 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

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

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

Wahlfrei. Der base64-codierte AES-256-Verschlüsselungsschlüssel.
x-ms-encryption-key-sha256

string

Wahlfrei. Der base64-codierte SHA256-Hash des Verschlüsselungsschlüssels.
x-ms-encryption-algorithm: AES256

string

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

Wahlfrei. Der Standardwert ist "Leer". Wenn der Wert festgelegt ist, wird blob/Dateisystemmetadaten festgelegt. Max. Länge - 1024. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist.
x-ms-client-transaction-id

string

Wahlfrei. Der Standardwert ist "Leer". Wenn der Wert festgelegt ist, wird blob-Metadaten beim Erstellen oder Umbenennen von Dateien festgelegt. Wenn das Zeitlimit für die Anforderung für den Client überschritten wird, kann dieser Wert mithilfe des Aufrufs "Get Properties" abgerufen werden, um zu bestätigen, ob die Timeoutanforderung erfolgreich war oder nicht am Dienstende. Max. Länge - 36. Nur gültig, wenn der hierarchische 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: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

Gibt die koordinierte Weltzeit (UTC) für die Anforderung an. Dies ist erforderlich, wenn Sie die Gemeinsame Schlüsselautorisierung verwenden.
x-ms-version

string

Gibt die Version des REST-Protokolls an, das für die Verarbeitung der Anforderung verwendet wird. Dies ist erforderlich, wenn Sie die Gemeinsame Schlüsselautorisierung verwenden.

Antworten

Name Typ Beschreibung
201 Created

Die Datei oder das Verzeichnis wurde erstellt.

Header

  • 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

Fehler. Die möglichen HTTP-Status-, Code- und Nachrichtenzeichenfolgen sind unten aufgeführt:

  • 400 Ungültige Anforderung, ContentLengthMustBeZero, "Der Anforderungsheader der Inhaltslänge muss null sein."
  • 400 Ungültige Anforderung, InvalidAuthenticationInfo, "Authentifizierungsinformationen werden nicht im richtigen Format angegeben. Überprüfen Sie den Wert des Autorisierungsheaders."
  • 400 Ungültige Anforderung, 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 Ungültige Anforderung, InvalidHeaderValue, "Der Wert für einen der HTTP-Header ist nicht im richtigen Format."
  • 400 Ungültige Anforderung, InvalidHttpVerb, "Das angegebene HTTP-Verb ist ungültig - es wird vom Server nicht erkannt."
  • 400 Ungültige Anforderung, InvalidInput, "Eine der Anforderungseingaben ist ungültig."
  • 400 Ungültige Anforderung, InvalidPropertyName, "Ein Eigenschaftsname darf nicht leer sein."
  • 400 Ungültige Anforderung, InvalidPropertyName, "Der Eigenschaftenname enthält ungültige Zeichen."
  • 400 Ungültige Anforderung, InvalidQueryParameterValue, "Wert für einen der abfrageparameter, die im Anforderungs-URI angegeben sind, ist ungültig."
  • 400 Ungültige Anforderung, InvalidResourceName, "Der angegebene Ressourcenname enthält ungültige Zeichen.".
  • 400 Ungültige Anforderung, InvalidSourceUri, "Der Quell-URI ist ungültig.".
  • 400 Ungültige Anforderung, InvalidUri, "Der Anforderungs-URI ist ungültig.".
  • 400 Ungültige Anforderung, MissingRequiredHeader, "Ein HTTP-Header, der für diese Anforderung erforderlich ist, ist nicht angegeben."
  • 400 Ungültige Anforderung, MissingRequiredQueryParameter, "Ein Abfrageparameter, der für diese Anforderung erforderlich ist, wird nicht angegeben."
  • 400 Ungültige Anforderung, MultipleConditionHeadersNotSupported, "Mehrere Bedingungsheader werden nicht unterstützt."
  • 400 Ungültige Anforderung, OutOfRangeInput, "Eine der Anforderungseingaben ist außerhalb des Zulässigen."
  • 400 Ungültige Anforderung, OutOfRangeQueryParameterValue: "Einer der im Anforderungs-URI angegebenen Abfrageparameter liegt außerhalb des zulässigen Bereichs."
  • 400 Ungültige Anforderung, nicht unterstütztHeader: "Einer der in der Anforderung angegebenen Header wird nicht unterstützt."
  • 400 Ungültige Anforderung, nicht unterstütztQueryParameter: "Einer der abfrageparameter, die im Anforderungs-URI angegeben sind, wird nicht unterstützt."
  • 400 Ungültige Anforderung, nicht unterstütztRestVersion, "Die angegebene Restversion wird nicht unterstützt."
  • 403 Verboten, AccountIsDisabled, "Das angegebene Konto ist deaktiviert.".
  • 403 Verboten, AuthorizationFailure: "Diese Anforderung ist nicht berechtigt, diesen Vorgang auszuführen."
  • 403 Forbidden, InsufficientAccountPermissions, "Auf das Konto zugegriffen wird, verfügt nicht über ausreichende Berechtigungen, um diesen Vorgang auszuführen."
  • 404 Nicht gefunden, FilesystemNotFound, "Das angegebene Dateisystem ist nicht vorhanden.".
  • 404 Nicht gefunden, PathNotFound, "Der angegebene Pfad ist nicht vorhanden.".
  • 404 Nicht gefunden, RenameDestinationParentPathNotFound, "Das übergeordnete Verzeichnis des Zielpfads ist nicht vorhanden.".
  • 404 Nicht gefunden, ResourceNotFound, "Die angegebene Ressource ist nicht vorhanden.".
  • 404 Nicht gefunden, SourcePathNotFound, "Der Quellpfad für einen Umbenennungsvorgang ist nicht vorhanden.".
  • 405-Methode nicht zulässig, nicht unterstütztHttpVerb, "Die Ressource unterstützt das angegebene HTTP-Verb nicht."
  • 409 Conflict, DestinationPathIsBeingDeleted, "The specified destination path is marked to be deleted."
  • 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, "The specified path, or an element of the path, exists and its resource type is invalid for this operation." * 409 Conflict, InvalidFlushOperation, "The resource was created or modified by the Blob Service API and cannot be written to the Data Lake Storage Service API."
  • 409 Conflict, InvalidRenameSourcePath, "Das Quellverzeichnis kann nicht mit dem Zielverzeichnis identisch sein, oder das Ziel kann ein Unterverzeichnis des Quellverzeichnisses sein."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Der Quell- und Zielressourcentyp muss identisch sein."
  • 409 Conflict, LeaseAlreadyPresent, "Es ist bereits eine Lease vorhanden."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "The lease ID specified did not match the lease ID for the resource with the specified lease operation."
  • 409 Conflict, LeaseIsAlreadyBroken, "Die Lease wurde bereits beschädigt und kann nicht erneut beschädigt werden."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "The lease ID matched, but the lease is currently in break state and cannot be acquired until it is broken."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "The lease ID matched, but the lease is currently in break state and cannot be changed."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "Die Lease-ID ist übereinstimmend, aber die Lease wurde explizit abgebrochen und kann nicht erneuert werden."
  • 409 Conflict, LeaseNameMismatch, "Der angegebene Leasename entspricht nicht dem vorhandenen Leasenamen.".
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "The lease ID is not present with the specified lease operation."
  • 409 Conflict, PathAlreadyExists, "Der angegebene Pfad ist bereits vorhanden."
  • 409 Conflict, PathConflict, "The specified path, or an element of the path, exists and its resource type is invalid for this operation."
  • 409 Conflict, SourcePathIsBeingDeleted, "The specified source path is marked to be deleted."
  • 409 Conflict, ResourceTypeMismatch, "Der in der Anforderung angegebene Ressourcentyp stimmt nicht mit dem Typ der Ressource überein."
  • 412 Vorbedingung fehlgeschlagen, ConditionNotMet, "Die mit HTTP-bedingten Header(n) angegebene Bedingung ist nicht erfüllt."
  • 412 Vorbedingung fehlgeschlagen, LeaseIdMismatch, "Die angegebene Lease-ID entspricht nicht der Lease-ID für die Ressource."
  • 412 Vorbedingung fehlgeschlagen, LeaseIdMissing: "Es gibt derzeit eine Lease für die Ressource, und in der Anforderung wurde keine Lease-ID angegeben."
  • 412 Vorbedingung fehlgeschlagen, LeaseNotPresent, "Es gibt derzeit keine Lease für die Ressource.".
  • 412 Vorbedingung fehlgeschlagen, LeaseLost, "Eine Lease-ID wurde angegeben, aber die Lease für die Ressource ist abgelaufen."
  • 412 Vorbedingung fehlgeschlagen, SourceConditionNotMet, "Die mit HTTP-bedingten Header(n) angegebene Quellbedingung ist nicht erfüllt."
  • 413 Request Entity Too Large, RequestBodyTooLarge, "Der Anforderungstext ist zu groß und überschreitet den maximal zulässigen Grenzwert."
  • 416 Angeforderter Bereich nicht satisfiable, InvalidRange, "Der angegebene Bereich ist für die aktuelle Größe der Ressource ungültig.".
  • 500 Interner Serverfehler, 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, "Der Ausgang liegt über dem Kontolimit.".
  • 503 Dienst nicht verfügbar, ServerBusy, "Ingress liegt über dem Kontolimit.".
  • 503 Dienst nicht verfügbar, ServerBusy, "Vorgänge pro Sekunde liegen über dem Kontolimit.".
  • 503 Dienst nicht verfügbar, ServerBusy: "Der Server kann derzeit keine Anforderungen empfangen. Versuchen Sie es bitte erneut."

Header

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

Definitionen

Name Beschreibung
DataLakeStorageError
Error

Das Dienstfehlerantwortobjekt.
PathRenameMode

Wahlfrei. 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 ist "posix".
PathResourceType

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

Wahlfrei. 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 ist "posix".

Name Typ Beschreibung
legacy

string

posix

string

PathResourceType

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

Name Typ Beschreibung
directory

string

file

string