Kuyruk Hizmeti Özelliklerini Alma
İşlem, Get Queue Service Properties
Depolama Analizi ve çıkış noktaları arası kaynak paylaşımı (CORS) kurallarının özellikleri de dahil olmak üzere bir Azure Kuyruk Depolama hesabının özelliklerini alır.
Çıkış noktaları arası kaynak paylaşımı (CORS) kuralları ve değerlendirme mantığı hakkında daha fazla bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.
İstek
İstek Get Queue Service Properties
aşağıdaki gibi belirtilebilir. HTTPS kullanmanızı öneririz. account-name> değerini depolama hesabınızın adıyla değiştirin<:
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
GET | https://<account-name>.queue.core.windows.net/?restype=service&comp=properties |
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 |
---|---|
restype=service&comp=properties |
Gereklidir. Depolama hizmeti özelliklerini almak için her iki sorgu dizesinin birleşimi gerekir. |
timeout |
İsteğe bağlı.
timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Kuyruk Depolama işlemleri için zaman aşımlarını ayarlama. |
İ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, depolama hesabı adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme. |
Date veya 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'ya istekleri 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 kibibayt (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, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
Yanıt üst bilgisi | Description |
---|---|
x-ms-request-id |
Hizmette yapılan bir isteği benzersiz olarak tanımlar. |
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. |
x-ms-client-request-id |
İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa 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. İstekte x-ms-client-request-id üst bilgi yoksa yanıtta bulunmaz. |
Yanıt gövdesi
Sürüm 2012-02-12 ve öncesi için yanıt gövdesinin biçimi aşağıdaki gibidir:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>version-number</Version>
<Delete>true|false</Delete>
<Read>true|false</Read>
<Write>true|false</Write>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Logging>
<Metrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Metrics>
</StorageServiceProperties>
Sürüm 2013-08-15 itibarıyla yanıt gövdesinin biçimi aşağıdaki gibidir:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>version-number</Version>
<Delete>true|false</Delete>
<Read>true|false</Read>
<Write>true|false</Write>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Logging>
<HourMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</HourMetrics>
<MinuteMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</MinuteMetrics>
<Cors>
<CorsRule>
<AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
<AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>
</CorsRule>
</Cors>
</StorageServiceProperties>
Yanıt gövdesinin öğeleri aşağıdaki tabloda açıklanmıştır:
Öğe Adı | Description |
---|---|
Günlüğe kaydetme | Depolama Analizi Günlüğü ayarlarını gruplandırın. |
Ölçümler | Depolama Analizi Ölçümleri ayarlarını gruplandırın. Ölçüm ayarları, kuyruklar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar. |
HourMetrics | Depolama Analizi HourMetrics ayarlarını gruplandırın. HourMetrics ayarları, kuyruklar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar. |
MinuteMetrics | Depolama Analizi MinuteMetrics* ayarlarını gruplandırın. MinuteMetrics ayarları kuyruklar için her dakika için istek istatistikleri sağlar. |
Sürüm | Şu anda kullanımda olan Depolama Analizi sürümü. |
Silme | Yalnızca günlük yapılandırması için geçerlidir. Silme isteklerinin günlüğe kaydedilip kaydedilmediğini gösterir. |
Read | Yalnızca günlük yapılandırması için geçerlidir. Okuma isteklerinin günlüğe kaydedilip kaydedilmediğini gösterir. |
Write | Yalnızca günlük yapılandırması için geçerlidir. Yazma isteklerinin günlüğe kaydedilip kaydedilmediğini gösterir. |
Etkin | Ölçümlerin Azure Kuyruk Depolama için etkinleştirilip etkinleştirilmediğini gösterir. Okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, hem birincil hem de ikincil ölçümler toplanır. Okuma erişimli coğrafi olarak yedekli çoğaltma etkin değilse, yalnızca birincil ölçümler toplanır. |
IncludeAPI'ler | Yalnızca ölçüm yapılandırması için geçerlidir. Ölçümlerin çağrılan API işlemleri için özet istatistikleri oluşturup oluşturmadığını gösterir. |
RetentionPolicy/Etkin | Depolama hizmeti için bir bekletme ilkesinin etkinleştirilip etkinleştirilmediğini gösterir. |
RetentionPolicy/Gün | Ölçümlerin veya günlük verilerinin tutulduğunu gün sayısını gösterir. Bu değerden daha eski olan tüm veriler silinir. |
Cors | Tüm CORS kurallarını gruplandırma. |
CorsRule | CORS kuralı için grup ayarları. |
AllowedOrigins | CORS aracılığıyla izin verilen kaynak etki alanlarının virgülle ayrılmış listesi veya tüm etki alanlarına izin veriliyorsa yıldız işareti (*) . |
ExposedHeaders | CORS istemcilerinin kullanıma sunmasına yönelik yanıt üst bilgilerinin virgülle ayrılmış listesi. |
MaxAgeInSeconds | İstemcinin veya tarayıcının denetim öncesi yanıtını önbelleğe alması gereken saniye sayısı. |
AllowedHeaders | Çıkış noktaları arası isteğin parçası olmasına izin verilen üst bilgilerin virgülle ayrılmış listesi. |
AllowedMethods | Kaynak tarafından yürütülmesine izin verilen HTTP yöntemlerinin virgülle ayrılmış listesi. Azure Depolama için izin verilen yöntemler DELETE, GET, HEAD, MERGE, POST, OPTIONS veya PUT yöntemleridir. |
Yetkilendirme
Bu işlemi yalnızca depolama hesabı sahibi çağırabilir.
Örnek istek ve yanıt
Aşağıdaki örnek URI , myaccount adlı kurgusal depolama hesabının Kuyruk hizmeti özelliklerini alma isteğinde bulunur:
GET https://myaccount.queue.core.windows.net/?restype=service&comp=properties HTTP/1.1
İstek aşağıdaki üst bilgilerle gönderilir:
x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 04:49:03 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.queue.core.windows.net
İstek gönderildikten sonra aşağıdaki yanıt döndürülür:
HTTP/1.1 200 OK
Content-Length: 1020
Content-Type: application/xml
Date: Wed, 23 Oct 2013 04:49:04 GMT
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2013-08-15
Yanıt gövdesi aşağıdakine benzer:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>1.0</Version>
<Delete>true</Delete>
<Read>false</Read>
<Write>true</Write>
<RetentionPolicy>
<Enabled>true</Enabled>
<Days>7</Days>
</RetentionPolicy>
</Logging>
<HourMetrics>
<Version>1.0</Version>
<Enabled>true</Enabled>
<IncludeAPIs>false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true</Enabled>
<Days>7</Days>
</RetentionPolicy>
</HourMetrics>
<MinuteMetrics>
<Version>1.0</Version>
<Enabled>true</Enabled>
<IncludeAPIs>true</IncludeAPIs>
<RetentionPolicy>
<Enabled>true</Enabled>
<Days>7</Days>
</RetentionPolicy>
</MinuteMetrics>
<Cors>
<CorsRule>
<AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>
<AllowedMethods>GET,PUT</AllowedMethods>
<MaxAgeInSeconds>500</MaxAgeInSeconds>
<ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>
<AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>
</CorsRule>
</Cors>
</StorageServiceProperties>
Ayrıca bkz.
Depolama Analizi
Azure Depolama hizmetleri için CORS desteği
CORS HTTP belirtimi