Mendapatkan Properti Layanan Tabel

Artikel
07/26/2022
4 menit untuk membaca

Operasi ini Get Table Service Properties mendapatkan properti layanan Tabel akun penyimpanan, termasuk properti untuk aturan Storage Analytics dan CORS (Berbagi Sumber Daya Lintas Asal).

Untuk informasi terperinci tentang aturan CORS dan logika evaluasi, lihat Dukungan CORS untuk Layanan Storage.

Minta

Permintaan Get Table Service Properties dapat ditentukan sebagai berikut. HTTPS disarankan. Ganti <account-name> dengan nama akun penyimpanan Anda:

Metode	Meminta URI	Versi HTTP
GET	`https://<account-name>.table.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Perhatikan bahwa URI harus selalu menyertakan garis miring (/) untuk memisahkan nama host dari jalur dan bagian kueri URI. Dalam kasus operasi ini, bagian jalur URI kosong.

Parameter URI

URI Parameter	Deskripsi
`restype=service&comp=properties`	Wajib diisi. Kombinasi kedua string kueri diperlukan untuk mendapatkan properti layanan Tabel.
`timeout`	Opsional. Parameter `timeout` dinyatakan dalam hitung detik.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Header Permintaan	Deskripsi
`Authorization`	Wajib diisi. Menentukan skema otorisasi, nama akun penyimpanan, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
`Date` atau `x-ms-date`	Wajib diisi. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
`x-ms-version`	Diperlukan untuk semua permintaan yang diotorisasi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
`x-ms-client-request-id`	Opsional. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 KiB yang dicatat dalam log analitik saat pengelogan analitik penyimpanan diaktifkan. Menggunakan header ini sangat direkomendasikan untuk mengkorelasi aktivitas sisi klien dengan permintaan yang diterima oleh server. Untuk informasi selengkapnya, lihat Tentang Pengelogan Storage Analytics dan Pengelogan Azure: Menggunakan Log untuk Melacak Permintaan Storage.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

Operasi yang berhasil mengembalikan kode status 200 (OK).

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons	Deskripsi
`x-ms-request-id`	Nilai yang secara unik mengidentifikasi permintaan yang dibuat terhadap layanan.
`x-ms-version`	Menentukan versi operasi yang digunakan untuk respons. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
`x-ms-client-request-id`	Header ini dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai `x-ms-client-request-id` header jika ada dalam permintaan dan nilainya paling banyak 1024 karakter ASCII yang terlihat. `x-ms-client-request-id` Jika header tidak ada dalam permintaan, header ini tidak akan ada dalam respons.

Isi Respons

Untuk versi 2012-02-12 dan yang lebih lama, format isi respons adalah sebagai berikut:

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

Dimulai dengan versi 2013-08-15, format isi respons adalah sebagai berikut:

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

Tabel berikut ini menjelaskan elemen isi respons:

Nama Elemen	Deskripsi
Pengelogan	Mengelompokkan pengaturan Pengelogan Azure Analytics.
Metrik	Mengelompokkan pengaturan Metrik Azure Analytics . Pengaturan Metrik menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk tabel.
HourMetrics	Mengelompokkan pengaturan HourMetrics Azure Analytics . Pengaturan HourMetrics menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk tabel.
MinuteMetrics	Mengelompokkan pengaturan MinuteMetrics Azure Analytics . Pengaturan MinuteMetrics menyediakan statistik permintaan untuk setiap menit untuk tabel.
Versi	Versi Storage Analytics yang saat ini digunakan.
Delete	Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah permintaan penghapusan sedang dicatat.
Baca	Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah permintaan baca sedang dicatat.
Tulis	Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah permintaan tulis sedang dicatat.
Aktif	Menunjukkan apakah metrik diaktifkan untuk layanan Tabel. Jika replikasi geo-redundan akses baca diaktifkan, metrik primer dan sekunder akan dikumpulkan. Jika replikasi geo-redundan akses baca tidak diaktifkan, hanya metrik utama yang dikumpulkan.
Sertakan API	Hanya berlaku untuk konfigurasi metrik. Menunjukkan apakah metrik menghasilkan statistik ringkasan untuk operasi API yang disebut.
RetentionPolicy/Enabled	Menunjukkan apakah kebijakan penyimpanan diaktifkan untuk layanan penyimpanan.
RetentionPolicy/Days	Menunjukkan jumlah hari metrik atau data pengelogan dipertahankan. Semua data yang lebih lama dari nilai ini akan dihapus.
Cors	Mengelompokkan semua aturan CORS.
CorsRule	Pengaturan grup untuk aturan CORS.
AllowedOrigins	Daftar domain asal yang dipisahkan koma yang diizinkan melalui CORS, atau "*" jika semua domain diizinkan.
ExposedHeaders	Daftar header respons yang dipisahkan koma untuk diekspos ke klien CORS.
MaxAgeInSeconds	Jumlah detik klien/browser harus menyimpan respons preflight.
AllowedHeaders	Daftar header yang dipisahkan koma yang diizinkan untuk menjadi bagian dari permintaan lintas asal.
AllowedMethods	Daftar metode HTTP yang dipisahkan koma yang diizinkan untuk dijalankan oleh asal. Untuk Azure Storage, metode yang diizinkan adalah DELETE, GET, HEAD, MERGE, POST, OPTIONS, atau PUT.

Authorization

Hanya pemilik akun penyimpanan yang dapat memanggil operasi ini.

Permintaan dan Respons Sampel

Contoh URI berikut membuat permintaan untuk mendapatkan properti layanan Tabel untuk akun penyimpanan fiksi bernama myaccount:

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

Permintaan dikirim dengan header berikut:

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

Setelah permintaan dikirim, respons berikut dikembalikan:

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

Isi respons mirip dengan yang berikut ini:

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

Lihat juga

Analitik Penyimpanan
Dukungan CORS untuk Layanan Storage
Spesifikasi HTTP CORS