Padrões de API e SDKs predefinidos multilíngues
A OpenAPI deste produto (cas/2020-04-07) utiliza o estilo de assinatura RPC. Encapsulamos SDKs para linguagens de programação comuns para desenvolvedores. Os desenvolvedores podem baixar o SDK para chamar diretamente a OpenAPI deste produto sem se preocupar com detalhes técnicos. Se o SDK existente não atender às suas necessidades, você pode usar o mecanismo de assinatura para integração com assinatura própria. Como os detalhes da autoassinatura são muito complexos, isso pode levar cerca de 5 dias úteis. Portanto, recomendamos ingressar em nosso grupo de serviço DingTalk (147535001692) e realizar a integração de assinatura sob orientação especializada.
Antes de usar a API, você precisa preparar sua conta de identidade e chave de acesso (AccessKey) para acessar efetivamente a API por meio de ferramentas cliente (SDK, CLI, etc.). Para obter detalhes, consulte Obter um AccessKey.
Cenários de assinatura personalizada
Se o seu cenário de negócios tiver requisitos especiais e você precisar integrar a API por meio de autoassinatura, recomendamos consultar primeiro nossa equipe de suporte técnico (grupo de serviço DingTalk: 147535001692) para obter orientação profissional e garantir uma integração eficiente.
Preparação de conta e segurança
As contas da Alibaba Cloud têm permissões administrativas completas sobre todos os recursos. Quando um AccessKey é comprometido, todos os recursos associados estarão em risco de acesso não autorizado. Para garantir a segurança, recomenda-se criar um usuário RAM com apenas permissões de acesso à API e configurar seu AccessKey, além de configurar políticas RAM com base no princípio do menor privilégio (PoLP). Use a conta da Alibaba Cloud apenas em cenários específicos em que as permissões da conta da Alibaba Cloud sejam explicitamente necessárias.
Instâncias de assinatura (V2.0)
|
API |
Título |
Descrição |
| ListInstances | Listar instâncias. | Obtém uma lista de instâncias. |
| UpdateInstance | Update an instance. | Atualiza uma instância. |
| GetInstanceDetail | Consulta de detalhes da instância. | Consulta os detalhes de uma instância. |
| DeleteInstance | Excluir uma instância. | Exclui uma instância. |
| RefundInstance | Reembolsar uma instância. | Reembolsa uma instância dentro de 7 dias. |
| GetInstanceSummary | GetInstanceSummary. | Consulta as estatísticas resumidas das instâncias do Certificate Management Service, como a contagem de certificados por status. |
| ApplyCertificate | Solicitar um certificado. | Solicita um certificado. |
| GetTaskAttribute | GetTaskAttribute | Consulta o resultado do processamento e o status de uma solicitação de certificado enviada. |
| CancelPendingCertificate | Revoke a certificate application. | Revoga uma solicitação de certificado. |
| ListCertificates | Listar certificados. | Obtém uma lista de certificados. |
| RevokeCertificate | Revoke a certificate. | Revoga um certificado. |
| GetCertificateDetail | Consulta de detalhes do certificado excluindo a chave privada. | Consulta os detalhes de um certificado. O conteúdo do certificado e o conteúdo da chave privada não são retornados. |
| GetUserCertificateDetail | Obter detalhes do certificado. | Obtém os detalhes de um certificado, incluindo informações básicas e conteúdo de chave pública/privada. Você pode usar esta operação para baixar o conteúdo do certificado e a chave privada. |
| DeleteUserCertificate | Excluir um certificado. | Exclui um certificado expirado, revogado ou carregado. |
| UploadUserCertificate | Upload de um certificado. | Faz o upload de um certificado, incluindo um certificado SM padrão ou um certificado não SM. |
Contatos de certificado
|
API |
Título |
Descrição |
| CreateContact | Criar um contato de solicitação de certificado. | Cria um contato de solicitação de certificado. |
| GetContact | Obter informações de contato. | Obtém um contato. |
| ListContact | Obter lista de contatos. | Obtém a lista de contatos. |
| UpdateContact | Editar um contato de solicitação de certificado. | Atualiza um contato. |
| DeleteContact | Excluir um contato de solicitação de certificado. | Exclui um contato. |
Organizações da empresa
|
API |
Título |
Descrição |
| CreateCompany | Criar uma organização de empresa certificada. | Cria uma empresa. |
| UpdateCompany | Editar organização da empresa do certificado. | Atualiza as informações da empresa. |
| ListCompanies | Recuperar organizações da empresa do certificado. | Obtém uma lista de empresas. |
| GetCompany | Obter detalhes da empresa ou organização do certificado. | Obtém os detalhes de uma empresa. |
| DeleteCompany | Excluir uma organização de empresa de certificado. | Exclui uma empresa. |
Grupos de recursos
|
API |
Título |
Descrição |
| MoveResourceGroup | MoveResourceGroup. | Altera o grupo de recursos ao qual um certificado ou solicitação de certificado pertence. |
Tarefas de implantação
|
API |
Título |
Descrição |
| CreateDeploymentJob | CreateDeploymentJob. | Cria uma tarefa de implantação de certificado para implantar um certificado SSL em um ou mais serviços da Alibaba Cloud imediatamente ou em um horário agendado. |
| UpdateDeploymentJobStatus | UpdateDeploymentJobStatus. | Atualiza o status de uma tarefa de implantação de certificado, como alterar de edição para execução pendente. |
| ListDeploymentJob | Consultar lista de tarefas de implantação. | Obtém uma lista de tarefas de implantação após a criação de uma tarefa de implantação. |
| UpdateDeploymentJob | UpdateDeploymentJob. | Atualiza a configuração de uma tarefa de implantação de certificado, como os certificados ou recursos de destino. |
| DescribeDeploymentJob | DescribeDeploymentJob. | Obtém informações sobre um trabalho de implantação de certificado, incluindo o status do trabalho, os recursos de destino e os certificados. |
| ListWorkerResource | ListWorkerResource. | Consulta as tarefas de worker de uma tarefa de implantação. Cada tarefa de worker implanta um certificado em um recurso de nuvem específico em um serviço de nuvem. |
| DescribeDeploymentJobStatus | DescribeDeploymentJobStatus. | Consulta o resumo do status de execução de uma tarefa de implantação de certificado, incluindo o número de tarefas worker bem-sucedidas e com falha. |
| ListDeploymentJobResource | ListDeploymentJobResource. | Consulta os recursos de nuvem associados a uma tarefa de implantação. Uma lista vazia indica que os recursos são inválidos e devem ser reassociados. |
| ListDeploymentJobCert | ListDeploymentJobCert. | Consulta os certificados associados a uma tarefa de implantação, como o ID da instância do certificado, o tipo e o nome. |
| UpdateWorkerResourceStatus | Atualizar status da tarefa de worker em uma tarefa de implantação. | Atualiza o status de uma tarefa de worker em uma tarefa de implantação. |
| DeleteWorkerResource | DeleteWorkerResource. | Exclui uma tarefa de worker de uma tarefa de implantação de certificado. |
| DeleteDeploymentJob | DeleteDeploymentJob. | Exclui uma tarefa de implantação de certificado. |
| DescribeCloudResourceStatus | DescribeCloudResourceStatus. | Consulta o número de recursos em nuvem nos quais certificados foram implantados usando uma tarefa de implantação multi-cloud. |
| ListCloudResources | ListCloudResources. | Consulta os recursos de nuvem nos quais os certificados estão implantados, como instâncias do Server Load Balancer (SLB) e domínios de CDN. |
| ListCloudAccess | ListCloudAccess. | Consulta os pares de AccessKey configurados para a implantação de certificados em multinuvem. |
Repositório de certificados
|
API |
Título |
Descrição |
| GetCertWarehouseQuota | GetCertWarehouseQuota. | Consulta a cota restante para operações do repositório de solicitação de certificados. |
| ListCertWarehouse | Consultar lista de repositórios de certificados. | Consulta a lista de repositórios de certificados. |
| ListCert | ListCert. | Consulta certificados no repositório de certificados. |
| Sign | Sign | Cria uma assinatura digital com um certificado PCA de um repositório de certificados. |
| Verify | Verify. | Verifica uma assinatura de dados usando um certificado privado em um repositório de aplicação de certificados. |
| Encrypt | Encrypt. | Criptografa dados usando um certificado em um repositório de aplicação de certificados. |
| Decrypt | Decrypt | Descriptografa dados que foram criptografados usando um certificado em um repositório de aplicações de certificados. |
| UploadPCACert | Carregar um certificado PCA para um repositório de certificados. | Faz upload de um certificado PCA para um repositório de certificados. |
| DeletePCACert | DeletePCACert. | Exclui um certificado privado de um repositório de solicitação de certificados. |
| CreateWHClientCertificate | CreateWHClientCertificate. | Emite um único certificado de cliente a partir do repositório geral de certificados de usuário. |
| RevokeWHClientCertificate | RevokeWHClientCertificate. | Revoga um certificado de cliente do repositório de certificados. |
Gerenciamento de CSR
|
API |
Título |
Descrição |
| ListCsr | ListCsr. | Consulta as solicitações de assinatura de certificado (CSRs) em sua conta. |
| CreateCsr | CreateCsr. | Cria uma solicitação de assinatura de certificado (CSR) que contém informações sobre um certificado SSL a ser solicitado, como os nomes de domínio e o titular do certificado. Você deve fornecer um CSR ao enviar uma solicitação de certificado para uma autoridade certificadora (CA). |
| UploadCsr | UploadCsr. | Faz o upload de uma solicitação de assinatura de certificado (CSR) existente para o Certificate Management Service. Após o upload, você pode usar a CSR para solicitar certificados. |
| GetCsrDetail | GetCsrDetail. | Consulta o conteúdo de uma solicitação de assinatura de certificado (CSR). |
| UpdateCsr | Fazer upload ou atualizar uma chave privada de CSR. | Faz upload da chave privada correspondente a um CSR caso você não tenha fornecido a chave privada do CSR ao fazer upload do CSR local. |
| DeleteCsr | DeleteCsr. | Exclui uma solicitação de assinatura de certificado (CSR). |
Pedidos (V1.0)
|
API |
Título |
Descrição |
| DescribePackageState | DescribePackageState. | Consulta a cota e o uso de pacotes de certificados com validação de domínio (DV). |
| ListUserCertificateOrder | Query user certificates or orders | Consulta a lista de certificados ou pedidos do usuário. |
| CreateCertificateForPackageRequest | CreateCertificateForPackageRequest. | Envia uma solicitação de certificado utilizando a cota de um pacote de certificados adquirido. |
| CancelCertificateForPackageRequest | CancelCertificateForPackageRequest. | Revoga um certificado emitido ou cancela um pedido de certificado pendente e restaura a cota. |
| CancelOrderRequest | CancelOrderRequest. | Cancela um pedido de certificado que está aguardando verificação de domínio ou em análise. |
| RenewCertificateOrderForPackageRequest | RenewCertificateOrderForPackageRequest. | Envia uma solicitação de renovação para um certificado SSL emitido. |
Solicitações de certificado (V1.0)
|
API |
Título |
Descrição |
| DescribeCertificateState | DescribeCertificateState. | Consulta o status de um pedido de certificado, como o progresso de validação do domínio. |
| CreateCertificateWithCsrRequest | CreateCertificateWithCsrRequest. | Compra, solicita e emite um certificado validado por domínio (DV) usando um arquivo personalizado de solicitação de assinatura de certificado (CSR). |
| CreateCertificateRequest | CreateCertificateRequest. | Compra, solicita e emite um certificado validado por domínio (DV) usando serviços de certificado estendidos. |
| DeleteCertificateRequest | DeleteCertificateRequest. | Exclui um pedido de solicitação de certificado com validação de domínio (DV) com falha. |
Outros
|
API |
Título |
Descrição |
| AddCloudAccess | AddCloudAccess. | Adiciona uma AccessKey para autorização. |
| CreateWarehouse | Criar um repositório de aplicações de certificados. | Cria um repositório de certificados. |
| DeleteCloudAccess | Excluir acesso à nuvem. | Exclui uma chave de acesso. |
| DeleteWarehouse | DeleteWarehouse. | Exclui um repositório de certificados. |
| DescribeWarehouseCert | DescribeWarehouseCert. | Obtém os detalhes de um certificado armazenado em um repositório de certificados. |
| GetAssetCount | Consultar contagem de ativos. | Consulta o número de ativos. |
| GetRiskCount | GetRiskCount. | Consulta o número de ativos com riscos relacionados a certificados, como certificados expirados ou prestes a expirar. |
| ListAssetCount | Consultar estatísticas de recursos de serviço em nuvem. | Consulta a lista de estatísticas de recursos de serviços em nuvem. |
| ListWarehouse | ListWarehouse. | Lista os warehouses. |
| BatchUpdateNoticeStatus | Atualiza o status da notificação de mensagem. | Atualiza o status de notificação em lotes. |
| GetMatchedResources | Retrieve matched resources for a certificate | Obtém os recursos que correspondem a um certificado. |
| CreateRollbackTask | Roll back a deployment. | Reverte uma implantação. |
| GetCertificatePackageCount | Obter quantidade de planos de recursos de certificados. | Obtém a quantidade de planos de recursos de certificados. |
| ListTagKeys | Consultar chaves de tags. | Obtém uma lista de chaves e valores de tags. |
| ListTagResources | Obter lista de tags de recursos. | Obtém as tags associadas a um recurso. |
| ListTrusteeOrder | Get managed order list. | Obtém a lista de pedidos gerenciados. |
| ShareCertificate | Compartilhar um certificado. | Compartilha um certificado. |
| TagResources | Anexa tags a um recurso especificado (instância de certificado SSL) | Adiciona tags de recurso. |
| UntagResources | Remover tags de um recurso especificado (instância de certificado SSL) | Remove tags. |