Mengatur Properti Blob Service
Operasi ini Set Blob Service Properties
menetapkan properti untuk titik akhir Blob Storage akun penyimpanan, termasuk properti untuk Storage Analytics, aturan berbagi sumber daya lintas asal (CORS), dan pengaturan penghapusan sementara.
Anda juga dapat menggunakan operasi ini untuk mengatur versi permintaan default untuk semua permintaan masuk ke Blob Storage yang tidak memiliki versi tertentu.
Untuk informasi selengkapnya tentang aturan CORS, lihat dukungan CORS untuk layanan Azure Storage.
Minta
Permintaan Set Blob 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 |
---|---|---|
PUT | https://account-name.blob.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
URI Parameter | Deskripsi |
---|---|
restype=service&comp=properties |
Wajib diisi. Kombinasi kedua string kueri diperlukan untuk mengatur properti layanan penyimpanan. |
timeout |
Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur waktu habis untuk operasi Blob Storage. |
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 Blob 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>
<!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</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-verbs</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>
<!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>
Untuk versi 2017-07-29 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-verbs</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>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
</StorageServiceProperties>
Untuk versi 2018-03-28 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-verbs</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>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true|false</Enabled>
<IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
<ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
Untuk versi 2019-12-12 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-verbs</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>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true|false</Enabled>
<IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
<DefaultIndexDocumentPath>absolute-path-of-the-default-index-page</DefaultIndexDocumentPath>
<ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
Pada versi 2013-08-15, Anda dapat memanggil Set Blob Service Properties
dengan satu atau beberapa elemen akar yang ditentukan dalam isi permintaan. Elemen akar meliputi:
- Pengelogan
- HourMetrics
- MinuteMetrics
- Cors
- DefaultServiceVersion
- DeleteRetentionPolicy: Versi 2017-07-29 dan yang lebih baru
- StaticWebsite: Versi 2018-03-28 dan yang lebih baru
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, Anda harus menentukan setiap elemen anak untuk elemen tersebut.
Tabel berikut ini menjelaskan elemen isi permintaan:
Nama elemen | Deskripsi |
---|---|
Pengelogan | Opsional pada versi 2013-08-15. Diperlukan untuk versi yang lebih lama. Grup pengaturan Pengelogan Azure Analytics. |
Metrik | Diperlukan untuk versi 2012-02-12 dan yang lebih lama. Tidak berlaku untuk versi 2013-08-15 dan yang lebih baru. Grup pengaturan Metrik Azure Analytics, yang menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk blob. |
HourMetrics | Opsional untuk versi 2013-08-15 dan yang lebih baru; tidak berlaku untuk versi yang lebih lama. Grup pengaturan HourMetrics Azure Analytics, yang menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk blob. |
MinuteMetrics | Opsional untuk versi 2013-08-15 dan yang lebih baru; tidak berlaku untuk versi yang lebih lama. Grup pengaturan MinuteMetrics Azure Analytics, yang menyediakan statistik permintaan untuk setiap menit untuk blob. 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 Blob Storage. 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 dihapus. Nilai minimum yang dapat Anda tentukan adalah 1 ; nilai terbesar adalah 365 (satu tahun). |
RetentionPolicy/AllowPermanentDelete | Opsional, versi 2020-02-10 dan yang lebih baru. Memungkinkan Anda mengaktifkan penghapusan permanen pada akun penyimpanan. Nilai defaultnya adalah false. |
DefaultServiceVersion | Pilihan. Untuk mengatur DefaultServiceVersion, panggil Set Blob Service Properties dengan menggunakan versi 2011-08-18 dan yang lebih baru.
DefaultServiceVersion menunjukkan versi default yang akan digunakan untuk permintaan ke Blob Storage jika versi permintaan masuk tidak ditentukan. Nilai yang mungkin termasuk versi 2008-10-27 dan yang lebih baru. Untuk informasi selengkapnya tentang versi yang berlaku, lihat Penerapan versi untuk layanan Azure Storage.Hanya berlaku untuk Blob Storage. |
Cors | Pilihan. Elemen Cors didukung untuk versi 2013-08-15 dan yang lebih baru. Grup semua aturan CORS. Menghilangkan grup elemen ini tidak menimpa pengaturan CORS yang ada. |
CorsRule | Pilihan. Menentukan aturan CORS untuk Blob Storage. Anda dapat menyertakan hingga lima elemen CorsRule dalam permintaan. Jika tidak ada elemen CorsRule yang disertakan dalam isi permintaan, semua aturan CORS dihapus, dan CORS dinonaktifkan untuk Blob Storage. |
AllowedOrigins | Diperlukan jika elemen CorsRule ada. Daftar domain asal yang dipisahkan koma yang diizinkan melalui CORS, atau "*" untuk mengizinkan semua domain. Domain asal juga dapat menyertakan karakter kartubebas dalam 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 mencapai 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 mencapai 256 karakter. |
AllowedMethods | Diperlukan jika elemen CorsRule ada. Daftar metode HTTP yang dipisahkan koma yang diizinkan untuk dieksekusi oleh asal. Untuk Azure Storage, metode yang diizinkan adalah DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS, dan PUT. |
DeleteRetentionPolicy | Opsional. Untuk mengatur DeleteRetentionPolicy, panggil Set Blob Service Properties dengan menggunakan versi 2017-07-29 dan yang lebih baru. Grup pengaturan penghapusan sementara. Hanya berlaku untuk Blob Storage. |
DeleteRetentionPolicy/Enabled | Wajib diisi. Menunjukkan apakah blob atau rekam jepret yang dihapus dipertahankan atau segera dihapus oleh operasi penghapusan. |
DeleteRetentionPolicy/Days | Diperlukan hanya jika DeleteRetentionPolicy/Enabled benar. Menunjukkan jumlah hari blob yang dihapus dipertahankan. Semua data yang lebih lama dari nilai ini dihapus secara permanen. Nilai minimum yang dapat Anda tentukan adalah 1 ; nilai terbesar adalah 365 . |
StaticWebsite | Opsional. Untuk mengatur properti StaticWebsite , panggil Set Blob Service Properties dengan menggunakan versi 2018-03-28 dan yang lebih baru. Hanya berlaku untuk Blob Storage. |
StaticWebsite/Diaktifkan | Wajib diisi. Menunjukkan apakah dukungan situs web statis diaktifkan untuk akun yang ditentukan. |
StaticWebsite/IndexDocument | Opsional. Halaman web yang dilayani Azure Storage untuk permintaan ke akar situs web atau subfolder apa pun (misalnya, index.html ). Nilai ini peka huruf besar/kecil. |
StaticWebsite/DefaultIndexDocumentPath | Pilihan. Jalur absolut ke halaman web yang dilayani Azure Storage untuk permintaan yang tidak sesuai dengan file yang ada. Konten halaman dikembalikan dengan HTTP 200 OK (misalnya, index.html ). Elemen ini saling eksklusif dengan StaticWebsite/IndexDocument . Nilai ini peka huruf besar/kecil. |
StaticWebsite/ErrorDocument404Path | Pilihan. Jalur absolut ke halaman web yang dilayani Azure Storage untuk permintaan yang tidak sesuai dengan file yang ada. Konten halaman dikembalikan dengan HTTP 404 Not Found (misalnya, error/404.html ). Hanya satu halaman 404 kustom yang didukung di setiap situs web statis. Nilai ini peka huruf besar/kecil. |
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
Otorisasi diperlukan saat memanggil operasi akses data apa pun di Azure Storage. Anda dapat mengotorisasi operasi seperti yang Set Blob Service Properties
dijelaskan di bawah ini.
Penting
Microsoft merekomendasikan penggunaan Microsoft Entra ID dengan identitas terkelola untuk mengotorisasi permintaan ke Azure Storage. Microsoft Entra ID memberikan keamanan yang unggul dan kemudahan penggunaan dibandingkan dengan otorisasi Kunci Bersama.
Azure Storage mendukung penggunaan Microsoft Entra ID untuk mengotorisasi permintaan ke data blob. Dengan Microsoft Entra ID, Anda dapat menggunakan kontrol akses berbasis peran Azure (Azure RBAC) untuk memberikan izin kepada prinsip keamanan. Perwakilan keamanan mungkin pengguna, grup, perwakilan layanan aplikasi, atau identitas terkelola Azure. Perwakilan keamanan diautentikasi oleh Microsoft Entra ID untuk mengembalikan token OAuth 2.0. Token kemudian dapat digunakan untuk mengotorisasi permintaan terhadap Blob service.
Untuk mempelajari selengkapnya tentang otorisasi menggunakan Microsoft Entra ID, lihat Mengotorisasi akses ke blob menggunakan Microsoft Entra ID.
Izin
Tercantum di bawah ini adalah tindakan RBAC yang diperlukan untuk pengguna, grup, identitas terkelola, atau perwakilan layanan Microsoft Entra untuk memanggil Set Blob Service Properties
operasi, dan peran Azure RBAC bawaan yang paling tidak istimewa yang mencakup tindakan ini:
- Tindakan Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/write
- Peran bawaan dengan hak istimewa paling sedikit:Kontributor Akun Penyimpanan
Untuk mempelajari selengkapnya tentang menetapkan peran menggunakan Azure RBAC, lihat Menetapkan peran Azure untuk akses ke data blob.
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:
Header harfiah, di mana nama header yang tepat disediakan, seperti x-ms-meta-processed. Maksimal 64 header literal dapat ditentukan pada permintaan.
Header yang diawali, 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 elemen AllowedMethods harus sesuai dengan metode yang didukung oleh API Azure Storage. Metode yang didukung adalah DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS, dan PUT.
Menentukan aturan CORS pada permintaan bersifat opsional. Jika Anda memanggil Set Blob Service Properties
tanpa menentukan elemen Cors dalam isi permintaan, aturan CORS yang ada akan dipertahankan.
Untuk menonaktifkan CORS, panggil Set Blob 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 Blob Storage.
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.
Billing
Permintaan harga dapat berasal dari klien yang menggunakan API Blob Storage, baik langsung melalui BLob Storage REST API, atau dari pustaka klien Azure Storage. Permintaan ini mengumpulkan biaya per transaksi. Jenis transaksi memengaruhi bagaimana akun ditagih. Misalnya, membaca transaksi bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut ini memperlihatkan kategori penagihan untuk Set Blob Service Properties
permintaan berdasarkan jenis akun penyimpanan:
Operasi | Jenis akun penyimpanan | Kategori penagihan |
---|---|---|
Mengatur Properti Blob Service | Objek besar biner blok premium Tujuan umum standar v2 |
Operasi lainnya |
Mengatur Properti Blob Service | Tujuan umum standar v1 | Operasi tulis |
Untuk mempelajari tentang harga untuk kategori penagihan yang ditentukan, lihat harga Azure Blob Storage.
Sampel permintaan dan respons
Contoh URI berikut membuat permintaan untuk mengubah properti Blob Storage untuk akun penyimpanan fiksi bernama myaccount:
PUT https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1
Permintaan dikirim dengan header berikut:
x-ms-version: 2018-03-28
x-ms-date: Tue, 12 Sep 2018 23:38:35 GMT
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.blob.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>
<DeleteRetentionPolicy>
<Enabled>true</Enabled>
<Days>5</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true</Enabled>
<IndexDocument>index.html</IndexDocument>
<ErrorDocument404Path>error/404.html</ErrorDocument404Path>
</StaticWebsite>
<DefaultServiceVersion>2018-03-28</DefaultServiceVersion>
</StorageServiceProperties>
Setelah permintaan dikirim, respons berikut dikembalikan:
HTTP/1.1 202 Accepted
Transfer-Encoding: chunked
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2018-03-28
Date: Tue, 12 Sep 2018 23:38:35 GMT
Lihat juga
Analitik Penyimpanan
Dukungan CORS untuk layanan Azure Storage
Spesifikasi HTTP CORS