Metagegevens delen instellen
Met Set Share Metadata de bewerking stelt u een of meer door de gebruiker gedefinieerde naam-/waardeparen in voor de opgegeven share. Hoewel deze bewerking volledig wordt ondersteund, is het een verouderde beheerbewerking. We raden u aan in plaats daarvan de bewerking Bestandsshares - Bijwerken te gebruiken die wordt geleverd door de opslagresourceprovider (Microsoft.Storage). Zie Bewerkingen op Bestandsshare-resources voor meer informatie over programmatisch communiceren met FileShare resources met behulp van de opslagresourceprovider.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| SMB |  |
| NFS | |
Aanvraag
U maakt de Set Share Metadata aanvraag als volgt. We raden HTTPS aan. Vervang myaccount door de naam van uw opslagaccount.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata |
HTTP/1.1 |
Vervang de padonderdelen die worden weergegeven in de aanvraag-URI door uw eigen, als volgt:
| Padonderdeel | Beschrijving |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. |
Zie Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevens voor meer informatie over padnaambeperkingen.
URI-parameters
U kunt de volgende aanvullende parameters opgeven voor de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Optioneel. Uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files bewerkingen voor meer informatie. |
Aanvraagheaders
In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven:
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. |
Date of x-ms-date |
Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
x-ms-meta-name:value |
Optioneel. Biedt een naam/waardepaar dat metagegevens voor de share bevat. Elke aanroep van deze bewerking vervangt alle bestaande metagegevens die aan de share zijn gekoppeld. Als u alle metagegevens uit de share 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 Opslaganalyse 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 Blob Storage bewaken voor meer informatie. |
x-ms-lease-id:<ID> |
Vereist als de doelbestandsshare een actieve lease heeft. Beschikbaar voor versie 2020-02-10 en hoger. Als de aanvraag de lease-id niet bevat of niet geldig is, mislukt de bewerking met statuscode 412 (Voorwaarde is mislukt). Als deze header is opgegeven en de doelbestandsshare momenteel geen actieve lease heeft, mislukt de bewerking met statuscode 412 (Voorwaarde mislukt). |
Aanvraagbody
Geen.
Voorbeeldaanvraag
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Beschrijving |
|---|---|
Last-Modified |
Retourneert de datum en tijd waarop de share voor het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Weergave van datum/tijd-waarden in kopteksten voor meer informatie. Elke bewerking die de share of de eigenschappen ervan wijzigt, wordt de laatste wijzigingstijd bijgewerkt. Bewerkingen op bestanden hebben geen invloed op de laatste wijzigingstijd van de share. |
ETag |
Bevat een waarde die de versie van de share vertegenwoordigt, tussen aanhalingstekens. |
x-ms-request-id |
Identificeert op unieke wijze de aanvraag die is gedaan. U kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie. |
x-ms-version |
Geeft de versie van Azure Files aan die is gebruikt om de aanvraag uit te voeren. |
Date of x-ms-date |
Een UTC-datum/tijd-waarde die het tijdstip aangeeft waarop de service het antwoord heeft verzonden. |
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 maximaal 1024 zichtbare ASCII-tekens is. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord. |
Hoofdtekst van de reactie
Geen.
Autorisatie
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Als u aanroept Set Share Metadata , worden alle bestaande metagegevens overschreven die aan de share zijn gekoppeld. Het is niet mogelijk om een afzonderlijk naam-waardepaar te wijzigen.
U kunt ook metagegevens instellen voor een share op het moment dat deze wordt gemaakt, als onderdeel van de bewerking Share maken .
Als u aanroept Set Share Metadata , worden de ETag eigenschappen en Last-Modified-Time voor de share bijgewerkt.
Set Share Metadata wordt niet ondersteund voor een momentopname van een share. Een poging om deze bewerking uit te voeren op een momentopname van een share mislukt met statuscode 400 (InvalidQueryParameterValue). U kunt metagegevens instellen voor een momentopname van een share op het moment dat deze wordt gemaakt, als onderdeel van de Snapshot Share bewerking.