Uzyskiwanie właściwości usługi Table Service

Operacja pobiera właściwości usługi Tabel konta magazynu, w tym właściwości reguł Storage Analytics i Get Table Service Properties CORS (współużytkowanie zasobów między źródłami).

Aby uzyskać szczegółowe informacje na temat reguł CORS i logiki oceny, zobacz CorS Support for the Storage Services (Obsługa cors dla usług Storage Services).

Żądanie

Żądanie Get Table Service Properties można określić w następujący sposób. Protokół HTTPS jest zalecany. Zastąp <account-name> nazwą konta magazynu:

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET https://<account-name>.table.core.windows.net/?restype=service&comp=properties HTTP/1.1

Należy pamiętać, że w celu oddzielenia nazwy hosta od ścieżki i części adresu URI zapytania należy zawsze uwzględnić ukośnik (/). W przypadku tej operacji część ścieżki w uri jest pusta.

Parametry identyfikatora URI

Parametr URI Opis
restype=service&comp=properties Wymagane. Kombinacja obu ciągów zapytań jest wymagana do uzyskania właściwości usługi Table Service.
timeout Opcjonalny. Parametr timeout jest wyrażony w sekundach.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania Opis
Authorization Wymagane. Określa schemat autoryzacji, nazwę konta magazynu i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Date lub x-ms-date Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-version Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Versioning for the Azure Storage Services(Wersje usług Azure Storage Services).
x-ms-client-request-id Opcjonalny. Zapewnia wygenerowaną przez klienta nieprzezroczystą wartość z limitem znaków 1 KiB, który jest rejestrowany w dziennikach analizy, gdy jest włączone rejestrowanie analizy magazynu. Używanie tego nagłówka jest wysoce zalecane do korelowania działań po stronie klienta z żądaniami odebranymi przez serwer. Aby uzyskać więcej informacji, zobacz About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Informacje o rejestrowaniu analizy danych i rejestrowaniu na platformie Azure: używanie dzienników do śledzenia żądań Storage danych).

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Pomyślna operacja zwraca kod stanu 200 (OK).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
x-ms-request-id Wartość, która unikatowo identyfikuje żądanie wykonane względem usługi.
x-ms-version Określa wersję operacji używanej dla odpowiedzi. Aby uzyskać więcej informacji, zobacz Versioning for the Azure Storage Services(Wersje usług Azure Storage Services).
x-ms-client-request-id Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka, jeśli jest obecny w żądaniu, a wartość jest co najwyżej 1024 widocznych znaków x-ms-client-request-id ASCII. Jeśli nagłówek x-ms-client-request-id nie jest obecny w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

Treść odpowiedzi

W przypadku wersji 2012-02-12 i starszych treść odpowiedzi ma następujący format:

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

Począwszy od wersji 2013-08-15, treść odpowiedzi ma następujący format:

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

W poniższej tabeli opisano elementy treści odpowiedzi:

Nazwa elementu Opis
Rejestrowanie Grupuje ustawienia rejestrowania usługi Azure Analytics.
Metryki Grupuje ustawienia metryk usługi Azure Analytics. Ustawienia Metryki zawierają podsumowanie statystyk żądań pogrupowanych według interfejsu API w agregacjach godzinowych dla tabel.
HourMetrics Grupuje ustawienia HourMetrics usługi Azure Analytics. Ustawienia HourMetrics zawierają podsumowanie statystyk żądań pogrupowanych według interfejsu API w agregacjach godzinowych dla tabel.
MinuteMetrics Grupuje ustawienia minutemetrics usługi Azure Analytics. Ustawienia MinuteMetrics zawierają statystyki żądań dla każdej minuty dla tabel.
Wersja Wersja usługi Storage Analytics jest obecnie w użyciu.
Usuwanie Dotyczy tylko konfiguracji rejestrowania. Wskazuje, czy żądania usuwania są rejestrowane.
Odczyt Dotyczy tylko konfiguracji rejestrowania. Wskazuje, czy żądania odczytu są rejestrowane.
Napisz Dotyczy tylko konfiguracji rejestrowania. Wskazuje, czy żądania zapisu są rejestrowane.
Włączono Wskazuje, czy metryki są włączone dla usługi Table Service.

Jeśli jest włączona replikacja geograficznie nadmiarowa z dostępem do odczytu, zbierane są metryki podstawowe i pomocnicze. Jeśli replikacja geograficznie nadmiarowa z dostępem do odczytu nie jest włączona, zbierane są tylko metryki podstawowe.
Uwzględnij interfejsy API Dotyczy tylko konfiguracji metryk. Wskazuje, czy metryki generują statystyki podsumowujące dla wywołanych operacji interfejsu API.
RetentionPolicy/Enabled Wskazuje, czy zasady przechowywania są włączone dla usługi magazynu.
RetentionPolicy/Days Wskazuje liczbę dni, przez które są zachowywane metryki lub dane rejestrowania. Wszystkie dane starsze niż ta wartość zostaną usunięte.
Cors Grupuje wszystkie reguły CORS.
CorsRule Grupuje ustawienia reguły CORS.
AllowedOrigins Rozdzielana przecinkami lista domen źródeł, które są dozwolone za pośrednictwem corS, lub "*", jeśli wszystkie domeny są dozwolone.
ExposedHeaders Rozdzielana przecinkami lista nagłówków odpowiedzi, które mają być uwidocznione dla klientów CORS.
MaxAgeInSeconds Liczba sekund buforowania odpowiedzi wstępnej przez klienta/przeglądarkę.
AllowedHeaders Rozdzielana przecinkami lista nagłówków, które mogą być częścią żądania między źródłami.
AllowedMethods Rozdzielana przecinkami lista metod HTTP, które mogą być wykonywane przez źródło. W przypadku usługi Azure Storage dozwolone metody to DELETE, GET, HEAD, MERGE, POST, OPTIONS lub PUT.

Autoryzacja

Tylko właściciel konta magazynu może wywołać tę operację.

Przykładowe żądanie i odpowiedź

Poniższy przykładowy kod URI żąda właściwości usługi Table Service dla fikcyjnego konta magazynu o nazwie myaccount:

GET https://myaccount.table.core.windows.net/?restype=service&comp=properties HTTP/1.1  

Żądanie jest wysyłane z następującymi nagłówkami:

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 wysłaniu żądania jest zwracana następująca odpowiedź:

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  
  

Treść odpowiedzi jest podobna do następującej:

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

Zobacz też

Storage Analytics
Obsługa cors dla usług Storage services
Specyfikacja PROTOKOŁU HTTP CORS