Hämta resursstatistik

Begäran Get Share Stats hämtar statistik som är relaterad till resursen. Ä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å Azure Files resurser.

Protokolltillgänglighet

Aktiverat filresursprotokoll	Tillgängligt
SMB
NFS

Förfrågan

Begäran Get Share Stats kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto och ersätt myshare med namnet på din resurs.

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

URI-parametrar

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

Parameter	Beskrivning
timeout	Valfritt. Timeout-parametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files åtgärder.

Begärandehuvuden

De obligatoriska och valfria begärandehuvudena 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. Version 2015-02-21 och senare. 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 loggning 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 det låne-ID som anges i begäran matchar låne-ID:t för filresursen. 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 http-statuskod, en uppsättning svarshuvuden och en svarstext.

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

Svarsrubrik	Description
Last-Modified	Returnerar datum och tid då resursen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum-/tidsvärden i rubriker. Alla åtgärder som ändrar resursen eller dess egenskaper uppdaterar den senaste ändringstiden. Åtgärder på filer påverkar inte den senaste ändringstiden 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 den begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version	Anger den Azure Files version som användes för att köra begäran.
Date	Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades.
x-ms-client-request-id	Kan användas för att felsöka begäranden och deras motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret.

Själva svaret

Formatet på svarstexten är följande:

<?xml version="1.0" encoding="utf-8"?>  
<ShareStats>  
   <ShareUsageBytes>8189134192</ShareUsageBytes>  
</ShareStats>  

Element	Beskrivning
ShareUsageBytes	Den ungefärliga storleken på data som lagras på resursen. Observera att det här värdet kanske inte innehåller alla nyligen skapade eller nyligen ändrad storlek.

Auktorisering

Endast kontoinnehavaren kan anropa den här åtgärden.

Kommentarer

Det går inte att hämta statistik för en resursögonblicksbild. Om ett försök görs att hämta statistik för resursögonblicksbilder returnerar tjänsten statuskod 400 (ogiltigt frågeparametervärde).

Från och med version 2018-11-09 ShareUsage ersattes svarselementet med ShareUsageBytes. ShareUsage är den ungefärliga storleken på de data som lagras på resursen, avrundade uppåt till närmaste gibibyte (GiB).

Se även

Åtgärder på Azure-filresurser