Mengatur Properti Layanan Antrean

  • Artikel

Operasi ini Set Queue Service Properties menetapkan properti untuk titik akhir layanan Antrean akun penyimpanan, termasuk properti untuk Storage Analytics dan aturan berbagi sumber daya lintas asal (CORS). Lihat Dukungan CORS untuk Layanan Penyimpanan untuk informasi selengkapnya tentang aturan CORS.

Minta

Anda dapat menentukan Set Queue Service Properties permintaan sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS. Ganti nama akun dengan nama akun penyimpanan Anda:

Metode Meminta URI Versi HTTP
PUT https://account-name.queue.core.windows.net/?restype=service&comp=properties HTTP/1.1

Catatan

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

Parameter URI

Parameter Deskripsi
restype=service&comp=properties Wajib diisi. Kombinasi kedua string kueri diperlukan untuk mengatur properti layanan Azure Storage.
timeout Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur waktu habis untuk operasi layanan Antrean.

Header permintaan

Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:

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. Untuk informasi selengkapnya, lihat Memantau Azure Queue Storage.

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-seperated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>

Pada versi 2013-08-15, Anda dapat memanggil Set Queue Service Properties dengan satu atau beberapa elemen akar yang ditentukan dalam isi permintaan. Elemen akar meliputi:

  • Pengelogan
  • HourMetrics
  • MinuteMetrics
  • Cors

Tidak perlu lagi menentukan setiap elemen akar pada permintaan. Jika Anda menghilangkan elemen akar, pengaturan yang ada untuk layanan untuk fungsionalitas tersebut dipertahankan. Namun, jika Anda menentukan elemen akar tertentu, Anda harus menentukan setiap elemen anak untuk elemen tersebut.

Elemen isi permintaan dijelaskan dalam tabel berikut:

Nama elemen Deskripsi
Pengelogan Opsional pada versi 2013-08-15. Diperlukan untuk versi yang lebih lama. Mengelompokkan pengaturan Pengelogan Storage Analytics.
Metrik Diperlukan untuk versi 2012-02-12 dan yang lebih lama. Tidak berlaku untuk versi 2013-08-15 dan yang lebih baru. Mengelompokkan pengaturan Metrik Storage Analytics . Pengaturan Metrik menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk antrean.
HourMetrics Opsional untuk versi 2013-08-15 dan yang lebih baru. Tidak berlaku untuk versi yang lebih lama. Mengelompokkan pengaturan HourMetrics Storage Analytics . Pengaturan HourMetrics menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk antrean.
MinuteMetrics Opsional untuk versi 2013-08-15 dan yang lebih baru. Tidak berlaku untuk versi yang lebih lama. Mengelompokkan pengaturan MinuteMetrics Storage Analytics . Pengaturan MinuteMetrics menyediakan statistik permintaan untuk setiap menit untuk antrean. Untuk versi yang lebih lama dari 2013-08-15, MinuteMetrics tidak disertakan dalam isi respons.
Versi Diperlukan jika pengaturan Pengelogan, Metrik, HourMetrics, atau MinuteMetrics ditentukan. Versi Storage Analytics untuk dikonfigurasi.
Hapus Diperlukan jika pengaturan Pengelogan, Metrik, HourMetrics, atau MinuteMetrics ditentukan. Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah semua permintaan penghapusan harus dicatat.
Baca Diperlukan jika pengaturan Pengelogan, Metrik, HourMetrics, atau MinuteMetrics ditentukan. Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah semua permintaan baca harus dicatat.
Tulis Diperlukan jika pengaturan Pengelogan, Metrik, HourMetrics, atau MinuteMetrics ditentukan. Hanya berlaku untuk konfigurasi pengelogan. Menunjukkan apakah semua permintaan tulis harus dicatat.
Aktif Wajib diisi. Menunjukkan apakah metrik diaktifkan untuk layanan Antrean.

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 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 penyimpanan.
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, dan nilai maksimumnya adalah 365 (satu tahun).
Cors Pilihan. Elemen Cors 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 layanan Antrean. Anda dapat menyertakan hingga lima elemen CorsRule dalam permintaan. Jika tidak ada elemen CorsRule yang disertakan dalam isi permintaan, semua aturan CORS akan dihapus, dan CORS akan dinonaktifkan untuk layanan Antrean.
AllowedOrigins Diperlukan jika elemen CorsRule ada. Daftar domain asal yang dipisahkan koma yang akan diizinkan melalui CORS, atau "*" 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 elemen CorsRule ada. Daftar header respons yang dipisahkan koma untuk diekspos ke klien CORS. Terbatas pada 64 header yang ditentukan dan dua header awalan. Setiap header dapat berisi hingga 256 karakter.
MaxAgeInSeconds Diperlukan jika elemen CorsRule ada. Jumlah detik klien/browser harus menyimpan respons preflight.
AllowedHeaders Diperlukan jika elemen CorsRule ada. 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 berisi hingga 256 karakter.
AllowedMethods Diperlukan jika elemen CorsRule ada. Daftar metode HTTP yang dipisahkan koma yang diizinkan untuk dijalankan oleh asal. Untuk Azure Storage, metode yang diizinkan adalah DELETE, , GET, HEADMERGE, POST, OPTIONS, atau PUT.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode status

Operasi yang berhasil mengembalikan kode status 202 (Diterima).

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 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 berisi tidak lebih dari 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header 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:

  • Maksimal lima aturan dapat disimpan.

  • 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 mungkin salah satu dari yang berikut ini:

    • Header harfiah, di mana nama header yang tepat disediakan, seperti x-ms-meta-processed. Maksimal 64 header literal dapat ditentukan pada permintaan.

    • Header awalan, di mana awalan header disediakan, seperti x-ms-meta-data*. Menentukan awalan dengan cara ini memungkinkan atau mengekspos header apa pun yang dimulai dengan awalan yang ditentukan. Maksimal dua header awalan dapat ditentukan pada permintaan.

  • Metode (atau kata kerja HTTP) yang ditentukan dalam AllowedMethods elemen harus sesuai dengan metode yang didukung oleh API layanan Azure Storage. Metode yang didukung adalah DELETE, , HEADGET, MERGE, POST, OPTIONS, dan PUT.

Menentukan aturan CORS pada permintaan bersifat opsional. Jika Anda memanggil Set Queue Service Properties tanpa menentukan elemen Cors dalam isi permintaan, aturan CORS yang ada akan dipertahankan.

Untuk menonaktifkan CORS, panggil Set Queue Service Properties dengan pengaturan aturan CORS kosong (yaitu,*</Cors>) dan tidak ada aturan CORS dalam. Panggilan ini menghapus aturan yang ada, dan menonaktifkan CORS untuk layanan Antrean.

Semua elemen aturan CORS diperlukan jika elemen CorsRule ditentukan. Permintaan gagal dengan kode kesalahan 400 (Bad Request) jika ada elemen yang hilang.

Pada versi 2013-08-15, elemen pengaturan XML bersifat opsional, sehingga Anda dapat memperbarui elemen tertentu dengan mengirim XML yang hanya berisi elemen yang diperbarui. Pengaturan lain tidak terpengaruh.

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 layanan Antrean untuk akun penyimpanan fiktif bernama myaccount:

PUT https://myaccount.queue.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:28:19 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.queue.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>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> 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: Wed, 23 Oct 2013 04:28:20 GMT  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2013-08-15

Lihat juga

Dukungan CORS untuk layanan Azure Storage
Spesifikasi HTTP CORS