Todos os produtos
Search

Este produto

    Certificate Management Service:CreateCustomCertificate

    Central de documentação

    Certificate Management Service:CreateCustomCertificate

    Última atualização: Jun 28, 2026

    Emite um certificado digital personalizado com assunto, nomes alternativos do assunto (SANs), uso de chave e atributos de uso estendido de chave especificados.

    Descrição da operação

    Por padrão, o assunto do certificado é recuperado da Solicitação de Assinatura de Certificado (CSR). Se você especificar um assunto de certificado, o assunto da CSR será ignorado e o assunto especificado será usado para emitir o certificado.

    Você deve especificar o uso de chave ou o uso estendido de chave com base no seu cenário. Os exemplos a seguir mostram cenários comuns:

    • Certificado de autenticação do lado do servidor.

    Uso de chave: digitalSignature, keyEncipherment.

    Uso estendido de chave: serverAuth.

    • Certificado de autenticação de cliente.

    Uso de chave: digitalSignature, keyEncipherment.

    Uso estendido de chave: clientAuth.

    • Certificado de autenticação mútua mTLS.

    Uso de chave: digitalSignature, keyEncipherment.

    Uso estendido de chave: serverAuth, clientAuth.

    • Certificado de assinatura de e-mail.

    Uso de chave: digitalSignature, contentCommitment.

    Uso estendido de chave: emailProtection.

    Nota: As CAs de conformidade são gerenciadas por autoridades terceirizadas e não suportam esta operação.

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

    create

    *All Resource

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    ParentIdentifier

    string

    Sim

    O identificador do certificado da CA.

    1ed4068c-6f1b-6deb-8e32-3f8439a851cb
    Csr

    string

    Sim

    O conteúdo da CSR. Você pode gerar uma CSR usando ferramentas como OpenSSL ou Keytool. Para obter mais informações, consulte Criar um arquivo CSR.

    -----BEGIN CERTIFICATE REQUEST----- MIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ ... ... ... vbIgMQIhAKHDWD6/WAMbtezAt4bysJ/BZIDz1jPWuUR5GV4TJ/mS -----END CERTIFICATE REQUEST-----
    Validity

    string

    Sim

    O período de validade do certificado. Este período não pode exceder o período de validade da instância. Você pode usar tempo relativo ou tempo absoluto.

    Tempo relativo: Suporta anos, meses e dias.

    • Ano - y

    • Mês - m

    • Dia - d

    Tempo absoluto: Usa GMT. Formato: yyyy-MM-dd'T'HH:mm:ss'Z'

    • Especificar a hora de término - $NotAfter

    • Especificar as horas de início e término - $NotBefore/$NotAfter

    相对时间： ● 1y ● 3m ● 7d 绝对时间： ● 2006-01-02T15:04:05Z ● 2006-01-02T15:04:05Z/2023-03-09T17:48:13Z
    ApiPassthrough

    object

    Não

    Parâmetros de passagem.

    Subject

    object

    Não

    O assunto do certificado.

    Country

    string

    Não

    O código do país. Use o código de país de duas letras da ISO 3166-1. Para obter mais informações, consulte ISO.

    CN
    State

    string

    Não

    A província ou estado onde a organização está localizada.

    浙江省
    Locality

    string

    Não

    O nome da cidade onde a organização está localizada. Suporta caracteres chineses e letras.

    杭州市
    Organization

    string

    Não

    O nome da organização.

    XXX公司
    OrganizationUnit

    string

    Não

    O nome do departamento ou filial dentro da organização.

    XXX部门
    CommonName

    string

    Não

    O nome comum do usuário do certificado.

    张三
    CustomAttributes

    array<object>

    Não

    As propriedades personalizadas do assunto do certificado.

    object

    Não

    As propriedades personalizadas do assunto do certificado.

    ObjectIdentifier

    string

    Não

    The key of the custom property. It must comply with industry standards. Examples:

    • 2.5.4.6: Country code

    • 2.5.4.10: Organization

    • 2.5.4.11: Organizational unit name

    • 2.5.4.12: Title

    • 2.5.4.3: Common name

    • 2.5.4.9: Street

    • 2.5.4.5: Serial number

    • 2.5.4.7: Locality

    • 2.5.4.8: State or province

    • 1.3.6.1.4.1.37244.1.1: Matter certificate - Node ID

    • 1.3.6.1.4.1.37244.1.5: Matter certificate - Fabric ID

    • 1.3.6.1.4.1.37244.2.1: Matter certificate Vendor ID (VID)

    • 1.3.6.1.4.1.37244.2.2: Matter certificate Product ID (PID)

    2.5.4.3
    Value

    string

    Não

    The value of the custom property.

    Aliyun
    Extensions

    object

    Não

    As extensões do certificado.

    KeyUsage

    object

    Não

    O uso de chave.

    DigitalSignature

    boolean

    Não

    Digital signature. Allows the private key of the certificate to be used for digital signatures and the public key to be used to verify digital signatures.

    true
    ContentCommitment

    boolean

    Não

    Content commitment. Formerly known as NonRepudiation. Allows the certificate key to be used for content commitment.

    false
    NonRepudiation

    boolean

    Não

    Non-repudiation. This has been renamed to ContentCommitment in the X.509 standard.

    false
    KeyEncipherment

    boolean

    Não

    Key encipherment. Allows the certificate key to be used to encrypt other keys.

    false
    DataEncipherment

    boolean

    Não

    Data encipherment.

    false
    KeyAgreement

    boolean

    Não

    Key agreement.

    false
    EncipherOnly

    boolean

    Não

    When KeyAgreement is true, this marks that the certificate key can only be used for encryption.

    false
    DecipherOnly

    boolean

    Não

    When KeyAgreement is true, this marks that the certificate key can only be used for decryption.

    false
    ExtendedKeyUsages

    array

    Não

    Os usos estendidos de chave.

    string

    Não

    Os seguintes valores são permitidos:

    • any - Sem restrições

    • serverAuth - Autenticação de servidor

    • clientAuth - Autenticação de cliente

    • codeSigning - Assinatura de código

    • emailProtection - Proteção de e-mail

    • timeStamping - Carimbo de data/hora

    • OCSPSigning - Assinatura OCSP

    • Outros OIDs de uso estendido de chave

    1.3.6.1.4.1.311.20.2.2
    SubjectAlternativeNames

    array<object>

    Não

    Os nomes alternativos do assunto (SANs) do certificado.

    object

    Não

    Os nomes alternativos do assunto (SANs) do certificado.

    Type

    string

    Sim

    The following values are allowed:

    • rfc822Name - Email address

    • dNSName - Domain name

    • uniformResourceIdentifier - Uniform Resource Identifier (URI)

    • iPAddress - IP address

    dNSName
    Value

    string

    Não

    A value that matches the specified Type.

    rfc822Name: example.aliyundoc.com dNSName: learn.aliyundoc.com uniformResourceIdentifier: acs:ecs:regionid:15619224785*****:instance/i-bp1bzvz55uz27hf***** iPAddress: 127.0.0.1
    Criticals

    array

    Não

    Se uma extensão for crítica, seu nome será incluído na lista de extensões críticas.

    string

    Não

    O nome da extensão crítica, como ExtendedKeyUsages.

    ExtendedKeyUsages
    SerialNumber

    string

    Não

    O número de série personalizado do certificado. Deve ser um inteiro longo.

    16889526086333
    Immediately

    integer

    Não

    Obtém o certificado imediatamente.

    • 0 - Emite o certificado de forma assíncrona.

    • 1 - Emite o certificado imediatamente.

    • 2 - Emite o certificado imediatamente e retorna a cadeia de certificados da CA.

    0
    EnableCrl

    integer

    Não

    Especifica se deve incluir um endereço CRL.

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

    testKey
    Value

    string

    Não

    O valor da tag.

    1
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos. Você pode obter esse ID chamando a operação ListResources.

    rg-aek****wia
    customIdentifier

    string

    Não

    Um identificador personalizado.

    XXX068c-6f1b-6deb-8e32-3f8439a8XXX

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    Identifier

    string

    O identificador exclusivo do certificado.

    160ae6bb538d538c70c01f81dcf2****
    Certificate

    string

    O conteúdo do certificado. Isso é retornado quando Immediately é definido como 1 ou 2.

    -----BEGIN CERTIFICATE----- MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/ ... ... ... KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg== -----END CERTIFICATE-----
    CertificateChain

    string

    A cadeia de certificados da CA. Isso é retornado quando Immediately é definido como 2.

    -----BEGIN CERTIFICATE----- MIIBfzCCATGgAwIBAgIUfI5kSdcO2S0+LkpdL3b2VUJG10YwBQYDK2VwMDUxCzAJ ... ... ... ZYYG -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ ... ... ... KL5cUmF -----END CERTIFICATE-----
    SerialNumber

    string

    O número de série do certificado. Isso é retornado quando Immediately é definido como 1 ou 2.

    084bde9cd233f0ddae33adc438cfbbbd****
    RequestId

    string

    O ID da solicitação. Este é um identificador exclusivo gerado pelo Alibaba Cloud para a solicitação. Use este ID para solucionar problemas.

    12345678-1234-1234-1234-123456789ABC

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "Identifier": "160ae6bb538d538c70c01f81dcf2****",
  "Certificate": "-----BEGIN CERTIFICATE-----\nMIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/\n...\n...\n...\nKOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\nMIIBfzCCATGgAwIBAgIUfI5kSdcO2S0+LkpdL3b2VUJG10YwBQYDK2VwMDUxCzAJ\n...\n...\n...\nZYYG\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ\n...\n...\n...\nKL5cUmF\n-----END CERTIFICATE-----",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "12345678-1234-1234-1234-123456789ABC"
}

    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.