Bagikan melalui


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
accountName
path True

string

minLength: 3
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

subscriptionId
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

ChangeFeed

Properti layanan blob untuk peristiwa umpan perubahan.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Properti layanan blob untuk penghapusan sementara kontainer.

properties.cors

CorsRules

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

DeleteRetentionPolicy

Properti layanan blob untuk penghapusan sementara blob.

properties.isVersioningEnabled

boolean

Penerapan versi diaktifkan jika diatur ke true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

Properti layanan blob untuk mengonfigurasi kebijakan pelacakan berbasis waktu akses terakhir.

properties.restorePolicy

RestorePolicyProperties

Properti layanan blob untuk kebijakan pemulihan blob.

Respons

Nama Jenis Deskripsi
200 OK

BlobServiceProperties

Operasi pembaruan 'BlobServiceProperties' sumber daya berhasil

Other Status Codes

ErrorResponse

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

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

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
AllowedMethods
BlobServiceProperties

Properti layanan Blob akun penyimpanan.

ChangeFeed

Properti layanan blob untuk peristiwa umpan perubahan.

CorsRule

Menentukan aturan CORS untuk layanan Blob.

CorsRules

Mengatur aturan CORS. Anda dapat menyertakan hingga lima elemen CorsRule dalam permintaan.

DeleteRetentionPolicy

Properti layanan untuk penghapusan sementara.

ErrorResponse

Respons kesalahan dari penyedia sumber daya penyimpanan.

ErrorResponseBody

Kontrak isi respons kesalahan.

LastAccessTimeTrackingPolicy

Properti layanan blob untuk Kebijakan pelacakan berbasis waktu akses terakhir.

Name

Nama kebijakan. Nilai yang valid adalah AccessTimeTracking. Bidang ini hanya dapat dibaca

RestorePolicyProperties

Properti layanan blob untuk kebijakan pemulihan blob

Sku

SKU akun penyimpanan.

SkuName

Nama SKU. Diperlukan untuk pembuatan akun; opsional untuk pembaruan. Perhatikan bahwa dalam versi yang lebih lama, nama SKU disebut accountType.

SkuTier

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

ChangeFeed

Properti layanan blob untuk peristiwa umpan perubahan.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Properti layanan blob untuk penghapusan sementara kontainer.

properties.cors

CorsRules

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

DeleteRetentionPolicy

Properti layanan blob untuk penghapusan sementara blob.

properties.isVersioningEnabled

boolean

Penerapan versi diaktifkan jika diatur ke true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

Properti layanan blob untuk mengonfigurasi kebijakan pelacakan berbasis waktu akses terakhir.

properties.restorePolicy

RestorePolicyProperties

Properti layanan blob untuk kebijakan pemulihan blob.

sku

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: 1
maximum: 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

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

CorsRule[]

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: 1
maximum: 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

ErrorResponseBody

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

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: 1
maximum: 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

SkuName

Nama SKU. Diperlukan untuk pembuatan akun; opsional untuk pembaruan. Perhatikan bahwa dalam versi yang lebih lama, nama SKU disebut accountType.

tier

SkuTier

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