Blob Services - Set Service Properties
Mengatur properti layanan Blob akun penyimpanan, termasuk properti untuk Analisis Penyimpanan dan aturan CORS (Berbagi Sumber Daya Lintas Asal).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2025-06-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
Nama akun penyimpanan dalam grup sumber daya yang ditentukan. Panjang nama akun penyimpanan harus antara 3 dan 24 karakter dan hanya menggunakan angka dan huruf kecil. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
Isi Permintaan
| Nama | Jenis | Deskripsi |
|---|---|---|
| properties.automaticSnapshotPolicyEnabled |
boolean |
Tidak digunakan lagi demi properti isVersioningEnabled. |
| properties.changeFeed |
Properti layanan blob untuk peristiwa umpan perubahan. |
|
| properties.containerDeleteRetentionPolicy |
Properti layanan blob untuk penghapusan sementara kontainer. |
|
| properties.cors |
Menentukan aturan CORS untuk layanan Blob. 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 Blob. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion menunjukkan versi default yang akan digunakan untuk permintaan ke layanan Blob jika versi permintaan masuk tidak ditentukan. Nilai yang mungkin termasuk versi 2008-10-27 dan semua versi terbaru lainnya. |
| properties.deleteRetentionPolicy |
Properti layanan blob untuk penghapusan sementara blob. |
|
| properties.isVersioningEnabled |
boolean |
Penerapan versi diaktifkan jika diatur ke true. |
| properties.lastAccessTimeTrackingPolicy |
Properti layanan blob untuk mengonfigurasi kebijakan pelacakan berbasis waktu akses terakhir. |
|
| properties.restorePolicy |
Properti layanan blob untuk kebijakan pemulihan blob. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi pembaruan 'BlobServiceProperties' sumber daya berhasil |
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
|
Blob |
|
Blob |
|
Put |
BlobServicesPutAllowPermanentDelete
Permintaan sampel
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01
{
"properties": {
"deleteRetentionPolicy": {
"allowPermanentDelete": true,
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
Respon sampel
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"deleteRetentionPolicy": {
"allowPermanentDelete": true,
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
BlobServicesPutLastAccessTimeBasedTracking
Permintaan sampel
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01
{
"properties": {
"lastAccessTimeTrackingPolicy": {
"name": "AccessTimeTracking",
"blobType": [
"blockBlob"
],
"enable": true,
"trackingGranularityInDays": 1
}
}
}
Respon sampel
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"lastAccessTimeTrackingPolicy": {
"name": "AccessTimeTracking",
"blobType": [
"blockBlob"
],
"enable": true,
"trackingGranularityInDays": 1
}
}
}
PutBlobServices
Permintaan sampel
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01
{
"properties": {
"changeFeed": {
"enabled": true,
"retentionInDays": 7
},
"cors": {
"corsRules": [
{
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"exposedHeaders": [
"x-ms-meta-*"
],
"maxAgeInSeconds": 100
},
{
"allowedHeaders": [
"*"
],
"allowedMethods": [
"GET"
],
"allowedOrigins": [
"*"
],
"exposedHeaders": [
"*"
],
"maxAgeInSeconds": 2
},
{
"allowedHeaders": [
"x-ms-meta-12345675754564*"
],
"allowedMethods": [
"GET",
"PUT"
],
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"maxAgeInSeconds": 2000
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
Respon sampel
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"changeFeed": {
"enabled": true,
"retentionInDays": 7
},
"cors": {
"corsRules": [
{
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"exposedHeaders": [
"x-ms-meta-*"
],
"maxAgeInSeconds": 100
},
{
"allowedHeaders": [
"*"
],
"allowedMethods": [
"GET"
],
"allowedOrigins": [
"*"
],
"exposedHeaders": [
"*"
],
"maxAgeInSeconds": 2
},
{
"allowedHeaders": [
"x-ms-meta-12345675754564*"
],
"allowedMethods": [
"GET",
"PUT"
],
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"maxAgeInSeconds": 2000
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
},
"sku": {
"name": "Standard_GRS",
"tier": "Standard"
}
}
Definisi
| Nama | Deskripsi |
|---|---|
|
Allowed |
|
|
Blob |
Properti layanan Blob akun penyimpanan. |
|
Change |
Properti layanan blob untuk peristiwa umpan perubahan. |
|
Cors |
Menentukan aturan CORS untuk layanan Blob. |
|
Cors |
Mengatur aturan CORS. Anda dapat menyertakan hingga lima elemen CorsRule dalam permintaan. |
|
Delete |
Properti layanan untuk penghapusan sementara. |
|
Error |
Respons kesalahan dari penyedia sumber daya penyimpanan. |
|
Error |
Kontrak isi respons kesalahan. |
|
Last |
Properti layanan blob untuk Kebijakan pelacakan berbasis waktu akses terakhir. |
| Name |
Nama kebijakan. Nilai yang valid adalah AccessTimeTracking. Bidang ini hanya dapat dibaca |
|
Restore |
Properti layanan blob untuk kebijakan pemulihan blob |
| Sku |
SKU akun penyimpanan. |
|
Sku |
Nama SKU. Diperlukan untuk pembuatan akun; opsional untuk pembaruan. Perhatikan bahwa dalam versi yang lebih lama, nama SKU disebut accountType. |
|
Sku |
Tingkat SKU. Ini didasarkan pada nama SKU. |
AllowedMethods
| Nilai | Deskripsi |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
BlobServiceProperties
Properti layanan Blob akun penyimpanan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
Nama sumber daya |
| properties.automaticSnapshotPolicyEnabled |
boolean |
Tidak digunakan lagi demi properti isVersioningEnabled. |
| properties.changeFeed |
Properti layanan blob untuk peristiwa umpan perubahan. |
|
| properties.containerDeleteRetentionPolicy |
Properti layanan blob untuk penghapusan sementara kontainer. |
|
| properties.cors |
Menentukan aturan CORS untuk layanan Blob. 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 Blob. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion menunjukkan versi default yang akan digunakan untuk permintaan ke layanan Blob jika versi permintaan masuk tidak ditentukan. Nilai yang mungkin termasuk versi 2008-10-27 dan semua versi terbaru lainnya. |
| properties.deleteRetentionPolicy |
Properti layanan blob untuk penghapusan sementara blob. |
|
| properties.isVersioningEnabled |
boolean |
Penerapan versi diaktifkan jika diatur ke true. |
| properties.lastAccessTimeTrackingPolicy |
Properti layanan blob untuk mengonfigurasi kebijakan pelacakan berbasis waktu akses terakhir. |
|
| properties.restorePolicy |
Properti layanan blob untuk kebijakan pemulihan blob. |
|
| sku |
Nama dan tingkatan SKU. |
|
| type |
string |
Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
ChangeFeed
Properti layanan blob untuk peristiwa umpan perubahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| enabled |
boolean |
Menunjukkan apakah pengelogan peristiwa umpan perubahan diaktifkan untuk layanan Blob. |
| retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
Menunjukkan durasi retensi changeFeed dalam hari. Nilai minimum adalah 1 hari dan nilai maksimum adalah 146000 hari (400 tahun). Nilai null menunjukkan retensi tak terbatas dari umpan perubahan. |
CorsRule
Menentukan aturan CORS untuk layanan Blob.
| Nama | Jenis | Deskripsi |
|---|---|---|
| allowedHeaders |
string[] |
Diperlukan jika elemen CorsRule ada. Daftar header yang diizinkan untuk menjadi bagian dari permintaan lintas asal. |
| allowedMethods |
Diperlukan jika elemen CorsRule ada. Daftar metode HTTP yang diizinkan untuk dijalankan oleh asal. |
|
| allowedOrigins |
string[] |
Diperlukan jika elemen CorsRule ada. Daftar domain asal yang akan diizinkan melalui CORS, atau "*" untuk mengizinkan semua domain |
| exposedHeaders |
string[] |
Diperlukan jika elemen CorsRule ada. Daftar header respons untuk diekspos ke klien CORS. |
| maxAgeInSeconds |
integer (int32) |
Diperlukan jika elemen CorsRule ada. Jumlah detik klien/browser harus menyimpan respons preflight. |
CorsRules
Mengatur aturan CORS. Anda dapat menyertakan hingga lima elemen CorsRule dalam permintaan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| corsRules |
Cors |
Daftar aturan CORS. Anda dapat menyertakan hingga lima elemen CorsRule dalam permintaan. |
DeleteRetentionPolicy
Properti layanan untuk penghapusan sementara.
| Nama | Jenis | Deskripsi |
|---|---|---|
| allowPermanentDelete |
boolean |
Properti ini ketika diatur ke true memungkinkan penghapusan versi blob dan rekam jepret yang dihapus sementara. Properti ini tidak dapat digunakan kebijakan pemulihan blob. Properti ini hanya berlaku untuk layanan blob dan tidak berlaku untuk kontainer atau berbagi file. |
| days |
integer (int32) minimum: 1maximum: 365 |
Menunjukkan jumlah hari item yang dihapus harus dipertahankan. Nilai minimum yang ditentukan bisa 1 dan nilai maksimumnya bisa 365. |
| enabled |
boolean |
Menunjukkan apakah DeleteRetentionPolicy diaktifkan. |
ErrorResponse
Respons kesalahan dari penyedia sumber daya penyimpanan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Isi respons kesalahan Penyedia Sumber Daya Azure Storage. |
ErrorResponseBody
Kontrak isi respons kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| code |
string |
Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram. |
| message |
string |
Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna. |
LastAccessTimeTrackingPolicy
Properti layanan blob untuk Kebijakan pelacakan berbasis waktu akses terakhir.
| Nama | Jenis | Deskripsi |
|---|---|---|
| blobType |
string[] |
Array jenis blob yang didukung yang telah ditentukan sebelumnya. Hanya blockBlob yang merupakan nilai yang didukung. Bidang ini hanya dapat dibaca |
| enable |
boolean |
Ketika diatur ke pelacakan berbasis waktu akses terakhir yang benar diaktifkan. |
| name |
Nama kebijakan. Nilai yang valid adalah AccessTimeTracking. Bidang ini hanya dapat dibaca |
|
| trackingGranularityInDays |
integer (int32) |
Bidang menentukan granularitas pelacakan objek blob dalam beberapa hari, biasanya seberapa sering objek blob harus dilacak. Bidang ini saat ini hanya dibaca dengan nilai sebagai 1 |
Name
Nama kebijakan. Nilai yang valid adalah AccessTimeTracking. Bidang ini hanya dapat dibaca
| Nilai | Deskripsi |
|---|---|
| AccessTimeTracking |
RestorePolicyProperties
Properti layanan blob untuk kebijakan pemulihan blob
| Nama | Jenis | Deskripsi |
|---|---|---|
| days |
integer (int32) minimum: 1maximum: 365 |
berapa lama blob ini dapat dipulihkan. Ini harus lebih besar dari nol dan kurang dari DeleteRetentionPolicy.days. |
| enabled |
boolean |
Pemulihan blob diaktifkan jika diatur ke true. |
| lastEnabledTime |
string (date-time) |
Tidak digunakan lagi untuk mendukung properti minRestoreTime. |
| minRestoreTime |
string (date-time) |
Mengembalikan tanggal dan waktu minimum pemulihan dapat dimulai. |
Sku
SKU akun penyimpanan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| name |
Nama SKU. Diperlukan untuk pembuatan akun; opsional untuk pembaruan. Perhatikan bahwa dalam versi yang lebih lama, nama SKU disebut accountType. |
|
| tier |
Tingkat SKU. Ini didasarkan pada nama SKU. |
SkuName
Nama SKU. Diperlukan untuk pembuatan akun; opsional untuk pembaruan. Perhatikan bahwa dalam versi yang lebih lama, nama SKU disebut accountType.
| Nilai | Deskripsi |
|---|---|
| Standard_LRS | |
| Standard_GRS | |
| Standard_RAGRS | |
| Standard_ZRS | |
| Premium_LRS | |
| Premium_ZRS | |
| Standard_GZRS | |
| Standard_RAGZRS | |
| StandardV2_LRS | |
| StandardV2_GRS | |
| StandardV2_ZRS | |
| StandardV2_GZRS | |
| PremiumV2_LRS | |
| PremiumV2_ZRS |
SkuTier
Tingkat SKU. Ini didasarkan pada nama SKU.
| Nilai | Deskripsi |
|---|---|
| Standard | |
| Premium |