Mengatur Properti Blob Service

Artikel
03/16/2023

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. Mengelompokkan 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. Mengelompokkan 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. Mengelompokkan 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. Mengelompokkan 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	Opsional. Elemen Cors didukung untuk versi 2013-08-15 dan yang lebih baru. Mengelompokkan 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	Pilihan. Untuk mengatur DeleteRetentionPolicy, panggil `Set Blob Service Properties` dengan menggunakan versi 2017-07-29 dan yang lebih baru. Mengelompokkan 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	Pilihan. 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	Pilihan. 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.

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, atau perwakilan layanan yang 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.

Tanda tangan akses bersama (SAS) menyediakan akses yang didelegasikan dengan aman ke sumber daya di akun penyimpanan. Dengan SAS, Anda memiliki kontrol terperinci atas bagaimana klien dapat mengakses data. Anda dapat menentukan sumber daya apa yang dapat diakses klien, izin apa yang mereka miliki ke sumber daya tersebut, dan berapa lama SAS valid.

Operasi ini Set Blob Service Properties mendukung otorisasi menggunakan SAS akun.

Ketika akses Kunci Bersama tidak diizinkan untuk akun penyimpanan, token SAS akun tidak akan diizinkan berdasarkan permintaan ke Blob Storage. Untuk mempelajari selengkapnya, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Akun SAS

Akun SAS diamankan dengan kunci akun penyimpanan. Akun SAS delegasikan akses ke sumber daya di satu atau beberapa layanan penyimpanan. Semua operasi yang tersedia melalui layanan atau delegasi pengguna SAS juga tersedia melalui akun SAS.

Tabel berikut menunjukkan jenis sumber daya yang ditandatangani dan izin yang ditandatangani untuk ditentukan saat mendelegasikan akses:

Operasi	Layanan yang ditandatangani	Jenis sumber daya yang ditandatangani	Izin yang ditandatangani
Mengatur Properti Blob Service	Blob (b)	Layanan (s)	Tulis (w)

Untuk mempelajari selengkapnya tentang akun SAS, lihat Membuat AKUN SAS.

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