Freigeben über


Path - Get Properties

Eigenschaften abrufen | Status abrufen | Zugriffssteuerungsliste abrufen | Zugriff überprüfen
Mit "Properties" werden alle system- und benutzerdefinierten Eigenschaften für einen Pfad zurückgegeben. Der Status gibt alle vom System definierten Eigenschaften für einen Pfad zurück. Abrufen der Zugriffssteuerungsliste gibt die Zugriffssteuerungsliste für einen Pfad zurück. Dieser Vorgang unterstützt bedingte HTTP-Anforderungen. Weitere Informationen finden Sie unter Angeben von bedingten Headern für Blob-Dienstvorgänge.

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&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.

path
path True

string

Die Datei oder der Verzeichnispfad.

action
query

PathGetPropertiesAction

Wahlfrei. Wenn der Wert "getStatus" ist, werden nur die vom System definierten Eigenschaften für den Pfad zurückgegeben. Wenn der Wert "getAccessControl" lautet, wird die Zugriffssteuerungsliste in den Antwortheadern zurückgegeben (hierarchischer Namespace muss für das Konto aktiviert sein), andernfalls werden die Eigenschaften zurückgegeben.

fsAction
query

string

Nur für die Zugriffsüberprüfungsaktion erforderlich. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Dateisystemvorgang lese-/schreib-/execute in Zeichenfolgenform, übereinstimmende regex-Muster '[rwx-]{3}'

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.

upn
query

boolean

Wahlfrei. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Wenn "true", werden die in den Headern "x-ms-owner", "x-ms-group" und "x-ms-acl" zurückgegebenen Benutzeridentitätswerte von Azure Active Directory-Objekt-IDs in Benutzerprinzipalnamen transformiert. Wenn "false", werden die Werte als Azure Active Directory-Objekt-IDs zurückgegeben. Der Standardwert ist "false". Beachten Sie, dass Gruppen- und Anwendungsobjekt-IDs nicht übersetzt werden, da sie keine eindeutigen Anzeigenamen enthalten.

Anforderungsheader

Name Erforderlich Typ Beschreibung
x-ms-lease-id

string

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

Wahlfrei. Wenn dieser Header angegeben ist, wird der Vorgang nur ausgeführt, wenn beide der folgenden Bedingungen erfüllt sind: i) die Lease des Pfads ist derzeit aktiv und ii) die in der Anforderung angegebene Lease-ID mit der des Pfads übereinstimmt.

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

Gibt alle Eigenschaften für die Datei oder das Verzeichnis zurück.

Header

  • 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
  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-resource-type: string
  • x-ms-properties: string
  • x-ms-owner: string
  • x-ms-group: string
  • x-ms-permissions: string
  • x-ms-acl: string
  • x-ms-lease-duration: string
  • x-ms-lease-state: string
  • x-ms-lease-status: string
  • x-ms-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-context: string
  • x-ms-encryption-scope: string
  • x-ms-creation-time: string
  • x-ms-expiry-time: string
  • x-ms-client-transaction-id: 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.

PathGetPropertiesAction

Wahlfrei. Wenn der Wert "getStatus" ist, werden nur die vom System definierten Eigenschaften für den Pfad zurückgegeben. Wenn der Wert "getAccessControl" lautet, wird die Zugriffssteuerungsliste in den Antwortheadern zurückgegeben (hierarchischer Namespace muss für das Konto aktiviert sein), andernfalls werden die Eigenschaften zurückgegeben.

DataLakeStorageError

Name Typ Beschreibung
error

Error

Das Dienstfehlerantwortobjekt.

Error

Das Dienstfehlerantwortobjekt.

Name Typ Beschreibung
code

string

Der Dienstfehlercode.

message

string

Die Dienstfehlermeldung.

PathGetPropertiesAction

Wahlfrei. Wenn der Wert "getStatus" ist, werden nur die vom System definierten Eigenschaften für den Pfad zurückgegeben. Wenn der Wert "getAccessControl" lautet, wird die Zugriffssteuerungsliste in den Antwortheadern zurückgegeben (hierarchischer Namespace muss für das Konto aktiviert sein), andernfalls werden die Eigenschaften zurückgegeben.

Wert Beschreibung
checkAccess
getAccessControl
getStatus