Nastavení vlastností služby front

  • Článek

Operace Set Queue Service Properties nastaví vlastnosti koncového bodu služby Queue účtu úložiště, včetně vlastností pro Analýza úložiště a pravidla sdílení prostředků mezi zdroji (CORS). Další informace o pravidlech CORS najdete v tématu Podpora CORS pro službu Storage Services .

Žádost

Požadavek můžete zadat Set Queue Service Properties následujícím způsobem. Doporučujeme používat protokol HTTPS. Nahraďte account-name názvem vašeho účtu úložiště:

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT https://account-name.queue.core.windows.net/?restype=service&comp=properties HTTP/1.1

Poznámka

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

Parametry identifikátoru URI

Parametr Popis
restype=service&comp=properties Povinná hodnota. K nastavení vlastností služby Azure Storage se vyžaduje kombinace obou řetězců dotazu.
timeout Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Fronta.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu úložiště a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo 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 Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. 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í služby Azure Queue Storage.

Text požadavku

Pro verzi 2012-02-12 a starší je formát textu požadavku následující:

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

Pro verzi 2013-08-15 a novější je formát textu požadavku následující:

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

Od verze 2013-08-15 můžete volat Set Queue Service Properties s jedním nebo více kořenovými elementy zadanými v textu požadavku. Mezi kořenové prvky patří:

  • Protokolování
  • HourMetrics
  • MinuteMetrics
  • Cors

V požadavku už není nutné zadávat všechny kořenové elementy. Pokud vynecháte kořenový prvek, stávající nastavení služby pro tuto funkci se zachovají. Pokud však zadáte zadaný kořenový prvek, musíte zadat každý podřízený prvek pro tento prvek.

Prvky textu požadavku jsou popsány v následující tabulce:

Název elementu Popis
Protokolování Volitelné od verze 2013-08-15. Vyžaduje se pro starší verze. Seskupí nastavení protokolování Analýza úložiště.
Metriky Vyžaduje se pro verzi 2012-02-12 a starší. Neplatí pro verzi 2013-08-15 a novější. Seskupí nastavení metrik Analýza úložiště. Nastavení Metriky poskytují souhrn statistik žádostí seskupených podle rozhraní API do hodinových agregací pro fronty.
HourMetrics Volitelné pro verzi 2013-08-15 a novější. Neplatí pro starší verze. Seskupí Analýza úložiště nastavení HourMetrics. Nastavení HourMetrics poskytují souhrn statistik žádostí seskupených podle rozhraní API v hodinové agregaci front.
MinuteMetrics Volitelné pro verzi 2013-08-15 a novější. Neplatí pro starší verze. Seskupí Analýza úložiště nastavení MinuteMetrics. Nastavení MinuteMetrics poskytují statistiky požadavků pro každou minutu front. U verzí starších než 2013-08-15 není MinuteMetrics součástí textu odpovědi.
Verze Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Verze Analýza úložiště, která se má nakonfigurovat.
Odstranit Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Platí pouze pro konfiguraci protokolování. Určuje, zda mají být protokolovány všechny žádosti o odstranění.
Read Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Platí pouze pro konfiguraci protokolování. Určuje, zda mají být protokolovány všechny žádosti o čtení.
Write Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Platí pouze pro konfiguraci protokolování. Určuje, jestli se mají protokolovat všechny požadavky na zápis.
Povoleno Povinná hodnota. Určuje, jestli jsou metriky povolené pro službu front.

Pokud je povolená geograficky redundantní replikace s přístupem pro čtení, shromažďují se primární i sekundární metriky. Pokud není povolená geograficky redundantní replikace s přístupem pro čtení, shromažďují se jenom primární metriky.
IncludeAPIs Povinné jenom v případě, že jsou povolené metriky. Platí jenom pro konfiguraci metrik. Určuje, jestli by metriky měly generovat souhrnné statistiky pro operace volaných rozhraní API.
Zásady uchovávání informací / Povoleno Povinná hodnota. Určuje, jestli je pro službu úložiště povolená zásada uchovávání informací.
Zásady uchovávání informací/dny Povinné pouze v případě, že jsou povolené zásady uchovávání informací. Určuje počet dnů, po který se mají metriky nebo data protokolování uchovávat. Všechna data, která jsou starší než tato hodnota, budou odstraněna. Minimální hodnota, kterou můžete zadat, je 1a maximální hodnota je 365 (jeden rok).
Cors Nepovinný parametr. Element Cors je podporovaný pro verzi 2013-08-15 a novější. Seskupí všechna pravidla CORS.

Vynecháním této skupiny prvků se nepřepíše existující nastavení CORS.
CorsRule Nepovinný parametr. Určuje pravidlo CORS pro službu Queue. Do žádosti můžete zahrnout až pět prvků CorsRule . Pokud v textu požadavku nejsou zahrnuté žádné prvky CorsRule , odstraní se všechna pravidla CORS a cors se pro službu Queue zakáže.
AllowedOrigins Vyžaduje se, pokud je k dispozici element CorsRule . Seznam domén původu oddělených čárkami, který bude povolený prostřednictvím CORS, nebo "*", aby se povolily všechny domény. Původní doména může také v subdoméně obsahovat zástupný znak, který umožňuje žádosti prostřednictvím CORS pro všechny subdomény domény. Omezeno na 64 původních domén. Každý povolený původ může mít až 256 znaků.
Exponované hlavičky Vyžaduje se, pokud je k dispozici element CorsRule . Seznam hlaviček odpovědí oddělených čárkami, které se mají zpřístupnit klientům CORS. Omezeno na 64 definovaných hlaviček a dvě předpony. Každé záhlaví může obsahovat až 256 znaků.
MaxAgeInSeconds Vyžaduje se, pokud je k dispozici element CorsRule . Počet sekund, po který by měl klient nebo prohlížeč uložit předběžnou odpověď do mezipaměti.
AllowedHeaders Vyžaduje se, pokud existuje element CorsRule . Seznam záhlaví oddělených čárkami, který může být součástí požadavku mezi zdroji. Omezeno na 64 definovaných hlaviček a 2 záhlaví s předponou. Každé záhlaví může obsahovat až 256 znaků.
AllowedMethods Vyžaduje se, pokud existuje element CorsRule . Seznam metod HTTP oddělených čárkami, které mohou být spouštěné zdrojem. Pro Azure Storage jsou DELETEpovolené metody , GET, HEAD, MERGE, POST, OPTIONS, nebo PUT.

Odpověď

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

Stavový kód

Úspěšná operace vrátí stavový kód 202 (přijato).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat 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ý je vůči službě proveden.
x-ms-version Určuje verzi operace, která byla použita pro odpověď. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a 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 neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude v odpovědi.

Text odpovědi

Žádné

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Na pravidla CORS ve službě Azure Storage se vztahují následující omezení:

  • Je možné uložit maximálně pět pravidel.

  • Maximální velikost všech nastavení pravidel CORS v požadavku s výjimkou značek XML by neměla překročit 2 KiB.

  • Délka povolené hlavičky, zveřejněné hlavičky nebo povoleného původu by neměla překročit 256 znaků.

  • Povolené a vystavené hlavičky mohou být některé z následujících:

    • Záhlaví literálů, kde je zadaný přesný název hlavičky, například x-ms-meta-processed. V požadavku může být zadáno maximálně 64 záhlaví literálů.

    • Hlavičky s předponou, kde je k dispozici předpona záhlaví, například x-ms-meta-data*. Zadáním předpony tímto způsobem povolíte nebo zpřístupníte jakoukoli hlavičku, která začíná určenou předponou. V požadavku mohou být zadány maximálně dvě hlavičky s předponou.

  • Metody (nebo příkazy HTTP) zadané v elementu AllowedMethods musí odpovídat metodám podporovaným rozhraními API služby Azure Storage. Podporované metody jsou DELETE, GET, HEAD, MERGE, POST, OPTIONSa PUT.

Zadání pravidel CORS v požadavku je volitelné. Pokud zavoláte Set Queue Service Properties bez zadání elementu Cors v textu požadavku, budou zachována všechna existující pravidla CORS.

Pokud chcete CORS zakázat, volejte Set Queue Service Properties s prázdným nastavením pravidel CORS (to znamená*</Cors>) a bez vnitřních pravidel CORS. Toto volání odstraní všechna existující pravidla a zakáže CORS pro službu Queue.

Všechny prvky pravidla CORS jsou vyžadovány, pokud je zadán element CorsRule . Pokud některý prvek chybí, požadavek selže s kódem chyby 400 (Bad Request).

Od verze 2013-08-15 jsou elementy nastavení XML volitelné, takže můžete aktualizovat konkrétní prvek odesláním XML, který obsahuje pouze aktualizovaný element. Na ostatní nastavení to nemá vliv.

Podrobné informace o pravidlech CORS a logice vyhodnocení najdete v tématu Podpora CORS pro služby Azure Storage.

Ukázkový požadavek a odpověď

Následující ukázkový identifikátor URI vytvoří požadavek na změnu vlastností služby Queue pro fiktivní účet úložiště s názvem myaccount:

PUT https://myaccount.queue.core.windows.net/?restype=service&comp=properties 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 04:28:19 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.queue.core.windows.net

Požadavek se odešle s následujícím textem XML:

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

Po odeslání požadavku se vrátí následující odpověď:

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

Viz také

Podpora CORS pro služby Azure Storage
Specifikace PROTOKOLU HTTP CORS