Dateimetadaten abrufen

Artikel
03/29/2023

Der Get File Metadata-Vorgang gibt alle benutzerdefinierten Metadaten für die angegebene Datei zurück.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll	Verfügbar
SMB
NFS

Anforderung

Die Get File Metadata-Anforderung wird folgendermaßen erstellt. Es wird empfohlen, HTTPS zu verwenden.

Methode	Anforderungs-URI	HTTP-Version
`GET`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=metadata`	HTTP/1.1
`GET`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=metadata&sharesnapshot=<DateTime>`	HTTP/1.1

Ersetzen Sie die im Anforderungs-URI angezeigten Pfadkomponenten wie folgt durch Ihre eigenen Angaben:

Pfadkomponente	Beschreibung
`myaccount`	Der Name Ihres Speicherkontos.
`myshare`	Der Name der Dateifreigabe.
`mydirectorypath`	Optional. Der Pfad zum Verzeichnis.
`myfile`	Der Name der Datei.

Informationen zu Einschränkungen bei der Pfadbenennung finden Sie unter Namens- und Verweisfreigaben, Verzeichnisse, Dateien und Metadaten.

URI-Parameter

Die folgenden zusätzlichen Parameter können im Anforderungs-URI angegeben werden:

Parameter	BESCHREIBUNG
`sharesnapshot`	Optional. Version 2017-04-17 und höher. Der `sharesnapshot` Parameter ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die Freigabe Momentaufnahme angibt, die nach den Dateimetadaten abzufragen ist.
`timeout`	Optional. Der `timeout`-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files Vorgänge.

Anforderungsheader

Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle beschrieben:

Anforderungsheader	BESCHREIBUNG
`Authorization`	Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
`Date` oder `x-ms-date`	Erforderlich. Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
`x-ms-version`	Erforderlich für alle autorisierten Anforderungen. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
`x-ms-lease-id:<ID>`	Optional. Version 2019-02-02 und höher. Wenn der Header angegeben ist, wird der Vorgang nur ausgeführt, wenn die Lease der Datei derzeit aktiv ist und die in der Anforderung angegebene Lease-ID mit der Lease-ID der Datei übereinstimmt. Andernfalls schlägt der Vorgang mit status Code 412 (Vorbedingung fehlgeschlagen) fehl.
`x-ms-client-request-id`	Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen Azure Files.
`x-ms-file-request-intent`	Erforderlich, wenn `Authorization` der Header ein OAuth-Token angibt. Zulässiger Wert ist `backup`. Dieser Header gibt an, dass oder `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/actionMicrosoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` gewährt werden soll, wenn sie in der RBAC-Richtlinie enthalten sind, die der Identität zugewiesen ist, die mithilfe des `Authorization` Headers autorisiert ist. Verfügbar für Version 2022-11-02 und höher.
`x-ms-allow-trailing-dot: { <Boolean> }`	Optional. Version 2022-11-02 und höher. Der boolesche Wert gibt an, ob ein nachgestellter Punkt in der Anforderungs-URL gekürzt werden soll. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten.

Anforderungstext

Keine.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 202 (Akzeptiert) zurück.

Weitere Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader	BESCHREIBUNG
`Last-Modified`	Gibt das Datum und die Uhrzeit der letzten Änderung der Datei zurück. Das Datumsformat entspricht RFC 1123. Weitere Informationen finden Sie unter Darstellen von Datums-/Uhrzeitwerten in Headern. Jeder Vorgang, der die Datei oder deren Eigenschaften ändert, aktualisiert den Zeitpunkt der letzten Änderung.
`x-ms-meta-name:value`	Eine Reihe von Name/Wert-Paaren, die Metadaten für die Datei enthalten.
`x-ms-type: <File>`	Gibt `File` zurück und ist für eine künftige Verwendung reserviert.
`x-ms-request-id`	Identifiziert die durchgeführte Anforderung eindeutig und kann zur Problembehandlung für die Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
`ETag`	Das ETag enthält einen Wert, den Sie verwenden können, um Vorgänge bedingt auszuführen. Der Wert wird in Anführungszeichen eingeschlossen.
`x-ms-version`	Die Dienstversion, die zum Ausführen der Anforderung verwendet wurde.
`Date` oder `x-ms-date`	Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der den Zeitpunkt angibt, zu dem die Antwort initiiert wurde.
`x-ms-client-request-id`	Dieser Header kann zur Problembehandlung von Anforderungen und entsprechenden Antworten verwendet werden. Der Wert dieses Headers ist gleich dem Wert des `x-ms-client-request-id` Headers, wenn er in der Anforderung vorhanden ist und der Wert nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der `x-ms-client-request-id` Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden.

Antworttext