Todos os produtos
Search

Este produto

    Certificate Management Service:DescribeClientCertificateForSerialNumber

    Central de documentação

    Certificate Management Service:DescribeClientCertificateForSerialNumber

    Última atualização: Aug 24, 2026

    Consulta os detalhes de certificados de cliente ou certificados de servidor em lote pelo número de série do certificado.

    Nota

    Esta API foi descontinuada. Recomendamos migrar para cas(2020-06-30) - DescribeClientCertificate para funcionalidade aprimorada e suporte contínuo. Embora a API descontinuada permaneça temporariamente acessível, nenhuma atualização ou correção de bugs será fornecida.

    Descrição da operação

    Descrição

    Esta operação permite consultar os detalhes de certificados de cliente ou certificados de servidor em lote pelo número de série do certificado. Os detalhes incluem o número de série, informações do titular, conteúdo e status dos certificados.

    Antes de chamar esta operação, você deve ter criado certificados de cliente ou certificados de servidor.

    Para obter informações sobre como chamar uma operação de API para criar um certificado de cliente, consulte:

    Para obter informações sobre como chamar uma operação de API para criar um certificado de servidor, consulte:

    Limite de QPS

    O limite de QPS por usuário único para esta operação é de 10 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Chame esta operação conforme apropriado.

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

    get

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    SerialNumber

    string

    Sim

    Os números de série dos certificados de cliente ou certificados de servidor que você deseja consultar. Separe vários números de série com vírgulas (,).

    Nota

    Você pode chamar ListClientCertificate para consultar os números de série de todos os certificados de cliente e certificados de servidor.

    084bde9cd233f0ddae33adc438cfbbbd****

    Ao chamar esta operação, você deve incluir os parâmetros de solicitação comuns da API da Alibaba Cloud além dos parâmetros de solicitação descritos neste tópico. Para obter mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

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

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    ListCertificateResponse

    CertificateList

    array<object>

    Os detalhes dos certificados de cliente ou certificados de servidor.

    object

    As informações do certificado.

    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.

    084bde9cd233f0ddae33adc438cfbbbd****
    SubjectDN

    string

    O atributo de nome distinto (DN) do certificado, que indica o titular do certificado. O DN 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=Alibaba Cloud Computing Co., Ltd.,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
    CommonName

    string

    O nome comum do certificado.

    aliyun.com
    OrganizationUnit

    string

    O nome do departamento na organização associada ao certificado de CA subordinada que emitiu este certificado.

    Security
    Organization

    string

    O nome da organização associada ao certificado de CA subordinada que emitiu este certificado.

    Alibaba Cloud Computing Co., Ltd
    Locality

    string

    O nome da cidade onde está localizada a organização associada ao certificado de CA subordinada que emitiu este certificado.

    Hangzhou
    State

    string

    O nome da província ou estado onde está localizada a organização associada ao certificado de CA subordinada que emitiu este certificado.

    Zhejiang
    CountryCode

    string

    O código do país onde está localizada a organização associada ao certificado de CA subordinada que emitiu este certificado.

    Para obter mais informações sobre códigos de país, consulte a seção Códigos internacionais em Gerenciar informações da empresa.

    CN
    Sans

    string

    A extensão Nome Alternativo do Titular (SAN) do certificado, que indica outros nomes de domínio ou endereços IP associados ao certificado.

    Este parâmetro é representado como uma string convertida de um array JSON. Cada elemento no array JSON é uma estrutura que corresponde a uma extensão SAN. Cada estrutura de extensão SAN contém os seguintes parâmetros:

    • Type: Um valor Integer que indica o tipo da extensão. 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: Um valor String que indica o conteúdo da extensão.

    [ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]
    Status

    string

    O status do certificado. Valores válidos:

    • ISSUE: emitido.

    • REVOKE: revogado.

    ISSUE
    BeforeDate

    string

    A data de emissão do certificado. O formato é AAAA-MM-DD.

    2021-10-28T16:15Z
    AfterDate

    string

    A data de expiração do certificado. O formato é AAAA-MM-DD.

    2022-08-23T16:15Z
    Algorithm

    string

    O tipo de 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.

    SUB_ROOT
    ParentIdentifier

    string

    Se este parâmetro não estiver vazio, o certificado de cliente foi emitido pela Alibaba Cloud.

    1a83bcbb89e562885e40aa0108f5****
    Sha2

    string

    A impressão digital SHA-256 do certificado.

    14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****
    Md5

    string

    A impressão digital MD5 do certificado.

    d3b95700998e47afc4d95f886579****
    Years

    integer

    O período de validade do certificado. Unidade: anos.

    1
    RequestId

    string

    O ID da solicitação.

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

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "CertificateList": [
    {
      "X509Certificate": "-----BEGIN CERTIFICATE-----  ...... -----END CERTIFICATE-----",
      "Identifier": "d3b95700998e47afc4d95f886579****",
      "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
      "SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
      "CommonName": "aliyun.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": "2021-10-28T16:15Z",
      "AfterDate": "2022-08-23T16:15Z",
      "Algorithm": "RSA",
      "KeySize": 4096,
      "SignAlgorithm": "SHA256WITHRSA",
      "CertificateType": "SUB_ROOT",
      "ParentIdentifier": "1a83bcbb89e562885e40aa0108f5****",
      "Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
      "Md5": "d3b95700998e47afc4d95f886579****",
      "Years": 1
    }
  ],
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

    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.