Filesystem - Set Properties

Dienst:

Storage Services

API-Version:

2023-08-03

Festlegen von Dateisystemeigenschaften
Legen Sie Eigenschaften für das Dateisystem fest. 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}?resource=filesystem

Mit optionalen Parametern:

PATCH https://{accountName}.{dnsSuffix}/{filesystem}?resource=filesystem&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. Der Wert muss mit einem Buchstaben oder einer Zahl beginnen und enden und darf nur Buchstaben, Zahlen und das Bindestrichzeichen (-) enthalten. Aufeinander folgende Bindestriche sind nicht zulässig. Alle Buchstaben müssen Kleinbuchstaben sein. Der Wert muss zwischen 3 und 63 Zeichen lang sein. RegEx-Muster: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
resource	query	True	FilesystemResourceType	Der Wert muss für alle Dateisystemvorgänge "dateisystem" 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

Name	Erforderlich	Typ	Beschreibung
x-ms-properties		string	Optional. Benutzerdefinierte Eigenschaften, die im Dateisystem gespeichert werden sollen, im Format einer durch Trennzeichen getrennten Liste von Namens- und Wertpaaren "n1=v1, n2=v2, ...", wobei jeder Wert eine base64-codierte Zeichenfolge ist. Beachten Sie, dass die Zeichenfolge nur ASCII-Zeichen im ZEICHENSATZ ISO-8859-1 enthalten darf. Wenn das Dateisystem 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 Werte für alle Eigenschaften ein.
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-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 (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
200 OK		OK, Header Date: string ETag: string Last-Modified: string x-ms-request-id: string x-ms-version: 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.)“ Header x-ms-request-id: string x-ms-version: string

Definitionen

Name	Beschreibung
DataLakeStorageError
Error	Das Dienstfehlerantwortobjekt.
FilesystemResourceType	Der Wert muss für alle Dateisystemvorgänge "dateisystem" sein.

DataLakeStorageError

Name	Typ	Beschreibung
error	Error	Das Dienstfehlerantwortobjekt.

Error

Das Dienstfehlerantwortobjekt.

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

FilesystemResourceType

Der Wert muss für alle Dateisystemvorgänge "dateisystem" sein.

Name	Typ	Beschreibung
filesystem	string