Update Storage Account - Update Storage Account

Serviço:: Key Vault

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

Atualiza os atributos especificados associados à conta de armazenamento fornecida. Esta operação requer a permissão de armazenamento/conjunto/atualização.

PATCH {vaultBaseUrl}/storage/{storage-account-name}?api-version=2025-07-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
storage-account-name	path	True	string pattern: ^[0-9a-zA-Z]+$	O nome da conta de armazenamento.
vaultBaseUrl	path	True	string	O nome do cofre, por exemplo `https://myvault.vault.azure.net`, .
api-version	query	True	string	Versão da API do cliente.

Corpo do Pedido

Name	Tipo	Description
activeKeyName	string	O nome da chave da conta de armazenamento ativa atual.
attributes	StorageAccountAttributes	Os atributos da conta de armazenamento.
autoRegenerateKey	boolean	Se o KeyVault deve gerenciar a conta de armazenamento para o usuário.
regenerationPeriod	string	A duração do tempo de regeneração da chave especificada no formato ISO-8601.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor.

Respostas

Name	Tipo	Description
200 OK	StorageBundle	A conta de armazenamento atualizada.
Other Status Codes	KeyVaultError	Resposta de erro do Key Vault descrevendo por que a operação falhou.

Exemplos

Update Storage account

Pedido de amostra

HTTP

PATCH https://myvault.vault.azure.net//storage/patchStrg01?api-version=2025-07-01

{
  "activeKeyName": "key1",
  "regenerationPeriod": "P10D"
}

Resposta da amostra

Código de estado:: 200

{
  "id": "https://myvault.vault.azure.net/storage/patchStrg01",
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key1",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P10D",
  "attributes": {
    "enabled": true,
    "created": 1490738386,
    "updated": 1490738386,
    "recoveryLevel": "Recoverable+Purgeable"
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Definições

Name	Description
DeletionRecoveryLevel	Reflete o nível de recuperação de exclusão atualmente em vigor para contas de armazenamento no cofre atual. Se contiver 'Purgeable', a conta de armazenamento pode ser permanentemente excluída por um usuário privilegiado; caso contrário, apenas o sistema pode limpar a conta de armazenamento, no final do intervalo de retenção.
Error	O erro do servidor do cofre de chaves.
KeyVaultError	A exceção de erro do cofre de chaves.
StorageAccountAttributes	Os atributos de gerenciamento de conta de armazenamento.
StorageAccountUpdateParameters	Os parâmetros de atualização da conta de armazenamento.
StorageBundle	Um pacote de conta de armazenamento consiste em detalhes da conta de armazenamento do cofre de chaves mais seus atributos.

DeletionRecoveryLevel

Enumeração

Reflete o nível de recuperação de exclusão atualmente em vigor para contas de armazenamento no cofre atual. Se contiver 'Purgeable', a conta de armazenamento pode ser permanentemente excluída por um usuário privilegiado; caso contrário, apenas o sistema pode limpar a conta de armazenamento, no final do intervalo de retenção.

Valor	Description
Purgeable	Indica um estado de cofre no qual a exclusão é uma operação irreversível, sem a possibilidade de recuperação. Este nível corresponde a nenhuma proteção disponível contra uma operação Delete; os dados são irremediavelmente perdidos ao aceitar uma operação de Exclusão no nível da entidade ou superior (cofre, grupo de recursos, assinatura, etc.)
Recoverable+Purgeable	Indica um estado vault no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, limpeza). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias), a menos que uma operação de limpeza seja solicitada ou a assinatura seja cancelada. O sistema irá excluí-lo permanentemente após 90 dias, se não for recuperado
Recoverable	Indica um estado vault no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, purga). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias) e enquanto a assinatura ainda estiver disponível. O sistema irá excluí-lo permanentemente após 90 dias, se não for recuperado
Recoverable+ProtectedSubscription	Indica um estado de cofre e assinatura no qual a exclusão é recuperável dentro do intervalo de retenção (90 dias), a exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente. O sistema irá excluí-lo permanentemente após 90 dias, se não for recuperado
CustomizedRecoverable+Purgeable	Indica um estado vault no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, purga quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção, a menos que uma operação Purge seja solicitada ou a assinatura seja cancelada.
CustomizedRecoverable	Indica um estado vault no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, purga quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e enquanto a assinatura ainda estiver disponível.
CustomizedRecoverable+ProtectedSubscription	Indica um estado de cofre e assinatura no qual a exclusão é recuperável, a exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser permanentemente cancelada quando 7<= SoftDeleteRetentionInDays < 90. Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e também reflete o fato de que a assinatura em si não pode ser cancelada.

Error

Object

O erro do servidor do cofre de chaves.

Name	Tipo	Description
code	string	O código de erro.
innererror	Error	O erro do servidor do cofre de chaves.
message	string	A mensagem de erro.

KeyVaultError

Object

A exceção de erro do cofre de chaves.

Name	Tipo	Description
error	Error	O erro do servidor do cofre de chaves.

StorageAccountAttributes

Object

Os atributos de gerenciamento de conta de armazenamento.

Name	Tipo	Description
created	integer (unixtime)	Hora de criação em UTC.
enabled	boolean	O estado habilitado do objeto.
recoverableDays	integer (int32)	softDelete dias de retenção de dados. O valor deve ser >=7 e <=90 quando softDelete ativado, caso contrário, 0.
recoveryLevel	DeletionRecoveryLevel	Reflete o nível de recuperação de exclusão atualmente em vigor para contas de armazenamento no cofre atual. Se contiver 'Purgeable', a conta de armazenamento pode ser permanentemente excluída por um usuário privilegiado; caso contrário, apenas o sistema pode limpar a conta de armazenamento, no final do intervalo de retenção.
updated	integer (unixtime)	Última atualização em UTC.

StorageAccountUpdateParameters

Object

Os parâmetros de atualização da conta de armazenamento.

Name	Tipo	Description
activeKeyName	string	O nome da chave da conta de armazenamento ativa atual.
attributes	StorageAccountAttributes	Os atributos da conta de armazenamento.
autoRegenerateKey	boolean	Se o KeyVault deve gerenciar a conta de armazenamento para o usuário.
regenerationPeriod	string	A duração do tempo de regeneração da chave especificada no formato ISO-8601.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor.

StorageBundle

Object

Um pacote de conta de armazenamento consiste em detalhes da conta de armazenamento do cofre de chaves mais seus atributos.

Name	Tipo	Description
activeKeyName	string	O nome da chave da conta de armazenamento ativa atual.
attributes	StorageAccountAttributes	Os atributos da conta de armazenamento.
autoRegenerateKey	boolean	Se o KeyVault deve gerenciar a conta de armazenamento para o usuário.
id	string	O ID da conta de armazenamento.
regenerationPeriod	string	A duração do tempo de regeneração da chave especificada no formato ISO-8601.
resourceId	string	A ID do recurso da conta de armazenamento.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor

Partilhar via

Update Storage Account - Update Storage Account

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Update Storage account

Pedido de amostra

Resposta da amostra

Definições

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountUpdateParameters

StorageBundle