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

Consulta as informações básicas e as URLs de acesso de várias imagens por ID da imagem após o upload das imagens para o ApsaraVideo VOD.

Descrição da operação

Esta operação suporta apenas a consulta de informações sobre imagens enviadas para o ApsaraVideo VOD. Para consultar informações sobre snapshots gerados a partir de snapshots de vídeo, chame a operação ListSnapshots.
Você pode consultar informações de até 20 imagens por vez.

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

list

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ImageIds	string	Sim	A lista de IDs de imagens. Separe vários IDs com vírgulas (,). O limite máximo é de 20 IDs. Você pode obter os IDs de imagens usando os seguintes métodos: Faça login no console do ApsaraVideo VOD e escolha Arquivos de mídia > Imagens para visualizar os IDs. Obtenha os IDs na resposta ao chamar CreateUploadImage para obter a URL e a credencial de upload. Obtenha os IDs na resposta ao chamar SearchMedia para consultar imagens.	bbc65bba53fed90de118a7849**,594228cdd14b4d069fc17a8c4a**
AuthTimeout	integer	Não	O período de validade da URL de acesso à imagem. Unidade: segundos. Se OutputType estiver definido como cdn: A URL da imagem expira apenas se a assinatura de URL estiver ativada. Caso contrário, a URL é permanentemente válida. Valor mínimo: 1. Valor máximo: ilimitado. Valor padrão: Se este parâmetro não for especificado, o período de validade padrão definido na assinatura de URL será usado. Se OutputType estiver definido como oss: A URL da imagem expira apenas 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 ao servidor de origem, o valor máximo é 2592000 (30 dias) se a imagem estiver armazenada em um bucket gerenciado pelo ApsaraVideo VOD, e 129600 (36 horas) se a imagem estiver armazenada em seu próprio bucket OSS. Valor padrão: Se este parâmetro não for especificado, o valor será 3600.	3600
OutputType	string	Não	O tipo de URL de acesso à imagem a ser retornado. Valores válidos: oss: o endereço de armazenamento. cdn (padrão): a URL acelerada por CDN.	cdn.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	25818875-5F78-4AF6-D7393642CA58*****
ImageInfo	array<object>	A lista de informações da imagem.
	array<object>	A lista de informações da imagem.
CreationTime	string	A hora em que a imagem foi criada. A hora está no formato aaaa-MM-ddTHH:mm:ssZ (UTC).	2018-11-21T02:37:23Z
StorageLocation	string	O endereço de armazenamento do arquivo de imagem.	outin-****..oss-cn-shanghai.aliyuncs.com.
Status	string	O status da imagem. Valores válidos: Uploading: A imagem está sendo enviada. Este é o status inicial. Normal: A imagem foi enviada. UploadFail: Falha ao enviar a imagem.	Uploading.
CateId	integer	O ID da categoria.	254766071
Tags	string	As tags da imagem. Várias tags são separadas por vírgulas (,).	tag1,tag2,tag3
ImageType	string	O tipo de imagem. Valores válidos: default: imagem comum. cover: miniatura de vídeo.	default.
CateName	string	O nome da categoria.	Teste.
Description	string	A descrição da imagem.	Descrição de teste.
AppId	string	O ID do aplicativo.	app-****
URL	string	A URL de acesso à imagem. Se um nome de domínio CDN estiver configurado, a URL CDN será retornada. Caso contrário, a URL OSS será retornada.	http://example.aliyundoc.com/image/default/**.gif?auth_key=**
Title	string	O título da imagem.	esta é uma amostra.
ImageId	string	O ID da imagem.	bbc65bba53f9*****ed90de118a7849
Mezzanine	object	As informações mezzanine da imagem.
FileURL	string	A URL do OSS do arquivo de imagem.	https://outin-bfefbb***163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*D4DAD.png?Expires=1590982353&OSSAccessKeyId=*&Signature=ALPET74o***c%3D
OriginalFileName	string	A URL do arquivo de origem.	****.gif
Width	integer	A largura da imagem. Unidade: pixels.	200
Height	integer	A altura da imagem. Unidade: pixels.	200
FileSize	string	O tamanho do arquivo a ser enviado. Unidade: bytes.	8932
NonExistImageIds	array	A lista de IDs de imagens que não existem.
	string	A lista de IDs de imagens que não existem.	f45cf4eba5c80233389558c39****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58*****",
  "ImageInfo": [
    {
      "CreationTime": "2018-11-21T02:37:23Z",
      "StorageLocation": "outin-****..oss-cn-shanghai.aliyuncs.com",
      "Status": "Uploading",
      "CateId": 254766071,
      "Tags": "tag1,tag2,tag3",
      "ImageType": "default",
      "CateName": "Test",
      "Description": "Test description",
      "AppId": "app-****",
      "URL": "http://example.aliyundoc.com/image/default/****.gif?auth_key=****",
      "Title": "this is a sample",
      "ImageId": "bbc65bba53f9*****ed90de118a7849",
      "Mezzanine": {
        "FileURL": "https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D",
        "OriginalFileName": "****.gif",
        "Width": 200,
        "Height": 200,
        "FileSize": "8932"
      }
    }
  ],
  "NonExistImageIds": [
    "f45cf4eba5c80233389558c39****"
  ]
}

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.