Megosztási statisztikák lekérése
A Get Share Stats kérelem lekéri a megosztáshoz kapcsolódó statisztikákat. Bár ez az API teljes mértékben támogatott, örökölt felügyeleti API. Ezért javasoljuk, hogy inkább a Fájlmegosztások – Get fájlt használja, amelyet a tárerőforrás-szolgáltató (Microsoft.Storage) biztosít.
Ha többet szeretne megtudni arról, hogyan használhatja FileShare programozott módon az erőforrásokat a tárolóerőforrás-szolgáltató használatával, olvassa el a Műveletek Azure Files megosztásokon című témakört.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Elérhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A Get Share Stats kérelem a következőképpen hozható létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount nevet a tárfiók nevére, és cserélje le a saját megosztást a megosztás nevére.
| Metódus | Kérés URI-ja | HTTP-verzió |
|---|---|---|
| GET | https://myaccount.file.core.windows.net/myshare?restype=share&comp=stats |
HTTP/1.1 |
URI-paraméterek
A kérelem URI-jában a következő további paraméterek adhatók meg:
| Paraméter | Leírás |
|---|---|
timeout |
Választható. Az időtúllépési paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Azure Files műveletekhez. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázatban ismertetjük:
| Kérelem fejléce | Leírás |
|---|---|
Authorization |
Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba. |
Date vagy x-ms-date |
Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérések engedélyezése az Azure Storage-ba. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. 2015-02-21-es és újabb verzió. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-client-request-id |
Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Monitorozási Azure Files. |
x-ms-lease-id:<ID> |
Választható. 2020-02-10-es és újabb verzió. Ha a fejléc meg van adva, a művelet csak akkor lesz végrehajtva, ha a fájlmegosztás bérlete jelenleg aktív, és a kérelemben megadott bérletazonosító megegyezik a fájlmegosztás bérletazonosítójával. Ha nincs egyezés, a művelet a 412-s állapotkóddal hiúsul meg (az előfeltétel sikertelen). |
A kérés törzse
Nincsenek.
Reagálás
A válasz tartalmazza a és a HTTP-állapotkódot, a válaszfejlécek készletét és a válasz törzsét.
Állapotkód
A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.
Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.
| Válaszfejléc | Description |
|---|---|
Last-Modified |
A megosztás utolsó módosításának dátumát és időpontját adja vissza. A dátumformátum az RFC 1123-at követi. További információ: Dátum-/időértékek ábrázolása fejlécekben. Minden olyan művelet, amely módosítja a megosztást vagy annak tulajdonságait, az utolsó módosítás időpontját frissíti. A fájlokon végzett műveletek nem befolyásolják a megosztás utolsó módosításának időpontját. |
ETag |
Olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. Az érték idézőjelek közé kerül. |
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A kérés végrehajtásához használt Azure Files verziót jelzi. |
Date |
A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. |
x-ms-client-request-id |
A kérések és a hozzájuk tartozó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban. |
Választörzs
A válasz törzsének formátuma a következő:
<?xml version="1.0" encoding="utf-8"?>
<ShareStats>
<ShareUsageBytes>8189134192</ShareUsageBytes>
</ShareStats>
| Elem | Leírás |
|---|---|
ShareUsageBytes |
A megosztáson tárolt adatok hozzávetőleges mérete. Vegye figyelembe, hogy ez az érték nem feltétlenül tartalmazza az összes nemrég létrehozott vagy nemrég átméretezett fájlt. |
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
A megosztási pillanatképek statisztikái nem kérhetők le. Ha megkísérlik lekérni a megosztás pillanatkép-statisztikáját, a szolgáltatás a 400-ás állapotkódot adja vissza (érvénytelen lekérdezési paraméterérték).
A 2018-11-09-es verziótól a válasz elemet a ShareUsage következőre cserélték: ShareUsageBytes.
ShareUsage a megosztáson tárolt adatok hozzávetőleges mérete, felfelé kerekítve a legközelebbi gibibyte-ra (GiB).