Tablo Hizmeti Özelliklerini Alma

Makale
06/27/2023

İşlem, Get Table Service PropertiesDepolama Analizi ve çıkış noktaları arası kaynak paylaşımı (CORS) kurallarının özellikleri de dahil olmak üzere bir Azure Tablo Depolama hesabının özelliklerini alır.

CORS kuralları ve değerlendirme mantığı hakkında daha fazla bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.

İstek

İstek Get Table Service Properties aşağıdaki gibi belirtilebilir. HTTPS kullanmanızı öneririz. account-name değerini depolama hesabınızın adıyla değiştirin<:>

Yöntem	İstek URI'si	HTTP sürümü
GET	`https://<account-name>.table.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Not

Ana bilgisayar adını URI'nin yolundan ve sorgu bölümlerinden ayırmak için URI her zaman bir eğik çizgi karakteri (/) içermelidir. Bu işlemde, URI'nin yol kısmı boş.

URI parametreleri

URI parametresi	Description
`restype=service&comp=properties`	Gereklidir. Tablo Depolama özelliklerini almak için her iki sorgu dizesi de gereklidir.
`timeout`	İsteğe bağlı. `timeout` parametresi saniye cinsinden ifade edilir.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi	Açıklama
`Authorization`	Gereklidir. Yetkilendirme düzenini, depolama hesabı adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
`Date` veya `x-ms-date`	Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
`x-ms-version`	Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`x-ms-client-request-id`	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında Depolama Analizi günlüklerine kaydedilen 1 kibibayt (KiB) karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. Azure Tablo Depolama'yı izleme.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir.

Durum kodu

Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Description
`x-ms-request-id`	Hizmette yapılan bir isteği benzersiz olarak tanımlar.
`x-ms-version`	Yanıt için kullanılan işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`x-ms-client-request-id`	İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine `x-ms-client-request-id` eşittir. `x-ms-client-request-id` Üst bilgi istekte yoksa yanıtta bulunmaz.

Yanıt gövdesi

Sürüm 2012-02-12 ve öncesi için yanıt gövdesinin biçimi aşağıdaki gibidir:

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

Sürüm 2013-08-15 itibarıyla yanıt gövdesinin biçimi aşağıdaki gibidir:

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

Yanıt gövdesinin öğeleri aşağıdaki tabloda açıklanmıştır:

Öğe	Açıklama
Günlüğe kaydetme	Depolama Analizi Günlüğü ayarlarını gruplandırın.
Ölçümler	Depolama Analizi Ölçüm ayarlarını gruplandırın. Ölçüm ayarları, tablolar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar.
HourMetrics	Depolama Analizi HourMetrics ayarlarını gruplandırın. HourMetrics ayarları, tablolar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar.
MinuteMetrics	Depolama Analizi MinuteMetrics ayarlarını gruplandırın. MinuteMetrics ayarları, tablolar için her dakika için istek istatistikleri sağlar.
Sürüm	Şu anda kullanımda olan Depolama Analizi sürümü.
Silme	Yalnızca günlük yapılandırması için geçerlidir. Silme isteklerinin günlüğe kaydedilip kaydedilmediğini gösterir.
Read	Yalnızca günlük yapılandırması için geçerlidir. Okuma isteklerinin günlüğe kaydedilip kaydedilmediğini gösterir.
Write	Yalnızca günlük yapılandırması için geçerlidir. Yazma isteklerinin günlüğe kaydedilip kaydedilmediğini gösterir.
Etkin	Ölçümlerin Tablo Depolama için etkinleştirilip etkinleştirilmediğini gösterir. Okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, hem birincil hem de ikincil ölçümler toplanır. Okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirilmediyse yalnızca birincil ölçümler toplanır.
IncludeAPI'ler	Yalnızca ölçüm yapılandırması için geçerlidir. Ölçümlerin çağrılan API işlemleri için özet istatistikleri oluşturup oluşturmadığını gösterir.
RetentionPolicy/Etkin	Depolama hizmeti için bir bekletme ilkesinin etkinleştirilip etkinleştirilmediğini gösterir.
RetentionPolicy/Gün	Ölçümlerin veya günlüğe kaydetme verilerinin tutulduğunu gösteren gün sayısı. Bu değerden daha eski olan tüm veriler silinir.
Cors	Tüm CORS kurallarını gruplandırma.
CorsRule	CORS kuralı için grup ayarları.
AllowedOrigins	CORS aracılığıyla izin verilen kaynak etki alanlarının virgülle ayrılmış listesi veya tüm etki alanlarına izin veriliyorsa yıldız işareti (*) .
ExposedHeaders	CORS istemcilerine kullanıma sunma amacıyla yanıt üst bilgilerinin virgülle ayrılmış listesi.
MaxAgeInSeconds	İstemcinin veya tarayıcının denetim öncesi yanıtı önbelleğe alması gereken saniye sayısı.
AllowedHeaders	Çıkış noktaları arası isteğin parçası olmasına izin verilen üst bilgilerin virgülle ayrılmış listesi.
AllowedMethods	Kaynak tarafından yürütülmesine izin verilen HTTP yöntemlerinin virgülle ayrılmış listesi. Azure Depolama için izin verilen yöntemler DELETE, GET, HEAD, MERGE, POST, OPTIONS veya PUT'dır.

Yetkilendirme

Bu işlemi yalnızca depolama hesabı sahibi çağırabilir.

Örnek istek ve yanıt

Aşağıdaki örnek URI , myaccount adlı kurgusal bir depolama hesabı için Tablo Depolama özelliklerini alma isteğinde bulunur:

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

İstek aşağıdaki üst bilgilerle gönderilir:

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

İstek gönderildikten sonra aşağıdaki yanıt döndürülür:

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

Yanıt gövdesi aşağıdakine benzer:

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

Ayrıca bkz.

Depolama Analizi
Azure Depolama hizmetleri için CORS desteği
CORS HTTP belirtimi