Aracılığıyla paylaş

Blob Hizmeti İstatistiklerini Alma

  • Makale

İşlem, Get Blob Service Stats Azure Blob Depolama için çoğaltmayla ilgili istatistikleri alır. İşlem yalnızca depolama hesabı için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde ikincil konum uç noktasında kullanılabilir.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Get Blob Service Stats . HTTPS kullanmanızı öneririz. değerini depolama hesabınızın adıyla değiştirin myaccount ve son ekin -secondary gerekli olduğuna dikkat edin:

Yöntem İstek URI'si HTTP sürümü
GET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

Not

Ana bilgisayar adını yol ve sorgu bölümlerinden ayırmak için URI her zaman eğik çizgi (/) içermelidir. Bu işlem söz konusu olduğunda, URI'nin yol kısmı boş olur.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz:

Parametre Açıklama
Timeout İsteğe bağlı. timeout parametresi saniye cinsinden ifade edilir.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek üst bilgisi Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
Date or x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
x-ms-version Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-client-request-id İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Blob Depolama.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir

Durum kodu

Başarılı bir işlem 200 (Tamam) durum kodunu döndürür. İkincil okuma için etkinleştirilmemiş bir ikincil konum uç noktasında bir işlem çağrıldığında, hata içeren InsufficientAccountPermissions 403 HTTP durum kodunu döndürür.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ayrıca ek standart HTTP üst bilgileri içerir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Description
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
x-ms-version Yanıt için kullanılan işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
x-ms-client-request-id İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa üst bilginin değerine x-ms-client-request-id ve görünür ASCII karakter sayısı 1.024'ten fazla değilse değere eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi yoktur.

Yanıt gövdesi

Yanıt gövdesinin biçimi aşağıdaki gibidir:

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

Yanıt gövdesinin öğeleri aşağıdaki tabloda açıklanmıştır:

Yanıt üst bilgisi Description
Status İkincil konumun durumu. Olası değerler şunlardır:

- live: İkincil konumun etkin ve çalışır durumda olduğunu gösterir.
- bootstrap: Birincil konumdan ikincil konuma ilk eşitlemenin devam ettiğini gösterir. Bu genellikle çoğaltma ilk etkinleştirildiğinde oluşur.
- kullanılamıyor: İkincil konumun geçici olarak kullanılamadığını gösterir.
LastSyncTime İkinciye kadar bir GMT tarih/saat değeri. Bu değerden önce gelen tüm birincil yazma işlemlerinin ikincilde okuma işlemleri için kullanılabilir olması garanti edilir. Bu noktadan sonra yapılan birincil yazma işlemleri okuma için kullanılabilir veya kullanılamayabilir.

Değer kullanılamıyorsa LastSyncTime boş olabilir. Çoğaltma durumu veya unavailableolduğunda bu bootstrap durum oluşabilir.

Coğrafi çoğaltma sürekli olarak etkin olsa da, LastSyncTime sonuç hizmetten önbelleğe alınmış bir değeri yansıtabilir ve bu değer birkaç dakikada bir yenilenir.

Yetkilendirme

Azure Depolama'da herhangi bir veri erişimi işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Get Blob Service Stats verebilirsiniz.

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra ID kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra ID kullanılmasını destekler. Microsoft Entra ID ile Azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak güvenlik sorumlusuna izinler verilmektedir. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. Güvenlik sorumlusunun kimliği, OAuth 2.0 belirtecini döndürmek için Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra ID kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz. Microsoft Entra ID kullanarak bloblara erişimi yetkilendirme.

İzinler

Aşağıda, Microsoft Entra kullanıcı, grup, yönetilen kimlik veya hizmet sorumlusunun işlemi çağırması Get Blob Service Stats için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Açıklamalar

Coğrafi olarak yedekli çoğaltma sayesinde Azure Depolama, verilerinizi birbirinden yüzlerce mil uzakta olan iki konumda durağan bir şekilde tutar. Her iki konumda da Azure Depolama sürekli olarak verilerinizin birden çok iyi durumdaki çoğaltmasını korur.

Coğrafi olarak yedekli çift şunları içerir:

  • Birincil konum: Verileri okuduğunuz, oluşturduğunuz, güncelleştirdiğiniz veya sildiğiniz konum. Birincil konum, klasik Azure portalı (örneğin, Orta Kuzey ABD) aracılığıyla bir hesap oluştururken seçtiğiniz bölgede bulunur.

  • İkincil konum: Verilerinizin çoğaltıldığı konum. İkincil konum, coğrafi olarak birincil bölgeyle otomatik olarak eşleştirilmiş bir bölgede bulunur. Depolama hesabınız için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, ikincil konumdan salt okunur erişim kullanılabilir. Okuma erişimli coğrafi olarak yedekli çoğaltma hakkında daha fazla bilgi için bkz. Veri yedekliliği.

Verileri okuduğunuz, oluşturduğunuz, güncelleştirdiğiniz veya sildiğiniz konum birincil depolama hesabı konumudur. Birincil konum, Azure Yönetimi Klasik Azure portalı aracılığıyla hesap oluştururken seçtiğiniz bölgede (örneğin, Orta Kuzey ABD) bulunur. Verilerinizin çoğaltıldığı konum ikincil konumdur. İkincil konum, birincil bölgeyle otomatik olarak coğrafi olarak eşleştirilmiş bir bölgede bulunur. Depolama hesabınız için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, ikincil konumdan salt okunur erişim kullanılabilir. Okuma erişimli coğrafi olarak yedekli çoğaltma hakkında daha fazla ayrıntı için bkz. Veri yedekliliği.

İkincil uç noktaya yönelik bir okuma işlemi isteği oluşturmak için, Blob Depolama'dan okumak için kullandığınız URI'de hesap adına ekleyin -secondary . Örneğin, Blob Alma işlemi için ikincil bir URI ile benzer https://myaccount-secondary.blob.core.windows.net/mycontainer/myblobolacaktır.

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Get Blob Service Stats faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Blob Hizmeti İstatistiklerini Alma Premium blok blobu
Standart genel amaçlı v2		 Diğer işlemler
Blob Hizmeti İstatistiklerini Alma Standart genel amaçlı v1 Okuma işlemleri

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. fiyatlandırma Azure Blob Depolama.

Örnek istek ve yanıt

İşlem için örnek bir istek aşağıda verilmiştir Get Blob Service Stats :

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

İstek aşağıdaki üst bilgilerle gönderilir:

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

Durum kodu ve yanıt üst bilgileri aşağıdaki gibi döndürülür:

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

Yanıt aşağıdaki XML gövdesini içerir:

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

Ayrıca bkz.

Hesap üzerindeki işlemler (Blob Depolama)