Eigenschappen van delen instellen
Met de Set Share Properties bewerking worden eigenschappen ingesteld voor de opgegeven Azure-bestandsshare. Hoewel deze bewerking volledig wordt ondersteund, is het een verouderde beheerbewerking. U wordt aangeraden in plaats daarvan de bestandsshares te gebruiken: bewerking bijwerken die wordt geleverd door de opslagresourceprovider (Microsoft.Storage). Zie Bewerkingen op FileShare-resourcesvoor meer informatie over programmatisch werken met FileShare resources met behulp van de opslagresourceprovider.
Beschikbaarheid van protocol
| Protocol voor bestandsshare ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Verzoek
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 in de aanvraag-URI als volgt door uw eigen padonderdelen:
| Padonderdeel | Beschrijving |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. |
Zie Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevensvoor meer informatie over padnaamgevingsbeperkingen.
URI-parameters
U kunt de volgende aanvullende parameters opgeven in de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Facultatief. Uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files-bewerkingenvoor meer informatie. |
Aanvraagheaders
In de volgende tabel worden de 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 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-share-quota |
Facultatief. Ondersteund in versie 2015-02-21 en hoger. Hiermee geeft u de maximale grootte van de share, in gibibytes (GiB). |
x-ms-access-tier |
Facultatief. Ondersteund in versie 2019-12-12 en hoger. Hiermee geeft u de toegangslaag van de share. Geldige waarden zijn TransactionOptimized, Hoten Cool. Zie Azure Files-opslaglagenvoor gedetailleerde informatie over opslaglagen voor bestandsshares. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Facultatief. Ondersteund in versie 2020-02-10 en hoger. Hiermee geeft u het root-squashgedrag op de share wanneer NFS is ingeschakeld.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Facultatief. Ondersteund in versie 2024-08-04 en hoger. Hiermee geeft u op of de virtuele map van de momentopname toegankelijk moet zijn in de hoofdmap van het share-koppelpunt wanneer NFS is ingeschakeld. |
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 Storage Analytics-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 mislukt). Als deze header is opgegeven en de doelbestandsshare momenteel geen actieve lease heeft, mislukt de bewerking met statuscode 412 (Voorwaarde mislukt). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Facultatief. Ondersteund in versie 2024-11-04 en hoger. Alleen toegestaan voor Premium-bestandsshares (bestandsshares binnen het type FileStorage-opslagaccount). Deze eigenschap kan worden gebruikt om betaalde bursting in of uit te schakelen. Als de eigenschap niet is opgegeven, behoudt de share de bestaande status van de betaalde bursting-activering. |
x-ms-share-paid-bursting-max-iops |
Facultatief. Ondersteund in versie 2024-11-04 en hoger. Alleen toegestaan voor Premium-bestandsshares. Een geheel getal dat de maximaal betaalde bursting-invoer-/uitvoerbewerkingen per seconde (IOPS) vertegenwoordigt die is toegestaan voor de share. Als betaalde bursting nog niet is ingeschakeld voor de share: het gedrag is identiek aan de x-ms-share-paid-bursting-max-iops header in Share maken. De standaardinstelling als deze niet is opgegeven, is de maximaal toegestane IOPS voor een share. Als deze koptekst is ingesteld, moet x-ms-share-paid-bursting-enabled ook worden ingesteld op true.Als betaalde bursting al is ingeschakeld voor de share: x-ms-share-paid-bursting-max-iops kan worden gebruikt om de maximaal betaalde bursting-IOPS voor de share bij te werken.
x-ms-share-paid-bursting-enabled hoeft in dit geval niet te worden ingesteld. Als x-ms-share-paid-bursting-enabled is ingesteld op true, maar x-ms-share-paid-bursting-max-iops niet is ingesteld, blijft de maximaal betaalde bursting-IOPS ongewijzigd. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Facultatief. Ondersteund in versie 2024-11-04 en hoger. Alleen toegestaan voor Premium-bestandsshares. Een geheel getal dat de maximaal betaalde bursting mebibytes per seconde (MiB/s) vertegenwoordigt die is toegestaan voor de share. Als betaalde bursting nog niet is ingeschakeld voor de share: het gedrag is identiek aan de x-ms-share-paid-bursting-max-bandwidth-mibps header in Share maken. De standaardinstelling als deze niet is opgegeven, is de maximaal toegestane MiB/s voor een share. Als deze koptekst is ingesteld, moet x-ms-share-paid-bursting-enabled ook worden ingesteld op true.Als betaalde bursting al is ingeschakeld voor de share: x-ms-share-paid-bursting-max-bandwidth-mibps kan worden gebruikt om de maximaal betaalde bursting MiB/s voor de share bij te werken.
x-ms-share-paid-bursting-enabled hoeft in dit geval niet te worden ingesteld. Als x-ms-share-paid-bursting-enabled is ingesteld op true, maar x-ms-share-paid-bursting-max-bandwidth-mibps niet is ingesteld, blijft de maximale betaalde burstingbandbreedte ongewijzigd. |
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 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 |
|---|---|
Last-Modified |
Retourneert de datum en tijd waarop de share het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Weergave van datum-/tijdwaarden in koptekstenvoor meer informatie. Elke bewerking die de share of de eigenschappen ervan wijzigt, werkt de laatste wijzigingstijd bij. 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 tussen aanhalingstekens. |
x-ms-request-id |
Identificeer de aanvraag die is gedaan, uniek. U kunt deze ook gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossenvoor 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 de tijd 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 bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord. |
Hoofdtekst van antwoord
Geen.
Machtiging
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Zie Share-maken voor meer informatie over het instellen van het sharequotum.
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 toevoegen aan de share als de hoeveelheid gegevens op de share lager is dan het quotum. 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).
Als u x-ms-enable-snapshot-virtual-directory-access header voor NFS-shares instelt, koppelt u de share opnieuw om het bijgewerkte gedrag te observeren.