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

Consulta as fontes de vídeo de um estúdio de produção.

Descrição da operação

Chame a operação CreateCaster para criar um estúdio de produção. Em seguida, você pode chamar esta operação para consultar as fontes de vídeo do estúdio de produção.

Limite de QPS

Esta operação é limitada a 15 consultas por segundo (QPS) para cada usuário. Se você exceder esse limite, suas chamadas de API serão limitadas. A limitação pode afetar seus negócios. Recomendamos que você chame esta operação em uma frequência 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:DescribeCasterVideoResources

get

*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-shanghai
CasterId	string	Sim	O ID do estúdio de produção. Se você criar o estúdio de produção chamando a operação CreateCaster, use o valor de CasterId que é retornado. Se você criar o estúdio de produção no console LIVE, acesse a página Cloud Production Studio para visualizar o ID. Para acessar a página, escolha LIVE Console > Production Studio > Cloud Production Studio. Nota O nome do estúdio de produção na lista da página Cloud Production Studio é o ID do estúdio de produção.	LIVEPRODUCER_POST-cn-0pp1czt****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	CF60DB6A-7FD6-426E-9288-122CC1A52FA7
Total	integer	O número total de registros.	2
VideoResources	object
VideoResource	array<object>	Uma lista de recursos.
	object	Uma lista de recursos.
BeginOffset	integer	The start offset of the video file. This parameter is valid only for video files. Unit: milliseconds. Greater than 0: The read operation starts from a point in time that is relative to the first frame.	1000
EndOffset	integer	The end offset of the video file. This parameter is valid only for video files. Unit: milliseconds. Greater than 0: The read operation ends at a point in time that is relative to the first frame. Less than 0: The read operation ends at a point in time that is relative to the last frame.	10000
FlvUrl	string	The stream pulling URL.	http://guide.aliyundoc.com/example.org
ImageId	string	The ID of the image in the material library.	a089175eb5f4427684fc0715159a****
ImageUrl	string	The URL of the image.	http://learn.aliyundoc.com/AppName/image.jpg
LiveStreamUrl	string	The URL of the live stream.	rtmp://abcLive/appName/b5447c21fcfe444c9e9b6f7ba208****
LocationId	string	The location of the video source.	RV01
MaterialId	string	The ID of the material.	d2c429cd907742ee8f6e76465ad3****
PtsCallbackInterval	integer	The callback interval for video-on-demand files. If this parameter is set to 0, no callbacks are sent.	0
RepeatNum	integer	This parameter is valid only for video files. It specifies the number of times the video is replayed after the playback is complete. 0 (default): The video is not replayed. -1: The video is replayed in a loop.	0
ResourceId	string	The ID of the resource.	b5f8c837-ceeb-424f-b30b-68e94e86****
ResourceName	string	The name of the resource.	resource-Name1
VodUrl	string	The URL of the video-on-demand file. This parameter is used only when the resource is a video file that is not imported to the material library. The video file must be in the MP4, FLV, or TS format.	http://developer.aliyundoc.com/caster1.flv

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7",
  "Total": 2,
  "VideoResources": {
    "VideoResource": [
      {
        "BeginOffset": 1000,
        "EndOffset": 10000,
        "FlvUrl": "http://guide.aliyundoc.com/example.org",
        "ImageId": "a089175eb5f4427684fc0715159a****",
        "ImageUrl": "http://learn.aliyundoc.com/AppName/image.jpg",
        "LiveStreamUrl": "rtmp://abcLive/appName/b5447c21fcfe444c9e9b6f7ba208****",
        "LocationId": "RV01",
        "MaterialId": "d2c429cd907742ee8f6e76465ad3****",
        "PtsCallbackInterval": 0,
        "RepeatNum": 0,
        "ResourceId": "b5f8c837-ceeb-424f-b30b-68e94e86****",
        "ResourceName": "resource-Name1",
        "VodUrl": "http://developer.aliyundoc.com/caster1.flv"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidCasterId.Malformed	%s, please check and try again later.	The parameter CasterId is invalid, please check and try again.
401	IllegalOperation	%s, please check and try again later.	Operation not allowed, please check and try again.
500	InternalError	%s, please try again later.	Internal error, please try again later.
404	InvalidCaster.NotFound	%s, please check and try again later.	The guide station does not exist, please check and try again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.