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

Chama a operação CreateCaster para criar um estúdio de produção.

Descrição da operação

Você deve ativar o ApsaraVideo Live antes de chamar esta operação. Para mais informações, consulte Ativar o ApsaraVideo Live. Esta operação suporta os seguintes tipos de estúdios de produção: Padrão e Nova Playlist (Carrossel).

Limite de QPS

O limite de consultas por segundo (QPS) para esta operação é de 10 chamadas por segundo para cada usuário. Se você exceder esse limite, as chamadas de API serão limitadas, o que pode afetar seus negócios. Recomendamos que você chame esta operação a uma taxa razoável.

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

create

*Caster

acs:live:*:{#accountId}:caster/{#CasterId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região.	cn-beijing
CasterName	string	Não	O nome do estúdio de produção.	liveCaster****
ClientToken	string	Sim	O token do cliente usado para garantir a idempotência da solicitação. Gere um token no seu cliente e certifique-se de que o token seja único entre diferentes solicitações. O token pode ter até 64 caracteres ASCII.	53200b81-b761-4c10-842a-a0726d97****
NormType	integer	Sim	O tipo do estúdio de produção. Valores válidos: 1: Padrão. 6: Carrossel (Nova Playlist).	1
ChargeType	string	Sim	O método de cobrança. Apenas PostPaid é suportado. Valores válidos: PrePaid: assinatura (não suportado). PostPaid: pagamento conforme o uso.	PostPaid
PurchaseTime	string	Não	A hora de compra do estúdio de produção. A hora está no formato `yyyy-MM-ddTHH:mm:ssZ` e é exibida em UTC. Nota Este parâmetro está disponível apenas se você definir ChargeType como PrePaid.	2017-08-20T12:10:10Z
ExpireTime	string	Não	A hora de expiração do estúdio de produção. A hora está no formato `yyyy-MM-ddTHH:mm:ssZ` e é exibida em UTC. Nota Este parâmetro está disponível apenas se você definir ChargeType como PrePaid.	2017-08-22T12:10:10Z
CasterTemplate	string	Não	A resolução predefinida do estúdio de produção. Este parâmetro está disponível apenas para o método de cobrança por assinatura. Valores válidos: lp_ld: baixa definição. lp_sd: definição padrão. lp_hd: alta definição. lp_ud: ultra-alta definição. lp_ld_v: baixa definição vertical. lp_sd_v: definição padrão vertical. lp_hd_v: alta definição vertical. lp_ud_v: ultra-alta definição vertical. Nota Se você usar o método de cobrança pagamento conforme o uso, chame a operação SetCasterConfig para definir a resolução.	lp_sd
ResourceGroupId	string	Não	O ID do grupo de recursos. Para mais informações, consulte O que é um grupo de recursos?.	rg-aekzw******
Tag	array<object>	Não	As tags.
	object	Não	As 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
CasterId	string	O ID do estúdio de produção. Você pode usar este ID como parâmetro de solicitação para consultar URLs de stream, iniciar o estúdio de produção, adicionar recursos de vídeo, adicionar layouts, consultar a lista de layouts, adicionar componentes e adicionar playlists.	a2b8e671-2fe5-4642-a2ec-bf93880e****
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F****

Exemplos

Resposta de sucesso

JSON formato

{
  "CasterId": "a2b8e671-2fe5-4642-a2ec-bf93880e****",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.PurchaseTime	%s, please check and try again later.	The parameter PurchaseTime is invalid, please check and try again.
400	InvalidParameter.ExpireTime	%s, please check and try again later.	The parameter ExpireTime is invalid, please check and try again.
400	MissingParameter	%s.	Missing parameter
400	InvalidChargeType.Malformed	%s, please check and try again later.	The parameter ChargeType is invalid, please check and try again.
400	InvalidChargeType.PostSupport	%s, please check and try again later.	ChargeType only supports post-paid, please check and try again.
400	InvalidCasterTemplate.Malformed	%s, please check and try again later.	The parameter CasterTemplate is invalid, please check and try again.
400	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.
400	InvalidParameter.ChargeType	%s, please check and try again later.	The parameter ChargeType is invalid, please check and try again.
400	InvalidPeriod.Malformed	%s, please check and try again later.	Invalid time interval, please check and try again.
400	InvalidUserId.Malformed	%s, please check userId.	The userId passed in is invalid, please check.
400	InvalidClientToken.Malformed	%s, please check and try again later.	The parameter ClientToken is invalid, please check and try again.
400	IncorrectCasterStatus	%s, please check and try again later.	Guide station status error, please check and try again.
401	CasterNumberExceed	%s, please check and try again later.	The number of casters exceeds the limit. Please check and try again.
403	PermissionDenied	%s, please check and try again later.	Access denied, please check and try again.
404	InvalidParameter.NormType	%s, please check and try again later.	The parameter NormType is invalid, please check and try again.
404	InvalidConfiguration.NotFound	%s, please check and try again later.	Configuration does not exist, please check and try again.
408	CreateCaster.Timeout	%s, please try again later.	Call CreateCaster timed out, please try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.