Todos os produtos
Search
Central de documentação

:GetCertificateDetail

Última atualização: Sep 17, 2026

Consulta os detalhes de um certificado. O conteúdo do certificado e o conteúdo da chave privada não são retornados.

Descrição da operação

O limite de consultas por segundo (QPS) por usuário para esta operação é 100. Se esse limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Use esta operação de forma 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:GetCertificateDetail

get

*Todos os recursos.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

CertificateId

integer

Sim

O ID do certificado.

18594156

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Algorithm

string

O algoritmo do certificado.

  • RSA: Algoritmo RSA.

  • ECC: Algoritmo ECC.

  • SM2: Algoritmo SM2.

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 do 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 será "123-cn-hangzhou" e o CertIdentifier no site internacional será "123-ap-southeast-1".

21912069-cn-hangzhou

CertificateChainList

array<object>

A lista de informações da cadeia de certificados.

object

As informações da cadeia de certificados.

Issuer

string

O nome do emissor da cadeia de certificados.

Digicert

NotAfter

integer

A hora de término do período de validade do certificado.

17326613180000

NotBefore

integer

A hora de início do período de validade do certificado.

17321613180000

RemainDay

integer

Os dias restantes do período de validade da cadeia de certificados.

10

Subject

string

O nome comum da cadeia de certificados.

Digicert

CertificateId

integer

O ID do certificado.

22559621

CertificateName

string

O nome do certificado.

123

CertificateSource

string

A origem do certificado.

  • BUY: Certificado comprado.

  • TEST: Certificado de teste.

  • UPLOAD: Certificado carregado.

BUY

CertificateStatus

string

O status do certificado.

  • issued: Emitido.

  • revoked: Revogado.

  • willExpire: Prestes a expirar.

  • expired: Expirado.

issued

CommonName

string

O nome de domínio comum.

www.example.com

CompanyId

integer

O ID das informações da empresa associadas à solicitação do certificado. Este valor está vazio para certificados DV.

44211

ContactId

integer

O ID do contato.

304066

Csr

string

A solicitação de assinatura de certificado (CSR) usada para emitir o certificado.

-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----

DeploymentDesc

string

As informações de implantação em formato JSON:

--Scope: Os valores válidos são all/server. O valor é all se o certificado tiver uma chave privada, ou server se não tiver.

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

Todos os nomes de domínio incluídos no certificado. Vários nomes de domínio são separados por vírgulas (,).

aliyundoc.com,example.aliyundoc.com

ExistPrivateKey

boolean

Indica se existe uma chave privada no backend para o certificado atual. Valores válidos:

  • true

  • false

true

FingerPrint

string

A impressão digital da chave pública.

123

InstanceId

string

O ID da instância.

cas_dv-cn-123

Issuer

string

A autoridade emissora do certificado.

Digicert

KeySize

integer

O comprimento do algoritmo de chave.

  • O comprimento do algoritmo RSA é tipicamente 2048, 3072 ou 4096.

  • O comprimento dos algoritmos ECC e SM2 é tipicamente 256.

2048

NotAfter

integer

A hora de término do período de validade do certificado.

17326613180000

NotBefore

integer

A hora de início do período de validade do certificado.

17321613180000

RequestId

string

O ID da solicitação. O Alibaba Cloud gera um identificador exclusivo para cada solicitação. Você pode usar este ID para solucionar problemas.

5979d897-d69f-4fc9-87dd-f3bb73c40b80

Serial

string

O número de série do certificado.

123

SubjectAlternativeNames

array

A lista de Nomes Alternativos do Assunto (SANs) do certificado, retornada em formato de matriz. Isso corresponde ao campo Subject Alternative Name do certificado.

string

O Nome Alternativo do Assunto (SAN) do certificado.

aliyundoc.com

Tags

array<object>

A lista de tags.

object

A lista de tags.

TagKey

string

A chave da tag da instância. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia.

A chave da tag pode ter até 64 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://.

test

TagValue

string

O valor da tag.

test

UsingProductList

array

A lista de serviços do Alibaba Cloud nos quais o certificado está implantado atualmente.

string

O serviço do Alibaba Cloud.

CDN

Exemplos

Resposta de sucesso

JSON formato

{
  "Algorithm": "RSA",
  "CertIdentifier": "21912069-cn-hangzhou",
  "CertificateChainList": [
    {
      "Issuer": "Digicert",
      "NotAfter": 17326613180000,
      "NotBefore": 17321613180000,
      "RemainDay": 10,
      "Subject": "Digicert"
    }
  ],
  "CertificateId": 22559621,
  "CertificateName": "123",
  "CertificateSource": "BUY",
  "CertificateStatus": "issued",
  "CommonName": "www.example.com",
  "CompanyId": 44211,
  "ContactId": 304066,
  "Csr": "-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----",
  "DeploymentDesc": "{\n      \"Scope\": \"all\",\n       \"ServerName\": \"acmeServerName\",\n       \"ResourceInstanceId\": \"cas_dv-cn-XXX\"\n}",
  "Domain": "aliyundoc.com,example.aliyundoc.com",
  "ExistPrivateKey": true,
  "FingerPrint": "123",
  "InstanceId": "cas_dv-cn-123",
  "Issuer": "Digicert",
  "KeySize": 2048,
  "NotAfter": 17326613180000,
  "NotBefore": 17321613180000,
  "RequestId": "5979d897-d69f-4fc9-87dd-f3bb73c40b80",
  "Serial": "123",
  "SubjectAlternativeNames": [
    "aliyundoc.com"
  ],
  "Tags": [
    {
      "TagKey": "test",
      "TagValue": "test"
    }
  ],
  "UsingProductList": [
    "CDN"
  ]
}

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.