Todos os produtos
Search
Central de documentação

Certificate Management Service:ListCert

Última atualização: Sep 16, 2026

Obtém uma lista de certificados.

Descrição da operação

Consulta a lista de certificados. Se você quiser consultar certificados por uma CA intermediária específica e não tiver o identificador exclusivo do certificado da CA, chame primeiro DescribeCACertificateList e passe o Identifier retornado como o parâmetro ParentIdentifier.

Limite de QPS

O limite de QPS por usuário para esta operação é de 10 chamadas por segundo. Se o limite for excedido, a chamada de API será limitada, o que pode afetar o seu negócio. Chame esta operação conforme necessário.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

yundun-cert:ListCert

list

*Todos os recursos.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

InstanceUuid

string

Não

O UUID da instância.

1ef79512-569b-6a4e-9105-9b91473562f7

BeforeDate

string

Não

A hora de modificação do certificado, no formato AAAA-MM-DD.

2025-09-04

AfterDate

string

Não

O registro de host vinculado ao certificado, no formato AAAA-MM-DD.

2024-05-13

Status

string

Não

O status do certificado. Valores válidos:

  • ISSUE: Normal.

  • REVOKE: Revogado.

ISSUE

Type

string

Não

O tipo de certificado. Valores válidos:

  • SERVER: certificado de servidor.

  • CLIENT: certificado de cliente.

  • END_ENTITY: certificado de entidade final.

CLIENT

CurrentPage

integer

Não

O número da página atual.

1

ShowSize

integer

Não

O tamanho total do certificado. Unidade: bytes.

50

MaxResults

integer

Não

O número máximo de entradas a serem retornadas.

20

NextToken

string

Não

O token para a próxima consulta. Se este parâmetro estiver vazio, não existem mais resultados.

1d2db86sca4384811e0b5e8707e68181f

ParentIdentifier

string

Não

O identificador da CA intermediária que emitiu o certificado. Você pode chamar DescribeCACertificateList para consultar o identificador exclusivo de um certificado de CA.

273ae6bb538d538c70c01f81jh2****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

OpenApiResponse<PagedResultData>

TotalCount

integer

O número total de certificados.

10

PageCount

integer

O número total de páginas.

1

CurrentPage

integer

O número da página atual.

1

ShowSize

integer

O tamanho total do certificado. Unidade: bytes.

50

List

array<object>

O ID da fonte de dados à qual os certificados pertencem.

object

As informações do certificado.

Status

string

O status do certificado. Valores válidos:

  • ISSUE: Normal.

  • REVOKE: Revogado.

complete

AfterDate

string

O horário de expiração do certificado em UTC/GMT.

Mon Nov 05 16:33:52 CST 2035

Organization

string

A organização do certificado.

test

KeyExportable

boolean

Indica se a chave do certificado pode ser exportada. Valores válidos:

  • true: A chave do certificado pode ser exportada.

  • false: A chave do certificado não pode ser exportada.

true

SubjectDn

string

O Nome Distinto do assunto.

SubjectDn

Algorithm

string

O tipo de algoritmo.

RSA

CertificateType

string

O tipo de certificado. Valores válidos:

  • free: certificado gratuito.

  • cas: certificado CAS.

  • upload: upload personalizado.

Server

Identifier

string

O identificador do certificado.

1ef539a8-1e1f-6b88-8c11-21cf01a203e9

SerialNumber

string

O número de série do certificado.

3a3ee3c3597d675e

Extra

string

O campo estendido.

{"appId":"APP_PFHMIGUHKDUW6S3N7ZL2"}

OrganizationUnit

string

O nome da empresa ou organização à qual o comprador do certificado pertence.

IT

BeforeTime

integer

O horário de emissão do certificado de cliente, no formato de timestamp. O valor padrão é o horário em que você chama esta operação. Unidade: milissegundos.

Nota

Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos especificados.

1728921600000

AliasName

string

O nome do certificado emitido.

test

AfterTime

integer

O horário de expiração do serviço do certificado de cliente, no formato de timestamp. Unidade: milissegundos.

Nota

Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos especificados.

1728921600000

Id

integer

O ID da fonte de dados do pedido do certificado.

1806958

Tags

array

As tags do certificado.

string

As tags do certificado.

{"app-57074":"test"}

CommonName

string

O nome de domínio principal vinculado ao certificado.

www.kfsjn.xyz

BeforeDate

string

O horário de emissão do certificado em UTC/GMT.

Wed Nov 05 16:33:52 CST 2025

CustomIdentifier

string

O identificador definido pelo usuário, que serve como uma chave exclusiva.

***b86sca4384811e0b5e8707e68***

RequestId

string

O ID da solicitação.

15C66C7B-671A-4297-9187-2C4477247A74

NextToken

string

O token para a próxima consulta. Se este parâmetro estiver vazio, não existem mais resultados.

1d2db86sca4384811e0b5e8707e68181f

MaxResults

integer

O número máximo de entradas a serem retornadas.

20

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 10,
  "PageCount": 1,
  "CurrentPage": 1,
  "ShowSize": 50,
  "List": [
    {
      "Status": "complete",
      "AfterDate": "Mon Nov 05 16:33:52 CST 2035",
      "Organization": "test",
      "KeyExportable": true,
      "SubjectDn": "SubjectDn",
      "Algorithm": "RSA",
      "CertificateType": "Server",
      "Identifier": "1ef539a8-1e1f-6b88-8c11-21cf01a203e9",
      "SerialNumber": "3a3ee3c3597d675e",
      "Extra": "{\"appId\":\"APP_PFHMIGUHKDUW6S3N7ZL2\"}",
      "OrganizationUnit": "IT",
      "BeforeTime": 1728921600000,
      "AliasName": "test",
      "AfterTime": 1728921600000,
      "Id": 1806958,
      "Tags": [
        "{\"app-57074\":\"test\"}"
      ],
      "CommonName": "www.kfsjn.xyz",
      "BeforeDate": "Wed Nov 05 16:33:52 CST 2025",
      "CustomIdentifier": "***b86sca4384811e0b5e8707e68***"
    }
  ],
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "NextToken": "1d2db86sca4384811e0b5e8707e68181f",
  "MaxResults": 20
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.