ListCertificates - : Central de Documentação do Alibaba Cloud

Obtém uma lista de certificados.

Descrição da operação

Consulta os logs de operação de certificados de CA, incluindo certificados de CA raiz e certificados de CA subordinados. Por exemplo, você pode consultar os logs de criação e os logs de alteração de status dos certificados de CA.

O limite de consultas por segundo (QPS) por usuário para esta operação é 10. Se esse limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Execute esta operação com uma frequência adequada.

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:ListCertificates

list

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Keyword	string	Não	A palavra-chave para correspondência aproximada. A palavra-chave é comparada com nomes de domínio, nomes e IDs de recursos correspondentes.	test
InstanceId	string	Não	O ID da instância.	cas-ivauto-hqito6
CertificateStatus	string	Não	O status do certificado. Valores válidos: issued: Emitido. revoked: Revogado. willExpire: Prestes a expirar. expired: Expirado.	issued
CertificateSource	string	Não	A origem do certificado. Valores válidos: BUY: um certificado formal. TEST: um certificado de teste. UPLOAD: um certificado carregado.	BUY
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-aek****wia
ShowSize	integer	Não	O número de entradas por página. Valor padrão: 10. Valor máximo: 100.	10
CurrentPage	integer	Não	O número da página atual.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
CertificateList	array<object>	A lista de certificados.
	object	As informações do certificado.
Algorithm	string	O tipo de algoritmo de criptografia do certificado. Valores válidos: RSA: algoritmo RSA. ECC: algoritmo ECC. SM2: algoritmo SM2 (criptográfico nacional chinês).	RSA
CertIdentifier	string	O ID global do certificado, no formato de ID do certificado + "-" + ID da região do site. Este ID é comumente usado nos serviços da Alibaba Cloud. Para o site da China, o valor é ID do certificado + "-cn-hangzhou". Para o site internacional, o valor é ID do certificado + "-ap-southeast-1". Por exemplo, se o ID do certificado for 123, o CertIdentifier no site da China é "123-cn-hangzhou", e o CertIdentifier no site internacional é "123-ap-southeast-1".	21589515-cn-hangzhou
CertificateId	string	O ID do certificado.	17281539
CertificateName	string	O nome do certificado.	test
CertificateSource	string	A origem do certificado. Valores válidos: BUY: um certificado formal. TEST: um certificado de teste. UPLOAD: um certificado carregado.	BUY
CertificateStatus	string	O status do certificado. Valores válidos: issued: Emitido. revoked: Revogado. willExpire: Prestes a expirar. expired: Expirado.	issued
CommonName	string	O nome comum do certificado.	aliyun.com
DeploymentDesc	string	As informações de implantação em formato JSON: --Scope: os valores válidos são all/server. Se o certificado tiver uma chave privada, o valor é all. Se o certificado não tiver uma chave privada, o valor é server. --ServerName: o nome do servidor associado à instância do certificado. --ResourceInstanceId: o identificador de recurso do servidor associado à instância do certificado.	{ "Scope": "all", "ServerName": "acmeServerName", "ResourceInstanceId": "cas_dv-cn-XXX" }
Domain	string	Os nomes de domínio vinculados ao certificado. Vários nomes de domínio são separados por vírgulas (,).	test.com
ExistPrivateKey	boolean	Indica se o certificado possui uma chave privada. Valores válidos: true false	true
FingerPrint	string	A impressão digital da chave pública.	123
InstanceId	string	O ID da instância do certificado.	cas-cn-v***
Issuer	string	O emissor do certificado.	DigiCert
KeySize	integer	O comprimento da chave do algoritmo. O comprimento da chave RSA é normalmente 2048, 3072 ou 4096. O comprimento das chaves ECC e SM2 é normalmente 256.	2048
NotAfter	integer	A hora de término do período de validade do certificado.	1749580567000
NotBefore	integer	A hora de início do período de validade do certificado.	1760745600000
Serial	string	O número de série do certificado.	123
SubjectAlternativeNames	array	A lista de nomes alternativos do assunto (SANs) do certificado, retornada como uma matriz. Isso corresponde ao campo `Subject Alternative Name` do certificado.
	string	O nome alternativo do assunto do certificado.	test.com
UsingProductList	array	A lista de serviços da Alibaba Cloud para os quais o certificado está implantado atualmente.
	string	O serviço da Alibaba Cloud.	CDN
CurrentPage	integer	O número da página atual. Valor padrão: 1.	1
RequestId	string	O ID da solicitação, que é um identificador exclusivo gerado pela Alibaba Cloud para a solicitação. Você pode usar este ID para solucionar problemas.	CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D
ShowSize	integer	O número de entradas por página.	10
TotalCount	integer	O número total de entradas retornadas.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "CertificateList": [
    {
      "Algorithm": "RSA",
      "CertIdentifier": "21589515-cn-hangzhou",
      "CertificateId": "17281539",
      "CertificateName": "test",
      "CertificateSource": "BUY",
      "CertificateStatus": "issued",
      "CommonName": "aliyun.com",
      "DeploymentDesc": "{\n      \"Scope\": \"all\",\n       \"ServerName\": \"acmeServerName\",\n       \"ResourceInstanceId\": \"cas_dv-cn-XXX\"\n}",
      "Domain": "test.com",
      "ExistPrivateKey": true,
      "FingerPrint": "123",
      "InstanceId": " cas-cn-v***",
      "Issuer": "DigiCert",
      "KeySize": 2048,
      "NotAfter": 1749580567000,
      "NotBefore": 1760745600000,
      "Serial": "123",
      "SubjectAlternativeNames": [
        "test.com"
      ],
      "UsingProductList": [
        "CDN"
      ]
    }
  ],
  "CurrentPage": 1,
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D",
  "ShowSize": 10,
  "TotalCount": 10
}

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.