Mendapatkan Properti Layanan Antrean
Operasi ini Get Queue Service Properties
mendapatkan properti akun Azure Queue Storage, termasuk properti untuk Storage Analytics dan aturan berbagi sumber daya lintas asal (CORS).
Untuk informasi selengkapnya tentang aturan berbagi sumber daya lintas asal (CORS) dan logika evaluasi, lihat dukungan CORS untuk layanan Azure Storage.
Minta
Permintaan Get Queue Service Properties
dapat ditentukan sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS. Ganti <nama> akun dengan nama akun penyimpanan Anda:
Metode | Meminta URI | Versi HTTP |
---|---|---|
GET | 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 tambahan berikut dapat ditentukan pada URI permintaan:
Parameter | Deskripsi |
---|---|
restype=service&comp=properties |
Wajib diisi. Kombinasi kedua string kueri diperlukan untuk mendapatkan properti layanan penyimpanan. |
timeout |
Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur waktu habis untuk operasi Azure Queue Storage. |
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. Untuk informasi selengkapnya, lihat Memantau Azure Queue 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 |
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
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>
Pada 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-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>
</CorsRule>
</Cors>
</StorageServiceProperties>
Elemen isi respons dijelaskan dalam tabel berikut:
Nama Elemen | Deskripsi |
---|---|
Pengelogan | Mengelompokkan pengaturan Pengelogan Storage Analytics. |
Metrik | Mengelompokkan pengaturan Metrik Analitik Penyimpanan. Pengaturan Metrik menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk antrean. |
HourMetrics | Mengelompokkan pengaturan Storage Analytics HourMetrics . Pengaturan HourMetrics menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk antrean. |
MinuteMetrics | Mengelompokkan pengaturan Storage Analytics MinuteMetrics*. Pengaturan MinuteMetrics menyediakan statistik permintaan untuk setiap menit untuk antrean. |
Versi | Versi Storage Analytics yang saat ini sedang digunakan. |
Hapus | 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 Azure Queue 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 | 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 tanda bintang (*) jika semua domain diizinkan. |
ExposedHeaders | Daftar header respons yang dipisahkan koma untuk diekspos ke klien CORS. |
MaxAgeInSeconds | Jumlah detik klien atau 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 dieksekusi 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.
Sampel permintaan dan respons
Contoh URI berikut membuat permintaan untuk mendapatkan properti layanan Antrean untuk akun penyimpanan fiksi bernama myaccount:
GET 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:49:03 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.queue.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-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2013-08-15
Isi responsnya 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 Azure Storage
Spesifikasi HTTP CORS