Blob Containers - Extend Immutability Policy

Service:: Storage Resource Provider

Version d'API:: 2025-08-01

Étend l’immutabilityPeriodSinceCreationInDays d’une immutabilityPolicy verrouillée. La seule action autorisée sur une politique verrouillée sera cette action. ETag dans If-Match est requis pour cette opération.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nom du compte de stockage dans le groupe de ressources spécifié. Les noms de compte de stockage doivent être compris entre 3 et 24 caractères et utiliser des chiffres et des lettres minuscules uniquement.
containerName	path	True	string minLength: 3 maxLength: 63	Nom du conteneur d’objets blob dans le compte de stockage spécifié. Les noms de conteneur d’objets blob doivent comporter entre 3 et 63 caractères et utiliser uniquement des chiffres, des lettres minuscules et un tiret (-). Chaque tiret (-) doit être immédiatement précédé et suivi d’une lettre ou d’un chiffre.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom	Obligatoire	Type	Description
If-Match	True	string	La version de l’état de l’entité (ETag) de la stratégie d’immuabilité à mettre à jour doit être renvoyée au serveur pour toutes les opérations de mise à jour. La valeur ETag doit inclure les guillemets doubles de début et de fin renvoyés par le service.

Corps de la demande

Nom	Type	Description
properties.allowProtectedAppendWrites	boolean	Cette propriété ne peut être modifiée que pour les stratégies de rétention basées sur le temps déverrouillées. Lorsqu’il est activé, de nouveaux blocs peuvent être écrits dans un objet blob d’ajout tout en conservant la protection et la conformité immuabilité. Seuls les nouveaux blocs peuvent être ajoutés et tous les blocs existants ne peuvent pas être modifiés ou supprimés. Cette propriété ne peut pas être modifiée avec l’API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Cette propriété ne peut être modifiée que pour les stratégies de rétention basées sur le temps déverrouillées. Lorsqu’il est activé, de nouveaux blocs peuvent être écrits dans « Append et Bock Blobs » tout en conservant la protection et la conformité immuabilité. Seuls les nouveaux blocs peuvent être ajoutés et tous les blocs existants ne peuvent pas être modifiés ou supprimés. Cette propriété ne peut pas être modifiée avec l’API ExtendImmutabilityPolicy. Les propriétés « allowProtectedAppendWrites » et « allowProtectedAppendWritesAll » s’excluent mutuellement.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Période d’immuabilité pour les objets blob dans le conteneur depuis la création de la stratégie, en jours.

Réponses

Nom	Type	Description
200 OK	ImmutabilityPolicy	Opération Azure terminée avec succès. En-têtes ETag: string
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

ImmutabilityPolicy

Opération Azure terminée avec succès.

En-têtes

ETag: string

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

ExtendImmutabilityPolicy

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
  }
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
ErrorResponse	Réponse d’erreur du fournisseur de ressources de stockage.
ErrorResponseBody	Contrat du corps de la réponse d’erreur.
ImmutabilityPolicy	Propriété ImmutabilityPolicy d’un conteneur d’objets blob, notamment ID, nom de ressource, type de ressource, Etag.
ImmutabilityPolicyState	L’état ImmutabilityPolicy d’un conteneur d’objets blob : Verrouillé et Déverrouillé.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Objet

Réponse d’erreur du fournisseur de ressources de stockage.

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

ErrorResponseBody

Objet

Contrat du corps de la réponse d’erreur.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.

ImmutabilityPolicy

Objet

Propriété ImmutabilityPolicy d’un conteneur d’objets blob, notamment ID, nom de ressource, type de ressource, Etag.

Nom	Type	Description
etag	string	Etag de ressource.
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties.allowProtectedAppendWrites	boolean	Cette propriété ne peut être modifiée que pour les stratégies de rétention basées sur le temps déverrouillées. Lorsqu’il est activé, de nouveaux blocs peuvent être écrits dans un objet blob d’ajout tout en conservant la protection et la conformité immuabilité. Seuls les nouveaux blocs peuvent être ajoutés et tous les blocs existants ne peuvent pas être modifiés ou supprimés. Cette propriété ne peut pas être modifiée avec l’API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Cette propriété ne peut être modifiée que pour les stratégies de rétention basées sur le temps déverrouillées. Lorsqu’il est activé, de nouveaux blocs peuvent être écrits dans « Append et Bock Blobs » tout en conservant la protection et la conformité immuabilité. Seuls les nouveaux blocs peuvent être ajoutés et tous les blocs existants ne peuvent pas être modifiés ou supprimés. Cette propriété ne peut pas être modifiée avec l’API ExtendImmutabilityPolicy. Les propriétés « allowProtectedAppendWrites » et « allowProtectedAppendWritesAll » s’excluent mutuellement.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Période d’immuabilité pour les objets blob dans le conteneur depuis la création de la stratégie, en jours.
properties.state	ImmutabilityPolicyState	L’état ImmutabilityPolicy d’un conteneur d’objets blob : Verrouillé et Déverrouillé.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ImmutabilityPolicyState

Énumération

L’état ImmutabilityPolicy d’un conteneur d’objets blob : Verrouillé et Déverrouillé.

Valeur	Description
Locked
Unlocked

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

Partager via

Blob Containers - Extend Immutability Policy

Paramètres URI

En-tête de la demande

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

ExtendImmutabilityPolicy

Exemple de requête

Exemple de réponse

Définitions

createdByType

ErrorResponse

ErrorResponseBody

ImmutabilityPolicy

ImmutabilityPolicyState

systemData