CreateCertificateForPackageRequest - : Central de Documentação do Alibaba Cloud

Envia uma solicitação de certificado utilizando a cota de um pacote de certificados adquirido.

Descrição da operação

Antes de chamar esta operação, certifique-se de ter adquirido um plano de recursos de certificado com as especificações necessárias. Para obter mais informações sobre como adquirir um plano de recursos de certificado, consulte Adquirir um plano de recursos de certificado. Você pode chamar a operação DescribePackageState para consultar o uso de um plano de recursos de certificado de especificações especificadas, incluindo o número total de planos de recursos de certificado adquiridos, o número de solicitações de certificado enviadas e o número de certificados emitidos.
Depois de chamar esta operação para enviar uma solicitação de certificado e o certificado for emitido, a cota de certificado fornecida pelo plano de recursos adquirido será consumida. Ao chamar esta operação, você pode usar o parâmetro ProductCode para especificar as especificações do certificado que deseja solicitar.
Depois de chamar esta operação para enviar uma solicitação de certificado, você também precisa chamar a operação DescribeCertificateState para obter as informações necessárias para a verificação de propriedade do nome de domínio e concluir a verificação manualmente. Em seguida, sua solicitação de certificado é analisada pela autoridade certificadora (CA). Se você usar o método de verificação do Domain Name System (DNS), deverá concluir a verificação no sistema do seu provedor de serviços de DNS. Se você usar o método de verificação por arquivo, deverá concluir a verificação no servidor DNS.

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

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Csr	string	Não	O conteúdo do arquivo de solicitação de assinatura de certificado (CSR) gerado manualmente usando OpenSSL ou Keytool para o nome de domínio. O algoritmo de chave no arquivo CSR deve ser Rivest-Shamir-Adleman (RSA) ou criptografia de curva elíptica (ECC), e o comprimento da chave do algoritmo RSA deve ser maior ou igual a 2.048 caracteres. Para obter mais informações sobre como criar um arquivo CSR, consulte Criar um arquivo CSR. Se você não especificar este parâmetro, o Certificate Management Service criará automaticamente um arquivo CSR. Um arquivo CSR contém informações sobre o seu servidor e empresa. Ao solicitar um certificado, você deve enviar o arquivo CSR para a CA. A CA assina o arquivo CSR usando a chave privada do certificado raiz e gera um arquivo de chave pública para emitir o seu certificado. Nota O campo CN no arquivo CSR especifica o nome de domínio vinculado ao certificado. Você deve incluir o campo no valor do parâmetro.	-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----
ProductCode	string	Não	As especificações do certificado que você deseja solicitar. Valores válidos: digicert-free-1-free (padrão): certificado de validação de domínio (DV) de domínio único DigiCert, gratuito e válido por 3 meses. Este valor está disponível apenas no site da China (aliyun.com). symantec-free-1-free: certificado DV de domínio único DigiCert, gratuito e válido por 1 ano. Este valor está disponível apenas no site da China (aliyun.com). symantec-dv-1-starter: certificado DV curinga DigiCert. symantec-ov-1-personal: certificado de validação de organização (OV) de domínio único DigiCert. symantec-ov-w-personal: certificado OV curinga DigiCert. geotrust-dv-1-starter: certificado DV de domínio único GeoTrust. geotrust-dv-w-starter: certificado DV curinga GeoTrust. geotrust-ov-1-personal: certificado OV de domínio único GeoTrust. geotrust-ov-w-personal: certificado OV curinga GeoTrust. globalsign-dv-1-personal: certificado DV de domínio único GlobalSign. globalsign-dv-w-advanced: certificado DV curinga GlobalSign. globalsign-ov-1-personal: certificado OV de domínio único GlobalSign. globalsign-ov-w-advanced: certificado OV curinga GlobalSign. cfca-ov-1-personal: certificado OV de domínio único da China Financial Certification Authority (CFCA), disponível apenas no site da China (aliyun.com). cfca-ev-w-advanced: certificado OV curinga CFCA, disponível apenas no site da China (aliyun.com).	digicert-free-1-free
Username	string	Não	O nome do solicitante. Se você não especificar este parâmetro, as informações do contato mais recente adicionado ao módulo Gerenciamento de Informações serão usadas. Para obter mais informações sobre como adicionar um contato ao módulo Gerenciamento de Informações, consulte Gerenciar contatos.	Tom
Phone	string	Não	O número de telefone de contato do solicitante. A equipe da CA pode ligar para o número de telefone para confirmar as informações da sua solicitação de certificado. Se você não especificar este parâmetro, as informações do contato mais recente adicionado ao módulo Gerenciamento de Informações serão usadas. Para obter mais informações sobre como adicionar um contato ao módulo Gerenciamento de Informações, consulte Gerenciar contatos.	1390000****
Email	string	Não	O endereço de e-mail do solicitante. Depois que a CA receber sua solicitação de certificado, ela enviará um e-mail de verificação para o endereço de e-mail especificado. Você deve fazer login na caixa de correio, abrir o e-mail e concluir a verificação de propriedade do nome de domínio com base nas etapas descritas no e-mail. Se você não especificar este parâmetro, as informações do contato mais recente adicionado ao módulo Gerenciamento de Informações serão usadas. Para obter mais informações sobre como adicionar um contato ao módulo Gerenciamento de Informações, consulte Gerenciar contatos.	username@example.com
Domain	string	Não	O nome de domínio que você deseja vincular ao certificado. O nome de domínio deve atender aos seguintes requisitos: O nome de domínio deve ser um nome de domínio único ou um nome de domínio curinga. Exemplo: `.aliyundoc.com`. Você pode especificar vários nomes de domínio. Separe vários nomes de domínio com vírgulas (,). Você pode especificar no máximo cinco nomes de domínio. Se você especificar vários nomes de domínio, eles deverão ser apenas nomes de domínio únicos ou apenas nomes de domínio curinga. Você não pode especificar nomes de domínio únicos e curingas simultaneamente. Nota* Se você deseja vincular vários nomes de domínio ao certificado, deve especificar este parâmetro. Você deve especificar pelo menos um dos parâmetros: Domain ou Csr. Se você especificar ambos os parâmetros Domain e Csr, o valor do campo CN no parâmetro Csr será usado como o nome de domínio vinculado ao certificado.	aliyundoc.com
CompanyName	string	Não	O nome da empresa da solicitação de certificado. Nota Este parâmetro está disponível apenas quando você solicita certificados OV. Para obter mais informações, consulte Gerenciar perfis de empresa. Se você deseja solicitar um certificado DV, não precisa adicionar um perfil de empresa. Se você especificar um nome de empresa, as informações da empresa configuradas no módulo Gerenciamento de Informações serão usadas. Se você não especificar este parâmetro, as informações da empresa mais recente adicionada ao módulo Gerenciamento de Informações serão usadas.	某公司
ValidateType	string	Não	O método de verificação da propriedade do nome de domínio. Valores válidos: DNS: verificação de DNS. Se você usar este método, deverá adicionar um registro TXT aos registros DNS do nome de domínio na plataforma de gerenciamento do nome de domínio. Você deve ter permissões de operação na resolução de nomes de domínio para verificar a propriedade do nome de domínio. FILE: verificação por arquivo. Se você usar este método, deverá criar um arquivo especificado no servidor DNS. Você deve ter direitos administrativos no servidor DNS para verificar a propriedade do nome de domínio. Para obter mais informações sobre os métodos de verificação, consulte Verificar a propriedade de um nome de domínio.	DNS
Tags	array<object>	Não	Uma lista de tags.
	object	Não	As tags.
Key	string	Não	A chave da tag.	runtime
Value	string	Não	O valor da tag.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OrderId	integer	O ID do pedido de solicitação de certificado. Nota Você pode usar o ID para consultar o status do pedido de solicitação de certificado. Para obter mais informações, consulte DescribeCertificateState.	2021010
RequestId	string	O ID da solicitação, que é usado para localizar e solucionar problemas.	5890029B-938A-589E-98B9-3DEC7BA7C400

Exemplos

Resposta de sucesso

JSON formato

{
  "OrderId": 2021010,
  "RequestId": "5890029B-938A-589E-98B9-3DEC7BA7C400"
}

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.