Todos os produtos
Search

Este produto

    Certificate Management Service:CreateServerCertificate

    Central de documentação

    Certificate Management Service:CreateServerCertificate

    Última atualização: Aug 17, 2026

    Emite um único certificado de servidor com base em uma solicitação de assinatura de certificado (CSR) gerada pelo sistema.

    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 CA subordinada. Apenas certificados de CA subordinada 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:CreateServerCertificate

    create

    *All Resource

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    Domain

    string

    Não

    Os nomes de domínio estendidos e endereços IP estendidos do certificado de servidor. Após adicionar informações estendidas ao certificado, você pode aplicar o certificado a vários nomes de domínio e endereços IP.

    Separe vários nomes de domínio e endereços IP 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 ou US.

    CN
    CommonName

    string

    Sim

    O nome do usuário do certificado. Para um certificado de autenticação de servidor (ServerAuth), o usuário é um servidor. Insira o nome de domínio ou endereço IP associado ao servidor.

    www.example.com
    State

    string

    Não

    O nome da província ou estado onde a organização do certificado está localizada. Caracteres chineses e ingleses são suportados. Valor padrão: o nome da província ou estado onde a organização do certificado de CA subordinada 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 e ingleses são suportados. Valor padrão: o nome da cidade onde a organização do certificado de CA subordinada que emite este certificado está localizada.

    Hangzhou
    Algorithm

    string

    Sim

    O algoritmo de chave do certificado de servidor. O algoritmo de chave está no formato <algoritmo de criptografia>_<comprimento 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 o mesmo do certificado de CA subordinada, mas o comprimento da chave pode ser diferente. Por exemplo, se o algoritmo de chave do certificado de CA subordinada 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 CA subordinada.

    RSA_2048
    ParentIdentifier

    string

    Sim

    O identificador exclusivo do certificado de CA subordinada que emite este certificado.

    Nota

    Você pode chamar DescribeCACertificateList para consultar o identificador exclusivo do certificado de CA subordinada.

    271ae6bb538d538c70c01f81dg3****
    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. Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos especificados. As seguintes regras se aplicam:

    • 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 CA subordinada. Você pode chamar DescribeCACertificate para consultar o período de validade do certificado de CA subordinada.

    365
    BeforeTime

    integer

    Não

    A hora de emissão do certificado de servidor no formato de timestamp. 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 especificados.

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

    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 da Lista de Revogação de Certificados (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. Você pode obter esse ID chamando a operação ListResources.

    test
    CustomIdentifier

    string

    Não

    O identificador personalizado, que é uma chave exclusiva.

    ****6bb538d538c70c01f81dg3****
    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 o envio da solicitação, 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 da API do Alibaba Cloud, além dos parâmetros de solicitação específicos da operação descritos neste tópico.

    Para o formato da solicitação, consulte os exemplos 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.

    160ae6bb538d538c70c01f81dcf2****
    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.

    15C66C7B-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": "160ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "15C66C7B-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.