Získání statistik služby Blob Service

  • Článek

Operace Get Blob Service Stats načte statistiky související s replikací pro Azure Blob Storage. Operace je k dispozici pouze v sekundárním koncovém bodu umístění, pokud je pro účet úložiště povolená geograficky redundantní replikace s přístupem pro čtení.

Žádost

Požadavek můžete vytvořit Get Blob Service Stats následujícím způsobem. Doporučujeme použít https. Nahraďte myaccount názvem vašeho účtu úložiště a všimněte si, že -secondary přípona je povinná:

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

Poznámka

Identifikátor URI musí vždy obsahovat lomítko (/), aby se název hostitele oddělil od částí cesty a dotazu. V případě této operace je část cesty identifikátoru URI prázdná.

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametry:

Parametr Popis
Timeout Nepovinný parametr. Parametr timeout je vyjádřen v sekundách.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date or x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Blob Storage.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK). Při volání operace v sekundárním koncovém bodu umístění, který není povolený pro sekundární čtení, vrátí stavový kód HTTP 403 s chybou InsufficientAccountPermissions .

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď obsahuje také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Description
x-ms-request-id Jedinečně identifikuje požadavek, který byl proveden, a můžete ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Určuje verzi operace, která se použije pro odpověď. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a jejich odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota ne více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, není tato hlavička v odpovědi.

Text odpovědi

Text odpovědi má následující formát:

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

Prvky textu odpovědi jsou popsané v následující tabulce:

Hlavička odpovědi Description
Status Stav sekundárního umístění. Možné hodnoty:

- live: Označuje, že sekundární umístění je aktivní a funkční.
- bootstrap: Označuje, že probíhá počáteční synchronizace z primárního umístění do sekundárního umístění. K tomu obvykle dochází při prvním povolení replikace.
– nedostupné: Označuje, že sekundární umístění je dočasně nedostupné.
LastSyncTime Hodnota data a času GMT na sekundu. U všech primárních zápisů, které předcházejí této hodnotě, je zaručeno, že budou k dispozici pro operace čtení v sekundárním prostředí. Primární zápisy po tomto bodu v čase můžou nebo nemusí být pro čtení k dispozici.

Pokud je hodnota nedostupná, může být prázdná LastSyncTime . K tomu může dojít, pokud je bootstrap stav replikace nebo unavailable.

Přestože je geografická replikace nepřetržitě povolená, LastSyncTime výsledek může odrážet hodnotu uloženou v mezipaměti ze služby, která se aktualizuje každých několik minut.

Autorizace

Při volání jakékoli operace přístupu k datům ve službě Azure Storage se vyžaduje autorizace. Operaci můžete autorizovat, Get Blob Service Stats jak je popsáno níže.

Azure Storage podporuje autorizaci požadavků na data objektů blob pomocí Microsoft Entra ID. S Microsoft Entra ID můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objektem zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Objekt zabezpečení je ověřen Microsoft Entra ID, aby vrátil token OAuth 2.0. Token se pak dá použít k autorizaci požadavku na službu Blob Service.

Další informace o autorizaci pomocí Microsoft Entra ID najdete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny nebo instančního Get Blob Service Stats objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která zahrnuje tuto akci:

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Poznámky

Díky geograficky redundantní replikaci Azure Storage trvale udržuje vaše data ve dvou umístěních, která jsou od sebe vzdálená stovky kilometrů. V obou umístěních Azure Storage neustále udržuje několik replik dat, které jsou v pořádku.

Geograficky redundantní pár zahrnuje:

  • Primární umístění: Umístění, kde čtete, vytváříte, aktualizujete nebo odstraňujete data. Primární umístění existuje v oblasti, kterou zvolíte při vytváření účtu prostřednictvím portálu Azure Classic (například USA – středosever).

  • Sekundární umístění: Umístění, do kterého se data replikují. Sekundární umístění se nachází v oblasti, která je automaticky geograficky spárovaná s primární oblastí. Přístup jen pro čtení je k dispozici ze sekundárního umístění, pokud je pro váš účet úložiště povolená geograficky redundantní replikace s přístupem pro čtení . Další informace o geograficky redundantní replikaci s přístupem pro čtení najdete v tématu Redundance dat.

Umístění, kde čtete, vytváříte, aktualizujete nebo odstraňujete data, je primární umístění účtu úložiště. Primární umístění existuje v oblasti, kterou zvolíte při vytváření účtu prostřednictvím portálu Azure Classic pro správu Azure, například USA – středosever. Umístění, do kterého se data replikují, je sekundární umístění. Sekundární umístění se nachází v oblasti, která je automaticky geograficky spárována s primární oblastí. Přístup jen pro čtení je k dispozici ze sekundárního umístění, pokud je pro váš účet úložiště povolená geograficky redundantní replikace jen pro čtení . Další podrobnosti o geograficky redundantní replikaci s přístupem pro čtení najdete v tématu Redundance dat.

Pokud chcete vytvořit požadavek na operaci čtení vůči sekundárnímu koncovému bodu, připojte -secondary k názvu účtu v identifikátoru URI, který používáte ke čtení ze služby Blob Storage. Například sekundární identifikátor URI pro operaci Get Blob bude podobný jako https://myaccount-secondary.blob.core.windows.net/mycontainer/myblob.

Fakturace

Požadavky na ceny můžou pocházet od klientů, kteří používají rozhraní API služby Blob Storage, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny služby Azure Storage. Za tyto žádosti se účtují poplatky za každou transakci. Typ transakce ovlivňuje způsob účtování za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro Get Blob Service Stats žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Získání statistik služby Blob Service Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Další operace
Získání statistik služby Blob Service Standard pro obecné účely v1 Operace čtení

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Ukázkový požadavek a odpověď

Tady je ukázkový požadavek na Get Blob Service Stats operaci:

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

Požadavek se odešle s následujícími hlavičkami:

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

Hlavičky stavového kódu a odpovědi se vrátí takto:

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

Odpověď obsahuje následující text XML:

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

Viz také

Operace s účtem (Blob Storage)