Get Certificate Versions - Get Certificate Versions

Referencia

Servicio:: Key Vault

Versión de la API:: 7.4

Enumerar las versiones de un certificado.
La operación GetCertificateVersions devuelve las versiones de un certificado en el almacén de claves especificado. Esta operación requiere el permiso certificates/list.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
certificate-name	path	True	string	Nombre del certificado.
vaultBaseUrl	path	True	string	El nombre del almacén, por ejemplo, https://myvault.vault.azure.net.
api-version	query	True	string	Versión de la API de cliente.
maxresults	query		integer (int32) minimum: 1 maximum: 25	Número máximo de resultados que se van a devolver en una página. Si no se especifica, el servicio devolverá hasta 25 resultados.

Respuestas

Nombre	Tipo	Description
200 OK	CertificateListResult	Mensaje de respuesta que contiene una lista de certificados en el almacén de claves junto con un vínculo a la página siguiente de claves.
Other Status Codes	KeyVaultError	Respuesta de error de Key Vault que describe por qué se produjo un error en la operación.

Ejemplos

GetCertificateVersions

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

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
}

Definiciones

Nombre	Description
CertificateAttributes	Atributos de administración de certificados.
CertificateItem	Elemento de certificado que contiene metadatos de certificado.
CertificateListResult	Resultado de la lista de certificados.
DeletionRecoveryLevel	Refleja el nivel de recuperación de eliminación actualmente en vigor para los certificados del almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente el certificado; De lo contrario, solo el sistema puede purgar el certificado al final del intervalo de retención.
Error	Error del servidor del almacén de claves.
KeyVaultError	Excepción de error del almacén de claves.

CertificateAttributes

Object

Atributos de administración de certificados.

Nombre	Tipo	Description
created	integer (unixtime)	Hora de creación en UTC.
enabled	boolean	Determina si el objeto está habilitado.
exp	integer (unixtime)	Fecha de expiración en UTC.
nbf	integer (unixtime)	No antes de la fecha en UTC.
recoverableDays	integer (int32)	días de retención de datos softDelete. El valor debe ser >=7 y <=90 cuando softDelete esté habilitado; de lo contrario, 0.
recoveryLevel	DeletionRecoveryLevel	Refleja el nivel de recuperación de eliminación actualmente en vigor para los certificados del almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente el certificado; De lo contrario, solo el sistema puede purgar el certificado al final del intervalo de retención.
updated	integer (unixtime)	Hora actualizada por última vez en UTC.

CertificateItem

Object

Elemento de certificado que contiene metadatos de certificado.

Nombre	Tipo	Description
attributes	CertificateAttributes	Atributos de administración de certificados.
id	string	Identificador de certificado.
tags	object	Metadatos específicos de la aplicación en forma de pares clave-valor.
x5t	string (base64url)	Huella digital del certificado.

CertificateListResult

Object

Resultado de la lista de certificados.

Nombre	Tipo	Description
nextLink	string	Dirección URL para obtener el siguiente conjunto de certificados.
value	CertificateItem[]	Mensaje de respuesta que contiene una lista de certificados en el almacén de claves junto con un vínculo a la página siguiente de certificados.

DeletionRecoveryLevel

Enumeración

Refleja el nivel de recuperación de eliminación actualmente en vigor para los certificados del almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente el certificado; De lo contrario, solo el sistema puede purgar el certificado al final del intervalo de retención.

Valor	Description
CustomizedRecoverable	Denota un estado de almacén en el que la eliminación se puede recuperar sin la posibilidad de eliminación inmediata y permanente (es decir, purga cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y mientras la suscripción sigue estando disponible.
CustomizedRecoverable+ProtectedSubscription	Indica un almacén y un estado de suscripción en el que la eliminación es recuperable, inmediata y permanente (es decir, la purga) no está permitida y en la que la propia suscripción no se puede cancelar permanentemente cuando 7<= SoftDeleteRetentionInDays < 90. Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y también refleja el hecho de que no se puede cancelar la propia suscripción.
CustomizedRecoverable+Purgeable	Denota un estado de almacén en el que se puede recuperar la eliminación y, además, permite la eliminación inmediata y permanente (es decir, purga cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención, a menos que se solicite una operación de purga o se cancele la suscripción.
Purgeable	Indica un estado de almacén en el que la eliminación es una operación irreversible, sin la posibilidad de recuperación. Este nivel no corresponde a ninguna protección disponible en una operación de eliminación; los datos se pierden irrecuperablemente al aceptar una operación De eliminación en el nivel de entidad o superior (almacén, grupo de recursos, suscripción, etc.).
Recoverable	Denota un estado de almacén en el que la eliminación se puede recuperar sin la posibilidad de eliminación inmediata y permanente (es decir, purga). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días) y mientras la suscripción sigue estando disponible. El sistema lo eliminará permanentemente después de 90 días, si no se recupera
Recoverable+ProtectedSubscription	Indica un almacén y un estado de suscripción en el que la eliminación se puede recuperar dentro del intervalo de retención (90 días), no se permite la eliminación inmediata y permanente (es decir, purga) y en la que la propia suscripción no se puede cancelar permanentemente. El sistema lo eliminará permanentemente después de 90 días, si no se recupera
Recoverable+Purgeable	Indica un estado de almacén en el que se puede recuperar la eliminación y que también permite la eliminación inmediata y permanente (es decir, purga). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días), a menos que se solicite una operación de purga o se cancele la suscripción. El sistema lo eliminará permanentemente después de 90 días, si no se recupera

Error

Object

Error del servidor del almacén de claves.

Nombre	Tipo	Description
code	string	Código de error.
innererror	Error	Error del servidor del almacén de claves.
message	string	Mensaje de error.

KeyVaultError

Object

Excepción de error del almacén de claves.

Nombre	Tipo	Description
error	Error	Error del servidor del almacén de claves.

Compartir a través de

Get Certificate Versions - Get Certificate Versions

Parámetros de identificador URI

Respuestas

Ejemplos

GetCertificateVersions

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CertificateAttributes

CertificateItem

CertificateListResult

DeletionRecoveryLevel

Error

KeyVaultError

Recursos adicionales