ListClientCertificate - Certificate Management Service: Central de Documentação do Alibaba Cloud

Lista todos os certificados de cliente e certificados de servidor emitidos por uma autoridade certificadora (CA) privada.

Descrição da operação

Esta API realiza uma consulta paginada para obter os detalhes de todos os certificados de cliente e de servidor que você criou. Esses detalhes incluem o identificador exclusivo, o número de série, as informações do assunto, o conteúdo e o status de cada certificado.

Limite de QPS

O limite de QPS para um único usuário é de 10 chamadas por segundo. Se você exceder esse limite, suas chamadas de API serão limitadas, o que pode afetar seus negócios. Chame esta API a uma taxa razoável.

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

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CurrentPage	integer	Não	O número da página. Valor padrão: 1.	1
ShowSize	integer	Não	O número de entradas a serem retornadas em cada página. Valor padrão: 20.	20
Identifier	string	Não	O identificador exclusivo do certificado de cliente ou de servidor que você deseja consultar. Nota Você pode chamar ListClientCertificate para consultar os identificadores exclusivos de todos os certificados de cliente e de servidor.	160ae6bb538d538c70c01f81dcf2****
ResourceGroupId	string	Não	O ID do grupo de recursos. Chame a operação ListResources para obter este ID.	rg-ae******4wia

Ao chamar esta API, você deve incluir os parâmetros de solicitação comuns para APIs do Alibaba Cloud, além dos parâmetros de solicitação descritos neste tópico.

Para o formato da solicitação, consulte o exemplo de solicitação na seção Exemplos deste tópico.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	ListCertificateResponse2
CertificateList	array<object>	Uma lista de detalhes sobre os certificados de cliente ou de servidor.
	object	Um objeto.
X509Certificate	string	O conteúdo do certificado.	-----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE-----
Identifier	string	O identificador exclusivo do certificado.	d3b95700998e47afc4d95f886579****
SerialNumber	string	O número de série do certificado.	62b2b943a32d96883a6650e672ea0276****
SubjectDN	string	O Nome Distinto (DN) do certificado. O DN indica o usuário do certificado e contém as seguintes informações: C: O país. O: A organização. OU: O departamento. L: A cidade. ST: A província ou estado. CN: O nome comum.	C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
CommonName	string	O nome comum do certificado.	aliyundoc.com
OrganizationUnit	string	O nome do departamento da organização que está associado ao certificado da autoridade certificadora (CA) subordinada emissora.	Security
Organization	string	O nome da organização que está associada ao certificado da CA subordinada emissora.	阿里云计算有限公司
Locality	string	A cidade onde está localizada a organização associada ao certificado da CA subordinada emissora.	Hangzhou
State	string	O nome da província ou estado onde está localizada a organização associada ao certificado da CA subordinada emissora.	Zhejiang
CountryCode	string	O código do país onde está localizada a organização associada ao certificado da CA subordinada emissora. Para obter mais informações sobre códigos de país, consulte a seção Códigos de país de Gerenciar informações da empresa.	CN
Sans	string	A extensão Nome Alternativo do Assunto (SAN) do certificado. Esta extensão indica outros nomes de domínio, endereços IP e assim por diante que estão associados ao certificado. Este parâmetro é uma string convertida de uma matriz JSON. Cada elemento na matriz JSON é uma estrutura que corresponde a uma extensão SAN. Cada estrutura de extensão SAN contém os seguintes parâmetros: Type: O tipo da extensão. Este parâmetro é do tipo Integer. Valores válidos: 1: um endereço de e-mail. 2: um nome de domínio. 6: um Identificador Uniforme de Recursos (URI). 7: um endereço IP. Value: O conteúdo da extensão. Este parâmetro é do tipo String.	[ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]
Status	string	O status do certificado. Valores válidos: ISSUE: O certificado foi emitido. REVOKE: O certificado foi revogado.	ISSUE
BeforeDate	integer	A data de emissão do certificado. Este valor é um carimbo de data/hora UNIX. Unidade: milissegundos.	1634283958000
AfterDate	integer	A data de validade do certificado. Este valor é um carimbo de data/hora UNIX. Unidade: milissegundos.	1665819958000
Algorithm	string	O tipo do algoritmo de criptografia do certificado. Valores válidos: RSA: Algoritmo RSA. ECC: Algoritmo ECC. SM2: Algoritmo SM2.	RSA
KeySize	integer	O comprimento da chave do certificado.	4096
SignAlgorithm	string	O algoritmo de assinatura do certificado.	SHA256WITHRSA
CertificateType	string	O tipo do certificado. Valores válidos: CLIENT: um certificado de cliente. SERVER: um certificado de servidor.	SERVER
ParentIdentifier	string	O identificador exclusivo do certificado da CA subordinada que emitiu este certificado.	160ae6bb538d538c70c01f81dcf2****
Sha2	string	A impressão digital SHA-256 do certificado.	14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****
Md5	string	A impressão digital MD5 do certificado.	d3b95700998e47afc4d95f886579****
Days	integer	O período de validade do certificado. Unidade: dias.	365
ResourceGroupId	string	O ID do grupo de recursos ao qual o certificado pertence.	rg-acfmyxa2uv6cu5a
CustomIdentifier	string	O identificador personalizado, que é uma chave exclusiva.	**48d8d3ecc9976d9ecd2b2f25**
Id	integer	O ID da chave primária do certificado.	12321
AliasName	string	O nome do certificado emitido.	生产培训10.153.13.177
CurrentPage	integer	O número da página retornada.	1
PageCount	integer	O número total de páginas.	1
ShowSize	integer	O número de certificados retornados por página.	20
TotalCount	integer	O número total de certificados de cliente e de servidor que são consultados.	1
RequestId	string	O ID da solicitação.	15C66C7B-671A-4297-9187-2C4477247A74
MaxResults	integer	Parâmetro de paginação: o número máximo de entradas no conjunto de resultados.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "CertificateList": [
    {
      "X509Certificate": "-----BEGIN CERTIFICATE-----  ...... -----END CERTIFICATE-----",
      "Identifier": "d3b95700998e47afc4d95f886579****",
      "SerialNumber": "62b2b943a32d96883a6650e672ea0276****",
      "SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
      "CommonName": "aliyundoc.com",
      "OrganizationUnit": "Security",
      "Organization": "阿里云计算有限公司",
      "Locality": "Hangzhou",
      "State": "Zhejiang",
      "CountryCode": "CN",
      "Sans": "[ {\"Type\": 7, \"Value\": \"192.0.XX.XX\"}, {\"Type\": 2, \"Value\": \"www.aliyundoc.com\"}, ]",
      "Status": "ISSUE",
      "BeforeDate": 1634283958000,
      "AfterDate": 1665819958000,
      "Algorithm": "RSA",
      "KeySize": 4096,
      "SignAlgorithm": "SHA256WITHRSA",
      "CertificateType": "SERVER",
      "ParentIdentifier": "160ae6bb538d538c70c01f81dcf2****",
      "Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
      "Md5": "d3b95700998e47afc4d95f886579****",
      "Days": 365,
      "ResourceGroupId": "rg-acfmyxa2uv6cu5a",
      "CustomIdentifier": "****48d8d3ecc9976d9ecd2b2f25****",
      "Id": 12321,
      "AliasName": "生产培训10.153.13.177"
    }
  ],
  "CurrentPage": 1,
  "PageCount": 1,
  "ShowSize": 20,
  "TotalCount": 1,
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "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.