SetCdnDomainSSLCertificate - CDN: Central de Documentação do Alibaba Cloud

Define se o recurso de certificado está ativado para um nome de domínio e atualiza as informações do certificado.

Descrição da operação

Limite de taxa por usuário: 30 chamadas por segundo.
Método HTTP: POST.

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

cdn:SetCdnDomainSSLCertificate

update

*Domínio.

acs:cdn:*:{#accountId}:domain/{#DomainName}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DomainName	string	Sim	O nome de domínio acelerado para o qual você deseja configurar o certificado. O nome de domínio deve usar a aceleração segura HTTPS. Você pode especificar apenas um nome de domínio.	example.com
CertName	string	Não	O nome do certificado. Você pode especificar apenas um nome de certificado. Este parâmetro é opcional quando CertType é definido como upload. Ele especifica o nome do novo certificado.	yourCertName
CertId	integer	Não	O ID do certificado. Este parâmetro é obrigatório quando CertType é definido como cas. Ele especifica o ID de um certificado existente.	8089870
CertType	string	Não	O tipo do certificado. Valores válidos: upload: faz o upload de um certificado. cas: usa um certificado do SSL Certificates Service. Valores válidos: cas : Certificado do SSL Certificates Service. upload : Upload de um certificado.	upload
SSLProtocol	string	Sim	Especifica se o certificado HTTPS deve ser ativado. Valores válidos: on: ativa o certificado HTTPS. off: desativa o certificado HTTPS.	off
SSLPub	string	Não	O conteúdo do certificado SSL. Este parâmetro não é obrigatório se o certificado estiver desativado. Se você configurar um certificado, deverá inserir o conteúdo do certificado.	xxx
SSLPri	string	Não	O conteúdo da chave privada. Este parâmetro não é obrigatório se o certificado estiver desativado. Se você configurar um certificado, deverá inserir o conteúdo da chave privada.	y****
CertRegion	string	Não	A região onde o certificado está armazenado. Este parâmetro entra em vigor apenas quando CertType é definido como cas. Valores válidos: cn-hangzhou e ap-southeast-1. Valor padrão: cn-hangzhou. Os usuários do site internacional devem usar ap-southeast-1. Valores válidos: ap-southeast-1 : ap-southeast-1 cn-hangzhou : cn-hangzhou.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	A7C69682-7F88-40DD-A198-10D0309E439D

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "A7C69682-7F88-40DD-A198-10D0309E439D\n"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidSSLProtocol.ValueNotSupported	The specified SSLProtocol is invalid.
400	SSLPub.MissingParameter	The SSLPub parameter is required.	O parâmetro SSLPub está ausente.
400	SSLPri.MissingParameter	The SSLPri parameter is required.	O parâmetro SSLPri está ausente.
400	InvalidSSLPub	The specified SSLPub is invalid.
400	InvalidSSLPri	The specified SSLPri is invalid.
400	Certificate.MissMatch	The SSLPri does not match the certificate.
400	InvalidCertificate.TooLong	The maximum length of the certificate is exceeded.
400	InvalidCertName.TooLong	The length of the certificate name cannot exceed 128 characters.
400	AuthenticationFailed	Error performing verification.
400	SetDomainCertificate.ParameterError	The specified parameters are invalid.	O parâmetro especificado é inválido.
400	Certificate.StatusError	The status of the certificate is invalid.
400	DeleteFailed	Error deleting the certificate.
400	Certificate.NotFind	The certificate does not exist.
400	Certificate.Duplicated	The certificate name already exists.
400	Certificate.FormatError	The format of the certificate is invalid.	O formato do certificado é inválido.
400	Certificate.KeyNull	The private key is required.
400	Key.Malformed	The specified Key format is invalid.
400	CertStorage.failed	Error saving the certificate.
400	CertificateContent.Duplicated	The certificate has been uploaded; do not upload again.
400	Certificate.Expired	The certificate has expired.
400	InvalidDomain.notOnline	The domain is offline. Check the status of the domain and try again later.
400	Decode.Error	Error decoding the SSLPub or SSLPri certificate.
400	sslPub.Error	Error encoding SSLPub.
400	sslPri.Error	Error encoding SSLPri.
400	DomainInSafeMode	The domain is in safe mode. To request permission, contact Customer Service.
400	CreateCertificateFailed	Create certificate failed,please try again.
400	Abs.CertRegion.ValueNotSupported	CertRegion is not supported.	A região do certificado não é suportada.
400	CertNameAlreadyExists	The CertName already exists.	O nome do certificado especificado já existe.
400	InvalidDomain.Offline	The domain provided is offline.	O nome de domínio foi colocado offline.
400	InvalidEnv	The specified Env is invalid.	O parâmetro especificado para implantação de certificado de versão canário é inválido.
403	DomainInProtectedMode	The domain is in protection mode. To request permission, contact Customer Service.
404	CertName.MissingParameter	You must specify CertName.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.