Get Certificate Versions - Get Certificate Versions

Referência

Service:: Key Vault

API Version:: 7.4

Liste as versões de um certificado.
A operação GetCertificateVersions retorna as versões de um certificado no cofre de chaves especificado. Essa operação requer a permissão de certificados/lista.

GET {vaultBaseUrl}/certificates/{certificate-name}/versions?api-version=7.4

With optional parameters:

GET {vaultBaseUrl}/certificates/{certificate-name}/versions?maxresults={maxresults}&api-version=7.4

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
certificate-name	path	True	string	O nome do certificado.
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.
maxresults	query		integer int32	Número máximo de resultados a serem retornados em uma página. Se não for especificado, o serviço retornará até 25 resultados.

Respostas

Nome	Tipo	Description
200 OK	CertificateListResult	Uma mensagem de resposta que contém uma lista de certificados no cofre de chaves junto com um link para a próxima página de chaves.
Other Status Codes	KeyVaultError	Key Vault resposta de erro que descreve por que a operação falhou.

Exemplos

GetCertificateVersions

Sample Request

HTTP

GET https://myvault.vault.azure.net//certificates/listVersionsCert01/versions?api-version=7.4

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/certificates/listVersionsCert01/002ade539442463aba45c0efb42e3e84",
      "x5t": "fLi3U52HunIVNXubkEnf8tP6Wbo",
      "attributes": {
        "enabled": true,
        "nbf": 1430344421,
        "exp": 2208988799,
        "created": 1482189534,
        "updated": 1482189534
      }
    },
    {
      "id": "https://myvault.vault.azure.net/certificates/listVersionsCert01/7fcb3e9eb8bf43f3a6ff4b9c3740801d",
      "x5t": "fLi3U52HunIVNXubkEnf8tP6Wbo",
      "attributes": {
        "enabled": true,
        "nbf": 1430344421,
        "exp": 2208988799,
        "created": 1482189532,
        "updated": 1482189532
      }
    }
  ],
  "nextLink": null
}

Definições

Nome	Description
CertificateAttributes	Os atributos de gerenciamento de certificados.
CertificateItem	O item de certificado que contém metadados de certificado.
CertificateListResult	O resultado da lista de certificados.
DeletionRecoveryLevel	Reflete o nível de recuperação de exclusão atualmente em vigor para certificados no cofre atual. Se ele contiver 'Purgeable', o certificado poderá ser excluído permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá limpar o certificado 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.

CertificateAttributes

Os atributos de gerenciamento de certificados.

Nome	Tipo	Description
created	integer	Tempo de criação em UTC.
enabled	boolean	Determina se o objeto está habilitado.
exp	integer	Data de expiração em UTC.
nbf	integer	Não antes da data em UTC.
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 certificados no cofre atual. Se ele contiver 'Purgeable', o certificado poderá ser excluído permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá limpar o certificado no final do intervalo de retenção.
updated	integer	Hora da última atualização em UTC.

CertificateItem

O item de certificado que contém metadados de certificado.

Nome	Tipo	Description
attributes	CertificateAttributes	Os atributos de gerenciamento de certificados.
id	string	Identificador de certificado.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor.
x5t	string	Impressão digital do certificado.

CertificateListResult

O resultado da lista de certificados.

Nome	Tipo	Description
nextLink	string	A URL para obter o próximo conjunto de certificados.
value	CertificateItem[]	Uma mensagem de resposta que contém uma lista de certificados no cofre de chaves junto com um link para a próxima página de certificados.

DeletionRecoveryLevel

Reflete o nível de recuperação de exclusão atualmente em vigor para certificados no cofre atual. Se ele contiver 'Purgeable', o certificado poderá ser excluído permanentemente por um usuário privilegiado; caso contrário, somente o sistema poderá limpar o certificado 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.