Update Sas Definition - Update Sas Definition

Referência

Serviço:: Key Vault

Versão da API:: 7.4

Atualizações os atributos especificados associados à definição de SAS fornecida. Esta operação requer a permissão de armazenamento/setsas.

PATCH {vaultBaseUrl}/storage/{storage-account-name}/sas/{sas-definition-name}?api-version=7.4

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
sas-definition-name	path	True	string	O nome da definição de SAS. Padrão Regex: `^[0-9a-zA-Z]+$`
storage-account-name	path	True	string	O nome da conta de armazenamento. Padrão Regex: `^[0-9a-zA-Z]+$`
vaultBaseUrl	path	True	string	O nome do cofre, por exemplo https://myvault.vault.azure.net, .
api-version	query	True	string	Versão de API do cliente.

Corpo da solicitação

Nome	Tipo	Description
attributes	SasDefinitionAttributes	Os atributos da definição de SAS.
sasType	SasTokenType	O tipo de token SAS que a definição de SAS criará.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor.
templateUri	string	O modelo de token de definição SAS assinado com uma chave arbitrária. Os tokens criados de acordo com a definição de SAS terão as mesmas propriedades que o modelo.
validityPeriod	string	O período de validade dos tokens SAS criados de acordo com a definição de SAS.

Respostas

Nome	Tipo	Description
200 OK	SasDefinitionBundle	A definição de SAS atualizada.
Other Status Codes	KeyVaultError	Key Vault resposta de erro que descreve por que a operação falhou.

Exemplos

Update Storage Sas definition

Solicitação de exemplo

HTTP

PATCH https://myvault.vault.azure.net//storage/patchsas01/sas/patchStrgSasDef01?api-version=7.4

{
  "templateUri": "se=2018-02-01T00%3A00Z&spr=https&sv=2017-04-17&sr=b&sig=XXFNfuMCHYrBx0bhemJ7PWn0xGfImMXT6LfbXWvtRUk%3D",
  "sasType": "service",
  "validityPeriod": "P15D",
  "attributes": {
    "enabled": true
  }
}

Resposta de exemplo

Código de status:: 200

{
  "id": "https://myvault.vault.azure.net/storage/patchsas01/sas/patchStrgSasDef01",
  "sid": "https://myvault.vault.azure.net/secrets/patchsas01-patchStrgSasDef01",
  "templateUri": "se=2018-02-01T00%3A00Z&spr=https&sv=2017-04-17&sr=b&sig=XXFNfuMCHYrBx0bhemJ7PWn0xGfImMXT6LfbXWvtRUk%3D",
  "sasType": "service",
  "validityPeriod": "P15D",
  "attributes": {
    "enabled": true,
    "created": 1490738438,
    "updated": 1490738438,
    "recoveryLevel": "Recoverable"
  }
}

Definições

Nome	Description
DeletionRecoveryLevel	Reflete o nível de recuperação de exclusão atualmente em vigor para contas de armazenamento no cofre atual. Se contiver "Purgável", a conta de armazenamento poderá ser excluída permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá 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.
SasDefinitionAttributes	Os atributos de gerenciamento de definição de SAS.
SasDefinitionBundle	Um pacote de definição sas consiste em detalhes de definição sas do cofre de chaves mais seus atributos.
SasDefinitionUpdateParameters	Os parâmetros de atualização de definição de SAS.
SasTokenType	O tipo de token SAS que a definição de SAS criará.

DeletionRecoveryLevel

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

Nome	Tipo	Description
CustomizedRecoverable	string	Indica um estado de cofre no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, limpeza 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 está disponível.
CustomizedRecoverable+ProtectedSubscription	string	Indica um cofre e um estado de assinatura no qual a exclusão é recuperável, exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente 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 própria assinatura não pode ser cancelada.
CustomizedRecoverable+Purgeable	string	Indica um estado de cofre no qual a exclusão é recuperável e que também permite exclusão imediata e permanente (ou seja, limpeza 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 de limpeza seja solicitada ou a assinatura seja cancelada.
Purgeable	string	Indica um estado de cofre no qual a exclusão é uma operação irreversível, sem a possibilidade de recuperação. Esse nível corresponde a nenhuma proteção disponível em uma operação Delete; os dados são irremediavelmente perdidos ao aceitar uma operação Delete no nível da entidade ou superior (cofre, grupo de recursos, assinatura etc.)
Recoverable	string	Indica um estado de cofre no qual a exclusão é recuperável sem a possibilidade de 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) e enquanto a assinatura ainda estiver disponível. O sistema o excluirá permanentemente após 90 dias, se não for recuperado
Recoverable+ProtectedSubscription	string	Indica um cofre e um estado de assinatura no qual a exclusão é recuperável dentro do intervalo de retenção (90 dias), a exclusão imediata e permanente (ou seja, a limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente. O sistema o excluirá permanentemente após 90 dias, se não for recuperado
Recoverable+Purgeable	string	Indica um estado de cofre 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 o excluirá permanentemente após 90 dias, se não for recuperado

Error

O erro do servidor do cofre de chaves.

Nome	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

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

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

SasDefinitionAttributes

Os atributos de gerenciamento de definição de SAS.

Nome	Tipo	Description
created	integer	Tempo de criação em UTC.
enabled	boolean	o estado habilitado do objeto .
recoverableDays	integer	softDelete dias de retenção de dados. O valor deve ser >=7 e <=90 quando softDelete habilitado, caso contrário, 0.
recoveryLevel	DeletionRecoveryLevel	Reflete o nível de recuperação de exclusão atualmente em vigor para definições de SAS no cofre atual. Se contiver "Purgável", a definição de SAS poderá ser excluída permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá limpar a definição de SAS no final do intervalo de retenção.
updated	integer	Hora da última atualização em UTC.

SasDefinitionBundle

Um pacote de definição sas consiste em detalhes de definição sas do cofre de chaves mais seus atributos.

Nome	Tipo	Description
attributes	SasDefinitionAttributes	Os atributos de definição de SAS.
id	string	A ID de definição de SAS.
sasType	SasTokenType	O tipo de token SAS que a definição de SAS criará.
sid	string	ID secreta de definição sas da conta de armazenamento.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor
templateUri	string	O modelo de token de definição SAS assinado com uma chave arbitrária. Os tokens criados de acordo com a definição de SAS terão as mesmas propriedades que o modelo.
validityPeriod	string	O período de validade dos tokens SAS criados de acordo com a definição de SAS.

SasDefinitionUpdateParameters

Os parâmetros de atualização de definição de SAS.

Nome	Tipo	Description
attributes	SasDefinitionAttributes	Os atributos da definição de SAS.
sasType	SasTokenType	O tipo de token SAS que a definição de SAS criará.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor.
templateUri	string	O modelo de token de definição SAS assinado com uma chave arbitrária. Os tokens criados de acordo com a definição de SAS terão as mesmas propriedades que o modelo.
validityPeriod	string	O período de validade dos tokens SAS criados de acordo com a definição de SAS.

SasTokenType

O tipo de token SAS que a definição de SAS criará.

Nome	Tipo	Description
account	string
service	string

Compartilhar via