SetLiveDomainCertificate - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Especifica se o recurso de certificado deve ser ativado para um nome de domínio e modifica as informações do certificado.

Descrição da operação

Obtenha primeiro o nome de domínio de transmissão ao vivo e, em seguida, chame esta operação para especificar se o recurso de certificado deve ser ativado para o nome de domínio e modificar as informações do certificado.

Limite de QPS

O limite de QPS por usuário para esta operação é de 30 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, 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

live:SetLiveDomainCertificate

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 ao qual o certificado pertence. O nome de domínio é do tipo de aceleração `https`.	developer.aliyundoc.com.
CertName	string	Não	O nome do certificado.	Cert-****
CertType	string	Não	O tipo de certificado. Valores válidos: upload: um certificado carregado. cas: um certificado do SSL Certificates Service. free: um certificado de teste pessoal gratuito. Valores válidos: cas : Um certificado do SSL Certificates Service. upload : Um certificado carregado. free : Um certificado de teste pessoal gratuito.	free.
SSLProtocol	string	Sim	Especifica se o certificado HTTPS deve ser ativado. Valores válidos: on: ativado. Se este parâmetro for definido como on, você também deverá definir os parâmetros de solicitação SSLPub e SSLPri. off (padrão): desativado.	off.
SSLPub	string	Não	O conteúdo da chave pública. Nota Este parâmetro é obrigatório apenas quando SSLProtocol está definido como on.	****
SSLPri	string	Não	O conteúdo da chave privada. Nota Este parâmetro é obrigatório apenas quando SSLProtocol está definido como on.	****
ForceSet	string	Não	Ignora a verificação de nomes de certificados duplicados e substitui as informações do certificado existente com o mesmo nome. Defina o valor como 1.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidSSLProtocol.ValueNotSupported	The specified value of parameter SSLProtocol is not supported.
400	SSLPub.MissingParameter	An input parameter "SSLPub" that is mandatory for processing the request is not supplied.
400	SSLPri.MissingParameter	An input parameter "SSLPri" that is mandatory for processing the request is not supplied.
400	InvalidSSLPub	The SSLPub you provided is malformed!
400	InvalidSSLPri	The SSLPri you provided is malformed!
400	Certificate.MissMatch	The SSLPri does not math the specified Certificate!
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length!
400	InvalidCertName.TooLong	The Certificate name you provided is over the max length 128!
400	IllegalOperationDomain	You are not authorized to operate the domain.
400	Certificate.NotPermittedOff	Turn off certificate will change domain scheduling, please contact customer service
400	Certificate.SettedNotEffect	Certificate was successfully setted but does't take effect for protecting current service, please contact customer service
400	Certificate.NotFind	Not find the certificate info.
400	AuthenticationFailed	Authentication failed.
400	SetDomainCertificate.ParameterError	Parameters have error.
400	InvalidSSLPubOrInvalidSSLPri	The SSLPri or SSLPub you provided is malformed!
400	Certificate.StatusError	Certificate is not exist or its status is error.
400	DeleteFailed	Delete certificate is failed.
400	Certificate.Duplicated	The certificate name is duplicated.
400	Certificate.FormatError	The certificate format is error.
400	Certificate.KeyNull	The private key is not null.
400	Key.Malformed	The private key format is error.
400	CertStorage.failed	The certificate storage failed.
400	CertificateContent.Duplicated	The certificate is already uploaded, please don't upload again.
400	Certificate.Expired	The certificate is expired.
400	InvalidDomain.notOnline	The domain is not online, please check the domain status and try again later.
400	Decode.Error	The certificate sslpub or sslpri decode error.
400	sslPub.Error	The SSLPub encoded failed.
400	sslPri.Error	The SSLPri encoded failed.
400	DomainInSafeMode	This domain is in the safe mode. if you want to do this operation, please contact us!
400	DomainInProtectedMode	This domain is in the protected mode. if you want to do this operation, please contact us!
400	FunctionMutex	Function is mutex with other function.
400	DomainOffline	The domain is not online, please check the domain status and try again later.	O nome de domínio não está ativado. Verifique o status do nome de domínio e tente novamente.
403	IllegalOperation	Illegal domain operate is not permitted.
404	CertName.MissingParameter	The CertName parameter is required.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.