BatchGetMediaInfos - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Obtém as informações básicas e as informações do arquivo de origem de vários ativos de mídia em lote.

Descrição da operação

Você pode obter informações de até 20 arquivos de áudio ou vídeo por vez.
Após o upload de um arquivo de áudio ou vídeo, o ApsaraVideo VOD analisa o arquivo de origem enviado. Portanto, as informações do ativo de mídia são geradas de forma assíncrona. Você pode configurar uma notificação de evento para o evento AudioVideoAnalysisComplete. Após receber a notificação do evento AudioVideoAnalysisComplete, chame esta operação para obter as informações de áudio ou vídeo.

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

vod:BatchGetMediaInfos

get

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
MediaIds	string	Sim	Os IDs dos ativos de mídia, que são IDs de áudio/vídeo (VideoId). Separe vários IDs com vírgulas (,). Você pode especificar até 20 IDs. Você pode obter os IDs usando os seguintes métodos: Para arquivos de áudio/vídeo enviados pelo console, faça login no console do ApsaraVideo VOD e escolha Arquivos de Mídia > Áudio/Vídeo para visualizar os IDs de áudio/vídeo. Ao chamar a operação para obter a URL de upload e a credencial para arquivos de áudio/vídeo, o valor VideoId é retornado como parâmetro de resposta. Após o upload de um arquivo de áudio/vídeo, você pode chamar a operação SearchMedia para consultar o valor VideoId na resposta.	61ccbdb06fa83012be4d8083f6**,7d2fbc380b0e08e55f**
ReferenceIds	string	Não	A lista de IDs personalizados. Separe vários IDs personalizados com vírgulas (,). Você pode especificar até 20 IDs.	123-123,1234-1234

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	9E290613-04F4-47F4-795D30732077****
NonExistMediaIds	array	A lista de IDs de ativos de mídia que não existem.
	string	A lista de IDs de ativos de mídia que não existem.	["bbc65bba53f6ed90de118a7849****"]
NonExistReferenceIds	array	A lista de IDs personalizados que não existem.
	string	A lista de IDs personalizados que não existem.	123-123
ForbiddenMediaIds	array	A lista de IDs de ativos de mídia que são proibidos. Isso ocorre normalmente porque você não tem permissões para operações de múltiplas aplicações. Para mais informações, consulte Múltiplas aplicações.
	string	A lista de IDs de ativos de mídia que são proibidos. Isso ocorre normalmente porque você não tem permissões para operações de múltiplas aplicações. Para mais informações, consulte Múltiplas aplicações.	["bbc65bba53f6ed90de118a7849****"]
MediaInfos	array<object>	A lista de ativos de mídia.
	array<object>	A lista de ativos de mídia.
MediaId	string	O ID do ativo de mídia.	10a5fa364a5b71ef89246733a78e****
MediaInfo	object	As informações básicas do ativo de mídia.
StorageLocation	string	O endereço de armazenamento do arquivo de áudio ou vídeo.	outin-***.oss-cn-shanghai.aliyuncs.com
CreationTime	string	A hora em que o arquivo de áudio ou vídeo foi criado. A hora está no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2017-11-14T09:15:50Z
Status	string	O status do vídeo. Valores válidos: Uploading: O vídeo está sendo enviado. UploadFail: Falha ao enviar o vídeo. UploadSucc: O vídeo foi enviado. Transcoding: O vídeo está sendo transcodificado. TranscodeFail: Falha ao transcodificar o vídeo. Blocked: O vídeo está bloqueado. Normal: O vídeo está em um estado normal.	Normal
CateId	integer	O ID da categoria.	781111****
MediaId	string	O ID do ativo de mídia.	7753d144efd74d6c45fe0570****
DownloadSwitch	string	O status da chave de download offline. Depois de ativar o download offline, os usuários podem usar o ApsaraVideo Player para armazenar vídeos em cache em seus dispositivos locais para visualização offline. Para obter mais informações, consulte Download offline. Valores válidos: on: O download offline está ativado. off: O download offline está desativado.	on
Tags	string	As tags do arquivo de áudio ou vídeo. Separe várias tags com vírgulas (,).	tag1, tag2
ModificationTime	string	A hora em que o arquivo de áudio ou vídeo foi atualizado pela última vez. A hora está no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2017-06-26T06:38:48Z
CateName	string	O nome da categoria.	cate1
Description	string	A descrição do arquivo de áudio ou vídeo.	Alibaba Cloud VOD video description
AppId	string	O ID do aplicativo.	app-****
CoverURL	string	A URL da miniatura.	https://example.aliyundoc.com/****.jpg
TemplateGroupId	string	O ID do grupo de modelos de transcodificação.	b4039216985f4312a5382a4ed****
Title	string	O título do arquivo de áudio ou vídeo.	Alibaba Cloud VOD Video Title
Snapshots	array	Uma matriz de URLs de snapshots de vídeo.
	string	Uma matriz de URLs de snapshots de vídeo. Nota Esta operação retorna apenas os dados de miniaturas de vídeo. Para consultar os dados de snapshots normais, sprites, imagens de sprite originais e snapshots WebVTT capturados usando o recurso de snapshot, chame a operação ListSnapshots.	["http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333","http://example.aliyundoc.com/snapshot/.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243**",...]
StorageClass	string	A classe de armazenamento do ativo de mídia. Valores válidos: Standard: Standard. IA: Infrequent Access (IA). Archive: Archive. ColdArchive: Cold Archive. SourceIA: Source IA. SourceArchive: Source Archive. SourceColdArchive: Source Cold Archive. Changing: A classe de armazenamento do ativo de mídia está sendo alterada. SourceChanging: A classe de armazenamento do arquivo de origem está sendo alterada.	Standard
RestoreStatus	string	O status de restauração do ativo de mídia. Valores válidos: Processing: O ativo de mídia está sendo restaurado. Success: O ativo de mídia foi restaurado. Failed: Falha ao restaurar o ativo de mídia.	Success
RestoreExpiration	string	O tempo de expiração do ativo de mídia restaurado.	2023-03-30T10:14:14Z
UserData	string	Os parâmetros personalizados.	{"Extend":"xxx","MessageCallback":"xxx"}
ReferenceId	string	O ID personalizado. O ID pode conter letras minúsculas, letras maiúsculas, dígitos, hifens (-) e sublinhados (_). O ID deve ter de 6 a 64 caracteres e ser exclusivo para um usuário.	123-123
MezzanineInfo	object	As informações do arquivo de origem.
CreationTime	string	A hora em que o arquivo foi criado. A hora está no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2017-11-14T09:15:50Z
Status	string	O status do arquivo. Valores válidos: Uploading: O arquivo está sendo enviado. Este é o estado inicial. Normal: O arquivo foi enviado. UploadFail: Falha ao enviar o arquivo. Deleted: O arquivo foi excluído.	Normal
FileURL	string	A URL do arquivo de origem.	http://example-bucket-**.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1**.mp4
MediaId	string	O ID do ativo de mídia.	1f1a6fc03ca04814031b8a6559e****
Height	integer	A altura do arquivo em pixels (px).	540
Bitrate	string	A taxa de bits do arquivo em Kbps.	771.2280
FileName	string	O nome do arquivo.	27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
Width	integer	A largura do arquivo em pixels (px).	960
Size	integer	O tamanho do arquivo em bytes.	4096477
Duration	string	A duração do arquivo em segundos.	42.4930
Fps	string	A taxa de quadros do arquivo em quadros por segundo.	25.0000
AudioStreamList	array<object>	As informações sobre o fluxo de áudio.
	object	Os detalhes do fluxo de áudio.
Index	string	O número de sequência do fluxo de áudio. Este número indica a posição do fluxo de áudio no fluxo de mídia.	0
Timebase	string	A base de tempo.	0.000000
SampleFmt	string	O formato de amostragem.	fltp
SampleRate	string	A taxa de amostragem.	44100
ChannelLayout	string	O layout de saída do canal de som. Valores válidos: mono: mono. stereo: estéreo.	mono
Lang	string	O idioma.	und
CodecLongName	string	O nome longo do formato de codificação.	AAC (Advanced Audio Coding)
Channels	string	O número de canais de som.	1
NumFrames	string	O número total de quadros.	1
Bitrate	string	A taxa de bits.	62.885
CodecTagString	string	O texto da tag do formato de codificação.	mp4a
StartTime	string	A hora de início. A hora está no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2017-01-11T12:00:00Z
CodecName	string	O nome curto do formato de codificação.	aac
Duration	string	A duração.	3.227574
CodecTag	string	A tag do formato de codificação.	0x6134706d
CodecTimeBase	string	A base de tempo do codec.	1/44100
VideoStreamList	array<object>	As informações sobre o fluxo de vídeo.
	object	Os detalhes do fluxo de vídeo.
Timebase	string	A base de tempo.	0.000000
Index	string	O número de sequência do fluxo de vídeo. Este número indica a posição do fluxo de vídeo no fluxo de mídia.	1
AvgFPS	string	A taxa média de quadros.	30.0
PixFmt	string	O formato de pixel.	yuv420p
Lang	string	O idioma.	und
Sar	string	A proporção de aspecto da amostra (SAR).	0:1
Height	string	A altura do vídeo.	320
CodecLongName	string	O nome longo do formato de codificação.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
NumFrames	string	O número total de quadros.	0
Bitrate	string	A taxa de bits do arquivo em Kbps.	500
Rotate	string	O ângulo de rotação do vídeo. Valores válidos: [0, 360).	90
CodecTagString	string	O texto da tag do formato de codificação.	avc1
HasBFrames	string	Indica se existem B-frames.	0
Profile	string	O perfil do codec.	Main
StartTime	string	A hora de início. A hora está no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2017-01-11T12:00:00Z
Dar	string	A proporção de aspecto de exibição (DAR).	0:1
CodecName	string	O nome curto do formato de codificação.	h264
Width	string	A largura do vídeo.	568
Duration	string	A duração.	3.166667
Fps	string	A taxa de quadros.	30.0
CodecTag	string	A tag do formato de codificação.	0x31637661
CodecTimeBase	string	A base de tempo do codec.	1/60
Level	string	O nível de codificação.	30
HDRType	string	O tipo de High Dynamic Range (HDR) do fluxo de vídeo.	HDR
FileMD5	string
PlayInfoList	array<object>	As informações de reprodução (informações de fluxo) do arquivo de áudio/vídeo.
	object	As informações detalhadas do arquivo de áudio/vídeo.
CreationTime	string	A hora em que o fluxo foi criado. A hora está no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2022-04-18T07:37:15Z
Status	string	O status do fluxo de mídia. Valores válidos: Normal: O fluxo de mídia está no estado normal. Este status é atribuído ao fluxo transcodificado mais recente de cada definição e formato. Invisible: O fluxo de mídia está invisível. Se vários fluxos forem transcodificados para a mesma definição e formato, o fluxo transcodificado mais recente será marcado como Normal e os outros fluxos serão marcados como Invisible.	Normal
Specification	string	As especificações de saída da transcodificação de áudio e vídeo. Para obter mais informações sobre os valores válidos e descrições, consulte Especificações de saída: Specification.	H264.LD
NarrowBandType	string	O tipo de transcodificação. Valores válidos: 0: transcodificação normal. 1.0: transcodificação Narrowband HD 1.0. 2.0: transcodificação Narrowband HD 2.0.	0
Height	integer	A altura do fluxo de mídia em pixels (px).	640
Bitrate	string	A taxa de bits do fluxo de mídia em Kbps.	450.878
ModificationTime	string	A hora em que o fluxo foi atualizado pela última vez. A hora está no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2022-04-20T06:32:19Z
WatermarkId	string	O ID do modelo de marca d'água associado ao fluxo de mídia.	dgfn26457856****
Encrypt	integer	Indica se o fluxo de mídia está criptografado. Valores válidos: 0: não. 1: sim.	1
Definition	string	A definição do fluxo de vídeo. Valores válidos: FD: baixa definição. LD: definição padrão. SD: alta definição. HD: definição ultra-alta. OD: qualidade original. 2K: 2K. 4K: 4K. SQ: áudio de qualidade padrão. HQ: áudio de alta qualidade. AUTO: taxa de bits adaptativa.	LD
EncryptType	string	O tipo de criptografia do fluxo de mídia. Valores válidos: AliyunVoDEncryption: criptografia proprietária do Alibaba Cloud. HLSEncryption: criptografia HLS. Nota Se o tipo de criptografia for AliyunVoDEncryption, você poderá reproduzir o fluxo apenas usando o ApsaraVideo Player SDK.	AliyunVoDEncryption
EncryptMode	string	O modo de criptografia do fluxo de mídia. Valores válidos: License: modo de descriptografia local. Nota Se o modo de criptografia for License, você poderá reproduzir o fluxo apenas usando o ApsaraVideo Player SDK.	License
StreamType	string	O tipo do fluxo de mídia. Se o fluxo de mídia for um fluxo de vídeo, o valor será video. Se o fluxo de mídia for um fluxo apenas de áudio, o valor será audio.	video
JobId	string	O ID do trabalho de transcodificação para o fluxo de mídia. Este ID serve como o identificador exclusivo do fluxo de mídia.	80e9c6580e754a798c3c19c59b16****
Size	integer	O tamanho do fluxo de mídia em bytes.	418112
Width	integer	A largura do fluxo de mídia em pixels (px).	360
Fps	string	A taxa de quadros do fluxo de mídia em quadros por segundo.	25
Duration	string	A duração do fluxo de mídia em segundos.	9.0464
PlayURL	string	A URL de reprodução do fluxo de vídeo.	https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d**/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704**.m3u8
Format	string	O formato do fluxo de mídia. Se o arquivo de mídia for um vídeo, os valores válidos são mp4 e m3u8. Se o arquivo de mídia for apenas de áudio, o valor será mp3.	m3u8
HDRType	string	O tipo de HDR do fluxo de mídia. Valores válidos: HDR HDR10 HLG DolbyVision HDRVivid SDR+	HLG
BitDepth	integer	A profundidade de cor. O valor é um número inteiro.	8
JobType	integer	O tipo da marca d'água digital. Valores válidos: 1: marca d'água de rastreamento. 2: marca d'água de direitos autorais.	2
JobExt	string	As informações personalizadas da marca d'água para a marca d'água de direitos autorais. Este parâmetro é retornado apenas quando `JobType` é `2`.	CopyrightMarkTest
CodecName	string	O nome curto do formato de codificação.	h264
TemplateId	string	O ID do modelo de transcodificação.	a86a4338dd2e83da45154004a541****
TemplateGroupId	string	O ID do grupo de modelos de transcodificação.	fb0716154b21a4ecb5b70a26ccc8****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "9E290613-04F4-47F4-795D30732077****",
  "NonExistMediaIds": [
    "[\"bbc65bba53f6ed90de118a7849****\"]"
  ],
  "NonExistReferenceIds": [
    "123-123"
  ],
  "ForbiddenMediaIds": [
    "[\"bbc65bba53f6ed90de118a7849****\"]"
  ],
  "MediaInfos": [
    {
      "MediaId": "10a5fa364a5b71ef89246733a78e****",
      "MediaInfo": {
        "StorageLocation": "outin-***.oss-cn-shanghai.aliyuncs.com",
        "CreationTime": "2017-11-14T09:15:50Z",
        "Status": "Normal",
        "CateId": 0,
        "MediaId": "7753d144efd74d6c45fe0570****",
        "DownloadSwitch": "on",
        "Tags": "tag1, tag2",
        "ModificationTime": "2017-06-26T06:38:48Z",
        "CateName": "cate1",
        "Description": "Alibaba Cloud VOD video description",
        "AppId": "app-****",
        "CoverURL": "https://example.aliyundoc.com/****.jpg",
        "TemplateGroupId": "b4039216985f4312a5382a4ed****",
        "Title": "Alibaba Cloud VOD Video Title",
        "Snapshots": [
          "[\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****\",\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243****\",...]"
        ],
        "StorageClass": "Standard",
        "RestoreStatus": "Success",
        "RestoreExpiration": "2023-03-30T10:14:14Z",
        "UserData": "{\"Extend\":\"xxx\",\"MessageCallback\":\"xxx\"}",
        "ReferenceId": "123-123"
      },
      "MezzanineInfo": {
        "CreationTime": "2017-11-14T09:15:50Z",
        "Status": "Normal",
        "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
        "MediaId": "1f1a6fc03ca04814031b8a6559e****",
        "Height": 540,
        "Bitrate": "771.2280",
        "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4\n",
        "Width": 960,
        "Size": 4096477,
        "Duration": "42.4930",
        "Fps": "25.0000",
        "AudioStreamList": [
          {
            "Index": "0",
            "Timebase": "0.000000",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "ChannelLayout": "mono",
            "Lang": "und",
            "CodecLongName": "AAC (Advanced Audio Coding)\n",
            "Channels": "1",
            "NumFrames": "1",
            "Bitrate": "62.885",
            "CodecTagString": "mp4a",
            "StartTime": "2017-01-11T12:00:00Z",
            "CodecName": "aac",
            "Duration": "3.227574",
            "CodecTag": "0x6134706d",
            "CodecTimeBase": "1/44100"
          }
        ],
        "VideoStreamList": [
          {
            "Timebase": "0.000000",
            "Index": "1",
            "AvgFPS": "30.0",
            "PixFmt": "yuv420p",
            "Lang": "und",
            "Sar": "0:1",
            "Height": "320",
            "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "NumFrames": "0",
            "Bitrate": "500",
            "Rotate": "90",
            "CodecTagString": "avc1",
            "HasBFrames": "0",
            "Profile": "Main",
            "StartTime": "2017-01-11T12:00:00Z",
            "Dar": "0:1",
            "CodecName": "h264",
            "Width": "568",
            "Duration": "3.166667",
            "Fps": "30.0",
            "CodecTag": "0x31637661",
            "CodecTimeBase": "1/60",
            "Level": "30",
            "HDRType": "HDR"
          }
        ],
        "FileMD5": ""
      },
      "PlayInfoList": [
        {
          "CreationTime": "2022-04-18T07:37:15Z\n",
          "Status": "Normal",
          "Specification": "H264.LD",
          "NarrowBandType": "0",
          "Height": 640,
          "Bitrate": "450.878",
          "ModificationTime": "2022-04-20T06:32:19Z",
          "WatermarkId": "dgfn26457856****",
          "Encrypt": 1,
          "Definition": "LD",
          "EncryptType": "AliyunVoDEncryption",
          "EncryptMode": "License",
          "StreamType": "video",
          "JobId": "80e9c6580e754a798c3c19c59b16****",
          "Size": 418112,
          "Width": 360,
          "Fps": "25",
          "Duration": "9.0464",
          "PlayURL": "https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d****/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704****.m3u8",
          "Format": "m3u8",
          "HDRType": "HLG",
          "BitDepth": 8,
          "JobType": 2,
          "JobExt": "CopyrightMarkTest",
          "CodecName": "h264",
          "TemplateId": "a86a4338dd2e83da45154004a541****",
          "TemplateGroupId": "fb0716154b21a4ecb5b70a26ccc8****"
        }
      ]
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.