Tous les produits
Search
Centre de documentation

:BatchGetMediaInfos

Dernière mise à jour :Aug 05, 2026

Obtient les informations sur plusieurs ressources multimédias en spécifiant plusieurs valeurs mediaId.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ice:BatchGetMediaInfos

get

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

MediaIds

string

Non

Les identifiants des ressources multimédias à interroger, séparés par des virgules.

******b48fb04483915d4f2cd8******,******c48fb37407365d4f2cd8******

AdditionType

string

Non

Les informations supplémentaires sur la ressource média à renvoyer dans la requête par lots. Par défaut, seul BasicInfo est renvoyé. Les informations supplémentaires incluent :

-FileInfo

-DynamicMetaData

FileInfo,DynamicMetaData

AuthTimeout

integer

Non

Le délai d'expiration de l'authentification. Unité : secondes.

  • Valeur minimale : 1.

  • Valeur maximale : 86400.

  • Valeur par défaut : 3600.

30

Éléments de réponse

Élément

Type

Description

Exemple

object

Schéma de la réponse.

RequestId

string

L'identifiant de la requête.

******11-DB8D-4A9A-875B-275798******

MediaInfos

array<object>

La collection de ressources média qui répondent aux exigences spécifiées.

array<object>

La collection de ressources média qui répondent aux exigences spécifiées.

MediaId

string

L'identifiant de la ressource média.

******c48fb37407365d4f2cd8******

MediaBasicInfo

object

Les informations de base sur la ressource média.

MediaId

string

The media ID.

******c48fb37407365d4f2cd8******

InputURL

string

The URL of the media asset in its source system.

https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

MediaType

string

The media type. Valid values:

  • Image

  • Video

  • Audio

  • Text

video

BusinessType

string

The business type of the media asset.

general

Source

string

The source. Valid values:

  • OSS

  • VOD

oss

Title

string

The title.

title

Description

string

The description.

description

Category

string

The category.

category1

MediaTags

string

The tags.

tag1, tag2

CoverURL

string

The cover URL.

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=

UserData

string

The user data.

userDataTest

Snapshots

string

The snapshots.

[ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]

Status

string

The status of the media asset.

Normal

TranscodeStatus

string

The transcoding status.

Init

CreateTime

string

The time the media asset was created.

2020-12-26T04:11:10Z

ModifiedTime

string

The time the media asset was last modified.

2020-12-26T04:11:12Z

DeletedTime

string

The time the media asset was deleted.

2020-12-26T04:11:10Z

SpriteImages

string

The sprite images.

[{"bucket":"example-bucket","count":"32","iceJobId":"******83ec44d58b2069def2e******","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"******e438b14ff39293eaec25******","tileCount":"1"}]

Biz

string

The business associated with the media asset.

ICE

FileInfoList

array<object>

La liste des informations de base sur les fichiers.

array<object>

Les informations de base sur le fichier.

FileBasicInfo

object

The basic information about the file, such as the duration and file size.

FileName

string

The file name.

example

FileStatus

string

The file status.

Normal

FileType

string

The file type.

source_file

FileSize

string

The file size, in bytes.

30611502

FileUrl

string

The OSS URL of the file.

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=

Region

string

The region where the file is stored.

cn-shanghai

FormatName

string

The container format.

mov,mp4,m4a,3gp,3g2,mj2

Duration

string

The duration.

200

Bitrate

string

The bitrate.

1132.68

Width

string

The width.

1920

Height

string

The height.

1080

AudioStreamInfoList

array<object>

The audio streams.

object

The details of an audio stream.

Index

string

The index of the stream.

CodecName

string

The short name of the codec.

CodecLongName

string

The full name of the codec.

CodecTimeBase

string

The time base of the codec.

CodecTagString

string

The codec tag string.

CodecTag

string

The codec tag.

Profile

string

The profile.

SampleFmt

string

The sample format.

SampleRate

string

The sample rate.

Channels

string

The number of audio channels.

ChannelLayout

string

The channel layout.

Timebase

string

The time base.

StartTime

string

The start time.

Duration

string

The duration.

Bitrate

string

The bitrate.

Fps

string

The frame rate.

NumFrames

string

The total number of frames.

Lang

string

The language.

VideoStreamInfoList

array<object>

The video streams.

object

The details of a video stream.

Index

string

The index of the stream.

CodecName

string

The short name of the codec.

CodecLongName

string

The full name of the codec.

Profile

string

The profile.

CodecTimeBase

string

The time base of the codec.

CodecTagString

string

The codec tag string.

CodecTag

string

The codec tag.

Width

string

The width of the video.

Height

string

The height of the video.

HasBFrames

string

Indicates whether B-frames exist.

Sar

string

The sample aspect ratio (SAR).

Dar

string

The display aspect ratio (DAR).

PixFmt

string

The pixel format.

Level

string

The level.

Fps

string

The frame rate.

AvgFPS

string

The average frame rate.

Timebase

string

The time base.

StartTime

string

The start time.

Duration

string

The duration.

Bitrate

string

The bitrate.

NumFrames

string

The total number of frames.

Lang

string

The language.

Rotate

string

The rotation angle.

Nb_frames

string

This parameter is an alias for NumFrames.

SubtitleStreamInfoList

array<object>

The subtitle streams.

object

The details of a subtitle stream.

Index

string

The index of the stream.

CodecName

string

The short name of the codec.

CodecLongName

string

The full name of the codec.

CodecTimeBase

string

The time base of the codec.

CodecTagString

string

The codec tag string.

CodecTag

string

The codec tag.

Timebase

string

The time base.

StartTime

string

The start time.

Duration

string

The duration.

Lang

string

The language.

MediaDynamicInfo

object

Le type de ressource multimédia.

DynamicMetaData

object

The type of dynamic metadata. Valid values:

  • "ai": Standardized data derived from raw AI results.

  • "user-defined": The user-defined metadata.

  • "system": The system-generated data.

Data

string

The content of the dynamic metadata.

system

IgnoredList

array

La liste des ressources multimédias dont la récupération a échoué.

string

Les informations sur la ressource multimédia.

****20b48fb04483915d4f2cd8ac****

Exemples

JSON format

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfos": [
    {
      "MediaId": "******c48fb37407365d4f2cd8******",
      "MediaBasicInfo": {
        "MediaId": "******c48fb37407365d4f2cd8******",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "title",
        "Description": "description",
        "Category": "category1",
        "MediaTags": "tag1, tag2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userDataTest",
        "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-26T04:11:10Z",
        "ModifiedTime": "2020-12-26T04:11:12Z",
        "DeletedTime": "2020-12-26T04:11:10Z",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "Biz": "ICE"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "200",
            "Bitrate": "1132.68",
            "Width": "1920",
            "Height": "1080"
          },
          "AudioStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Profile": "",
              "SampleFmt": "",
              "SampleRate": "",
              "Channels": "",
              "ChannelLayout": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "Fps": "",
              "NumFrames": "",
              "Lang": ""
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "Profile": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Width": "",
              "Height": "",
              "HasBFrames": "",
              "Sar": "",
              "Dar": "",
              "PixFmt": "",
              "Level": "",
              "Fps": "",
              "AvgFPS": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "NumFrames": "",
              "Lang": "",
              "Rotate": "",
              "Nb_frames": ""
            }
          ],
          "SubtitleStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Lang": ""
            }
          ]
        }
      ],
      "MediaDynamicInfo": {
        "DynamicMetaData": {
          "Data": "system"
        }
      }
    }
  ],
  "IgnoredList": [
    "****20b48fb04483915d4f2cd8ac****"
  ]
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.