CreateServerCertificateWithCsr - Certificate Management Service: Central de Documentação do Alibaba Cloud

Emite um único certificado de servidor com base em uma CSR personalizada.

Descrição da operação

Antes de chamar esta operação, você deve ter chamado CreateRootCACertificate para criar um certificado de CA raiz e chamado CreateSubCACertificate para criar um certificado de sub-CA. Apenas certificados de sub-CA podem emitir certificados de servidor.

Limite de QPS

O limite de QPS por usuário para esta operação é de 10 chamadas por segundo. Se o limite for excedido, a chamada da API será limitada, o que pode afetar seus negócios. Chame esta operação adequadamente.

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

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Csr	string	Sim	O conteúdo da CSR. Você pode usar OpenSSL ou Keytool para gerar uma CSR. Para mais informações, consulte Como criar um arquivo CSR?.	-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----
Domain	string	Não	O nome de domínio estendido ou endereço IP estendido do certificado de servidor. Após adicionar informações estendidas ao certificado, você pode aplicar o certificado a vários nomes de domínio ou endereços IP. Você pode inserir vários nomes de domínio e endereços IP ao mesmo tempo. Separe vários valores com vírgulas (,).	example.com
Organization	string	Não	O nome da organização. Valor padrão: Alibaba Inc.	Alibaba Cloud
OrganizationUnit	string	Não	O nome do departamento. Valor padrão: Aliyun CDN.	IT
Country	string	Não	O código do país, como CN.	CN
CommonName	string	Não	O nome comum do certificado. Caracteres chineses, caracteres ingleses e outros caracteres são suportados. Nota Se você definir o parâmetro Csr, o valor do parâmetro CommonName será determinado pelas informações correspondentes no parâmetro Csr.	mtcsq.com
State	string	Não	O nome da província ou estado onde a organização do certificado está localizada. Caracteres chineses, caracteres ingleses e outros caracteres são suportados. O valor padrão é o nome da província ou estado onde a organização do certificado de sub-CA que emite este certificado está localizada.	Zhejiang
Locality	string	Não	O nome da cidade onde a organização do certificado está localizada. Caracteres chineses, caracteres ingleses e outros caracteres são suportados. O valor padrão é o nome da cidade onde a organização do certificado de sub-CA que emite este certificado está localizada.	Hangzhou
Algorithm	string	Não	O algoritmo de chave do certificado de servidor. O algoritmo de chave está no formato `<algoritmo de criptografia>_<tamanho da chave>`. Valores válidos: RSA_1024: O algoritmo de assinatura é Sha256WithRSA. RSA_2048: O algoritmo de assinatura é Sha256WithRSA. RSA_4096: O algoritmo de assinatura é Sha256WithRSA. ECC_256: O algoritmo de assinatura é Sha256WithECDSA. ECC_384: O algoritmo de assinatura é Sha256WithECDSA. ECC_512: O algoritmo de assinatura é Sha256WithECDSA. SM2_256: O algoritmo de assinatura é SM3WithSM2. O algoritmo de criptografia do certificado de servidor deve ser igual ao do certificado de sub-CA, mas o tamanho da chave pode ser diferente. Por exemplo, se o algoritmo de chave do certificado de sub-CA for RSA_2048, o algoritmo de chave do certificado de servidor deve ser RSA_1024, RSA_2048 ou RSA_4096. Nota Você pode chamar DescribeCACertificate para consultar o algoritmo de chave do certificado de sub-CA.	RSA_2048
ParentIdentifier	string	Sim	O identificador exclusivo do certificado de sub-CA que emite este certificado. Nota Você pode chamar DescribeCACertificateList para consultar o identificador exclusivo do certificado de sub-CA.	270oe6bb538d538c70c01f81hfd3****
Years	integer	Não	O período de validade do certificado. Unidade: anos.	1
Months	integer	Não	O período de validade do certificado. Unidade: meses.	12
Days	integer	Não	O período de validade do certificado de servidor. Unidade: dias. Os parâmetros Days, BeforeTime e AfterTime não podem estar todos vazios, e os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos definidos. A seguir, descreve-se como definir este parâmetro: Se você definir o parâmetro Days, poderá optar por definir ou não os parâmetros BeforeTime e AfterTime. Se você não definir o parâmetro Days, deverá definir os parâmetros BeforeTime e AfterTime. Nota Se você definir os parâmetros Days, BeforeTime e AfterTime ao mesmo tempo, o período de validade do certificado de servidor será determinado pelo valor do parâmetro Days. O período de validade do certificado de servidor não pode exceder o período de validade do certificado de sub-CA. Você pode chamar DescribeCACertificate para visualizar o período de validade do certificado de sub-CA.	365
BeforeTime	integer	Não	A hora de emissão do certificado de servidor no formato de timestamp. O valor padrão é a hora em que você chama esta operação. Unidade: segundos. Nota Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos definidos.	1634283958
AfterTime	integer	Não	A hora de expiração do certificado de servidor no formato de timestamp. Unidade: segundos. Nota Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos definidos.	1665819958
Immediately	integer	Não	Especifica se o certificado digital deve ser retornado imediatamente. Valores válidos: 0: não retorna o certificado. Este é o valor padrão. 1: retorna o certificado. 2: retorna o certificado e sua cadeia de certificados.	1
EnableCrl	integer	Não	Especifica se o endereço CRL deve ser incluído. Valores válidos: 0: não. 1: sim.	1
Tags	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag.	account
Value	string	Não	O valor da tag.	test
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-aek****wia
CustomIdentifier	string	Não	O identificador personalizado, que é uma chave exclusiva.	*e6bb538d538c70c01f81hfd3**
AsynchronousFlag	boolean	Não	O sinalizador de processamento assíncrono. Se o valor for "true", o serviço de back-end emite o certificado de forma assíncrona. Após a solicitação ser enviada, você pode chamar a operação ListClientCertificate para obter o certificado mais recente.	false

Ao chamar esta operação, você deve incluir parâmetros de solicitação comuns das APIs do Alibaba Cloud, além dos parâmetros de solicitação descritos neste tópico.

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	CreateCertificateResponse
X509Certificate	string	O conteúdo do certificado de servidor.	-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----
CertificateChain	string	A cadeia de certificados da CA.	-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n
Identifier	string	O identificador exclusivo do certificado de servidor.	180ae6bb538d538c70c01f81dcf2****
SerialNumber	string	O número de série do certificado.	084bde9cd233f0ddae33adc438cfbbbd****
RequestId	string	O ID da solicitação. O Alibaba Cloud gera um identificador exclusivo para cada solicitação. Você pode usar o ID da solicitação para solucionar problemas.	55C66C7B-671A-4297-9187-2C4477247A74

Exemplos

Resposta de sucesso

JSON formato

{
  "X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n",
  "Identifier": "180ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "55C66C7B-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.