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 especificada. Esta operação requer a permissão de armazenamento/conjuntos como.

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

Parâmetros do URI

Name	Em	Necessá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 da API de Cliente.

Corpo do Pedido

Name	Tipo	Description
attributes	SasDefinitionAttributes	Os atributos da definição de SAS.
sasType	SasTokenType	O tipo de token de SAS que a definição de SAS irá criar.
tags	object	Metadados específicos da aplicação sob a forma de pares chave-valor.
templateUri	string	O modelo de token de definição de 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 de SAS criados de acordo com a definição de SAS.

Respostas

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

Exemplos

Update Storage Sas definition

Pedido de amostra

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 da amostra

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

Name	Description
DeletionRecoveryLevel	Reflete o nível de recuperação de eliminação atualmente em vigor para contas de armazenamento no cofre atual. Se contiver "Purgeable", a conta de armazenamento pode ser eliminada permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover 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 gestão de definições de SAS.
SasDefinitionBundle	Um pacote de definição de SAS consiste em detalhes de definição de SAS do cofre de chaves e os seus atributos.
SasDefinitionUpdateParameters	Os parâmetros de atualização da definição de SAS.
SasTokenType	O tipo de token de SAS que a definição de SAS irá criar.

DeletionRecoveryLevel

Reflete o nível de recuperação de eliminação atualmente em vigor para contas de armazenamento no cofre atual. Se contiver "Purgeable", a conta de armazenamento pode ser eliminada permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover a conta de armazenamento, no final do intervalo de retenção.

Name	Tipo	Description
CustomizedRecoverable	string	Indica um estado do cofre no qual a eliminação é recuperável sem a possibilidade de eliminação imediata e permanente (ou seja, remover quando 7<= SoftDeleteRetentionInDays < 90). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção e enquanto a subscrição ainda está disponível.
CustomizedRecoverable+ProtectedSubscription	string	Indica um cofre e um estado de subscrição em que a eliminação é recuperável, imediata e permanente (isto é, remoção) não é permitida e na qual a subscrição em si não pode ser cancelada permanentemente quando 7<= SoftDeleteRetentionInDays < 90. Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção e também reflete o facto de a própria subscrição não poder ser cancelada.
CustomizedRecoverable+Purgeable	string	Indica um estado do cofre no qual a eliminação é recuperável e que também permite a eliminação imediata e permanente (ou seja, remover quando 7<= SoftDeleteRetentionInDays < 90). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção, a menos que seja pedida uma operação de Remoção ou a subscrição seja cancelada.
Purgeable	string	Indica um estado do cofre em que a eliminação é uma operação irreversível, sem a possibilidade de recuperação. Este nível corresponde a nenhuma proteção disponível numa operação Eliminar; os dados são perdidos irremediavelmente ao aceitar uma operação Eliminar ao nível da entidade ou superior (cofre, grupo de recursos, subscrição, etc.)
Recoverable	string	Indica um estado do cofre no qual a eliminação é recuperável sem a possibilidade de eliminação imediata e permanente (ou seja, remoção). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção (90 dias) e enquanto a subscrição ainda está disponível. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado
Recoverable+ProtectedSubscription	string	Indica um cofre e um estado de subscrição no qual a eliminação é recuperável dentro do intervalo de retenção (90 dias), a eliminação imediata e permanente (ou seja, remoção) não é permitida e na qual a subscrição em si não pode ser cancelada permanentemente. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado
Recoverable+Purgeable	string	Indica um estado do cofre no qual a eliminação é recuperável e que também permite a eliminação imediata e permanente (ou seja, remoção). Este nível garante a capacidade de recuperação da entidade eliminada durante o intervalo de retenção (90 dias), a menos que seja pedida uma operação de Remoção ou a subscrição seja cancelada. O sistema irá eliminá-lo permanentemente após 90 dias, se não for recuperado

Error

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

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

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

SasDefinitionAttributes

Os atributos de gestão de definições de SAS.

Name	Tipo	Description
created	integer	Hora de criação em UTC.
enabled	boolean	o estado ativado do objeto.
recoverableDays	integer	softDelete data retention days. O valor deve ser >=7 e <=90 quando softDelete ativado, caso contrário 0.
recoveryLevel	DeletionRecoveryLevel	Reflete o nível de recuperação de eliminação atualmente em vigor para definições de SAS no cofre atual. Se contiver "Purgeable", a definição de SAS pode ser eliminada permanentemente por um utilizador com privilégios; caso contrário, apenas o sistema pode remover 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 de SAS consiste em detalhes de definição de SAS do cofre de chaves e os seus atributos.

Name	Tipo	Description
attributes	SasDefinitionAttributes	Os atributos de definição de SAS.
id	string	O ID de definição de SAS.
sasType	SasTokenType	O tipo de token de SAS que a definição de SAS irá criar.
sid	string	ID do segredo da definição de SAS da conta de armazenamento.
tags	object	Metadados específicos da aplicação sob a forma de pares chave-valor
templateUri	string	O modelo de token de definição de 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 de SAS criados de acordo com a definição de SAS.

SasDefinitionUpdateParameters

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

Name	Tipo	Description
attributes	SasDefinitionAttributes	Os atributos da definição de SAS.
sasType	SasTokenType	O tipo de token de SAS que a definição de SAS irá criar.
tags	object	Metadados específicos da aplicação sob a forma de pares chave-valor.
templateUri	string	O modelo de token de definição de 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 de SAS criados de acordo com a definição de SAS.

SasTokenType

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

Name	Tipo	Description
account	string
service	string

Partilhar via