Blob Containers - Extend Immutability Policy

Szolgáltatás:

Storage Resource Provider

API-verzió:

2025-08-01

Kiterjeszti egy zárolt immutabilityPeriodSinceCreationInDays immutabilityPolicy-t. A zárolt szabályzaton csak ez a művelet engedélyezett. Ehhez a művelethez e-címke szükséges a If-Match.

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-paraméterek

Name	In	Kötelező	Típus	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	A tárfiók neve a megadott erőforráscsoporton belül. A tárfiókok nevének 3 és 24 karakter közötti hosszúságúnak kell lennie, és csak számokat és kisbetűket kell használnia.
containerName	path	True	string minLength: 3 maxLength: 63	A blobtároló neve a megadott tárfiókban. A blobtárolók nevének 3 és 63 karakter közötti hosszúságúnak kell lennie, és csak számokat, kisbetűket és kötőjelet (-) kell használni. Minden kötőjelet (-) közvetlenül egy betűnek vagy számnak kell megelőznie és követnie.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Name	Kötelező	Típus	Description
If-Match	True	string	A frissítendő nem módosítható szabályzat entitásállapot-verzióját (ETag) minden frissítési művelethez vissza kell adni a kiszolgálónak. Az ETag értéknek tartalmaznia kell a szolgáltatás által visszaadott kezdő és záró dupla idézőjeleket.

Kérelem törzse

Name	Típus	Description
properties.allowProtectedAppendWrites	boolean	Ez a tulajdonság csak a feloldott időalapú adatmegőrzési szabályzatok esetében módosítható. Ha engedélyezve van, az új blokkok egy hozzáfűző blobba írhatók, miközben fenntartják a nem módosíthatóság elleni védelmet és megfelelőséget. Csak új blokkok vehetők fel, és a meglévő blokkok nem módosíthatók vagy törölhetők. Ez a tulajdonság nem módosítható az ExtendImmutabilityPolicy API-val.
properties.allowProtectedAppendWritesAll	boolean	Ez a tulajdonság csak a feloldott időalapú adatmegőrzési szabályzatok esetében módosítható. Ha engedélyezve van, az új blokkok mind a Hozzáfűzés, mind a Bock Blobba írhatók, miközben fenntartják a nem módosíthatóság elleni védelmet és megfelelőséget. Csak új blokkok vehetők fel, és a meglévő blokkok nem módosíthatók vagy törölhetők. Ez a tulajdonság nem módosítható az ExtendImmutabilityPolicy API-val. Az "allowProtectedAppendWrites" és az "allowProtectedAppendWritesAll" tulajdonságok kölcsönösen kizárják egymást.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	A házirend létrehozása óta a tárolóban lévő blobok nem módosíthatósági időszaka napokban.

Válaszok

Name	Típus	Description
200 OK	ImmutabilityPolicy	Az Azure működése sikeresen befejeződött. Fejlécek ETag: string
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

ExtendImmutabilityPolicy

Mintakérelem

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

Mintaválasz

Állapotkód:

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

Definíciók

Name	Description
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorResponse	Hibaválasz a tárerőforrás-szolgáltatótól.
ErrorResponseBody	Hibaválasz törzsszerződése.
ImmutabilityPolicy	Egy blobtároló ImmutabilityPolicy tulajdonsága, beleértve az azonosítót, az erőforrásnevet, az erőforrástípust és az Etaget.
ImmutabilityPolicyState	A blobtároló ImmutabilityPolicy állapota, a lehetséges értékek a következők: Locked és Unlocked.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Tárgy

Hibaválasz a tárerőforrás-szolgáltatótól.

Name	Típus	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Tárgy

Hibaválasz törzsszerződése.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

ImmutabilityPolicy

Tárgy

Egy blobtároló ImmutabilityPolicy tulajdonsága, beleértve az azonosítót, az erőforrásnevet, az erőforrástípust és az Etaget.

Name	Típus	Description
etag	string	Erőforráscímke.
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Az erőforrás neve
properties.allowProtectedAppendWrites	boolean	Ez a tulajdonság csak a feloldott időalapú adatmegőrzési szabályzatok esetében módosítható. Ha engedélyezve van, az új blokkok egy hozzáfűző blobba írhatók, miközben fenntartják a nem módosíthatóság elleni védelmet és megfelelőséget. Csak új blokkok vehetők fel, és a meglévő blokkok nem módosíthatók vagy törölhetők. Ez a tulajdonság nem módosítható az ExtendImmutabilityPolicy API-val.
properties.allowProtectedAppendWritesAll	boolean	Ez a tulajdonság csak a feloldott időalapú adatmegőrzési szabályzatok esetében módosítható. Ha engedélyezve van, az új blokkok mind a Hozzáfűzés, mind a Bock Blobba írhatók, miközben fenntartják a nem módosíthatóság elleni védelmet és megfelelőséget. Csak új blokkok vehetők fel, és a meglévő blokkok nem módosíthatók vagy törölhetők. Ez a tulajdonság nem módosítható az ExtendImmutabilityPolicy API-val. Az "allowProtectedAppendWrites" és az "allowProtectedAppendWritesAll" tulajdonságok kölcsönösen kizárják egymást.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	A házirend létrehozása óta a tárolóban lévő blobok nem módosíthatósági időszaka napokban.
properties.state	ImmutabilityPolicyState	A blobtároló ImmutabilityPolicy állapota, a lehetséges értékek a következők: Locked és Unlocked.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Felsorolás

A blobtároló ImmutabilityPolicy állapota, a lehetséges értékek a következők: Locked és Unlocked.

Érték	Description
Locked
Unlocked

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.