Path - Update

Service:

Storage Services

API Version:

2023-08-03

Daten anfügen | Daten leeren | Eigenschaften festlegen | Festlegen Access Control
Lädt Daten hoch, die an eine Datei angefügt werden sollen, leert (schreibt), zuvor hochgeladene Daten in eine Datei, legt Eigenschaften für eine Datei oder ein Verzeichnis fest oder legt die Zugriffssteuerung für eine Datei oder ein Verzeichnis fest. Daten können nur an eine Datei angefügt werden. Gleichzeitige Schreibvorgänge in dieselbe Datei mit mehreren Clients werden nicht unterstützt. 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).

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}

With optional parameters:

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&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.
action	query	True	PathUpdateAction	Die Aktion muss "anfügen", um Daten hochzuladen, die an eine Datei angefügt werden sollen, "flush", um zuvor hochgeladene Daten in eine Datei zu löschen, "setProperties", um die Eigenschaften einer Datei oder eines Verzeichnisses festzulegen, oder "setAccessControl", um den Besitzer, die Gruppe, die Berechtigungen oder die Zugriffssteuerungsliste für eine Datei oder ein Verzeichnis festzulegen, oder "setAccessControlRecursive", um die Zugriffssteuerungsliste für ein Verzeichnis rekursiv festzulegen. Beachten Sie, dass der hierarchische Namespace für das Konto aktiviert sein muss, um die Zugriffssteuerung verwenden zu können. Beachten Sie auch, dass die Access Control List (ACL) Berechtigungen für den Besitzer, die besitzende Gruppe und andere enthält, sodass sich die x-ms-permissions- und x-ms-acl-Anforderungsheader gegenseitig ausschließen.
close	query		boolean	Azure Storage-Ereignisse ermöglichen Es Anwendungen, Benachrichtigungen zu erhalten, wenn Sich Dateien ändern. Wenn Azure Storage-Ereignisse aktiviert sind, wird ein Dateiänderungsereignis ausgelöst. Dieses Ereignis weist eine -Eigenschaft auf, die angibt, ob dies die letzte Änderung ist, um den Unterschied zwischen einem zwischengeschalteten Leeren in einen Dateidatenstrom und dem endgültigen Schließen eines Dateidatenstroms zu unterscheiden. Der Close-Abfrageparameter ist nur gültig, wenn die Aktion "leeren" ist und Änderungsbenachrichtigungen aktiviert sind. Wenn der Wert von close "true" ist und der Leerungsvorgang erfolgreich abgeschlossen wird, löst der Dienst eine Dateiänderungsbenachrichtigung mit einer -Eigenschaft aus, die angibt, dass es sich um das endgültige Update handelt (der Dateidatenstrom wurde geschlossen). Bei "false" wird eine Änderungsbenachrichtigung ausgelöst, die angibt, dass sich die Datei geändert hat. Die Standardeinstellung ist „false“. Dieser Abfrageparameter wird vom Hadoop ABFS-Treiber auf true festgelegt, um anzugeben, dass der Dateidatenstrom geschlossen wurde."
continuation	query		string	Optional und nur für den Vorgang "setAccessControlRecursive" gültig. Die Anzahl der Pfade, die mit jedem Aufruf verarbeitet werden, ist begrenzt. Wenn die Anzahl der zu verarbeitenden Pfade diesen Grenzwert überschreitet, wird im Antwortheader x-ms-continuation ein Fortsetzungstoken zurückgegeben. Wenn ein Fortsetzungstoken in der Antwort zurückgegeben wird, muss es prozent codiert sein und in einem nachfolgenden Aufruf des Vorgangs setAccessControlRecursive angegeben werden.
flush	query		boolean	Nur für Anfügeaufrufe gültig. Mit diesem Parameter kann der Aufrufer während eines Anfügeaufrufs geleert werden. Der Standardwert ist "false", wenn "true" die Daten mit dem Anfügeaufruf geleert werden. Beachten Sie, dass bei Verwendung von flush=true die folgenden Header nicht unterstützt werden: "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". Verwenden Sie action=flush, um diese Header während des Leerens festzulegen.
forceFlag	query		boolean	Optional und nur für den Vorgang "setAccessControlRecursive" gültig. Wenn dies "false" ist, wird der Vorgang schnell beendet, wenn Benutzerfehler auftreten (4XX). Bei "true" ignoriert die API Benutzerfehler und fährt mit dem Vorgang auf anderen Untergeordnetentitäten des Verzeichnisses fort. Eine ausführliche status von Benutzerfehlern wird in der Antwort für beide Szenarien zurückgegeben. Fortsetzungstoken wird nur zurückgegeben, wenn forceFlag bei Benutzerfehlern "true" ist. Der Standardwert für forceFlag ist false.
maxRecords	query		integer int32	Optional und nur für den Vorgang "setAccessControlRecursive" gültig. Es gibt die maximale Anzahl von Dateien oder Verzeichnissen an, auf die die ACL-Änderung angewendet wird. Wenn nicht angegeben oder größer als 2.000, verarbeitet die Anforderung bis zu 2.000 Elemente.
mode	query		string	Optional. Gültig und erforderlich für den Vorgang "setAccessControlRecursive". Modus "set" legt POSIX-Zugriffssteuerungsrechte für Dateien und Verzeichnisse fest, "ändern" ändert mindestens eine POSIX-Zugriffssteuerung, die für Dateien und Verzeichnisse bereits vorhanden sind, "entfernen" entfernt mindestens eine POSIX-Zugriffssteuerung, die zuvor für Dateien und Verzeichnisse vorhanden waren.
position	query		integer int64	Dieser Parameter ermöglicht es dem Aufrufer, Daten parallel hochzuladen und die Reihenfolge zu steuern, in der sie an die Datei angefügt werden. Dies ist erforderlich, wenn Daten an die Datei angefügt werden, und wenn zuvor hochgeladene Daten in die Datei geleert werden. Der Wert muss die Position sein, an der die Daten angefügt werden sollen. Hochgeladene Daten werden nicht sofort geleert oder in die Datei geschrieben. Zum Leeren müssen die zuvor hochgeladenen Daten zusammenhängend sein, der Positionsparameter muss angegeben und der Länge der Datei entsprechen, nachdem alle Daten geschrieben wurden, und es darf kein Anforderungsentitätstext in der Anforderung enthalten sein.
retainUncommittedData	query		boolean	Nur für Leerungsvorgänge gültig. Bei "true" werden daten ohne Commit nach Abschluss des Leerungsvorgangs beibehalten. Andernfalls werden die nicht committeten Daten nach dem Leerungsvorgang gelöscht. Die Standardeinstellung ist „false“. Daten an Offsets, die kleiner als die angegebene Position sind, werden bei erfolgreichem Leeren in die Datei geschrieben. Dieser optionale Parameter ermöglicht jedoch, dass Daten nach der Leerungsposition für einen zukünftigen Leerungsvorgang beibehalten werden.
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", "text/plain"

Name	Erforderlich	Typ	Beschreibung
Content-Length		integer int64	Erforderlich für "Daten anfügen" und "Daten leeren". Muss für "Daten leeren" 0 sein. Muss die Länge des Anforderungsinhalts in Bytes für "Daten anfügen" sein.
Content-MD5		string	Optional. Ein MD5-Hash des Anforderungsinhalts. Dieser Header ist für die Vorgänge "Append" und "Flush" gültig. Mithilfe des Hash wird die Integrität des Anforderungsinhalts während der Übertragung überprüft. Bei Angabe dieses Headers vergleicht der Speicherdienst den Hash des eingegangenen Inhalts mit diesem Headerwert. Wenn die beiden Hashs nicht übereinstimmen, schlägt der Vorgang mit Fehlercode 400 (Ungültige Anforderung) fehl. Beachten Sie, dass dieser MD5-Hash nicht in der Datei gespeichert wird. Dieser Header ist dem Anforderungsinhalt und nicht dem gespeicherten Inhalt der Datei selbst zugeordnet.
x-ms-lease-id		string	Die Lease-ID muss angegeben werden, wenn eine aktive Lease vorhanden ist. Ungültig für "setAccessControlRecursive"-Vorgänge. Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-cache-control		string	Optional und nur gültig für Leerungs- und Festlegen von Eigenschaftenvorgängen. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Cache-Control" für "Datei lesen"-Vorgänge ein.
x-ms-content-type		string	Optional und nur gültig für Leerungs- und Festlegen von Eigenschaftenvorgängen. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Type" für "Datei lesen"-Vorgänge ein.
x-ms-content-disposition		string	Optional und nur gültig für Leerungs- und Festlegen von Eigenschaftenvorgängen. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Disposition" für "Datei lesen"-Vorgänge ein.
x-ms-content-encoding		string	Optional und nur gültig für Leerungs- und Festlegen von Eigenschaftenvorgängen. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Encoding" für "Datei lesen"-Vorgänge ein.
x-ms-content-language		string	Optional und nur gültig für Leerungs- und Festlegen von Eigenschaftenvorgängen. Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Language" für "Datei lesen"-Vorgänge ein.
x-ms-content-md5		string	Optional und nur gültig für Vorgänge "Eigenschaften leeren und festlegen". Der Dienst speichert diesen Wert und schließt ihn in den Antwortheader "Content-Md5" für Die Vorgänge "Eigenschaften lesen und abrufen" ein. Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von "Eigenschaften lesen und abrufen" geben diese Eigenschaft nur zurück, wenn sie erneut explizit für diese Datei festgelegt wird.
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 ISO-8859-1-Zeichensatz enthalten darf. Gilt nur für den SetProperties-Vorgang. Wenn die Datei oder das Verzeichnis vorhanden ist, werden alle Eigenschaften entfernt, die nicht in der Liste enthalten sind. Alle Eigenschaften werden entfernt, wenn der Header ausgelassen wird. Um neue und vorhandene Eigenschaften zusammenzuführen, rufen Sie zunächst alle vorhandenen Eigenschaften und das aktuelle E-Tag ab, stellen Sie dann eine bedingte Anforderung mit dem E-Tag und schließen Sie Werte für alle Eigenschaften ein.
x-ms-owner		string	Optional und nur für den SetAccessControl-Vorgang gültig. Legt den Besitzer der Datei oder des Verzeichnisses fest.
x-ms-group		string	Optional und nur für den SetAccessControl-Vorgang gültig. Legt die besitzende Gruppe der Datei oder des Verzeichnisses fest.
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 Dateibesitzergruppe und andere fest. Jeder Klasse kann die Berechtigung Lesen (4), Schreiben (2) oder Ausführen (1) erteilt 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 Kategorie "Sonstige" festgelegt bzw. nicht festgelegt ist (z. B. rwxrw-rw- mit sticky 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 das klebrige Bit nicht festgelegt ist. In der 4-stelligen oktalen Notation wird seine durch die 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-acl		string	Optional und nur gültig für die Vorgänge setAccessControl und setAccessControlRecursive. Erforderlich für den SetAccessControlRecursive-Vorgang. Legt POSIX-Zugriffssteuerungsrechte für Dateien und Verzeichnisse fest. Der Wert ist eine durch Trennzeichen getrennte Liste von Zugriffssteuerungseinträgen, die die vorhandene Zugriffssteuerungsliste (Access Control List, ACL) im Fall von setAccessControl und den Set-Modus von setAccessControlRecursive vollständig ersetzt. Der Modus "modify" von setAccessControlRecursive aktualisiert die bereits vorhandene ACLS. 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 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 Dem Besitzer oder einem benannten Benutzer Rechte, "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, die nicht in einem der anderen Einträge gefunden wurden, Rechte. 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 besitzende Gruppe weggelassen. Das Berechtigungsfeld ist eine 3-stellige Sequenz, bei der das erste Zeichen "r" ist, um Lesezugriff zu gewähren, das zweite Zeichen "w", um Schreibzugriff zu gewähren, und das dritte Zeichen ist "x", um die Berechtigung zum Ausführen zu erteilen. Wenn der Zugriff nicht gewährt wird, wird das Zeichen "-" verwendet, um anzugeben, dass die Berechtigung verweigert wird. Beispielsweise gewährt die folgende ACL 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-permissions. Der "remove"-Modus von setAccessControlRecursive entfernt die bereits vorhandenen ACLs und sollte keine Berechtigungen in der angegebenen Zugriffssteuerungsliste enthalten: "user:john.doe@contoso:, mask:". Der "set"-Modus von setAccessControlRecursive legt die ACLs fest, die die bereits vorhandenen ACLs des angegebenen Bereichs ersetzen, und muss alle drei enthalten – besitzernde Benutzer, Besitzende Gruppe und andere Informationen, wenn der Zugriffsbereich festgelegt wird oder wenn einer der besitzenden Benutzer, die besitzende Gruppe oder eine andere im Standardbereich festgelegt wird. Die Modi "set" und "modify" von setAccessControlRecursive müssen Berechtigungen als Teil der Zugriffssteuerungsliste enthalten.
If-Match		string	Optional für Daten leeren, festlegen Access Control und Festlegen von Eigenschaften, aber ungültig für Anfügen von Daten und Festlegen Access Control Rekursiv. 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 für Daten leeren, festlegen Access Control und Festlegen von Eigenschaften, aber ungültig für Anfügen von Daten und Festlegen Access Control Rekursiv. Ein ETag-Wert oder der spezielle Wildcardwert ("*") 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 für Daten leeren und Eigenschaften festlegen, aber ungültig für Anfügen von Daten und Festlegen Access Control Rekursiv. 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 für Daten leeren und Eigenschaften festlegen, aber ungültig für Anfügen von Daten und Festlegen Access Control Rekursiv. 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-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-lease-action	True	PathLeaseAction	Ab Version 2020-08-04 in Anfüge- und Leerlaufvorgängen. Append unterstützt die Aktionen "acquire", "auto-renew" und "acquire-release". Wenn "erworben" wird, wird die Lease erworben. Bei automatischer Verlängerung wird die Lease erneuert. Wenn "acquire-release" abgerufen wird, werden & den Vorgang abgeschlossen, & die Lease nach Abschluss des Vorgangs freigeben. Die Aktion "Freigeben" wird nur im Leervorgang unterstützt. Wenn "true" ist, gibt die Lease für die Datei unter Verwendung der Lease-ID-Informationen aus dem x-ms-lease-id-Header frei.
x-ms-lease-duration		integer int32	Die Leasedauer ist erforderlich, um eine Lease zu erwerben, und gibt die Dauer der Lease in Sekunden an. Die Leasedauer muss zwischen 15 und 60 Sekunden oder -1 für unbegrenztes Lease betragen.
x-ms-proposed-lease-id		string	Erforderlich, wenn "x-ms-lease-action" "acquire" oder "change" ist. Wenn der Vorgang erfolgreich ist, 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-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.

Anforderungstext

Media Types: "application/octet-stream", "text/plain"

Name	Typ	Beschreibung
requestBody	object	Nur für Anfügevorgänge gültig. Die Daten, die hochgeladen und an die Datei angefügt werden sollen.

Antworten

Name	Typ	Beschreibung
200 OK	SetAccessControlRecursiveResponse	Die Daten wurden in die Datei geleert (geschrieben), oder die Eigenschaften wurden erfolgreich festgelegt. Der Antworttext ist optional und nur für "SetAccessControlRecursive" gültig. Headers Date: string ETag: string Last-Modified: string Accept-Ranges: string Cache-Control: string Content-Disposition: string Content-Encoding: string Content-Language: string Content-Length: integer Content-Range: string Content-Type: string Content-MD5: string x-ms-properties: string x-ms-continuation: string x-ms-request-id: string x-ms-version: string x-ms-request-server-encrypted: true/false: boolean x-ms-encryption-key-sha256: string x-ms-encryption-scope: string x-ms-lease-renewed: boolean
202 Accepted		Die hochgeladenen Daten wurden akzeptiert. Headers Content-MD5: string Date: string x-ms-request-id: string x-ms-version: string x-ms-lease-renewed: boolean
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
AclFailedEntryList
DataLakeStorageError
Error	Das Dienstfehlerantwortobjekt.
PathLeaseAction	Ab Version 2020-08-04 in Anfüge- und Leerlaufvorgängen. Append unterstützt die Aktionen "acquire", "auto-renew" und "acquire-release". Wenn sie "erwerben", wird die Lease erworben. Bei "automatischer Verlängerung" wird die Lease verlängert. Bei "acquire-release" wird & der Vorgang abgeschlossen, & die Lease freigegeben wird, sobald der Vorgang abgeschlossen ist. Die Aktion "Release" wird nur im Leerungsvorgang unterstützt. Bei "true" wird die Lease für die Datei mithilfe der Lease-ID-Informationen aus dem x-ms-lease-id-Header freigegeben.
PathUpdateAction	Die Aktion muss "anfügen" sein, um Daten hochzuladen, die an eine Datei angefügt werden sollen, "leeren", um zuvor hochgeladene Daten in eine Datei zu leeren, "setProperties", um die Eigenschaften einer Datei oder eines Verzeichnisses festzulegen, oder "setAccessControl", um den Besitzer, die Gruppe, die Berechtigungen oder die Zugriffssteuerungsliste für eine Datei oder ein Verzeichnis festzulegen, oder "setAccessControlRecursive", um die Zugriffssteuerungsliste für ein Verzeichnis rekursiv festzulegen. Beachten Sie, dass der hierarchische Namespace für das Konto aktiviert sein muss, um die Zugriffssteuerung verwenden zu können. Beachten Sie auch, dass die Access Control List (ACL) Berechtigungen für den Besitzer, die besitzende Gruppe und andere enthält, sodass sich die Anforderungsheader x-ms-permissions und x-ms-acl gegenseitig ausschließen.
SetAccessControlRecursiveResponse

AclFailedEntryList

Name	Typ	Beschreibung
errorMessage	string
name	string
type	string

DataLakeStorageError

Name	Typ	Beschreibung
error	Error	Das Dienstfehlerantwortobjekt.

Error

Das Dienstfehlerantwortobjekt.

Name	Typ	Beschreibung
code	string	Der Dienstfehlercode.
message	string	Die Dienstfehlermeldung.

PathLeaseAction

Ab Version 2020-08-04 in Anfüge- und Leerlaufvorgängen. Append unterstützt die Aktionen "acquire", "auto-renew" und "acquire-release". Wenn sie "erwerben", wird die Lease erworben. Bei "automatischer Verlängerung" wird die Lease verlängert. Bei "acquire-release" wird & der Vorgang abgeschlossen, & die Lease freigegeben wird, sobald der Vorgang abgeschlossen ist. Die Aktion "Release" wird nur im Leerungsvorgang unterstützt. Bei "true" wird die Lease für die Datei mithilfe der Lease-ID-Informationen aus dem x-ms-lease-id-Header freigegeben.

Name	Typ	Beschreibung
acquire	string
acquire-release	string
auto-renew	string
release	string

PathUpdateAction

Die Aktion muss "anfügen" sein, um Daten hochzuladen, die an eine Datei angefügt werden sollen, "leeren", um zuvor hochgeladene Daten in eine Datei zu leeren, "setProperties", um die Eigenschaften einer Datei oder eines Verzeichnisses festzulegen, oder "setAccessControl", um den Besitzer, die Gruppe, die Berechtigungen oder die Zugriffssteuerungsliste für eine Datei oder ein Verzeichnis festzulegen, oder "setAccessControlRecursive", um die Zugriffssteuerungsliste für ein Verzeichnis rekursiv festzulegen. Beachten Sie, dass der hierarchische Namespace für das Konto aktiviert sein muss, um die Zugriffssteuerung verwenden zu können. Beachten Sie auch, dass die Access Control List (ACL) Berechtigungen für den Besitzer, die besitzende Gruppe und andere enthält, sodass sich die Anforderungsheader x-ms-permissions und x-ms-acl gegenseitig ausschließen.

Name	Typ	Beschreibung
append	string
flush	string
setAccessControl	string
setAccessControlRecursive	string
setProperties	string

SetAccessControlRecursiveResponse

Name	Typ	Beschreibung
directoriesSuccessful	integer
failedEntries	AclFailedEntryList[]
failureCount	integer
filesSuccessful	integer