Získání vlastností frontové služby

Článek
08/04/2023

Operace Get Queue Service Properties získá vlastnosti účtu služby Azure Queue Storage, včetně vlastností pro Analýza úložiště a pravidla sdílení prostředků mezi zdroji (CORS).

Další informace o pravidlech sdílení prostředků mezi zdroji (CORS) a logice vyhodnocení najdete v tématu Podpora CORS pro služby Azure Storage.

Žádost

Žádost Get Queue Service Properties může být zadána následujícím způsobem. Doporučujeme použít https. Nahraďte <název> účtu názvem vašeho účtu úložiště:

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

Poznámka

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

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry:

Parametr	Popis
`restype=service&comp=properties`	Povinná hodnota. K získání vlastností služby úložiště se vyžaduje kombinace obou řetězců dotazu.
`timeout`	Nepovinný parametr. Parametr `timeout` je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Azure Queue Storage.

Hlavičky požadavku

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

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`	Povinné 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í 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

Žádné

Odpověď

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

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

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 provedený vůči službě.
`x-ms-version`	Určuje verzi operace použité 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

Pro verzi 2012-02-12 a starší je formát textu odpovědi 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>

Od verze 2013-08-15 je formát textu odpovědi 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-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>

Prvky textu odpovědi jsou popsané v následující tabulce:

Název prvku	Description
Protokolování	Seskupí nastavení protokolování Analýza úložiště.
Metriky	Seskupí nastavení metrik Analýza úložiště. Nastavení Metriky poskytují souhrn statistik žádostí seskupených podle rozhraní API v hodinových agregacích pro fronty.
HourMetrics	Seskupí nastavení Analýza úložiště HourMetrics. Nastavení HourMetrics poskytuje souhrn statistik žádostí seskupených podle rozhraní API v hodinové agregaci front.
MinuteMetrics	Seskupí nastavení Analýza úložiště MinuteMetrics. Nastavení MinuteMetrics* poskytuje statistiky požadavků pro každou minutu pro fronty.
Verze	Verze Analýza úložiště, která se právě používá.
Odstranit	Platí pouze pro konfiguraci protokolování. Označuje, jestli se protokolují požadavky na odstranění.
Read	Platí pouze pro konfiguraci protokolování. Určuje, jestli se protokolují žádosti o čtení.
Write	Platí pouze pro konfiguraci protokolování. Určuje, jestli se protokolují žádosti o zápis.
Povoleno	Označuje, jestli jsou pro Azure Queue Storage povolené metriky. 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 pouze primární metriky.
IncludeAPIs	Platí jenom pro konfiguraci metrik. Označuje, jestli metriky generují souhrnné statistiky pro operace volaných rozhraní API.
Zásady uchovávání informací / Povoleno	Určuje, jestli je pro službu úložiště povolená zásada uchovávání informací.
Zásady uchovávání informací/dny	Určuje počet dnů, po které se metriky nebo data protokolování uchovávají. Všechna data starší než tato hodnota se odstraní.
Cors	Seskupí všechna pravidla CORS.
CorsRule	Nastavení skupin pro pravidlo CORS
AllowedOrigins	Seznam počátečních domén oddělených čárkami, které jsou povolené prostřednictvím CORS, nebo hvězdička (*), pokud jsou povolené všechny domény.
ExposedHeaders	Seznam hlaviček odpovědí oddělených čárkami, které se mají zpřístupnit klientům CORS.
MaxAgeInSeconds	Počet sekund, po který by měl klient nebo prohlížeč uložit předběžnou odpověď do mezipaměti.
Povolené hlavičky	Seznam hlaviček oddělených čárkami, které mohou být součástí požadavku mezi zdroji.
AllowedMethods	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.

Autorizace

Tuto operaci může volat pouze vlastník účtu úložiště.

Ukázkový požadavek a odpověď

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

GET 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:49:03 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.queue.core.windows.net

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

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

Text odpovědi je podobný tomuto:

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

Viz také

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