Share-eigenschappen instellen
Met Set Share Properties de bewerking worden eigenschappen ingesteld voor de opgegeven Azure-bestandsshare. 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 kunt de Set Share Properties aanvraag als volgt samenstellen. 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=properties |
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 in 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-share-quota |
Optioneel. Ondersteund in versie 2015-02-21 en hoger. Hiermee geeft u de maximale grootte van de share, in gibibytes (GiB). |
x-ms-access-tier |
Optioneel. Ondersteund in versie 2019-12-12 en hoger. Hiermee geeft u de toegangslaag van de share op. Geldige waarden zijn TransactionOptimized, Hoten Cool. Zie opslaglagen Azure Files voor gedetailleerde informatie over opslaglagen voor bestandsshares |
x-ms-root-squash: <NoRootSquash | RootSquash | AllSquash> |
Optioneel. Ondersteund in versie 2020-02-10 en hoger. Hiermee geeft u het basisverpletteringsgedrag op de share op wanneer NFS is ingeschakeld. Als dit niet is opgegeven, is NoRootSquashde standaardwaarde .
|
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=properties
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=
x-ms-share-quota: 55
x-ms-root-squash: RootSquash
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, als een tekenreeks met aanhalingstekens. |
x-ms-request-id |
Identificeert op unieke wijze de aanvraag die is gedaan. U kunt deze ook 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 wordt 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
Zie Share maken voor meer informatie over het instellen van het quotum voor delen.
Als u het quotum voor delen instelt op kleiner dan de grootte van de gegevens op de share, slaagt de bewerking. U kunt echter pas meer gegevens aan de share toevoegen als de hoeveelheid gegevens op de share onder het quotum is verlaagd. U kunt de hoeveelheid gegevens verminderen door bestanden te verwijderen of te comprimeren.
Set Share Properties 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).