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

Obtém as informações do arquivo de origem de um arquivo de áudio ou vídeo, como a URL do arquivo, resolução e taxa de bits.

Descrição da operação

As informações completas de um arquivo de origem ficam disponíveis após a transcodificação do fluxo de vídeo ou áudio.

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

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VideoId	string	Não	O ID do arquivo de áudio ou vídeo. Obtenha o ID de uma das seguintes maneiras: Para arquivos de áudio ou vídeo enviados pelo console: Faça login no console do VOD. No painel de navegação, escolha Biblioteca de Mídia > Áudio/Vídeo para visualizar o ID do vídeo. Ao obter uma URL de upload e credenciais chamando a operação CreateUploadVideo, o ID do áudio/vídeo é o valor do parâmetro `VideoId` na resposta. Após o upload de um vídeo, chame a operação SearchMedia para consultar o ID do áudio/vídeo. O ID é o valor do parâmetro `VideoId` na resposta.	1f1a6fc03ca04814031b8a6559e****
AuthTimeout	integer	Não	O tempo de expiração da URL assinada para o arquivo de origem (`FileURL`). Unidade: segundos. O valor padrão é 3600. O valor mínimo é 1. Se `OutputType` estiver definido como cdn: A `FileURL` expira somente se a assinatura de URL estiver habilitada. Caso contrário, a URL é permanentemente válida. Valor mínimo: 1. Valor máximo: ilimitado. Valor padrão: 3600. Se `OutputType` estiver definido como oss: A `FileURL` expira somente se a permissão de armazenamento estiver definida como privada. Caso contrário, a URL é permanentemente válida. Valor mínimo: 1. Valor máximo: Para reduzir riscos de segurança na origem, o valor máximo é 2592000 (30 dias) se o arquivo de áudio ou vídeo estiver armazenado em um bucket do VOD. O valor máximo é 129600 (36 horas) se o arquivo de áudio ou vídeo estiver armazenado em seu próprio bucket OSS. Valor padrão: 3600.	3600
OutputType	string	Não	O tipo da URL de saída. Valores válidos: oss: a URL de origem. cdn (padrão): a URL acelerada. Nota Se o tipo de bucket do arquivo de origem for `in`, apenas uma URL OSS será retornada.	oss
AdditionType	string	Não	O tipo de informação adicional. Separe múltiplos tipos com vírgulas (,). Por padrão, apenas informações básicas são retornadas. Valores válidos: video: informações do fluxo de vídeo. audio: informações do fluxo de áudio.	video
ReferenceId	string	Não	O ID personalizado. O ID pode conter apenas letras minúsculas, letras maiúsculas, dígitos, hifens (-) e underscores (_). O ID deve ter de 6 a 64 caracteres e ser único para cada usuário.	123-123

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta retornada.
RequestId	string	O ID da solicitação.	25818875-5F78-4AF6-D7393642CA58****
Mezzanine	object	As informações do arquivo.
CreationTime	string	A hora em que o arquivo foi criado. A hora está no formato yyyy-MM-ddTHH:mm:ssZ em UTC.	2017-11-14T09:15:50Z
Status	string	O status do arquivo. Valores válidos: Uploading: O estado inicial do arquivo, que indica que o arquivo está sendo enviado. Normal: O arquivo foi enviado. UploadFail: O upload do arquivo falhou. 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
VideoId	string	O ID do vídeo.	1f1a6fc03ca04814031b8a6559e****
Height	integer	A altura do arquivo. Unidade: pixels.	540
Bitrate	string	A taxa de bits do arquivo. Unidade: Kbps.	771.2280
FileName	string	O nome do arquivo.	27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
OutputType	string	O tipo da URL de saída. Valores válidos: oss: a URL de origem. cdn (padrão): a URL acelerada. Nota Apenas URLs OSS para arquivos no formato MP4 são suportadas para reprodução.	oss
PreprocessStatus	string	O status de pré-processamento. Valores válidos: UnPreprocess: Nenhum pré-processamento foi realizado. Preprocessing: O arquivo está sendo pré-processado. PreprocessSucceed: O arquivo foi pré-processado. PreprocessFailed: O pré-processamento do arquivo falhou.	UnPreprocess
Width	integer	A largura do arquivo. Unidade: pixels.	960
Size	integer	O tamanho do arquivo. Unidade: bytes.	4096477
Duration	string	A duração do arquivo. Unidade: 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	The ordinal number of the audio stream, which indicates the position of the audio stream in the entire media stream.	0
Timebase	string	The time base.	0.000000
SampleFmt	string	The sampling format.	fltp
SampleRate	string	The sample rate.	44100
ChannelLayout	string	The sound channel layout. Valid values: mono: mono. stereo: stereo.	mono
Lang	string	The language.	und
CodecLongName	string	The long name of the encoding format.	AAC (Advanced Audio Coding)
Channels	string	The number of sound channels.	1
NumFrames	string	The total number of frames.	1
Bitrate	string	The bitrate.	62.885
CodecTagString	string	The tag of the encoding format.	mp4a
StartTime	string	The start time. The time is in the yyyy-MM-ddTHH:mm:ssZ format in UTC.	2017-01-11T12:00:00Z
CodecName	string	The short name of the encoding format.	aac
Duration	string	The duration.	3.227574
CodecTag	string	The tag of the encoding format.	0x6134706d
CodecTimeBase	string	The codec time base.	1/44100
VideoStreamList	array<object>	As informações sobre o fluxo de vídeo.
	object	Os detalhes do fluxo de vídeo.
Timebase	string	The time base.	0.000000
Index	string	The ordinal number of the video stream, which indicates the position of the video stream in the entire media stream.	1
AvgFPS	string	The average frame rate.	30.0
PixFmt	string	The pixel format.	yuv420p
Lang	string	The language.	und
Sar	string	The sample aspect ratio (SAR).	0:1
Height	string	The height of the video.	320
CodecLongName	string	The long name of the encoding format.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
NumFrames	string	The total number of frames.	0
Bitrate	string	The bitrate of the file. Unit: Kbps.	500
Rotate	string	The rotation angle of the video. Valid values: [0, 360).	90
CodecTagString	string	The tag of the encoding format.	avc1
HasBFrames	string	Indicates whether B-frames exist.	0
Profile	string	The codec profile.	Main
StartTime	string	The start time. The time is in the yyyy-MM-ddTHH:mm:ssZ format in UTC.	2017-01-11T12:00:00Z
Dar	string	The display aspect ratio (DAR).	0:1
CodecName	string	The short name of the encoding format.	h264
Width	string	The width of the video.	568
Duration	string	The duration.	3.166667
Fps	string	The destination frame rate.	30.0
CodecTag	string	The tag of the encoding format.	0x31637661
CodecTimeBase	string	The codec time base.	1/60
Level	string	The encoding level.	30
HDRType	string	The High Dynamic Range (HDR) type of the video stream.	HDR
StorageClass	string	A classe de armazenamento do ativo de mídia. Valores válidos: Standard: Standard. IA: Infrequent Access. Archive: Archive. ColdArchive: Cold Archive. SourceIA: Source Infrequent Access. 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 estado 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: A restauração do ativo de mídia falhou.	Success
RestoreExpiration	string	O tempo de expiração do ativo de mídia restaurado.	2023-03-30T10:14:14Z
FileMD5	string

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Mezzanine": {
    "CreationTime": "2017-11-14T09:15:50Z",
    "Status": "Normal",
    "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "VideoId": "1f1a6fc03ca04814031b8a6559e****",
    "Height": 540,
    "Bitrate": "771.2280",
    "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "OutputType": "oss",
    "PreprocessStatus": "UnPreprocess",
    "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)",
        "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"
      }
    ],
    "StorageClass": "Standard",
    "RestoreStatus": "Success",
    "RestoreExpiration": "2023-03-30T10:14:14Z",
    "FileMD5": ""
  }
}

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.