Freigeben über

Filesystem - Set Properties

  • Referenz
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 Angeben von bedingten Headern für Blob-Dienstvorgänge.

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

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

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 Striche sind nicht zulässig. Alle Buchstaben müssen Kleinbuchstaben sein. Der Wert muss zwischen 3 und 63 Zeichen enthalten.
resource
 query True

FilesystemResourceType

Der Wert muss für alle Dateisystemvorgänge "Filesystem" sein.
timeout
 query

integer (int32)

minimum: 1

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

Name Erforderlich Typ Beschreibung
x-ms-properties

string

Wahlfrei. Benutzerdefinierte Eigenschaften, die mit dem Dateisystem 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. Wenn das Dateisystem vorhanden ist, werden alle eigenschaften, die nicht in der Liste enthalten sind, entfernt. Alle Eigenschaften werden entfernt, wenn die Kopfzeile weggelassen wird. Um neue und vorhandene Eigenschaften zusammenzuführen, rufen Sie zuerst alle vorhandenen Eigenschaften und das aktuelle E-Tag ab, und erstellen Sie dann eine bedingte Anforderung mit dem E-Tag und enthalten Werte für alle Eigenschaften.
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-client-request-id

string

pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

Eine in den Analyseprotokollen aufgezeichnete UUID zur Problembehandlung und Korrelation.
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
200 OK

Okay

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

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

DataLakeStorageError

Objekt
Name Typ Beschreibung
error

Error

Das Dienstfehlerantwortobjekt.

Error

Objekt

Das Dienstfehlerantwortobjekt.

Name Typ Beschreibung
code

string

Der Dienstfehlercode.
message

string

Die Dienstfehlermeldung.

FilesystemResourceType

Enumeration

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

Wert Beschreibung
filesystem