Ange resursegenskaper
Den Set Share Properties åtgärden anger egenskaper för den angivna Azure-filresursen. Även om den här åtgärden stöds fullt ut är det en äldre hanteringsåtgärd. Vi rekommenderar att du använder Filresurser – Uppdatera åtgärd som tillhandahålls av lagringsresursprovidern (Microsoft.Storage) i stället. Mer information om hur du interagerar programmatiskt med FileShare resurser med hjälp av lagringsresursprovidern finns i Åtgärder för FileShare-resurser.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Du kan skapa Set Share Properties begäran enligt följande. Vi rekommenderar HTTPS. Ersätt myaccount- med namnet på ditt lagringskonto.
| Metod | Begärande-URI | HTTP-version |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna enligt följande:
| Sökvägskomponent | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namngivnings- och referensresurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar i begärande-URI:n:
| Parameter | Beskrivning |
|---|---|
timeout |
Valfri. Uttryckt i sekunder. Mer information finns i Ange tidsgränser för Azure Files-åtgärder. |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden:
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-share-quota |
Valfri. Stöds i version 2015-02-21 och senare. Anger den maximala storleken på resursen i gibibyte (GiB). |
x-ms-access-tier |
Valfri. Stöds i version 2019-12-12 och senare. Anger resursens åtkomstnivå. Giltiga värden är TransactionOptimized, Hotoch Cool. Detaljerad information om filresursnivåindelning finns i Azure Files-lagringsnivåer. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Valfri. Stöds i version 2020-02-10 och senare. Anger rotens squashbeteende på resursen när NFS är aktiverat.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Valfri. Stöds i version 2024-08-04 och senare. Anger om den virtuella katalogen för ögonblicksbilder ska vara tillgänglig vid roten för resursmonteringspunkten när NFS är aktiverat. |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kib-teckengräns på 1 kibibyte (KiB) som registreras i Storage Analytics-loggarna när loggningen konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage-. |
x-ms-lease-id:<ID> |
Krävs om målfilresursen har ett aktivt lån. Tillgänglig för version 2020-02-10 och senare. Om begäran inte innehåller låne-ID:t eller om det inte är giltigt misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades). Om det här huvudet har angetts och målfilresursen för närvarande inte har något aktivt lån misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Valfri. Stöds i version 2024-11-04 och senare. Tillåts endast för Premium-filresurser (filresurser i lagringskontotypen FileStorage). Den här egenskapen kan användas för att aktivera eller inaktivera betald bursting. Om egenskapen inte har angetts behåller resursen sin befintliga status för betald bursting-aktivering. |
x-ms-share-paid-bursting-max-iops |
Valfri. Stöds i version 2024-11-04 och senare. Tillåts endast för Premium-filresurser. Ett heltal som representerar maximalt antal betalda in- och utdataåtgärder per sekund (IOPS) som tillåts för resursen. Om betald bursting inte redan är aktiverat på resursen: Beteendet är identiskt med x-ms-share-paid-bursting-max-iops-huvudet i Skapa resurs. Standardvärdet om det inte anges är det högsta tillåtna IOPS för en resurs. Om det här huvudet anges måste x-ms-share-paid-bursting-enabled också anges till true.Om betald bursting redan är aktiverat på resursen: x-ms-share-paid-bursting-max-iops kan användas för att uppdatera den högsta betalda IOPS för resursen.
x-ms-share-paid-bursting-enabled behöver inte anges i det här fallet. Om x-ms-share-paid-bursting-enabled är inställt på sant men x-ms-share-paid-bursting-max-iops inte har angetts förblir den maximala betalda burst-IOPS oförändrad. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Valfri. Stöds i version 2024-11-04 och senare. Tillåts endast för Premium-filresurser. Ett heltal som representerar det högsta antal betalda mebibyte per sekund (MiB/s) som tillåts för resursen. Om betald bursting inte redan är aktiverat på resursen: Beteendet är identiskt med x-ms-share-paid-bursting-max-bandwidth-mibps-huvudet i Skapa resurs. Standardvärdet om det inte anges är det högsta tillåtna MiB/s för en resurs. Om det här huvudet anges måste x-ms-share-paid-bursting-enabled också anges till true.Om betald bursting redan är aktiverat på resursen: x-ms-share-paid-bursting-max-bandwidth-mibps kan användas för att uppdatera den maximala betalda bursting MiB/s för resursen.
x-ms-share-paid-bursting-enabled behöver inte anges i det här fallet. Om x-ms-share-paid-bursting-enabled är inställt på sant men x-ms-share-paid-bursting-max-bandwidth-mibps inte har angetts förblir den maximala betalda bandbredden oförändrad. |
Begärandetext
Ingen.
Exempelbegäran
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
Svar
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK).
Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare STANDARD HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| Svarsrubrik | Beskrivning |
|---|---|
Last-Modified |
Returnerar datum och tid då resursen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representation av datum/tid-värden i rubriker. Alla åtgärder som ändrar resursen eller dess egenskaper uppdaterar den senaste ändrade tiden. Åtgärder på filer påverkar inte resursens senaste ändringstid. |
ETag |
Innehåller ett värde som representerar resursens version som en citerad sträng. |
x-ms-request-id |
Identifierar unikt den begäran som gjordes. Du kan också använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av Azure Files som används för att köra begäran. |
Date eller x-ms-date |
Ett UTC-datum/tid-värde som anger den tid då tjänsten skickade svaret. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id-huvudet, om det finns i begäran och värdet är högst 1 024 synliga ASCII-tecken. Om x-ms-client-request-id huvudet inte finns i begäran visas inte det här huvudet i svaret. |
Svarstext
Ingen.
Tillstånd
Endast kontoägaren kan anropa den här åtgärden.
Anmärkningar
Mer information om hur du anger resurskvoten finns i Create Share.
Om du anger att resurskvoten ska vara mindre än storleken på data på resursen kommer åtgärden att lyckas. Du kan dock inte lägga till mer data till resursen förrän mängden data på resursen har minskats under kvoten. Du kan minska mängden data genom att antingen ta bort eller komprimera filer.
Set Share Properties stöds inte för en resursögonblicksbild. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med statuskoden 400 (InvalidQueryParameterValue).
Om du ställer in huvudet x-ms-enable-snapshot-virtual-directory-access för NFS-resurser monterar du resursen igen för att observera det uppdaterade beteendet.