Získání vlastností služby Table Service

  • Článek

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

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

Žádost

Žádost Get Table Service Properties může být zadána 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
GET https://<account-name>.table.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 identifikátoru URI Description
restype=service&comp=properties Povinná hodnota. Oba řetězce dotazů jsou potřeba k získání vlastností Table Storage.
timeout Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách.

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ý se při konfiguraci protokolování zaznamená do protokolů Analýza úložiště. 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 Table 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 Jednoznačně identifikuje požadavek, který byl 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 jejich odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud se nachází v požadavku, a hodnota obsahuje maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, v odpovědi se nezobrazí.

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 popsány v následující tabulce:

Element Popis
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é agregaci tabulek.
HourMetrics Seskupí Analýza úložiště nastavení HourMetrics. Nastavení HourMetrics poskytují souhrn statistik žádostí seskupených podle rozhraní API do hodinových agregací tabulek.
MinuteMetrics Seskupí Analýza úložiště nastavení MinuteMetrics. Nastavení MinuteMetrics poskytují statistiky požadavků pro každou minutu pro tabulky.
Verze Verze Analýza úložiště, která se aktuálně používá.
Odstranit Platí pouze pro konfiguraci protokolování. Určuje, jestli se protokolují žádosti o 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í požadavky na zápis.
Povoleno Určuje, jestli jsou metriky povolené pro Table Storage.

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 Platí jenom pro konfiguraci metrik. Určuje, jestli metriky generují souhrnné statistiky pro volané operace rozhraní API.
RetentionPolicy/Enabled Určuje, jestli je pro službu úložiště povolená zásada uchovávání informací.
RetentionPolicy/Days Počet dnů, po které se metriky nebo data protokolování uchovávají. Všechna data, která jsou 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í Table Storage pro fiktivní účet úložiště myaccount:

GET https://myaccount.table.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.table.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-Table/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