Hämta resursegenskaper

Begäran Get Share Properties returnerar egenskaper för den angivna resursen eller resursögonblicksbilden.

Även om det här API:et stöds fullt ut är det ett äldre hanterings-API. Därför rekommenderar vi att du använder Filresurser – Hämta, som tillhandahålls av lagringsresursprovidern (Microsoft.Storage) i stället.

Mer information om hur du interagerar programmatiskt med resurser med FileShare hjälp av lagringsresursprovidern finns i Åtgärder på FileShares.

Protokolltillgänglighet

Aktiverat filresursprotokoll	Tillgängligt
SMB
NFS

Förfrågan

Begäran Get Share Properties kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS.

Metod	URI för förfrågan	HTTP-version
GET/HEAD	https://myaccount.file.core.windows.net/myshare?restype=share	HTTP/1.1
GET/HEAD	https://myaccount.file.core.windows.net/myshare?restype=share&sharesnapshot=<DateTime>	HTTP/1.1

Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt följande:

Sökvägskomponent	Description
myaccount	Namnet på ditt lagringskonto.
myshare	Namnet på filresursen.

Information om namngivningsbegränsningar för sökväg finns i Namn och referensresurser, kataloger, filer och metadata.

URI-parametrar

Följande ytterligare parametrar kan anges i begärande-URI:n:

Parameter	Beskrivning
sharesnapshot	Valfritt. Version 2017-04-17 och senare. Parametern sharesnapshot är ett ogenomskinliga datum-/tidsvärde som när det finns anger resursögonblicksbilden för att fråga för att hämta egenskaperna.
timeout	Valfritt. Tidsgränsparametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files åtgärder.

Begärandehuvuden

De obligatoriska och valfria rubrikerna beskrivs i följande tabell:

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 Coordinated Universal Time (UTC) 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-client-request-id	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. 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 Files.
x-ms-lease-id:<ID>	Valfritt. Version 2020-02-10 och senare. Om rubriken anges utförs åtgärden endast om filresursens lån för närvarande är aktivt och låne-ID:t som anges i begäran matchar filresursens låne-ID. Om det inte finns någon matchning misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades).

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskoden 200 (OK).

Mer 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 HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik	Description
Last-Modified	Returnerar datum och tid när resursen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representation of Date-Time Values in Headers (Representation av Date-Time-värden i sidhuvuden). Alla åtgärder som ändrar resursen eller dess egenskaper uppdaterar den senaste ändrade tiden. Åtgärder på filer påverkar inte resursens senast ändrade tid.
x-ms-meta-name:value	En uppsättning namn/värde-par som innehåller användardefinierade metadata för resursen.
ETag	Innehåller ett värde som du kan använda för att utföra åtgärder villkorligt. Värdet omges av citattecken.
x-ms-request-id	Identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version	Den Azure Files version som användes för att köra begäran.
Date	Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades.
x-ms-share-quota	Version 2015-02-21 och senare. Returnerar den aktuella resurskvoten i gibibyte (GiB).
x-ms-share-provisioned-iops	Version 2019-07-07 och senare. Returneras endast för Premium-filresurser (filresurser inom lagringskontotypen FileStorage). Returnerar antalet indata-/utdataåtgärder per sekund (IOPS) som etablerats för premiumresursen.
x-ms-share-provisioned-ingress-mbps	Version 2019-07-07 och senare. Returneras endast för Premium-filresurser (filresurser inom lagringskontotypen FileStorage). Returnerar ingressen i mebibyte per sekund (MiB/s), som etablerats för premiumresursen.
x-ms-share-provisioned-egress-mbps	Version 2019-07-07 och senare. Returneras endast för Premium-filresurser (filresurser inom lagringskontotypen FileStorage). Returnerar utgående i MiB/s, som etablerats för premiumresursen.
x-ms-share-provisioned-bandwidth-mibps	Version 2021-02-12 och senare. Returneras endast för Premium-filresurser (filresurser inom lagringskontotypen FileStorage). Returnerar den kombinerade bandbredden (ingress + utgående) i MiB/s, som etablerats för premiumresursen.
x-ms-share-next-allowed-quota-downgrade-time	Version 2019-07-07 och senare. Returneras endast för Premium-filresurser (filresurser inom lagringskontotypen FileStorage). Ett datum/tid-värde som anger när kvoten för premiumfilresursen tillåts minskas. Datumformatet följer RFC 1123.
x-ms-access-tier	Version 2019-12-12 och senare. Returnerar resursens aktuella åtkomstnivå. I GPv2-lagringskonton TransationOptimized (generell användning version 2) är standardnivån för resursen. I FilLagringslagringskontotyper Premium är standardnivån för resursen.
x-ms-access-tier-change-time	Version 2019-12-12 och senare. Returnerar datum och tid när åtkomstnivån på resursen senast ändrades.
x-ms-access-tier-transition-state	Version 2019-12-12 och senare. Om resursen genomgår nivåövergång anger det här huvudet den nivå som den övergår från.
x-ms-lease-duration:<fixed,infinite>	Version 2020-02-10 och senare. Anger om lånet för en resurs har obegränsad eller fast varaktighet.
x-ms-lease-state: <available;leased;expired;breaking;broken>	Version 2020-02-10 och senare. När en resurs leasas anger den här rubriken lånetillståndet för resursen.
x-ms-lease-status: <locked;unlocked>	Version 2020-02-10 och senare. När en resurs leasas anger den här rubriken lånestatus för resursen.
x-ms-enabled-protocols: <SMB;NFS>	Returnerar de aktuella resursaktiverade protokollen för version 2019-07-07 och senare. - SMB: Resursen kan nås av SMBv3.0, SMBv2.1 och REST. - NFS: Resursen kan nås av NFSv4.1.
x-ms-root-squash: <NoRootSquash;RootSquash;AllSquash>	Returnerar den aktuella resursens rot squashing-beteende för version 2019-07-07 och senare. Endast NFS. - NoRootSquash: Rot squash är av. - RootSquash: Begäranden från UID/GID 0 mappas till det anonyma UID/GID. - AllSquash: Alla användargränssnitt och GID:n mappas till den anonyma användaren.
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 x-ms-client-request-id för huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns i begäran visas den inte i svaret.

Själva svaret

Inga.

Exempelsvar

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-meta-name: some_metadata  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Last-Modified: <date>  
x-ms-share-quota: 1024
x-ms-access-tier: Premium
x-ms-version: 2020-02-10  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

Auktorisering

Endast kontoägaren kan anropa den här åtgärden.

Kommentarer

Inga.

Se även

Åtgärder på Azure-filresurser