Freigabestatistiken abrufen
Die Get Share Stats Anforderung ruft Statistiken ab, die sich auf die Freigabe beziehen. Obwohl diese API vollständig unterstützt wird, handelt es sich um eine Legacyverwaltungs-API. Aus diesem Grund wird empfohlen, stattdessen Dateifreigaben – Abrufen zu verwenden, die vom Speicherressourcenanbieter (Microsoft.Storage) bereitgestellt wird.
Weitere Informationen zur programmgesteuerten Interaktion mit FileShare Ressourcen mithilfe des Speicherressourcenanbieters finden Sie unter Vorgänge auf Azure Files Freigaben.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |
|
| NFS |
|
Anforderung
Die Get Share Stats-Anforderung kann wie folgt erstellt werden. Es wird empfohlen, HTTPS zu verwenden. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos, und ersetzen Sie myshare durch den Namen Ihrer Freigabe.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| GET | https://myaccount.file.core.windows.net/myshare?restype=share&comp=stats |
HTTP/1.1 |
URI-Parameter
Die folgenden zusätzlichen Parameter können im Anforderungs-URI angegeben werden:
| Parameter | BESCHREIBUNG |
|---|---|
timeout |
Optional. Der timeout-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files Vorgänge. |
Anforderungsheader
Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle beschrieben:
| Anforderungsheader | BESCHREIBUNG |
|---|---|
Authorization |
Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
Date oder x-ms-date |
Erforderlich. Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
x-ms-version |
Erforderlich für alle autorisierten Anforderungen. Version 2015-02-21 und höher. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste. |
x-ms-client-request-id |
Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen Azure Files. |
x-ms-lease-id:<ID> |
Optional. Version 2020-02-10 und höher. Wenn der Header angegeben ist, wird der Vorgang nur ausgeführt, wenn die Lease der Dateifreigabe derzeit aktiv ist und die in der Anforderung angegebene Lease-ID mit der Lease-ID der Dateifreigabe übereinstimmt. Wenn keine Übereinstimmung vorliegt, schlägt der Vorgang mit status Code 412 (Vorbedingungsfehler) fehl. |
Anforderungstext
Keine.
Antwort
Die Antwort enthält einen HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.
Statuscode
Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.
Informationen zu status Codes finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann auch zusätzliche HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
| Antwortheader | BESCHREIBUNG |
|---|---|
Last-Modified |
Gibt das Datum und die Uhrzeit der letzten Änderung der Freigabe zurück. Das Datumsformat entspricht RFC 1123. Weitere Informationen finden Sie unter Darstellen von Datums-/Uhrzeitwerten in Headern. Bei jedem Vorgang, durch den die Freigabe oder deren Eigenschaften geändert werden, wird der Zeitpunkt der letzten Änderung aktualisiert. Vorgänge für Dateien haben keine Auswirkung auf den Zeitpunkt der letzten Änderung der Freigabe. |
ETag |
Enthält einen Wert, den Sie zum bedingten Ausführen von Vorgängen verwenden können. Der Wert wird in Anführungszeichen eingeschlossen. |
x-ms-request-id |
Identifiziert eindeutig die Anforderung, die gestellt wurde, und kann zur Problembehandlung für die Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge. |
x-ms-version |
Gibt die Azure Files Version an, die zum Ausführen der Anforderung verwendet wurde. |
Date |
Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der den Zeitpunkt angibt, zu dem die Antwort initiiert wurde. |
x-ms-client-request-id |
Kann zur Problembehandlung von Anforderungen und deren entsprechenden Antworten verwendet werden. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der x-ms-client-request-id Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden. |
Antworttext
Der Antworttext weist das folgende Format auf:
<?xml version="1.0" encoding="utf-8"?>
<ShareStats>
<ShareUsageBytes>8189134192</ShareUsageBytes>
</ShareStats>
| Element | BESCHREIBUNG |
|---|---|
ShareUsageBytes |
Die ungefähre Größe der in der Freigabe gespeicherten Daten. Beachten Sie, dass dieser Wert möglicherweise nicht alle kürzlich erstellten oder kürzlich geänderten Dateien enthält. |
Authorization
Dieser Vorgang kann nur vom Kontobesitzer aufgerufen werden.
Hinweise
Statistiken für eine Freigabe Momentaufnahme können nicht abgerufen werden. Wenn versucht wird, die Freigabe Momentaufnahme Statistiken abzurufen, gibt der Dienst status Code 400 (Ungültiger Abfrageparameterwert) zurück.
Ab Version 2018-11-09 wurde das ShareUsage Response-Element durch ShareUsageBytesersetzt.
ShareUsage ist die ungefähre Größe der Daten, die auf der Freigabe gespeichert sind, aufgerundet auf das nächste Gibibyte (GiB).