Blob Services - Set Service Properties
Mengatur properti blob service akun penyimpanan, termasuk properti untuk aturan Storage Analytics dan CORS (Cross-Origin Resource Sharing).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-01-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
account
|
path | True |
string |
Nama akun penyimpanan dalam grup sumber daya yang ditentukan. Nama akun penyimpanan harus sepanjang antara 3 dan 24 karakter dan hanya menggunakan angka dan huruf kecil. Regex pattern: |
Blob
|
path | True |
Nama Layanan blob dalam akun penyimpanan yang ditentukan. Nama Blob Service harus 'default' |
|
resource
|
path | True |
string |
Nama grup sumber daya dalam langganan pengguna. Nama tidak peka huruf besar/kecil. Regex pattern: |
subscription
|
path | True |
string |
ID langganan target. |
api-version
|
query | True |
string |
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 blob service. 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 digunakan untuk permintaan ke layanan Blob jika versi permintaan masuk tidak ditentukan. Nilai yang mungkin termasuk versi 2008-10-27 dan semua versi terbaru. |
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 |
OK -- Mengatur properti Blob service akun penyimpanan dengan sukses. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
Blob |
Blob |
Put |
BlobServicesPutAllowPermanentDelete
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01
{
"properties": {
"deleteRetentionPolicy": {
"enabled": true,
"days": 300,
"allowPermanentDelete": true
},
"isVersioningEnabled": true
}
}
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"properties": {
"deleteRetentionPolicy": {
"enabled": true,
"days": 300,
"allowPermanentDelete": true
},
"isVersioningEnabled": true
}
}
BlobServicesPutLastAccessTimeBasedTracking
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01
{
"properties": {
"lastAccessTimeTrackingPolicy": {
"enable": true,
"name": "AccessTimeTracking",
"trackingGranularityInDays": 1,
"blobType": [
"blockBlob"
]
}
}
}
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"properties": {
"lastAccessTimeTrackingPolicy": {
"enable": true,
"name": "AccessTimeTracking",
"trackingGranularityInDays": 1,
"blobType": [
"blockBlob"
]
}
}
}
PutBlobServices
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01
{
"properties": {
"cors": {
"corsRules": [
{
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"maxAgeInSeconds": 100,
"exposedHeaders": [
"x-ms-meta-*"
],
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
]
},
{
"allowedOrigins": [
"*"
],
"allowedMethods": [
"GET"
],
"maxAgeInSeconds": 2,
"exposedHeaders": [
"*"
],
"allowedHeaders": [
"*"
]
},
{
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"allowedMethods": [
"GET",
"PUT"
],
"maxAgeInSeconds": 2000,
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"allowedHeaders": [
"x-ms-meta-12345675754564*"
]
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"enabled": true,
"days": 300
},
"isVersioningEnabled": true,
"changeFeed": {
"enabled": true,
"retentionInDays": 7
}
}
}
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"properties": {
"cors": {
"corsRules": [
{
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"maxAgeInSeconds": 100,
"exposedHeaders": [
"x-ms-meta-*"
],
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
]
},
{
"allowedOrigins": [
"*"
],
"allowedMethods": [
"GET"
],
"maxAgeInSeconds": 2,
"exposedHeaders": [
"*"
],
"allowedHeaders": [
"*"
]
},
{
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"allowedMethods": [
"GET",
"PUT"
],
"maxAgeInSeconds": 2000,
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"allowedHeaders": [
"x-ms-meta-12345675754564*"
]
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"enabled": true,
"days": 300
},
"isVersioningEnabled": true,
"changeFeed": {
"enabled": true,
"retentionInDays": 7
}
},
"sku": {
"name": "Standard_GRS",
"tier": "Standard"
}
}
Definisi
Nama | Deskripsi |
---|---|
Allowed |
Diperlukan jika elemen CorsRule ada. Daftar metode HTTP yang diizinkan untuk dieksekusi oleh asal. |
Blob |
Properti Blob service akun penyimpanan. |
Blob |
Nama Layanan blob dalam akun penyimpanan yang ditentukan. Nama Blob Service harus 'default' |
Change |
Properti layanan blob untuk peristiwa umpan perubahan. |
Cors |
Menentukan aturan CORS untuk Blob service. |
Cors |
Mengatur aturan CORS. Anda dapat menyertakan hingga lima elemen CorsRule dalam permintaan. |
Delete |
Properti layanan untuk penghapusan sementara. |
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
Diperlukan jika elemen CorsRule ada. Daftar metode HTTP yang diizinkan untuk dieksekusi oleh asal.
Nama | Jenis | Deskripsi |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
BlobServiceProperties
Properti Blob service akun penyimpanan.
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /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 blob service. 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 digunakan untuk permintaan ke layanan Blob jika versi permintaan masuk tidak ditentukan. Nilai yang mungkin termasuk versi 2008-10-27 dan semua versi terbaru. |
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" |
BlobServicesName
Nama Layanan blob dalam akun penyimpanan yang ditentukan. Nama Blob Service harus 'default'
Nama | Jenis | Deskripsi |
---|---|---|
default |
string |
ChangeFeed
Properti layanan blob untuk peristiwa umpan perubahan.
Nama | Jenis | Deskripsi |
---|---|---|
enabled |
boolean |
Menunjukkan apakah pencatatan peristiwa umpan perubahan diaktifkan untuk Blob service. |
retentionInDays |
integer |
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 Blob service.
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 dieksekusi 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 |
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 |
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. |
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 true pelacakan berbasis waktu akses terakhir diaktifkan. |
name |
Nama kebijakan. Nilai yang valid adalah AccessTimeTracking. Bidang ini hanya dapat dibaca |
|
trackingGranularityInDays |
integer |
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
Nama | Jenis | Deskripsi |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
Properti layanan blob untuk kebijakan pemulihan blob
Nama | Jenis | Deskripsi |
---|---|---|
days |
integer |
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 |
Tidak digunakan lagi demi properti minRestoreTime. |
minRestoreTime |
string |
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.
Nama | Jenis | Deskripsi |
---|---|---|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
Standard_GRS |
string |
|
Standard_GZRS |
string |
|
Standard_LRS |
string |
|
Standard_RAGRS |
string |
|
Standard_RAGZRS |
string |
|
Standard_ZRS |
string |
SkuTier
Tingkat SKU. Ini didasarkan pada nama SKU.
Nama | Jenis | Deskripsi |
---|---|---|
Premium |
string |
|
Standard |
string |