Blob Containers - Extend Immutability Policy

Serviço:: Storage Resource Provider

Versão da API:: 2025-08-01

Estende a imutabilidadePeríodoDesdeCriaçãoInDias de uma política de imutabilidade bloqueada. A única ação permitida em uma política bloqueada será essa ação. ETag em If-Match é necessário para esta operação.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes das contas de armazenamento devem ter entre 3 e 24 caracteres e usar apenas números e letras minúsculas.
containerName	path	True	string minLength: 3 maxLength: 63	O nome do contêiner de blob dentro da conta de armazenamento especificada. Os nomes dos contêineres de blob devem ter entre 3 e 63 caracteres e usar apenas números, letras minúsculas e traço (-). Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match	True	string	A versão do estado da entidade (ETag) da política de imutabilidade a ser atualizada deve ser retornada ao servidor para todas as operações de atualização. O valor ETag deve incluir as aspas duplas à esquerda e à direita, conforme retornadas pelo serviço.

Corpo do Pedido

Name	Tipo	Description
properties.allowProtectedAppendWrites	boolean	Essa propriedade só pode ser alterada para políticas de retenção com base no tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade da imutabilidade. Apenas novos blocos podem ser adicionados e quaisquer blocos existentes não podem ser modificados ou excluídos. Esta propriedade não pode ser alterada com a API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Essa propriedade só pode ser alterada para políticas de retenção com base no tempo desbloqueadas. Quando ativados, novos blocos podem ser gravados em 'Append e Bock Blobs', mantendo a proteção e a conformidade da imutabilidade. Apenas novos blocos podem ser adicionados e quaisquer blocos existentes não podem ser modificados ou excluídos. Esta propriedade não pode ser alterada com a API ExtendImmutabilityPolicy. As propriedades 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' são mutuamente exclusivas.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	O período de imutabilidade para os blobs no contêiner desde a criação da política, em dias.

Respostas

Name	Tipo	Description
200 OK	ImmutabilityPolicy	Operação do Azure concluída com sucesso. Cabeçalhos ETag: string
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Description

200 OK

ImmutabilityPolicy

Operação do Azure concluída com sucesso.

Cabeçalhos

ETag: string

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

ExtendImmutabilityPolicy

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Definições

Name	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorResponse	Uma resposta de erro do provedor de recursos de armazenamento.
ErrorResponseBody	Contrato do corpo de resposta ao erro.
ImmutabilityPolicy	A propriedade ImmutabilityPolicy de um contêiner de blob, incluindo Id, nome do recurso, tipo de recurso, Etag.
ImmutabilityPolicyState	O estado ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: Bloqueado e Desbloqueado.
systemData	Metadados referentes à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Object

Uma resposta de erro do provedor de recursos de armazenamento.

Name	Tipo	Description
error	ErrorResponseBody	Azure Storage Resource Provider erro response body.

ErrorResponseBody

Object

Contrato do corpo de resposta ao erro.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message	string	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.

ImmutabilityPolicy

Object

A propriedade ImmutabilityPolicy de um contêiner de blob, incluindo Id, nome do recurso, tipo de recurso, Etag.

Name	Tipo	Description
etag	string	Etag de recurso.
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.allowProtectedAppendWrites	boolean	Essa propriedade só pode ser alterada para políticas de retenção com base no tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade da imutabilidade. Apenas novos blocos podem ser adicionados e quaisquer blocos existentes não podem ser modificados ou excluídos. Esta propriedade não pode ser alterada com a API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Essa propriedade só pode ser alterada para políticas de retenção com base no tempo desbloqueadas. Quando ativados, novos blocos podem ser gravados em 'Append e Bock Blobs', mantendo a proteção e a conformidade da imutabilidade. Apenas novos blocos podem ser adicionados e quaisquer blocos existentes não podem ser modificados ou excluídos. Esta propriedade não pode ser alterada com a API ExtendImmutabilityPolicy. As propriedades 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' são mutuamente exclusivas.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	O período de imutabilidade para os blobs no contêiner desde a criação da política, em dias.
properties.state	ImmutabilityPolicyState	O estado ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: Bloqueado e Desbloqueado.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Enumeração

O estado ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: Bloqueado e Desbloqueado.

Valor	Description
Locked
Unlocked

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via

Blob Containers - Extend Immutability Policy

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

ExtendImmutabilityPolicy

Pedido de amostra

Resposta da amostra

Definições

createdByType

ErrorResponse

ErrorResponseBody

ImmutabilityPolicy

ImmutabilityPolicyState

systemData