Get Sas Definition - Get Sas Definition

Referência

Service:: Key Vault

API Version:: 7.4

Obtém informações sobre uma definição de SAS para a conta de armazenamento especificada. Essa operação requer a permissão storage/getsas.

GET {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. Regex pattern: `^[0-9a-zA-Z]+$`
storage-account-name	path	True	string	O nome da conta de armazenamento. Regex pattern: `^[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.

Respostas

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

Exemplos

Get Storage Sas Definition

Sample Request

HTTP

GET https://myvault.vault.azure.net//storage/getsas01/sas/getStrgSasDef01?api-version=7.4

Sample Response

Status code:: 200

{
  "id": "https://myvault.vault.azure.net/storage/getsas01/sas/getStrgSasDef01",
  "sid": "https://myvault.vault.azure.net/secrets/getsas01-getStrgSasDef01",
  "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 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.
SasDefinitionAttributes	Os atributos de gerenciamento de definição de SAS.
SasDefinitionBundle	Um pacote de definição de SAS consiste em detalhes de definição de SAS do cofre de chaves mais seus atributos.
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 pode 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, limpar 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, 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 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 a exclusão imediata e permanente (ou seja, limpar 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 relação a uma operação De exclusão; 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	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 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 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	Hora 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 de SAS consiste em detalhes de definição de 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 de 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.

SasTokenType

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

Nome	Tipo	Description
account	string
service	string