Todos os produtos
Search
Central de documentação

Certificate Management Service:Consultar status de certificado DV via API

Última atualização: Aug 27, 2026

Use a operação DescribeCertificateState para consultar o status da solicitação de um certificado com validação de domínio (DV).

Consultar a documentação da OpenAPI

O API overview indica que a operação DescribeCertificateState consulta o status da solicitação de certificados DV. Consulte a documentação correspondente para verificar os parâmetros obrigatórios e as permissões necessárias.

Criar um usuário RAM e conceder permissões

Identidade

Você pode chamar esta API com uma conta Alibaba Cloud, um usuário RAM ou uma função RAM (Identidade, credencial e autorização). Este exemplo usa um usuário RAM.

Faça login no console RAM e crie um usuário RAM com permissões exclusivas para API. Anote o par de AccessKey. Create a RAM user.

Autorização

  1. Acesse a lista de usuários RAM. Na coluna Actions, clique em Attach Policy.

  2. Na seção Policy, pesquise e selecione AliyunYundunCertFullAccess (acesso total ao Alibaba Cloud Security Certificate Service) e clique em OK.

Credencial

O sistema gera um par de AccessKey automaticamente durante a criação do usuário RAM. Para gerar um novo par, acesse a página de detalhes do usuário RAM, clique na aba Authentication e clique em Create AccessKey. Create an AccessKey.

Chamar a OpenAPI

Este exemplo usa Java.

Preparar o ambiente de desenvolvimento Java

Requisitos

Verificar a versão

Execute java -version no terminal para confirmar a versão do JDK instalada.

Configurar variáveis de ambiente

Para evitar codificar as credenciais AccessKey diretamente no código-fonte, armazene-as em variáveis de ambiente. Configure environment variables on Linux, macOS, and Windows.

Instalar dependências

Dependência do SDK

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>cas20200407</artifactId>
  <version>1.0.13</version>
</dependency>

Dependência de autenticação

Use a versão mais recente da biblioteca Java Credentials.

<dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>credentials-java</artifactId>
   <version>LATEST</version>
</dependency>

Baixar o código de exemplo

  1. Acesse a página de depuração da API DescribeCertificateState no OpenAPI Explorer.

  2. Insira o OrderId do pedido de solicitação do certificado que deseja consultar.

  3. Siga as instruções abaixo e clique em Download full project para baixar o pacote com o código de exemplo em Java.

    No lado direito da página de depuração da OpenAPI, clique na aba SDK Sample, defina a versão do SDK como V2.0 e selecione Java como linguagem.

  4. Extraia o conteúdo do pacote e importe o projeto no IntelliJ IDEA.

Executar o código

Execute o código no IntelliJ IDEA. Saída esperada:

{
  "Type": "domain_verify",
  "Domain": "www.example.com",
  "RecordType": "TXT",
  "Certificate": "-----BEGIN CERTIFICATE----- …… -----END CERTIFICATE-----",
  "RequestId": "082FAB35-6AB9-4FD5-8750-D36673548E76",
  "RecordDomain": "_dnsauth",
  "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----…… -----END RSA PRIVATE KEY-----",
  "ValidateType": "FILE",
  "RecordValue": "20200420000000223erigacv46uhaubchcm0o7spxi7i2isvjq59mlx9lucnkqcy",
  "Content": "http://example.com/.well-known/pki-validation/fileauth.txt",
  "Uri": "/.well-known/pki-validation/fileauth.txt"
}