Nastavení vlastností služby fronty

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

Žádost

Požadavek Set Queue Service Properties lze zadat následujícím způsobem. Doporučuje se https. Nahraďte <account-name> názvem účtu úložiště:

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

Všimněte si, že identifikátor URI musí vždy obsahovat lomítko (/), aby se název hostitele oddělil od cesty a částí dotazu identifikátoru URI. V případě této operace je část cesty identifikátoru URI prázdná.

Parametry identifikátoru URI

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

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Description
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ů na 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ů na Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí služeb Azure Storage.
x-ms-client-request-id Nepovinný parametr. Poskytuje vygenerovanou neprůhlásnou hodnotu s limitem znaků 1 KiB, který je zaznamenán v analytických protokolech při povolení protokolování analýzy úložiště. Použití této hlavičky se důrazně doporučuje pro korelaci aktivit na straně klienta s požadavky přijatými serverem. Další informace najdete v tématu o protokolování Analýza úložiště a protokolování Azure: Sledování požadavků Storage pomocí protokolů.

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 prvky zadanými v textu požadavku. Mezi kořenové prvky patří:

  • Protokolování

  • HourMetrics

  • MinuteMetrics

  • Cors

Už není nutné zadat každý kořenový prvek požadavku. Pokud vynecháte kořenový prvek, zachovají se stávající nastavení služby pro tuto funkci. Pokud ale zadáte daný kořenový prvek, musíte pro tento prvek zadat každý podřízený prvek.

Následující tabulka popisuje prvky textu požadavku:

Název prvku Description
Protokolování Volitelné od verze 2013-08-15. Vyžaduje se pro starší verze. Seskupí nastavení protokolování Azure Analytics.
Metriky Vyžaduje se pro verzi 2012-02-12 a starší. Neplatí pro verzi 2013-08-15 nebo novější. Seskupí nastavení metrik Azure Analytics. Nastavení metrik poskytují souhrn statistik požadavků seskupených podle rozhraní API v hodinových agregovaných agregovaných frontách.
HourMetrics Volitelné pro verzi 2013-08-15 nebo novější; se nevztahuje na dřívější verze. Seskupí nastavení hodinových metrik Azure Analytics. Nastavení HourMetrics poskytuje souhrn statistik požadavků seskupených podle rozhraní API v hodinové agregaci front.
MinuteMetrics Volitelné pro verzi 2013-08-15 nebo novější; se nevztahuje na dřívější verze. Seskupí nastavení azure Analytics MinuteMetrics . Nastavení MinuteMetrics poskytuje statistiky požadavků pro každou minutu pro fronty. U verzí starších než 2013-08-15 není funkce MinuteMetrics zahrnuta v textu odpovědi.
Verze Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics . Verze Analýza úložiště ke konfiguraci.
Odstranit Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics . Platí jenom pro konfiguraci protokolování. Určuje, jestli se mají protokolovat všechny požadavky na odstranění.
Číst Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics . Platí jenom pro konfiguraci protokolování. Určuje, jestli se mají protokolovat všechny požadavky na čtení.
Zápis Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics . Platí jenom pro konfiguraci protokolování. Určuje, jestli se mají protokolovat všechny požadavky na zápis.
Povoleno Povinná hodnota. Označuje, jestli jsou pro službu Queue povoleny metriky.

Pokud je povolená geograficky redundantní replikace přístupu pro čtení, shromažďují se primární i sekundární metriky. Pokud geograficky redundantní replikace přístupu pro čtení není povolená, shromažďují se pouze primární metriky.
IncludeAPIs Povinné pouze v případě, že jsou povolené metriky. Platí jenom pro konfiguraci metrik. Označuje, jestli metriky mají generovat souhrnné statistiky pro operace rozhraní API.
RetentionPolicy/Enabled 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í za dny Vyžadováno pouze v případě, že je povolená zásada uchovávání informací. Označuje počet dnů, po které se mají uchovávat metriky nebo data protokolování. Odstraní se všechna data starší než tato hodnota. Minimální hodnota, kterou můžete zadat, je 1; největší hodnota je 365 (jeden rok).
Cors Nepovinný parametr. Element Cors je podporován pro verzi 2013-08-15 nebo novější. Seskupí všechna pravidla CORS.

Vynechání této skupiny elementů nepřepíše stávající nastavení CORS.
CorsRule Nepovinný parametr. Určuje pravidlo CORS pro službu Queue. Do požadavku můžete zahrnout až pět prvků CorsRule . Pokud do textu požadavku nejsou zahrnuty žá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ý čárkami, které budou povoleny prostřednictvím CORS nebo *, aby povolovaly všechny domény. Původní doména může také obsahovat zástupný znak v subdoméně, 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ů.
Vystavené hlavičky Vyžaduje se, pokud je k dispozici element CorsRule . Seznam hlaviček odpovědí oddělený čárkami pro zveřejnění klientům CORS Omezeno na 64 definovaných hlaviček a dvě předpony. Každé záhlaví může mít maximálně 256 znaků.
MaxAgeInSeconds Vyžaduje se, pokud je k dispozici element CorsRule . Počet sekund, po které má klient nebo prohlížeč ukládat předběžnou odpověď do mezipaměti.
AllowedHeaders Vyžaduje se, pokud existuje element CorsRule . Seznam hlaviček oddělených čárkami může být součástí žádosti mezi zdroji. Omezeno na 64 definovaných hlaviček a 2 předpony hlaviček. Každé záhlaví může mít maximálně 256 znaků.
AllowedMethods Vyžaduje se, pokud existuje element CorsRule . Seznam metod HTTP oddělených čárkami, které mohou být provedeny původem. Pro Azure Storage jsou povolené metody DELETE, 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ěď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také 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 Hodnota, která jednoznačně identifikuje požadavek provedený vůči službě.
x-ms-version Určuje verzi operace použitou pro odpověď. Další informace najdete v tématu Správa verzí služby Azure Storage Services.
x-ms-client-request-id Tato hlavička se dá použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky, pokud se nachází v požadavku a hodnota je maximálně 1024 viditelných x-ms-client-request-id znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id , nebude tato hlavička v odpovědi k dispozici.

Text odpovědi

Žádné

Autorizace

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

Poznámky

Následující omezení a omezení platí pro pravidla CORS v Azure Storage:

  • Můžete 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, vystavené hlavičky nebo povoleného původu by neměla překročit 256 znaků.

  • Povolené hlavičky a vystavené hlavičky můžou být:

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

    • Předpona hlaviček, kde je k dispozici předpona hlavičky, například x-ms-meta-data*. Zadáním předpony tímto způsobem povolíte nebo zveřejníte libovolnou hlavičku, která začíná danou předponou. Pro požadavek je možné zadat 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, OPTIONS a PUT.

Zadání pravidel CORS v požadavku je volitelné. Pokud volá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 (tj</Cors>. 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 elementy pravidla CORS jsou vyžadovány, pokud je zadán element CorsRule . Pokud nějaký prvek chybí, požadavek selže s kódem chyby 400 (Bad Request).

Počínaje verzí 2013-08-15 budou elementy nastavení XML volitelné, takže aktualizace konkrétního prvku může být provedena odesláním XML, který obsahuje pouze aktualizovaný prvek a další nastavení nebudou ovlivněna.

Podrobné informace o pravidlech CORS a logikě vyhodnocení najdete v tématu Podpora CORS pro Storage Services.

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é

Vylepšené hlavičky HTTP pro obnovení při stahování a změnu v If-Match podmínkách
Podpora CORS pro služby Storage
Specifikace CORS HTTP