Mengatur Properti Layanan Tabel
Operasi ini Set Table Service Properties
menetapkan properti untuk titik akhir Azure Table Storage akun penyimpanan, termasuk properti untuk aturan Storage Analytics dan Cross-Origin Resource Sharing (CORS). Untuk informasi selengkapnya tentang aturan CORS, lihat Dukungan CORS untuk layanan Azure Storage.
Minta
Anda dapat menentukan Set Table Service Properties
permintaan sebagai berikut. Kami merekomendasikan HTTPS. Ganti nama akun dengan nama akun penyimpanan Anda.
Metode | Meminta URI | Versi HTTP |
---|---|---|
PUT | 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
Parameter URI | Deskripsi |
---|---|
restype=service&comp=properties |
Wajib diisi. Kombinasi kedua string kueri diperlukan untuk mengatur properti untuk layanan Azure Storage. |
timeout |
Opsional. Parameter timeout dinyatakan dalam hitung detik. |
Header permintaan
Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional:
Meminta kop | 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 kibibyte (KiB) yang dicatat dalam log saat pengelogan dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server. |
Isi permintaan
Untuk versi 2012-02-12 dan yang lebih lama, format isi permintaan 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>
Untuk versi 2013-08-15 dan yang lebih baru, format isi permintaan 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-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>
</CorsRule>
</Cors>
</StorageServiceProperties>
Dimulai dengan versi 2013-08-15, Anda dapat memanggil Set Table Service Properties
dengan satu atau beberapa elemen akar yang ditentukan dalam isi permintaan. Elemen root meliputi:
Logging
HourMetrics
MinuteMetrics
Cors
Tidak perlu lagi menentukan setiap elemen akar pada permintaan. Jika Anda menghilangkan elemen akar, pengaturan yang ada untuk layanan untuk fungsi tersebut dipertahankan. Tetapi jika Anda menentukan elemen akar, Anda harus menentukan setiap elemen anak untuk elemen tersebut.
Tabel berikut ini menjelaskan elemen isi permintaan:
Nama elemen | Deskripsi |
---|---|
Logging |
Opsional untuk versi 2013-08-15 dan yang lebih baru. Diperlukan untuk versi yang lebih lama. Mengelompokkan pengaturan Storage Analytics Logging . |
Metrics |
Diperlukan untuk versi 2012-02-12 dan yang lebih lama. Tidak berlaku untuk versi 2013-08-15 dan yang lebih baru. Mengelompokkan pengaturan Storage Analytics Metrics . Pengaturan Metrics menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk tabel. |
HourMetrics |
Opsional untuk versi 2013-08-15 dan yang lebih baru. Tidak berlaku untuk versi yang lebih lama. Mengelompokkan pengaturan Storage Analytics HourMetrics . Pengaturan HourMetrics menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk tabel. |
MinuteMetrics |
Opsional untuk versi 2013-08-15 dan yang lebih baru. Tidak berlaku untuk versi yang lebih lama. Mengelompokkan pengaturan Storage Analytics MinuteMetrics . Pengaturan MinuteMetrics menyediakan statistik permintaan untuk setiap menit untuk tabel. Untuk versi yang lebih lama dari 2013-08-15, MinuteMetrics tidak disertakan dalam isi respons. |
Version |
Wajib diisi. Menunjukkan versi Storage Analytics untuk dikonfigurasi. |
Delete |
Wajib diisi. Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah semua permintaan penghapusan harus dicatat. |
Read |
Wajib diisi. Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah semua permintaan baca harus dicatat. |
Write |
Wajib diisi. Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah semua permintaan tulis harus dicatat. |
Enabled |
Wajib diisi. Menunjukkan apakah metrik diaktifkan untuk layanan Azure Storage. Jika replikasi geo-redundan akses baca diaktifkan, metrik primer dan sekunder dikumpulkan. Jika replikasi geo-redundan akses baca tidak diaktifkan, hanya metrik utama yang dikumpulkan. |
IncludeAPIs |
Diperlukan hanya jika metrik diaktifkan. Hanya berlaku untuk konfigurasi metrik. Menunjukkan apakah metrik harus menghasilkan statistik ringkasan untuk operasi API yang disebut. |
RetentionPolicy/Enabled |
Wajib diisi. Menunjukkan apakah kebijakan penyimpanan diaktifkan untuk layanan Azure Storage. |
RetentionPolicy/Days |
Diperlukan hanya jika kebijakan penyimpanan diaktifkan. Menunjukkan jumlah hari metrik atau data pengelogan harus dipertahankan. Semua data yang lebih lama dari nilai ini akan dihapus. Nilai minimum yang dapat Anda tentukan adalah 1 . Nilai terbesar adalah 365 (satu tahun). |
Cors |
Opsional. Didukung untuk versi 2013-08-15 dan yang lebih baru. Mengelompokkan semua aturan CORS. Menghilangkan grup elemen ini tidak akan menimpa pengaturan CORS yang ada. |
CorsRule |
Pilihan. Menentukan aturan CORS untuk Table Storage. Anda dapat menyertakan hingga lima CorsRule elemen dalam permintaan. Jika tidak ada CorsRule elemen yang disertakan dalam isi permintaan, semua aturan CORS akan dihapus, dan CORS akan dinonaktifkan untuk Table Storage. |
AllowedOrigins |
Diperlukan jika CorsRule elemen ada. Menyediakan daftar domain asal yang dipisahkan koma yang akan diizinkan melalui CORS, atau berisi * untuk mengizinkan semua domain. Domain asal mungkin juga menyertakan karakter kartubebas di subdomain untuk mengizinkan permintaan melalui CORS untuk semua subdomain domain. Terbatas pada 64 domain asal. Setiap asal yang diizinkan dapat memiliki hingga 256 karakter. |
ExposedHeaders |
Diperlukan jika CorsRule elemen ada. Menyediakan daftar header respons yang dipisahkan koma untuk diekspos ke klien CORS. Terbatas pada 64 header yang ditentukan dan dua header awalan. Setiap header dapat mencapai 256 karakter. |
MaxAgeInSeconds |
Diperlukan jika CorsRule elemen ada. Menunjukkan jumlah detik bahwa klien atau browser harus menyimpan respons preflight. |
AllowedHeaders |
Diperlukan jika CorsRule elemen ada. Menyediakan daftar header yang dipisahkan koma yang diizinkan untuk menjadi bagian dari permintaan lintas asal. Terbatas pada 64 header yang ditentukan dan 2 header awalan. Setiap header dapat mencapai 256 karakter. |
AllowedMethods |
Diperlukan jika CorsRule elemen ada. Menyediakan daftar metode HTTP yang dipisahkan koma yang asalnya diizinkan untuk dijalankan. Untuk Azure Storage, metode yang diizinkan adalah DELETE , , GET , HEAD MERGE , POST , OPTIONS , dan PUT . |
Respons
Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.
Kode status
Operasi yang berhasil mengembalikan kode status 202 (Diterima).
Header respons
Respons untuk operasi ini mencakup header berikut. Respons mungkin juga menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.
Header respons | Deskripsi |
---|---|
x-ms-request-id |
Menentukan 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 |
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 1.024 karakter ASCII yang terlihat.
x-ms-client-request-id Jika header tidak ada dalam permintaan, header ini tidak akan ada dalam respons. |
Isi Respons
Tidak ada.
Authorization
Hanya pemilik akun yang dapat memanggil operasi ini.
Keterangan
Pembatasan dan batasan berikut berlaku untuk aturan CORS di Azure Storage:
Anda dapat menyimpan maksimal lima aturan.
Ukuran maksimum semua pengaturan aturan CORS pada permintaan, tidak termasuk tag XML, tidak boleh melebihi 2 KiB.
Panjang header yang diizinkan, header yang diekspos, atau asal yang diizinkan tidak boleh melebihi 256 karakter.
Header yang diizinkan dan header yang diekspos dapat berupa:
Header harfiah tempat nama header yang tepat disediakan, seperti
x-ms-meta-processed
. Anda dapat menentukan maksimum 64 header harfiah pada permintaan.Header awalan tempat awalan header disediakan, seperti
x-ms-meta-data\
. Menentukan awalan dengan cara ini memungkinkan atau mengekspos header apa pun yang dimulai dengan awalan tersebut. Anda dapat menentukan maksimum dua header awalan pada permintaan.
Metode (atau kata kerja HTTP) yang ditentukan dalam
AllowedMethods
elemen harus sesuai dengan metode yang didukung API layanan Azure Storage. Metode yang didukung adalahDELETE
, ,HEAD
GET
,MERGE
,POST
,OPTIONS
, danPUT
.
Menentukan aturan CORS pada permintaan bersifat opsional. Jika Anda memanggil Set Table Service Properties
tanpa menentukan Cors
elemen dalam isi permintaan, aturan CORS yang ada akan dipertahankan.
Untuk menonaktifkan CORS, panggil Set Table Service Properties
dengan pengaturan aturan CORS kosong (misalnya, </Cors>
) dan tidak ada aturan CORS dalam. Panggilan ini menghapus aturan yang ada dan menonaktifkan CORS untuk Table Storage.
Semua elemen aturan CORS diperlukan jika Anda menentukan CorsRule
elemen . Jika ada elemen yang hilang, permintaan akan gagal dengan kode kesalahan 400 (Permintaan Buruk).
Dimulai dengan versi 2013-08-15, elemen untuk pengaturan XML bersifat opsional. Anda dapat memperbarui elemen tertentu dengan mengirim XML yang hanya berisi elemen yang diperbarui dan tidak memengaruhi pengaturan lain.
Untuk informasi mendetail tentang aturan CORS dan logika evaluasi, lihat dukungan CORS untuk layanan Azure Storage.
Sampel permintaan dan respons
Contoh URI berikut membuat permintaan untuk mengubah properti Table Storage untuk akun penyimpanan fiktif bernama myaccount:
PUT 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: Mon, 21 Oct 2013 04:38:23 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.table.core.windows.net
Permintaan dikirim dengan isi XML berikut:
<?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>
Setelah permintaan dikirim, respons berikut dikembalikan:
HTTP/1.1 202 Accepted
Connection: Keep-Alive
Transfer-Encoding: chunked
Date: Mon, 21 Oct 2013 04:38:24 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