Mapmetagegevens instellen
Met de Set Directory Metadata bewerking worden door de gebruiker gedefinieerde metagegevens ingesteld voor de opgegeven map. Deze bewerking is beschikbaar in versie 2015-02-21 en hoger.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| PUT | https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory& comp=metadata |
HTTP/1.1 |
Vervang als volgt de padonderdelen die worden weergegeven in de aanvraag-URI door uw eigen onderdelen:
| Padonderdeel | Description |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van de bestandsshare. |
myparentdirectorypath |
Optioneel. Het pad naar de bovenliggende map. |
mydirectory |
De naam van de map. |
Zie Naam- en verwijzingsshares, mappen, bestanden en metagegevens voor meer informatie over beperkingen voor padnamen.
URI-parameters
U kunt de volgende aanvullende parameters opgeven in de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor bestandsservicebewerkingen voor 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. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
Date of x-ms-date |
Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Deze bewerking is alleen beschikbaar in versie 2015-02-21 en hoger. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
x-ms-meta-name:value |
Optioneel. Hiermee stelt u een naam-waardepaar in voor de map. Elke aanroep van deze bewerking vervangt alle bestaande metagegevens die aan de map zijn gekoppeld. Als u alle metagegevens uit de map wilt verwijderen, roept u deze bewerking aan zonder metagegevensheaders. Namen van metagegevens moeten voldoen aan de naamgevingsregels voor C#-id's. |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet 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 Azure Files bewaken voor meer informatie. |
x-ms-file-request-intent |
Vereist als Authorization de 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 moet worden verleend als deze 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> } |
Optioneel. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt in de aanvraag-URL moet worden ingekort of niet. Zie Shares, mappen, bestanden en metagegevens een naam geven en hiernaar verwijzen voor 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 foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord bevat ook aanvullende standaard-HTTP-headers. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Description |
|---|---|
ETag |
Bevat een waarde die de versie van de map vertegenwoordigt. De waarde staat tussen aanhalingstekens. |
x-ms-request-id |
Identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie. |
x-ms-version |
Geeft de versie van de bestandsservice aan die is gebruikt om de aanvraag uit te voeren. |
Date of x-ms-date |
Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die 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 wordt ingesteld op true als de inhoud van de aanvraag is versleuteld met behulp van het opgegeven algoritme. Anders wordt de waarde ingesteld op false. |
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 de reactie
Geen.
Opmerkingen
Set Directory Metadata wordt niet ondersteund op een momentopname van een share. Dit is een alleen-lezenkopie van een share. Een poging om deze bewerking uit te voeren op een momentopname van een share mislukt met 400 (InvalidQueryParameterValue).