Blob Containers - Extend Immutability Policy

Hizmet:

Storage Resource Provider

API Sürümü:

2025-08-01

Kilitli bir immutabilityPolicy'nin immutabilityPeriodSinceCreationInDays değerini genişletir. Kilitli bir ilkede izin verilen tek eylem bu eylem olacaktır. Bu işlem için If-Match ETag gereklidir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Belirtilen kaynak grubu içindeki depolama hesabının adı. Depolama hesabı adlarının uzunluğu 3 ile 24 karakter arasında olmalı ve yalnızca sayıları ve küçük harfleri kullanmalıdır.
containerName	path	True	string minLength: 3 maxLength: 63	Belirtilen depolama hesabındaki blob kapsayıcısının adı. Blob kapsayıcı adları 3 ile 63 karakter uzunluğunda olmalı ve yalnızca sayı, küçük harf ve kısa çizgi (-) kullanmalıdır. Her tire (-) karakterinin hemen önünde ve ardından bir harf veya rakam gelmelidir.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
If-Match	True	string	Güncelleştirilecek değişmezlik ilkesinin varlık durumu (ETag) sürümü, tüm güncelleştirme işlemleri için sunucuya döndürülmelidir. ETag değeri, hizmet tarafından döndürülen baştaki ve sondaki çift tırnak işaretlerini içermelidir.

İstek Gövdesi

Name	Tür	Description
properties.allowProtectedAppendWrites	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken ekleme blobuna yeni bloklar yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez.
properties.allowProtectedAppendWritesAll	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken yeni bloklar hem 'Ekleme hem de Bock Bloblarına' yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez. 'allowProtectedAppendWrites' ve 'allowProtectedAppendWritesAll' özellikleri birbirini dışlar.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	İlke oluşturma işleminden bu yana kapsayıcıdaki bloblar için gün cinsinden değişmezlik süresi.

Yanıtlar

Name	Tür	Description
200 OK	ImmutabilityPolicy	Azure işlemi başarıyla tamamlandı. Üst Bilgiler ETag: string
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

ExtendImmutabilityPolicy

Örnek isteği

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
  }
}

Örnek yanıt

Durum kodu:

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"
  }
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorResponse	Depolama kaynağı sağlayıcısından bir hata yanıtı.
ErrorResponseBody	Hata yanıtı gövde sözleşmesi.
ImmutabilityPolicy	Kimlik, kaynak adı, kaynak türü, Etag gibi bir blob kapsayıcısının ImmutabilityPolicy özelliği.
ImmutabilityPolicyState	Blob kapsayıcısının ImmutabilityPolicy durumu, olası değerler şunlardır: Kilitli ve Kilidi Açık.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Nesne

Depolama kaynağı sağlayıcısından bir hata yanıtı.

Name	Tür	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Nesne

Hata yanıtı gövde sözleşmesi.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	string	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

ImmutabilityPolicy

Nesne

Kimlik, kaynak adı, kaynak türü, Etag gibi bir blob kapsayıcısının ImmutabilityPolicy özelliği.

Name	Tür	Description
etag	string	Kaynak Etag'i.
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.allowProtectedAppendWrites	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken ekleme blobuna yeni bloklar yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez.
properties.allowProtectedAppendWritesAll	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken yeni bloklar hem 'Ekleme hem de Bock Bloblarına' yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez. 'allowProtectedAppendWrites' ve 'allowProtectedAppendWritesAll' özellikleri birbirini dışlar.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	İlke oluşturma işleminden bu yana kapsayıcıdaki bloblar için gün cinsinden değişmezlik süresi.
properties.state	ImmutabilityPolicyState	Blob kapsayıcısının ImmutabilityPolicy durumu, olası değerler şunlardır: Kilitli ve Kilidi Açık.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Numaralandırma

Blob kapsayıcısının ImmutabilityPolicy durumu, olası değerler şunlardır: Kilitli ve Kilidi Açık.

Değer	Description
Locked
Unlocked

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.