Kuyruk Hizmeti İstatistiklerini Alma
İşlem, Get Queue Service Stats
Azure Kuyruk Depolama için çoğaltmayla ilgili istatistikleri alır. Depolama hesabı için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde yalnızca ikincil konum uç noktasında kullanılabilir.
İstek
İstek Get Queue Service Stats
aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz.
myaccount değerini depolama hesabınızın adıyla değiştirin ve -secondary soneki gerektiğini unutmayın:
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
GET | https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Not
Ana bilgisayar adını URI'nin yolundan ve sorgu bölümlerinden ayırmak için URI her zaman bir eğik çizgi karakteri (/) içermelidir. Bu işlemde, URI'nin yol kısmı boş.
URI parametreleri
İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:
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. Azure Kuyruk Depolama'yı izleme. |
İ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 çağrıldığında, HTTP durum kodu 403 (Yetersiz Hesap İzinleri) 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 istekle ilgili sorunları gidermek için kullanılabilir. 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 |
Bu üst bilgi, istekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir.
x-ms-client-request-id Üst bilgi istekte yoksa yanıtta bulunmaz. |
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ılamaz: İkincil konumun geçici olarak kullanılamadığını gösterir. |
LastSyncTime |
Saniye olarak UTC tarih/saat değeri. Bu değerden önceki tüm birincil yazma işlemlerinin ikincil yazmada 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 önyüklemeyse veya kullanılamıyorsa bu durum oluşabilir.Coğrafi çoğaltma sürekli olarak etkin olsa da, LastSyncTime sonuç birkaç dakikada bir yenilenen hizmetten önbelleğe alınmış bir değeri yansıtabilir. |
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Coğrafi olarak yedekli çoğaltma sayesinde Azure Depolama verilerinizi iki konumda durağan bir şekilde tutar. Her iki konumda da Azure Depolama sürekli olarak verilerinizin birden çok iyi durumdaki çoğaltmasını tutar.
Verileri okuduğunuz, oluşturduğunuz, güncelleştirdiğiniz veya sildiğiniz konum birincil depolama hesabı konumudur. Birincil konum, Azure Yönetimi Azure klasik portalı (örneğin, Orta Kuzey ABD) aracılığıyla hesap oluşturduğunuzda seçtiğiniz bölgede bulunur.
Verilerinizin çoğaltıldığı konum ikincil konumdur. İ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.
İkincil uç noktaya yönelik bir okuma işlemi isteği oluşturmak için, Kuyruk Depolama'dan okumak için kullandığınız URI'deki hesap adına sonek olarak ekleyin -secondary
. Örneğin, İletileri Özetleme işlemi için ikincil bir URI ile benzerdir https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true
.
Örnek istek ve yanıt
İşlem için örnek bir istek aşağıda verilmiştir Get Queue Service Stats
:
GET http://myaccount-secondary.queue.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-Queue/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>