Todos os produtos
Search
Central de documentação

Certificate Management Service:CreateWHClientCertificate

Última atualização: Jun 28, 2026

Emite um único certificado de cliente a partir do repositório geral de certificados de usuário.

Descrição da operação

Esta API é limitada a 10 QPS por usuário. Exceder esse limite aciona a limitação de taxa, o que pode afetar seus negócios. Chame esta API a uma taxa razoável para evitar interrupções.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

SanType

integer

Não

O tipo do nome alternativo do assunto (SAN) para o certificado de cliente. Valores válidos:

  • 1: endereço de e-mail.

  • 2: nome de domínio.

  • 6: Identificador Uniforme de Recursos (URI).

  • 7: endereço IP.

2

SanValue

string

Não

O valor da extensão SAN. Para especificar vários valores, separe-os por vírgulas (,).

example.com

CommonName

string

Não

O nome comum do certificado de cliente. Suporta caracteres em chinês, inglês e outros.

aliyun

Algorithm

string

Não

O algoritmo de chave para o certificado de cliente. O formato é <encryption_algorithm>_<key_length>. Valores válidos:

  • RSA_1024: O algoritmo de assinatura correspondente é Sha256WithRSA.

  • RSA_2048: O algoritmo de assinatura correspondente é Sha256WithRSA.

  • RSA_4096: O algoritmo de assinatura correspondente é Sha256WithRSA.

  • ECC_256: O algoritmo de assinatura correspondente é Sha256WithECDSA.

  • ECC_384: O algoritmo de assinatura correspondente é Sha256WithECDSA.

  • ECC_512: O algoritmo de assinatura correspondente é Sha256WithECDSA.

  • SM2_256: O algoritmo de assinatura correspondente é SM3WithSM2.

O algoritmo de criptografia do certificado de cliente deve corresponder ao do certificado da AC subordinada emissora, mas os comprimentos de chave podem ser diferentes. Por exemplo, se o algoritmo de chave do certificado da AC subordinada for RSA_2048, o algoritmo de chave para o certificado de cliente deve ser um entre RSA_1024, RSA_2048 ou RSA_4096.

RSA_2048

Csr

string

Não

O conteúdo da solicitação de assinatura de certificado (CSR). Você pode gerar uma CSR com ferramentas como OpenSSL ou Keytool.

-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----

ParentIdentifier

string

Sim

O identificador exclusivo do certificado da AC subordinada emissora.

273ae6bb538d538c70c01f81jh2****

Days

integer

Não

O período de validade do certificado de cliente, em dias.

Você não pode deixar os parâmetros Days, BeforeTime e AfterTime todos vazios. Os parâmetros BeforeTime e AfterTime devem ser especificados juntos ou não serem especificados.

  • Se você especificar o parâmetro Days, a especificação de BeforeTime e AfterTime é opcional.

  • Se você não especificar o parâmetro Days, deverá especificar tanto BeforeTime quanto AfterTime.

Nota

Se você especificar Days, BeforeTime e AfterTime simultaneamente, o parâmetro Days terá precedência na determinação do período de validade.

365

BeforeTime

integer

Não

A hora de emissão do certificado de cliente, como um timestamp Unix em segundos. Se omitido, o padrão é a hora da chamada da API.

Nota

Os parâmetros BeforeTime e AfterTime devem ser especificados juntos ou não serem especificados.

1634283958

AfterTime

integer

Não

A hora de expiração do certificado de cliente, especificada como um timestamp Unix em segundos.

Nota

Os parâmetros BeforeTime e AfterTime devem ser especificados juntos ou não serem especificados.

1665819958

Organization

string

Não

O nome da organização associado ao certificado da AC raiz, normalmente o nome da sua empresa. Suporta caracteres em chinês, inglês e outros.

阿里巴巴网络技术有限公司

OrganizationUnit

string

Não

O nome do departamento ou unidade de negócios dentro da organização.

IT

Country

string

Não

O país onde a organização está localizada.

CN

State

string

Não

A província, município ou região autônoma onde a organização está localizada. Suporta caracteres em chinês, inglês e outros.

Zhejiang

Locality

string

Não

A cidade onde a organização está localizada. Suporta caracteres em chinês, inglês e outros.

Hangzhou

Years

integer

Não

O período de validade do certificado, em anos.

1

Months

integer

Não

O período de validade do certificado, em meses.

12

Immediately

integer

Não

Especifica qual conteúdo do certificado retornar na resposta.

  • 0: Não retorna o certificado (padrão).

  • 1: Retorna o certificado.

  • 2: Retorna o certificado e sua cadeia de certificados.

1

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O objeto de resposta.

Identifier

string

O identificador exclusivo do certificado de cliente.

190ae6bb538d538c70c01f81dcf2****

RequestId

string

O ID da solicitação. Este ID exclusivo é gerado pela Alibaba Cloud para cada solicitação e pode ser usado para solução de problemas.

8C467B38-3910-447D-87BC-AC049166F216

RootX509Certificate

string

O conteúdo do certificado da AC raiz.

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----

ParentX509Certificate

string

O conteúdo do certificado da AC subordinada.

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----

X509Certificate

string

O conteúdo do certificado de cliente.

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----

CertificateChain

string

A cadeia de certificados.

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n

Exemplos

Resposta de sucesso

JSON formato

{
  "Identifier": "190ae6bb538d538c70c01f81dcf2****",
  "RequestId": "8C467B38-3910-447D-87BC-AC049166F216",
  "RootX509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "ParentX509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n"
}

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.