Blob Containers - Extend Immutability Policy

Layanan:

Storage Resource Provider

Versi API:

2025-08-01

Memperpanjang immutabilityPeriodSinceCreationInDays of a locked immutabilityPolicy. Satu-satunya tindakan yang diizinkan pada kebijakan Terkunci adalah tindakan ini. ETag dalam If-Match diperlukan untuk operasi ini.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default/containers/{containerName}/immutabilityPolicies/default/extend?api-version=2025-08-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.
containerName	path	True	string minLength: 3 maxLength: 63	Nama kontainer blob dalam akun penyimpanan yang ditentukan. Nama kontainer blob harus memiliki panjang antara 3 dan 63 karakter dan hanya menggunakan angka, huruf kecil, dan tanda hubung (-). Setiap karakter tanda hubung (-) harus segera didahului dan diikuti dengan huruf atau angka.
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.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
If-Match	True	string	Versi status entitas (ETag) dari kebijakan kekekalan yang akan diperbarui harus dikembalikan ke server untuk semua operasi pembaruan. Nilai ETag harus menyertakan tanda kutip ganda depan dan belakang seperti yang dikembalikan oleh layanan.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.allowProtectedAppendWrites	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke blob penambahan sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API.
properties.allowProtectedAppendWritesAll	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API. Properti 'allowProtectedAppendWrites' dan 'allowProtectedAppendWritesAll' saling eksklusif.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Periode imutabilitas untuk blob dalam kontainer sejak pembuatan kebijakan, dalam beberapa hari.

Respons

Nama	Jenis	Deskripsi
200 OK	ImmutabilityPolicy	Operasi Azure berhasil diselesaikan. Header ETag: string
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

ExtendImmutabilityPolicy

Permintaan sampel

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res6238/providers/Microsoft.Storage/storageAccounts/sto232/blobServices/default/containers/container5023/immutabilityPolicies/default/extend?api-version=2025-08-01


{
  "properties": {
    "immutabilityPeriodSinceCreationInDays": 100
  }
}

Respon sampel

Kode status:

200

{
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices/containers/immutabilityPolicies",
  "etag": "\"8d57a8b2ff50332\"",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res6238/providers/Microsoft.Storage/storageAccounts/sto232/blobServices/default/containers/container5023/immutabilityPolicies/default",
  "properties": {
    "immutabilityPeriodSinceCreationInDays": 100,
    "state": "Locked"
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorResponse	Respons kesalahan dari penyedia sumber daya penyimpanan.
ErrorResponseBody	Kontrak isi respons kesalahan.
ImmutabilityPolicy	Properti ImmutabilityPolicy dari kontainer blob, termasuk Id, nama sumber daya, jenis sumber daya, Etag.
ImmutabilityPolicyState	Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorResponse

Objek

Respons kesalahan dari penyedia sumber daya penyimpanan.

Nama	Jenis	Deskripsi
error	ErrorResponseBody	Isi respons kesalahan Penyedia Sumber Daya Azure Storage.

ErrorResponseBody

Objek

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.

ImmutabilityPolicy

Objek

Properti ImmutabilityPolicy dari kontainer blob, termasuk Id, nama sumber daya, jenis sumber daya, Etag.

Nama	Jenis	Deskripsi
etag	string	Sumber daya Etag.
id	string (arm-id)	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.allowProtectedAppendWrites	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke blob penambahan sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API.
properties.allowProtectedAppendWritesAll	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API. Properti 'allowProtectedAppendWrites' dan 'allowProtectedAppendWritesAll' saling eksklusif.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Periode imutabilitas untuk blob dalam kontainer sejak pembuatan kebijakan, dalam beberapa hari.
properties.state	ImmutabilityPolicyState	Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Enumerasi

Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.

Nilai	Deskripsi
Locked
Unlocked

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.