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

Adiciona um nome de domínio de transmissão ao vivo. Você pode adicionar apenas um nome de domínio por vez.

Descrição da operação

Antes de adicionar um nome de domínio de transmissão ao vivo, você deve ativar o ApsaraVideo Live. Para mais informações, consulte Ativar o serviço.
Antes de adicionar um novo nome de domínio, você deve primeiro verificar a propriedade do nome de domínio e então chamar esta operação para adicionar o nome de domínio. Você pode usar a verificação por resolução DNS ou a verificação por arquivo. Para mais informações, consulte Verificar a propriedade do nome de domínio.
O ApsaraVideo Live requer tanto ingestão de fluxo quanto streaming. Você deve adicionar um domínio de ingestão e um domínio de streaming separadamente. Você pode enviar apenas um nome de domínio por vez.
Após adicionar um nome de domínio, você deve configurar a resolução CNAME para o nome de domínio. Para mais informações, consulte Configurar resolução CNAME.
Após adicionar um domínio de ingestão e um domínio de streaming, você deve associar os domínios associados antes de poder usar o ApsaraVideo Live. Para mais informações, consulte Domínio associado.

Importante A partir de 19 de fevereiro de 2019, os nomes de domínio adicionados usando AddLiveDomain não suportam ingestão via live center. Novos nomes de domínio adicionados usando operações da API CDN também não suportam ingestão via live center. Use a ingestão de borda para adicionar um domínio de ingestão (chame AddLiveDomain com o tipo de negócio definido como liveEdge) e um domínio de streaming (chame AddLiveDomain com o tipo de negócio definido como liveVideo) e, em seguida, associe-os (chame AddLiveDomainMapping). Os nomes de domínio adicionados antes de 19 de fevereiro de 2019 não são afetados.

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

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
LiveDomainType	string	Sim	O tipo do nome de domínio. Valores válidos: liveVideo: domínio de streaming. Se você definir DomainName (o nome de domínio a ser conectado ao ApsaraVideo Live) como um domínio de streaming, deverá definir este parâmetro como liveVideo. liveEdge: domínio de ingestão de borda. Se você definir DomainName (o nome de domínio a ser conectado ao ApsaraVideo Live) como um domínio de ingestão, deverá definir este parâmetro como liveEdge. Valores válidos: liveEdge : Domínio de ingestão de borda. liveGrtnPub : Domínio de ingestão GRTN. liveGrtnSub : Domínio de streaming GRTN. liveVideo : Domínio de streaming.	liveVideo.
DomainName	string	Sim	O domínio de ingestão ou domínio de streaming a ser conectado ao ApsaraVideo Live. Nomes de domínio curinga são suportados e devem começar com um ponto (.).	example.aliyundoc.com.
Region	string	Sim	As informações de unidade do nome de domínio de transmissão ao vivo. Valores válidos: cn-beijing: Pequim. cn-shanghai: Xangai. cn-shenzhen: Shenzhen. cn-qingdao: Qingdao. ap-southeast-1: Singapura. eu-central-1: Alemanha. ap-northeast-1: Tóquio. ap-southeast-5: Jacarta. Nota Region (informações de unidade do nome de domínio de transmissão ao vivo) e Scope (região de aceleração) não se restringem mutuamente.	cn-beijing.
CheckUrl	string	Não	A URL de verificação de integridade.	http://demo.aliyundoc.com/status.html.
Scope	string	Não	A região de aceleração. Este parâmetro entra em vigor para usuários internacionais e usuários do site China no nível L3 ou superior. Valores válidos: domestic (padrão): China continental. overseas: fora da China continental, incluindo Hong Kong (China), Macau (China) e Taiwan (China). global: aceleração global.	domestic.
TopLevelDomain	string	Não	O nome de domínio de nível superior para acesso.	learn.aliyundoc.com.
ResourceGroupId	string	Não	O ID do grupo de recursos. Para mais informações sobre grupos de recursos, consulte O que é um grupo de recursos.	rg-aekzw******
Tag	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.	TestValue.

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	InvalidDomainName.Malformed	Specified DomainName is malformed.
400	InvalidRegion.Malformed	Specified Region is malformed.	A região especificada é inválida.
400	InvalidSource.Content.Malformed	Specified source content is malformed.
400	InvalidTypeContent.Mismatch	Specified source type does not math the specified source content.
400	MissingSource.Content	Specified source content is mandatory for this action.
400	MissingSource.Type	Specified source type is mandatory for this action.
400	InvalidSource.Type.Malformed	Specified source type is malformed.
400	InvalidSource.Priority.Malformed	Specified source priority is malformed.
400	InvalidScope.Malformed	Specified Scope is malformed.
400	SourceIp.Exceed	The Certificate you provided is malformed!
400	InvalidCertificate	The Certificate you provided is malformed!
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length!
400	InnerAddDomainDenied	Your account haven't bind aoneId, can not add domain.
400	CheckSourceHealthFailed	sources ip or source domain check health failed，please input right source.
400	ExtensiveAndAllBothExist	Extensive domain and the domain begins with 'all.' can not exist at the same time.
400	CdnTypeNotSupportExtensiveDomain	Extensive domain not supported for this cdn type.
400	ExtensiveAndSpecificDomainConflict	Extensive domain and corresponding specific domain are mutually exclusive.	O nome de domínio curinga entra em conflito com o nome de domínio exato correspondente.
400	InvalidDomainNameLevel	Domain name suffixed with alicdn.com only support third level.
400	TopLevelDomain.NotFound	TopLevelDomain is not exist.
400	EntityNotExists.ResourceGroup	The resource group does not exist.
400	InvalidStatus.ResourceGroup	It's now allowed to do this operation because of the current status of resource-group.
400	NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.	Você deve usar uma identidade autorizada válida para acessar recursos na China continental.
400	RecordCheckNotAvailable	Please try again later.
400	IcpBlack	The domain is on the ICP blacklist.
400	IspBlack	The domain is on the ISP blacklist.
400	DomainNotRecordedAliyun	The domain not access Ali Cloud for the record please access.
400	Abs.CheckUrl.Malformed	The CheckUrl you provided is malformed!
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.
400	InvalidResourceGroupId.Malformed	Specified ResourceGroupId is malformed.
400	DomainReserved	The root domain of your domain is reserved by another account.	O nome de domínio raiz deste nome de domínio foi adicionado a outra conta.
400	ExceedLimit	The number of domains has exceeded the limit.	O número de nomes de domínio que você possui excedeu o limite superior.
400	LockFail	Domain has been occupied.	O nome de domínio está atualmente em uso. Tente novamente mais tarde.
403	AccountException	Account exception. Please open ticket to make an appeal.
403	EntityNotExist.ResourceGroup	The resource group does not exist.	O grupo de recursos não existe.
404	InvalidUser	The user's account is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.