Blob Containers - Extend Immutability Policy

Servizio:

Storage Resource Provider

Versione API:

2025-08-01

Estende l'immutabilityPeriodSinceCreationInDays di un immutabilityPolicy bloccato. L'unica azione consentita in un criterio Bloccato sarà questa azione. L'ETag in If-Match è necessario per questa operazione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nome dell'account di archiviazione all'interno del gruppo di risorse specificato. I nomi degli account di archiviazione devono avere una lunghezza compresa tra 3 e 24 caratteri e usare solo numeri e lettere minuscole.
containerName	path	True	string minLength: 3 maxLength: 63	Nome del contenitore BLOB all'interno dell'account di archiviazione specificato. I nomi dei contenitori BLOB devono avere una lunghezza compresa tra 3 e 63 caratteri e devono usare solo numeri, lettere minuscole e trattino (-). Ogni trattino (-) deve essere immediatamente preceduto e seguito da una lettera o da un numero.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
If-Match	True	string	La versione dello stato dell'entità (ETag) dei criteri di immutabilità da aggiornare deve essere restituita al server per tutte le operazioni di aggiornamento. Il valore ETag deve includere le virgolette doppie iniziali e finali restituite dal servizio.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.allowProtectedAppendWrites	boolean	Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitata, è possibile scrivere nuovi blocchi in un BLOB di accodamento mantenendo al contempo la protezione e la conformità dell'immutabilità. È possibile aggiungere solo nuovi blocchi e non è possibile modificare o eliminare blocchi esistenti. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitata, i nuovi blocchi possono essere scritti sia in "Accoda che in BLOB Bock" mantenendo al contempo la protezione e la conformità dell'immutabilità. È possibile aggiungere solo nuovi blocchi e non è possibile modificare o eliminare blocchi esistenti. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy. Le proprietà 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' si escludono a vicenda.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Periodo di immutabilità per i BLOB nel contenitore dopo la creazione dei criteri, in giorni.

Risposte

Nome	Tipo	Descrizione
200 OK	ImmutabilityPolicy	Operazione Azure completata con successo. Intestazioni ETag: string
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ExtendImmutabilityPolicy

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
ErrorResponse	Risposta di errore del provider di risorse di archiviazione.
ErrorResponseBody	Contratto del corpo della risposta di errore.
ImmutabilityPolicy	Proprietà ImmutabilityPolicy di un contenitore BLOB, inclusi ID, nome risorsa, tipo di risorsa, Etag.
ImmutabilityPolicyState	Stato ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: Bloccato e Sbloccato.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorResponse

Oggetto

Risposta di errore del provider di risorse di archiviazione.

Nome	Tipo	Descrizione
error	ErrorResponseBody	Azure Storage Resource Provider error: corpo di risposta all'errore.

ErrorResponseBody

Oggetto

Contratto del corpo della risposta di errore.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

ImmutabilityPolicy

Oggetto

Proprietà ImmutabilityPolicy di un contenitore BLOB, inclusi ID, nome risorsa, tipo di risorsa, Etag.

Nome	Tipo	Descrizione
etag	string	Etag risorsa.
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties.allowProtectedAppendWrites	boolean	Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitata, è possibile scrivere nuovi blocchi in un BLOB di accodamento mantenendo al contempo la protezione e la conformità dell'immutabilità. È possibile aggiungere solo nuovi blocchi e non è possibile modificare o eliminare blocchi esistenti. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitata, i nuovi blocchi possono essere scritti sia in "Accoda che in BLOB Bock" mantenendo al contempo la protezione e la conformità dell'immutabilità. È possibile aggiungere solo nuovi blocchi e non è possibile modificare o eliminare blocchi esistenti. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy. Le proprietà 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' si escludono a vicenda.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Periodo di immutabilità per i BLOB nel contenitore dopo la creazione dei criteri, in giorni.
properties.state	ImmutabilityPolicyState	Stato ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: Bloccato e Sbloccato.
systemData	systemData	Metadati di Azure Resource Manager contenenti informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Enumerazione

Stato ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: Bloccato e Sbloccato.

Valore	Descrizione
Locked
Unlocked

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.