Kuyruk Hizmeti Özelliklerini Ayarlama

  • Makale

İşlem, Set Queue Service PropertiesDepolama Analizi ve çıkış noktaları arası kaynak paylaşımı (CORS) kurallarının özellikleri de dahil olmak üzere depolama hesabının Kuyruk hizmeti uç noktasının özelliklerini ayarlar. CORS kuralları hakkında daha fazla bilgi için bkz. Depolama Hizmetleri için CORS Desteği.

İstek

İsteği aşağıdaki gibi belirtebilirsiniz Set Queue Service Properties . 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ü
PUT 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

Parametre Açıklama
restype=service&comp=properties Gereklidir. Azure Depolama hizmeti özelliklerini ayarlamak için her iki sorgu dizesinin birleşimi de gereklidir.
timeout İsteğe bağlı. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz . Kuyruk hizmeti işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştı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 isteklerini 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 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

Sürüm 2012-02-12 ve öncesi için istek 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 ve üzeri için istek 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-seperated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>

2013-08-15 sürümünden itibaren, istek gövdesinde belirtilen bir veya daha fazla kök öğeyle çağrı Set Queue Service Properties yapabilirsiniz. Kök öğeler şunlardır:

  • Günlüğe kaydetme
  • HourMetrics
  • MinuteMetrics
  • Cors

artık istekte her kök öğeyi belirtmek gerekli değildir. Bir kök öğeyi atlarsanız, bu işlev için hizmetin mevcut ayarları korunur. Ancak, belirtilen bir kök öğe belirtirseniz, bu öğe için her alt öğeyi belirtmeniz gerekir.

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

Öğe adı Açıklama
Günlüğe kaydetme 2013-08-15 sürümünden itibaren isteğe bağlı. Önceki sürümler için gereklidir. Depolama Analizi Günlüğü ayarlarını gruplandırın.
Ölçümler Sürüm 2012-02-12 ve öncesi için gereklidir. Sürüm 2013-08-15 ve üzeri için geçerli değildir. Depolama Analizi Ölçüm 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 2013-08-15 ve üzeri sürümler için isteğe bağlı. Önceki sürümler için geçerli değildir. 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 2013-08-15 ve üzeri sürümler için isteğe bağlı. Önceki sürümler için geçerli değildir. Depolama Analizi MinuteMetrics ayarlarını gruplandırın. MinuteMetrics ayarları, kuyruklar için her dakika için istek istatistikleri sağlar. 2013-08-15'ten önceki sürümler için MinuteMetrics yanıt gövdesine dahil değildir.
Sürüm Günlük,Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yapılandırılan Depolama Analizi sürümü.
Silme Günlük,Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yalnızca günlük yapılandırması için geçerlidir. Tüm silme isteklerinin günlüğe kaydedilip kaydedilmeyeceğini gösterir.
Read Günlük,Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yalnızca günlük yapılandırması için geçerlidir. Tüm okuma isteklerinin günlüğe kaydedilip kaydedilmeyeceğini gösterir.
Write Günlük,Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yalnızca günlük yapılandırması için geçerlidir. Tüm yazma isteklerinin günlüğe kaydedilip kaydedilmeyeceğini gösterir.
Etkin Gereklidir. Kuyruk hizmeti için ölçümlerin 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 etkinleştirilmediyse yalnızca birincil ölçümler toplanır.
IncludeAPI'ler Yalnızca ölçümler etkinleştirildiğinde gereklidir. 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şturmayacağını gösterir.
RetentionPolicy/Etkin Gereklidir. Depolama hizmeti için bir bekletme ilkesinin etkinleştirilip etkinleştirilmediğini gösterir.
RetentionPolicy/Gün Yalnızca bekletme ilkesi etkinleştirildiğinde gereklidir. Ölçümlerin veya günlük verilerinin saklanması gereken gün sayısını gösterir. Bu değerden daha eski olan tüm veriler silinir. Belirtebileceğiniz en düşük değer , 1maksimum değer ise (bir yıl) olur 365 .
Cors İsteğe bağlı. Cors öğesi sürüm 2013-08-15 ve üzeri için desteklenir. Tüm CORS kurallarını gruplandırma.

Bu öğe grubunun atlanması, mevcut CORS ayarlarının üzerine yazılmaz.
CorsRule İsteğe bağlı. Kuyruk hizmeti için bir CORS kuralı belirtir. İsteğe en fazla beş CorsRule öğesi ekleyebilirsiniz. İstek gövdesine corsrule öğesi eklenmezse, tüm CORS kuralları silinir ve Kuyruk hizmeti için CORS devre dışı bırakılır.
AllowedOrigins CorsRule öğesi varsa gereklidir. CORS aracılığıyla izin verilecek çıkış noktası etki alanlarının virgülle ayrılmış listesi veya tüm etki alanlarına izin vermek için "*". Bir kaynak etki alanı, bir etki alanının tüm alt etki alanları için CORS aracılığıyla isteklere izin vermek için alt etki alanında joker karakter de içerebilir. 64 kaynak etki alanıyla sınırlıdır. İzin verilen her kaynak 256 karaktere kadar olabilir.
ExposedHeaders CorsRule öğesi varsa gereklidir. CORS istemcilerinin kullanıma sunmasına yönelik yanıt üst bilgilerinin virgülle ayrılmış listesi. 64 tanımlı üst bilgi ve iki ön ekli üst bilgi ile sınırlıdır. Her üst bilgi en fazla 256 karakter içerebilir.
MaxAgeInSeconds CorsRule öğesi varsa gereklidir. İstemcinin/tarayıcının denetim öncesi yanıtını önbelleğe alması gereken saniye sayısı.
AllowedHeaders CorsRule öğesi varsa gereklidir. Çıkış noktaları arası isteğin parçası olmasına izin verilen üst bilgilerin virgülle ayrılmış listesi. 64 tanımlı üst bilgi ve 2 ön ekli üst bilgi ile sınırlıdır. Her üst bilgi en fazla 256 karakter içerebilir.
AllowedMethods CorsRule öğesi varsa gereklidir. 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 , , GET, , MERGEPOST, OPTIONSveya PUTyöntemleridirDELETE. HEAD

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 202 (Kabul Edildi) 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

Yok.

Yetkilendirme

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Azure Depolama'daki CORS kuralları için aşağıdaki kısıtlamalar ve sınırlamalar geçerlidir:

  • En fazla beş kural depolanabilir.

  • İstek üzerindeki tüm CORS kuralları ayarlarının boyut üst sınırı (XML etiketleri hariç) 2 KiB'ı geçmemelidir.

  • İzin verilen üst bilgi, kullanıma sunulan üst bilgi veya izin verilen kaynağın uzunluğu 256 karakteri aşmamalıdır.

  • İzin verilen üst bilgiler ve kullanıma sunulan üst bilgiler aşağıdakilerden biri olabilir:

    • Gibi tam üst bilgi adının sağlandığı x-ms-meta-processeddeğişmez başlıklar. İstekte en fazla 64 değişmez üst bilgi belirtilebilir.

    • Üst bilgi ön ekinin sağlandığı önekli üst bilgiler, örneğin x-ms-meta-data*. Bir ön ekin bu şekilde belirtilmesi, belirtilen ön ek ile başlayan tüm üst bilgileri sağlar veya kullanıma sunar. İstekte en fazla iki ön ekli üst bilgi belirtilebilir.

  • öğesinde AllowedMethods belirtilen yöntemler (veya HTTP fiilleri), Azure Depolama hizmeti API'leri tarafından desteklenen yöntemlere uygun olmalıdır. Desteklenen yöntemler , , GET, HEAD, MERGE, POSTOPTIONSve PUTyöntemleridirDELETE.

İstekte CORS kurallarının belirtilmesi isteğe bağlıdır. İstek gövdesinde Cors öğesini belirtmeden çağırırsanızSet Queue Service Properties, mevcut CORS kuralları korunur.

CORS'yi devre dışı bırakmak için boş bir CORS kural ayarlarıyla (yani,*</Cors>) ve iç CORS kuralları olmadan çağrısı Set Queue Service Properties yapın. Bu çağrı mevcut kuralları siler ve Kuyruk hizmeti için CORS'yi devre dışı bırakır.

CorsRule öğesi belirtilirse tüm CORS kural öğeleri gereklidir. Herhangi bir öğe eksikse istek 400 (Bad Request) hata koduyla başarısız olur.

2013-08-15 sürümünden itibaren, XML ayarları öğeleri isteğe bağlıdır, bu nedenle yalnızca güncelleştirilmiş öğeyi içeren bir XML göndererek belirli bir öğeyi güncelleştirebilirsiniz. Diğer ayarlar etkilenmez.

CORS kuralları ve değerlendirme mantığı hakkında ayrıntılı bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.

Örnek istek ve yanıt

Aşağıdaki örnek URI , myaccount adlı kurgusal depolama hesabının Kuyruk hizmeti özelliklerini değiştirme isteğinde bulunur:

PUT 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:28:19 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.queue.core.windows.net

İstek aşağıdaki XML gövdesiyle gönderilir:

<?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>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> 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>

İstek gönderildikten sonra aşağıdaki yanıt döndürülür:

HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
Date: Wed, 23 Oct 2013 04:28:20 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

Ayrıca bkz.

Azure Depolama hizmetleri için CORS desteği
CORS HTTP belirtimi