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).