Set File Properties
Mit dem Vorgang Set File Properties werden Systemeigenschaften für die Datei festgelegt.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |  |
| NFS |  |
Anforderung
Die Set File Properties-Anforderung kann wie folgt erstellt werden. Es wird empfohlen, HTTPS zu verwenden.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| PUT | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties |
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 übergeordneten Verzeichnis. |
myfile |
Der Name der Datei. |
Informationen zu Pfadbenennungseinschränkungen finden Sie unter Namens- und Verweisfreigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
Sie können die folgenden zusätzlichen Parameter im Anforderungs-URI angeben:
| Parameter | BESCHREIBUNG |
|---|---|
timeout |
Optional. Der timeout-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Dateidienstvorgä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-cache-control |
Optional. Ändert die Cachesteuerelement-Zeichenfolge für die Datei. Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Dateieigenschaften abrufen geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für die Datei festgelegt. |
x-ms-content-type |
Optional. Legt den Inhaltstyp der Datei fest. Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Dateieigenschaften abrufen geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für die Datei festgelegt. |
x-ms-content-md5 |
Optional. Legt den MD5-Hash der Datei fest. Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Dateieigenschaften abrufen geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für die Datei festgelegt. |
x-ms-content-encoding |
Optional. Legt die Inhaltscodierung der Datei fest. Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Dateieigenschaften abrufen geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für die Datei festgelegt. |
x-ms-content-language |
Optional. Legt die Sprache für den Inhalt der Datei fest. Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Dateieigenschaften abrufen geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für die Datei festgelegt. |
x-ms-content-disposition |
Optional. Legt den Header der Datei fest Content-Disposition .Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Dateieigenschaften abrufen geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für die Datei festgelegt. |
x-ms-content-length: bytes |
Optional. Ändert die Größe einer Datei in die angegebene Größe. Wenn der angegebene Bytewert kleiner als die aktuelle Größe der Datei ist, werden alle Bereiche über dem angegebenen Bytewert gelöscht. |
x-ms-file-permission: { preserve ¦ <SDDL> } |
In den Versionen 2019-02-02 bis 2021-04-10 ist dieser Header erforderlich, wenn x-ms-file-permission-key nicht angegeben ist. Ab Version 2021-06-08 sind beide Header optional. Diese Berechtigung ist der Sicherheitsdeskriptor für die Datei, die in der Security Descriptor Definition Language (SDDL) angegeben ist. Sie können diesen Header verwenden, wenn die Berechtigungsgröße 8 Kibibytes (KiB) oder weniger beträgt. Andernfalls können Sie verwenden x-ms-file-permission-key. Falls angegeben, muss sie über eine Besitzer-, Gruppen- und diskretionäre Zugriffssteuerungsliste (DACL) verfügen. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten.Hinweis: Sie können entweder x-ms-file-permission oder x-ms-file-permission-keyangeben. Wenn keiner der Header angegeben wird, wird der Standardwert von preserve verwendet. |
x-ms-file-permission-key: <PermissionKey> |
In den Versionen 2019-02-02 bis 2021-04-10 ist dieser Header erforderlich, wenn x-ms-file-permission nicht angegeben ist. Ab Version 2021-06-08 sind beide Header optional. Der Schlüssel der Berechtigung, die für die Datei festgelegt werden soll. Dies kann mithilfe der Create-Permission API erstellt werden.Hinweis: Sie können entweder x-ms-file-permission oder x-ms-file-permission-keyangeben. Wenn keiner der Header angegeben ist, wird der Standardwert von preserve für den x-ms-file-permission Header verwendet. |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
Erforderlich, Version 2019-02-02 bis 2021-04-10. Optional, Version 2021-06-08 und höher. Die Dateisystemattribute, die für die Datei festgelegt werden sollen. Sehen Sie sich die Liste der verfügbaren Attribute an. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten. Standardwert: preserve. |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
Erforderlich, Version 2019-02-02 bis 2021-04-10. Optional, Version 2021-06-08 und höher. Die UTC-Eigenschaft (Koordinierte Weltzeit) für eine Datei. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten. Standardwert: preserve. |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
Erforderlich, Version 2019-02-02 bis 2021-04-10. Optional, Version 2021-06-08 und höher. Die UTC-Eigenschaft (Coordinated Universal Time) zum letzten Schreiben für eine Datei. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten. Wenn preserve angegeben ist und die Größe der Datei geändert wird, wird die letzte Schreibzeit auf den aktuellen Zeitpunkt aktualisiert. Wenn die Größe der Datei geändert wird, aber ein expliziter Zeitstempel angegeben wird, wird der explizite Zeitstempel verwendet. Standardwert: preserve. |
x-ms-lease-id: <ID> |
Erforderlich, wenn die Datei über eine aktive Lease verfügt. Verfügbar für Version 2019-02-02 und höher. |
x-ms-client-request-id |
Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der beim Konfigurieren der Protokollierung in den Protokollen aufgezeichnet wird. 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-change-time: { now ¦ <DateTime> } |
Optional. Version 2021-06-08 und höher. Die Utc-Eigenschaft (Koordinierte Weltzeit) ändert die Zeit für die Datei, die im ISO 8601-Format formatiert ist. Sie können den Wert von now verwenden, um die Uhrzeit der Anforderung anzugeben. Standardwert: now. |
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 in der Anforderungs-URL vorhandener nachgestellter Punkt gekürzt werden soll oder nicht. 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
Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.
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 |
|---|---|
ETag |
Enthält einen Wert, der die Version der Datei darstellt. Der Wert wird in Anführungszeichen eingeschlossen. |
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 das Verzeichnis oder die zugehörigen Eigenschaften ändert, aktualisiert den Zeitpunkt der letzten Änderung. Vorgänge für Dateien wirken sich nicht auf den Zeitpunkt der letzten Änderung des Verzeichnisses aus. |
x-ms-request-id |
Identifiziert eindeutig die Anforderung, die gestellt wurde, und kann zur Problembehandlung für die Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung bei API-Vorgängen. |
x-ms-version |
Gibt die Version des Dateidiensts an, der zum Ausführen der Abfrage verwendet wird. |
Date oder x-ms-date |
Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. |
x-ms-request-server-encrypted: true/false |
Version 2017-04-17 und höher. Der Wert dieses Headers wird auf true festgelegt, wenn der Inhalt der Anforderung mit dem angegebenen Algorithmus erfolgreich verschlüsselt wurde. Andernfalls wird der Wert auf false festgelegt. |
x-ms-file-permission-key |
Version 2019-02-02 und höher. Der Schlüssel der Berechtigung der Datei. |
x-ms-file-attributes |
Version 2019-02-02 und höher. Die Dateisystemattribute für die Datei. Weitere Informationen finden Sie in der Liste der verfügbaren Attribute. |
x-ms-file-creation-time |
Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Erstellungszeiteigenschaft für die Datei darstellt. |
x-ms-file-last-write-time |
Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Eigenschaft der letzten Schreibzeit für die Datei darstellt. |
x-ms-file-change-time |
Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Änderungszeiteigenschaft für die Datei darstellt. |
x-ms-client-request-id |
Kann verwendet werden, um Anforderungen und entsprechende Antworten zu behandeln. 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
Keine.
Authorization
Dieser Vorgang kann nur vom Kontobesitzer aufgerufen werden.
Dateisystemattribute
| attribute | Win32-Dateiattribute | Definition |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | Eine datei, die schreibgeschützt ist. Anwendungen können die Datei lesen, aber nicht in sie schreiben oder löschen. |
| Ausgeblendet | FILE_ATTRIBUTE_HIDDEN | Die Datei ist ausgeblendet. Es ist nicht in einer normalen Verzeichnisliste enthalten. |
| System | FILE_ATTRIBUTE_SYSTEM | Eine Datei, von der das Betriebssystem einen Teil oder ausschließlich verwendet. |
| Keine | FILE_ATTRIBUTE_NORMAL | Eine Datei, für die keine anderen Attribute festgelegt sind. Dieses Attribut ist nur gültig, wenn es allein verwendet wird. |
| Archivieren | FILE_ATTRIBUTE_ARCHIVE | Eine Datei, bei der es sich um eine Archivdatei handelt. Anwendungen verwenden dieses Attribut normalerweise, um Dateien für die Sicherung oder Entfernung zu markieren. |
| Temporäre Prozeduren | FILE_ATTRIBUTE_TEMPORARY | Eine Datei, die für den temporären Speicher verwendet wird. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Die Daten einer Datei sind nicht sofort verfügbar. Dieses Dateisystemattribute wird in erster Linie angezeigt, um die Kompatibilität mit Windows zu gewährleisten. Azure Files unterstützt keine Offlinespeicheroptionen. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Die Datei soll nicht vom Inhaltsindizierungsdienst indiziert werden. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Der Benutzerdatenstrom darf nicht vom Hintergrunddatenintegritätsscanner gelesen werden. Dieses Dateisystemattribute wird in erster Linie angezeigt, um die Kompatibilität mit Windows zu gewährleisten. |
Hinweise
Die Semantik für das Aktualisieren der Eigenschaften einer Datei lautet wie folgt:
Die Größe einer Datei wird nur geändert, wenn in der Anforderung ein Wert für den Header
x-ms-content-lengthangegeben ist.Wenn eine Anforderung nur
x-ms-content-lengthund keine anderen Eigenschaften festlegt, werden keine anderen Eigenschaften der Datei geändert.Wenn eine oder mehrere der folgenden Eigenschaften in der Anforderung festgelegt sind, werden alle diese Eigenschaften zusammen festgelegt. Wenn für eine angegebene Eigenschaft kein Wert angegeben wird, wenn mindestens eine der folgenden Eigenschaften festgelegt ist, wird diese Eigenschaft für die Datei gelöscht.
x-ms-cache-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-ms-content-language
Hinweis
Die vorherigen Dateieigenschaften sind getrennt von den Dateisystemeigenschaften, die für SMB-Clients verfügbar sind. SMB-Clients können diese Eigenschaftswerte nicht lesen, schreiben oder ändern.
Set File propertieswird nicht für eine Freigabe Momentaufnahme unterstützt, bei der es sich um eine schreibgeschützte Kopie einer Freigabe handelt. Ein Versuch, diesen Vorgang für eine Freigabe auszuführen Momentaufnahme schlägt mit 400 (InvalidQueryParameterValue) fehl.
Wenn die Datei über eine aktive Lease verfügt, muss der Client für die Anforderung zum Schreiben von Eigenschaften in die Datei eine gültige Lease-ID angeben. Wenn der Client keine Lease-ID oder eine ungültige Lease-ID angibt, gibt der Dateidienst status Code 412 (Voraussetzung fehlgeschlagen) zurück. Wenn der Client eine Lease-ID angibt, die Datei jedoch keine aktive Lease aufweist, gibt der Dateidienst auch status Code 412 (Vorbedingung fehlgeschlagen) zurück.