Blob szolgáltatásstatisztikák lekérése

  • Cikk

A Get Blob Service Stats művelet lekéri a Azure Blob Storage replikációval kapcsolatos statisztikáit. A művelet csak a másodlagos hely végpontján érhető el, ha az olvasási hozzáférés georedundáns replikációja engedélyezve van a tárfiókban.

Kérés

A kérést az Get Blob Service Stats alábbiak szerint hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le myaccount a elemet a tárfiók nevére, és vegye figyelembe, hogy az -secondary utótag megadása kötelező:

Metódus Kérés URI-ja HTTP-verzió
GET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

Megjegyzés

Az URI-nak mindig tartalmaznia kell egy perjelet (/), hogy elkülönítse a gazdagép nevét az elérési úttól és a lekérdezési részektől. Ebben a műveletben az URI elérési útja üres.

URI-paraméterek

A kérelem URI-ján a következő további paramétereket adhatja meg:

Paraméter Leírás
Timeout Választható. A timeout paraméter másodpercben van kifejezve.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

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érelmek engedélyezése az Azure Storage-ba.
Date or 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érelmek engedélyezése az Azure Storage-ba.
x-ms-version Minden engedélyezett kéréshez szükséges. A kérelemhez használandó 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 kibibyte (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ó: Azure Blob Storage figyelése.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset

Állapotkód

A sikeres művelet a 200 -os állapotkódot adja vissza (OK). Ha egy műveletet olyan másodlagos helyvégponton hívnak meg, amely nincs engedélyezve másodlagos olvasáshoz, a 403-at tartalmazó HTTP-állapotkódot adja vissza hibával InsufficientAccountPermissions .

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 tartalmaz. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc Description
x-ms-request-id Egyedileg azonosítja a végrehajtott kérést, és segítségével elháríthatja a kérést. További információ: API-műveletek hibaelhárítása.
x-ms-version A válaszhoz használt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
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ó. Ennek a fejlécnek az értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, és legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor ez a fejléc nem szerepel a válaszban.

Választörzs

A válasz törzsének formátuma a következő:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>        
      <Status>live|bootstrap|unavailable</Status>  
      <LastSyncTime>sync-time|<empty></LastSyncTime>  
  </GeoReplication>  
</StorageServiceStats>

A válasz törzsének elemeit a következő táblázat ismerteti:

Válaszfejléc Description
Status A másodlagos hely állapota. Lehetséges értékek:

- live: Azt jelzi, hogy a másodlagos hely aktív és működőképes.
- bootstrap: Azt jelzi, hogy az elsődleges helyről a másodlagos helyre történő kezdeti szinkronizálás folyamatban van. Ez általában akkor fordul elő, ha a replikáció először engedélyezve van.
- nem érhető el: Azt jelzi, hogy a másodlagos hely átmenetileg nem érhető el.
LastSyncTime Egy GMT dátum/idő érték, a másodikig. Az ezt az értéket megelőző összes elsődleges írás garantáltan elérhető lesz a másodlagos olvasási műveletekhez. Előfordulhat, hogy az elsődleges írások ezt az időpontot követően nem érhetők el olvasásra.

Az érték üres lehet, ha LastSyncTime nem érhető el. Ez akkor fordulhat elő, ha a replikáció állapota bootstrap vagy unavailable.

Bár a georeplikáció folyamatosan engedélyezve van, az LastSyncTime eredmény a szolgáltatás gyorsítótárazott értékét tükrözheti, amely néhány percenként frissül.

Engedélyezés

Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Get Blob Service Stats alábbiak szerint engedélyezheti.

Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatásra irányuló kérések engedélyezésére használható.

További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobokhoz való hozzáférés engedélyezése Microsoft Entra ID használatával.

Engedélyek

Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport vagy szolgáltatásnév meghívja a Get Blob Service Stats műveletet, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

A szerepkörök Azure RBAC-vel való hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

Megjegyzések

A georedundáns replikációval az Azure Storage két helyen, több száz mérföldnyi távolságban őrzi meg az adatokat. Az Azure Storage mindkét helyen folyamatosan fenntartja az adatok több kifogástalan állapotú replikáját.

A georedundáns párok a következőket tartalmazzák:

  • Elsődleges hely: Az a hely, ahol adatokat olvas, hoz létre, frissít vagy töröl. Az elsődleges hely abban a régióban található, amelyet akkor választ, amikor a klasszikus Azure portálon (például az USA északi középső régióján) keresztül hoz létre fiókot.

  • Másodlagos hely: Az a hely, ahová az adatok replikálva lesznek. A másodlagos hely egy olyan régióban található, amely automatikusan földrajzilag párosítva van az elsődleges régióval. A csak olvasható hozzáférés akkor érhető el a másodlagos helyről, ha az olvasási hozzáférés georedundáns replikációja engedélyezve van a tárfiókhoz. További információ az olvasási hozzáférés georedundáns replikációjáról: Adatredundancia.

Az adatok olvasási, létrehozási, frissítési vagy törlési helye az elsődleges tárfiók helye. Az elsődleges hely abban a régióban található, amelyben a fiók létrehozásakor a klasszikus Azure-beli Azure-portálon (például az USA északi középső régióján) keresztül hoz létre fiókot. Az adatok replikálásának helye a másodlagos hely. A másodlagos hely egy olyan régióban található, amely automatikusan földrajzilag párosítva van az elsődleges régióval. Az írásvédett hozzáférés a másodlagos helyről érhető el, ha az olvasási hozzáférés georedundáns replikációja engedélyezve van a tárfiókban. További információ az olvasási hozzáférés georedundáns replikációjáról: Adatredundancia.

Ha olvasási műveletre vonatkozó kérést szeretne létrehozni a másodlagos végponton, fűzze hozzá -secondary a blobtárolóból olvasáshoz használt URI-fiók nevét. A Blob lekérése művelet másodlagos URI-ja például a következőhöz https://myaccount-secondary.blob.core.windows.net/mycontainer/myblobhasonló lesz: .

Számlázás

A díjszabási kérések a Blob Storage API-kat használó ügyfelektől, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból származhatnak. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérelmek számlázási kategóriáját Get Blob Service Stats mutatja be:

Művelet Tárfiók típusa Számlázási kategória
Blob Service-statisztikák lekérése Prémium szintű blokkblob
Standard általános célú v2		 Egyéb műveletek
Blob Service-statisztikák lekérése Standard általános célú v1 Olvasási műveletek

A megadott számlázási kategória díjszabásával kapcsolatos további információkért lásd: Azure Blob Storage Díjszabás.

Mintakérés és válasz

Íme egy mintakérés a Get Blob Service Stats művelethez:

GET http://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

A kérést a rendszer a következő fejlécekkel küldi el:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=

Az állapotkód és a válaszfejlécek a következőképpen lesznek visszaadva:

HTTP/1.1 200 OK  
Content-Type: application/xml  
Date: Wed, 23 Oct 2013 22:08:54 GMT  
x-ms-version: 2013-08-15  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

A válasz a következő XML-törzset tartalmazza:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>  
      <Status>live</Status>  
      <LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>        
  </GeoReplication>  
</StorageServiceStats>

Lásd még

A fiók műveletei (Blob Storage)