Bestandseigenschappen instellen
Met de Set File Properties-bewerking worden systeemeigenschappen voor het bestand ingesteld.
Beschikbaarheid van protocol
| Protocol voor bestandsshare ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Verzoek
De Set File Properties aanvraag kan als volgt worden samengesteld. U wordt aangeraden HTTPS te gebruiken.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| ZETTEN | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties |
HTTP/1.1 |
Vervang de padonderdelen in de aanvraag-URI als volgt door uw eigen padonderdelen:
| Padonderdeel | Beschrijving |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. |
mydirectorypath |
Facultatief. Het pad naar de bovenliggende map. |
myfile |
De naam van het bestand. |
Zie Naam- en referentieshares, mappen, bestanden en metagegevensvoor meer informatie over naamgevingsbeperkingen voor paden.
URI-parameters
U kunt de volgende aanvullende parameters opgeven in de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Facultatief. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor bestandsservicebewerkingenvoor meer informatie. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
Date of x-ms-date |
Vereist. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-servicesvoor meer informatie. |
x-ms-cache-control |
Facultatief. Hiermee wijzigt u de tekenreeks voor cachebeheer voor het bestand. Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap voor het bestand gewist. Volgende aanroepen naar Bestandseigenschappen ophalen retourneert deze eigenschap niet, tenzij deze expliciet opnieuw is ingesteld op het bestand. |
x-ms-content-type |
Facultatief. Hiermee stelt u het inhoudstype van het bestand in. Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap voor het bestand gewist. Volgende aanroepen naar Bestandseigenschappen ophalen retourneert deze eigenschap niet, tenzij deze expliciet opnieuw is ingesteld op het bestand. |
x-ms-content-md5 |
Facultatief. Hiermee stelt u de MD5-hash van het bestand in. Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap voor het bestand gewist. Volgende aanroepen naar Bestandseigenschappen ophalen retourneert deze eigenschap niet, tenzij deze expliciet opnieuw is ingesteld op het bestand. |
x-ms-content-encoding |
Facultatief. Hiermee stelt u de inhoudscodering van het bestand in. Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap voor het bestand gewist. Volgende aanroepen naar Bestandseigenschappen ophalen retourneert deze eigenschap niet, tenzij deze expliciet opnieuw is ingesteld op het bestand. |
x-ms-content-language |
Facultatief. Hiermee stelt u de inhoudstaal van het bestand in. Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap voor het bestand gewist. Volgende aanroepen naar Bestandseigenschappen ophalen retourneert deze eigenschap niet, tenzij deze expliciet opnieuw is ingesteld op het bestand. |
x-ms-content-disposition |
Facultatief. Hiermee stelt u de Content-Disposition header van het bestand in.Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap voor het bestand gewist. Volgende aanroepen naar Bestandseigenschappen ophalen retourneert deze eigenschap niet, tenzij deze expliciet opnieuw is ingesteld op het bestand. |
x-ms-content-length: bytes |
Facultatief. Hiermee wijzigt u het formaat van een bestand in de opgegeven grootte. Als de opgegeven bytewaarde kleiner is dan de huidige grootte van het bestand, worden alle bereiken boven de opgegeven bytewaarde gewist. |
x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> } |
In versies 2019-02-02 tot 2021-04-10 is deze header vereist als x-ms-file-permission-key niet is opgegeven. Vanaf versie 2021-06-08 zijn beide headers optioneel. Deze machtiging is de beveiligingsdescriptor voor het bestand dat is opgegeven in de Security Descriptor Definition Language (SDDL) of (versie 2024-11-04 of hoger) in base64-gecodeerde binaire beveiligingsdescriptorindeling. U kunt opgeven welke indeling moet worden gebruikt met de x-ms-file-permission-format-header. U kunt deze header gebruiken als de grootte van de machtigingen 8 kibibytes (KiB) of kleiner is. Anders kunt u x-ms-file-permission-keygebruiken. Indien opgegeven, moet deze een eigenaar, groep en discretionaire toegangsbeheerlijst (DACL)hebben. Een waarde van preserve kan worden doorgegeven om een bestaande waarde ongewijzigd te houden.Opmerking: u kunt x-ms-file-permission of x-ms-file-permission-keyopgeven. Als geen van beide headers is opgegeven, wordt de standaardwaarde van preserve gebruikt. |
x-ms-file-permission-format: { sddl ¦ binary } |
Facultatief. Versie 2024-11-04 of hoger. Hiermee geeft u op of de waarde die is doorgegeven in x-ms-file-permission zich in SDDL of in binaire indeling bevindt. Als x-ms-file-permission-key is ingesteld op preserve, mag deze header niet worden ingesteld. Als x-ms-file-permission-key is ingesteld op een andere waarde dan preserveen als deze header niet is ingesteld, wordt de standaardwaarde van sddl gebruikt. |
x-ms-file-permission-key: <PermissionKey> |
In versies 2019-02-02 tot 2021-04-10 is deze header vereist als x-ms-file-permission niet is opgegeven. Vanaf versie 2021-06-08 zijn beide headers optioneel. De sleutel van de machtiging die moet worden ingesteld voor het bestand. Dit kan worden gemaakt met behulp van de Create-Permission-API.Opmerking: u kunt x-ms-file-permission of x-ms-file-permission-keyopgeven. Als geen van beide headers is opgegeven, wordt de standaardwaarde van preserve gebruikt voor de x-ms-file-permission-header. |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
Vereist, versie 2019-02-02 tot 2021-04-10. Optioneel, versie 2021-06-08 en hoger. De kenmerken van het bestandssysteem die op het bestand moeten worden ingesteld. Zie de lijst met beschikbare kenmerken. Een waarde van preserve kan worden doorgegeven om een bestaande waarde ongewijzigd te houden. De standaardwaarde is preserve. |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
Vereist, versie 2019-02-02 tot 2021-04-10. Optioneel, versie 2021-06-08 en hoger. De eigenschap Coordinated Universal Time (UTC) voor het maken van een bestand. Een waarde van preserve kan worden doorgegeven om een bestaande waarde ongewijzigd te houden. De standaardwaarde is preserve. |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
Vereist, versie 2019-02-02 tot 2021-04-10. Optioneel, versie 2021-06-08 en hoger. De laatste schrijfeigenschap utc (Coordinated Universal Time) voor een bestand. Een waarde van preserve kan worden doorgegeven om een bestaande waarde ongewijzigd te houden. Als preserve is opgegeven en de grootte van het bestand wordt gewijzigd, wordt de laatste schrijftijd bijgewerkt naar de huidige tijd. Als de grootte van het bestand wordt gewijzigd, maar er een expliciete tijdstempel wordt opgegeven, wordt de expliciete tijdstempel gebruikt. De standaardwaarde is preserve. |
x-ms-lease-id: <ID> |
Vereist als het bestand een actieve lease heeft. Beschikbaar voor versie 2019-02-02 en hoger. |
x-ms-client-request-id |
Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Monitor Azure Filesvoor meer informatie. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Facultatief. Versie 2021-06-08 en hoger. De eigenschap Coordinated Universal Time (UTC) wijzigt tijd voor het bestand, opgemaakt in de ISO 8601-indeling. U kunt een waarde van now gebruiken om de tijd van de aanvraag aan te geven. De standaardwaarde is now. |
x-ms-file-request-intent |
Vereist als Authorization header een OAuth-token opgeeft. Acceptabele waarde is backup. Deze header geeft aan dat de Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action of Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action moeten worden verleend als ze zijn opgenomen in het RBAC-beleid dat is toegewezen aan de identiteit die is geautoriseerd met behulp van de Authorization-header. Beschikbaar voor versie 2022-11-02 en hoger. |
x-ms-allow-trailing-dot: { <Boolean> } |
Facultatief. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt aanwezig in de aanvraag-URL moet worden ingekort of niet. Zie Shares, mappen, bestanden en metagegevensvoor meer informatie. |
Aanvraagbody
Geen.
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Statuscode
Een geslaagde bewerking retourneert statuscode 200 (OK).
Zie Status en foutcodesvoor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Beschrijving |
|---|---|
ETag |
Bevat een waarde die de versie van het bestand vertegenwoordigt. De waarde staat tussen aanhalingstekens. |
Last-Modified |
Retourneert de datum en tijd waarop het bestand voor het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in koptekstenvoor meer informatie. Elke bewerking die de map of de eigenschappen wijzigt, werkt de laatst gewijzigde tijd bij. Bewerkingen op bestanden hebben geen invloed op de laatst gewijzigde tijd van de map. |
x-ms-request-id |
Identificeer de aanvraag die is gemaakt en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossenvoor meer informatie. |
x-ms-version |
Geeft de versie van de Bestandsservice aan die wordt gebruikt om de aanvraag uit te voeren. |
Date of x-ms-date |
Een UTC-datum/tijdwaarde die wordt gegenereerd door de service, wat de tijd aangeeft waarop het antwoord is gestart. |
x-ms-request-server-encrypted: true/false |
Versie 2017-04-17 en hoger. De waarde van deze header is ingesteld op true als de inhoud van de aanvraag is versleuteld met behulp van het opgegeven algoritme. Anders is de waarde ingesteld op false. |
x-ms-file-permission-key |
Versie 2019-02-02 en hoger. De sleutel van de machtiging van het bestand. |
x-ms-file-attributes |
Versie 2019-02-02 en hoger. De kenmerken van het bestandssysteem in het bestand. Zie de lijst met beschikbare kenmerkenvoor meer informatie. |
x-ms-file-creation-time |
Versie 2019-02-02 en hoger. De utc-datum/tijd-waarde die de eigenschap aanmaaktijd voor het bestand vertegenwoordigt. |
x-ms-file-last-write-time |
Versie 2019-02-02 en hoger. De datum/tijd-waarde van UTC die de eigenschap voor de laatste schrijftijd voor het bestand vertegenwoordigt. |
x-ms-file-change-time |
Versie 2019-02-02 en hoger. De utc-datum/tijd-waarde die de eigenschap wijzigingstijd voor het bestand vertegenwoordigt. |
x-ms-client-request-id |
Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord. |
Hoofdtekst van antwoord
Geen.
Machtiging
Alleen de accounteigenaar kan deze bewerking aanroepen.
Bestandssysteemkenmerken
| Attribuut | Win32-bestandskenmerk | Definitie |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | Een bestand dat alleen-lezen is. Toepassingen kunnen het bestand lezen, maar kunnen er niet naar schrijven of verwijderen. |
| Verborgen | FILE_ATTRIBUTE_HIDDEN | Het bestand is verborgen. Het is niet opgenomen in een gewone lijst met mappen. |
| Systeem | FILE_ATTRIBUTE_SYSTEM | Een bestand waarvan het besturingssysteem een deel van of uitsluitend gebruikt. |
| Geen | FILE_ATTRIBUTE_NORMAL | Een bestand waarvoor geen andere kenmerken zijn ingesteld. Dit kenmerk is alleen geldig wanneer het alleen wordt gebruikt. |
| Archief | FILE_ATTRIBUTE_ARCHIVE | Een bestand dat een archiefbestand is. Toepassingen gebruiken dit kenmerk gewoonlijk om bestanden te markeren voor back-up of verwijdering. |
| Tijdelijk | FILE_ATTRIBUTE_TEMPORARY | Een bestand dat wordt gebruikt voor tijdelijke opslag. |
| Offline | FILE_ATTRIBUTE_OFFLINE | De gegevens van een bestand zijn niet onmiddellijk beschikbaar. Dit bestandssysteemkenmerk wordt voornamelijk gepresenteerd om compatibiliteit met Windows te bieden. Azure Files biedt geen ondersteuning voor offlineopslagopties. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Het bestand moet niet worden geïndexeerd door de inhoudsindexeringsservice. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | De gegevensstroom van de gebruiker hoeft niet te worden gelezen door de scanner voor gegevensintegriteit op de achtergrond. Dit bestandssysteemkenmerk wordt voornamelijk gepresenteerd om compatibiliteit met Windows te bieden. |
Opmerkingen
De semantiek voor het bijwerken van de eigenschappen van een bestand zijn als volgt:
De grootte van een bestand wordt alleen gewijzigd als de aanvraag een waarde voor de
x-ms-content-lengthheader opgeeft.Als een aanvraag alleen
x-ms-content-lengthen geen andere eigenschappen instelt, worden er geen andere eigenschappen van het bestand gewijzigd.Als een of meer van de volgende eigenschappen zijn ingesteld in de aanvraag, worden al deze eigenschappen samen ingesteld. Als er geen waarde is opgegeven voor een opgegeven eigenschap wanneer ten minste één van de volgende eigenschappen is ingesteld, wordt die eigenschap voor het bestand gewist.
x-ms-cache-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-ms-content-language
Notitie
De voorgaande bestandseigenschappen staan los van de eigenschappen van het bestandssysteem die beschikbaar zijn voor SMB-clients. SMB-clients kunnen deze eigenschapswaarden niet lezen, schrijven of wijzigen.
Set File properties wordt niet ondersteund op een momentopname van een share. Dit is een alleen-lezen kopie van een share. Een poging om deze bewerking uit te voeren op een momentopname van een share mislukt met 400 (InvalidQueryParameterValue).
Als het bestand een actieve lease heeft, moet de client een geldige lease-id opgeven voor de aanvraag om eigenschappen naar het bestand te schrijven. Als de client geen lease-id opgeeft of een ongeldige lease-id opgeeft, retourneert de bestandsservice statuscode 412 (Voorwaarde mislukt). Als de client een lease-id opgeeft, maar het bestand geen actieve lease heeft, retourneert de bestandsservice ook statuscode 412 (Voorwaarde mislukt).