Blob Containers - Extend Immutability Policy

Service:

Storage Resource Provider

API-versie:

2025-08-01

Verlengt de onveranderlijkheidPeriodSinSinCreatieInDagen van een vergrendelde onveranderlijkheidBeleid. De enige actie die is toegestaan voor een vergrendeld beleid, is deze actie. ETag in If-Match is vereist voor deze bewerking.

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

Name	In	Vereist	Type	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	De naam van het opslagaccount binnen de opgegeven resourcegroep. Namen van opslagaccounts mogen tussen de 3 en 24 tekens lang zijn en mogen alleen cijfers en kleine letters gebruiken.
containerName	path	True	string minLength: 3 maxLength: 63	De naam van de blobcontainer in het opgegeven opslagaccount. De namen van blobcontainers moeten tussen de 3 en 63 tekens lang zijn en mogen alleen cijfers, kleine letters en streepjes (-) bevatten. Elk streepje (-) moet onmiddellijk worden voorafgegaan en gevolgd door een letter of cijfer.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagkoptekst

Name	Vereist	Type	Description
If-Match	True	string	De versie van de entiteitsstatus (ETag) van het onveranderbaarheidsbeleid dat moet worden bijgewerkt, moet voor alle updatebewerkingen worden teruggestuurd naar de server. De ETag-waarde moet de dubbele aanhalingstekens en dubbele aanhalingstekens bevatten die door de service worden geretourneerd.

Aanvraagbody

Name	Type	Description
properties.allowProtectedAppendWrites	boolean	Deze eigenschap kan alleen worden gewijzigd voor retentiebeleid op basis van tijd. Wanneer deze optie is ingeschakeld, kunnen nieuwe blokken worden weggeschreven naar een toevoeg-blob terwijl onveranderbaarheidsbeveiliging en -naleving behouden blijven. Alleen nieuwe blokken kunnen worden toegevoegd en bestaande blokken kunnen niet worden gewijzigd of verwijderd. Deze eigenschap kan niet worden gewijzigd met de ExtendImmutabilityPolicy-API.
properties.allowProtectedAppendWritesAll	boolean	Deze eigenschap kan alleen worden gewijzigd voor retentiebeleid op basis van tijd. Wanneer deze optie is ingeschakeld, kunnen nieuwe blokken worden geschreven naar zowel Toevoeg- als Bock-Blobs, terwijl onveranderbaarheidsbeveiliging en -naleving behouden blijven. Alleen nieuwe blokken kunnen worden toegevoegd en bestaande blokken kunnen niet worden gewijzigd of verwijderd. Deze eigenschap kan niet worden gewijzigd met de ExtendImmutabilityPolicy-API. De eigenschappen allowProtectedAppendWrites en allowProtectedAppendWritesAll sluiten elkaar wederzijds uit.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	De onveranderbaarheidsperiode voor de blobs in de container sinds het maken van het beleid, in dagen.

Antwoorden

Name	Type	Description
200 OK	ImmutabilityPolicy	Azure-operatie succesvol voltooid. Kopteksten ETag: string
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ExtendImmutabilityPolicy

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorResponse	Een foutreactie van de opslagresourceprovider.
ErrorResponseBody	Contract voor antwoordtekst van fout.
ImmutabilityPolicy	De eigenschap ImmutabilityPolicy van een blobcontainer, inclusief id, resourcenaam, resourcetype, Etag.
ImmutabilityPolicyState	De status ImmutabilityPolicy van een blobcontainer, mogelijke waarden zijn: Vergrendeld en ontgrendeld.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Object

Een foutreactie van de opslagresourceprovider.

Name	Type	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Object

Contract voor antwoordtekst van fout.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

ImmutabilityPolicy

Object

De eigenschap ImmutabilityPolicy van een blobcontainer, inclusief id, resourcenaam, resourcetype, Etag.

Name	Type	Description
etag	string	Resource-Etag.
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties.allowProtectedAppendWrites	boolean	Deze eigenschap kan alleen worden gewijzigd voor retentiebeleid op basis van tijd. Wanneer deze optie is ingeschakeld, kunnen nieuwe blokken worden weggeschreven naar een toevoeg-blob terwijl onveranderbaarheidsbeveiliging en -naleving behouden blijven. Alleen nieuwe blokken kunnen worden toegevoegd en bestaande blokken kunnen niet worden gewijzigd of verwijderd. Deze eigenschap kan niet worden gewijzigd met de ExtendImmutabilityPolicy-API.
properties.allowProtectedAppendWritesAll	boolean	Deze eigenschap kan alleen worden gewijzigd voor retentiebeleid op basis van tijd. Wanneer deze optie is ingeschakeld, kunnen nieuwe blokken worden geschreven naar zowel Toevoeg- als Bock-Blobs, terwijl onveranderbaarheidsbeveiliging en -naleving behouden blijven. Alleen nieuwe blokken kunnen worden toegevoegd en bestaande blokken kunnen niet worden gewijzigd of verwijderd. Deze eigenschap kan niet worden gewijzigd met de ExtendImmutabilityPolicy-API. De eigenschappen allowProtectedAppendWrites en allowProtectedAppendWritesAll sluiten elkaar wederzijds uit.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	De onveranderbaarheidsperiode voor de blobs in de container sinds het maken van het beleid, in dagen.
properties.state	ImmutabilityPolicyState	De status ImmutabilityPolicy van een blobcontainer, mogelijke waarden zijn: Vergrendeld en ontgrendeld.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ImmutabilityPolicyState

Opsomming

De status ImmutabilityPolicy van een blobcontainer, mogelijke waarden zijn: Vergrendeld en ontgrendeld.

Waarde	Description
Locked
Unlocked

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.