Blob Containers - Extend Immutability Policy

Serviço:: Storage Resource Provider

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

Estende o immutabilityPeriodSinceCreationInDays de uma immutabilityPolicy bloqueada. A única ação permitida em uma política bloqueada será essa ação. A ETag no If-Match é necessária 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 de URI

Nome	Em	Obrigató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 da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento 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 de contêiner 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 uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome	Obrigató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 retornado pelo serviço.

Corpo da solicitação

Nome	Tipo	Description
properties.allowProtectedAppendWrites	boolean	Essa propriedade só pode ser alterada para políticas de retenção baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e todos os blocos existentes não podem ser modificados ou excluídos. Essa 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 baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em 'Blobs de Acréscimo e Bock' mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e todos os blocos existentes não podem ser modificados ou excluídos. Essa 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 dos blobs no contêiner desde a criação da política, em dias.

Respostas

Nome	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.

Nome

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 do OAuth2 do Azure Active Directory.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

ExtendImmutabilityPolicy

Solicitação de exemplo

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 de exemplo

Código de status:: 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

Nome	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 da resposta de 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: Locked e Unlocked.
systemData	Metadados relativos à 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

Objeto

Uma resposta de erro do provedor de recursos de armazenamento.

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

ErrorResponseBody

Objeto

Contrato do corpo da resposta de erro.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

ImmutabilityPolicy

Objeto

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

Nome	Tipo	Description
etag	string	Etag de recurso.
id	string (arm-id)	ID de recurso totalmente qualificada 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 baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e todos os blocos existentes não podem ser modificados ou excluídos. Essa 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 baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em 'Blobs de Acréscimo e Bock' mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e todos os blocos existentes não podem ser modificados ou excluídos. Essa 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 dos 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: Locked e Unlocked.
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: Locked e Unlocked.

Valor	Description
Locked
Unlocked

systemData

Objeto

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

Nome	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.

Compartilhar via

Blob Containers - Extend Immutability Policy

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

ExtendImmutabilityPolicy

Solicitação de exemplo

Resposta de exemplo

Definições

createdByType

ErrorResponse

ErrorResponseBody

ImmutabilityPolicy

ImmutabilityPolicyState

systemData