QueryMediaListByURL - - Centre de documentation Alibaba Cloud

Consulte les fichiers multimédias à l'aide des URL de fichiers OSS.

Description de l'opération

Cette opération peut interroger jusqu'à 10 fichiers multimédias à la fois.
Avant d'appeler cette opération, appelez l'opération Ajouter des médias pour ajouter des fichiers multimédias, puis appelez cette opération pour interroger les informations sur les médias.
Cette opération prend uniquement en charge l'interrogation des informations des fichiers traités par des flux de travail. Pour les fichiers multimédias nouvellement importés, les informations de fichier obtenues à l'aide de cette opération ne sont complètes qu'une fois l'exécution du flux de travail terminée. Pour obtenir les informations sur les données vidéo pour les tâches de traitement hors flux de travail, vous devez appeler l'opération SubmitMediaInfoJob pour soumettre une tâche d'analyse des informations multimédias avant de pouvoir consulter les informations.

Limites de QPS

La limite de QPS pour un seul utilisateur est de 100 requêtes par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Effectuez les appels d'API à une fréquence raisonnable. Pour plus d'informations, consultez Limites de QPS.

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.

mts:QueryMediaListByURL

get

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
FileURLs	string	Oui	Les URL des fichiers multimédias à interroger. Vous pouvez vous connecter à la console MPS, choisir Gestion des médias > Liste des médias pour trouver les fichiers multimédias à interroger, cliquer sur Gérer dans la colonne Actions, et obtenir les URL des fichiers multimédias dans l'onglet Obtenir l'URL de transcodage. Séparez les URL multiples par des virgules (,). Vous pouvez interroger jusqu'à 10 URL à la fois. L'URL doit être conforme à la RFC 3986. Elle doit être encodée en UTF-8 et ses caractères réservés doivent faire l'objet d'un encodage d'URL. Pour plus d'informations, consultez Encodage d'URL. L'URL ne peut pas dépasser 3 200 octets. Seules les URL HTTP OSS sont prises en charge. Les URL CDN et les URL HTTPS ne sont pas prises en charge.	http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4
IncludePlayList	boolean	Non	Indique si la réponse inclut les informations de lecture. Valeurs valides : true (inclus), false (non inclus). Valeur par défaut : false.	true
IncludeSnapshotList	boolean	Non	Indique si la réponse inclut les informations sur les instantanés. Valeurs valides : true (inclus), false (non inclus). Valeur par défaut : false.	true
IncludeMediaInfo	boolean	Non	Indique si la réponse inclut les informations multimédias. Valeurs valides : true (inclus), false (non inclus). Valeur par défaut : false. Remarque Pour obtenir des informations multimédias détaillées, définissez ce paramètre sur true.	true
IncludeSummaryList	boolean	Non	Indique si la réponse inclut la liste des résumés. Valeurs valides : true (oui), false (non). Valeur par défaut : false.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
MediaList	object
Media	array<object>	La liste des médias.
	array<object>	Les détails des médias.
CreationTime	string	L'heure de création. L'heure est affichée en UTC et suit la norme ISO 8601 au format AAAA-MM-JJThh:mm:ssZ.	2021-07-14T13:05:00Z
CateId	integer	L'identifiant de la catégorie.	123
Height	string	La hauteur du fichier média interrogé.	360
CensorState	string	L'état de la modération de la vidéo. Valeurs valides : Initiated : État initial. La vidéo est téléchargée mais la modération n'est pas terminée. Pass : Réussie. La vidéo est téléchargée et a passé la modération.	Initiated
Tags	object
Tag	array	Les informations de balise.
	string	La liste des balises.	tag1,tag2
PlayList	object
Play	array<object>	La liste de lecture.
	array<object>	Les détails du fichier de lecture.
Encryption	string	L'état du chiffrement. Valeurs valides : 0 : Non chiffré. 1 : Chiffré.	1
Height	string	La hauteur.	10
Bitrate	string	Le débit binaire.	25.067
File	object	Le fichier de lecture.
State	string	L'état du fichier. Valeurs valides : Normal : Normal. Deleted : Supprimé.	Normal
URL	string	Le compartiment OSS d'entrée du fichier de lecture.	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4l-test/in/1.mp4
MediaWorkflowId	string	L'identifiant du workflow qui a généré le fichier de lecture.	6cc3aa66d1cb4bb2adf14e726c0a****
Width	string	La largeur.	11
Size	string	La taille.	100
Fps	string	La fréquence d'images.	25.0
Duration	string	La durée.	7.965000
ActivityName	string	Le nom de l'activité du workflow de médias.	test name
Format	string	Le format d'encodage. Les formats pris en charge incluent mov, mp4, m4a, 3gp, 3g2 et mj2.	mov
MediaWorkflowName	string	Le nom du workflow qui a généré le fichier de lecture.	example-mediaworkflow-****
Bitrate	string	Le débit binaire.	593.192
MediaId	string	L'identifiant du média.	52d7e98b05e648199612290bb819****
File	object	Les détails du fichier d'entrée.
State	string	L'état du fichier. Valeurs valides : Normal : Normal. Deleted : Supprimé.	Normal
URL	string	Le compartiment OSS du fichier d'entrée.	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
SummaryList	object
Summary	array<object>	La liste des résumés vidéo.
	array<object>	Les données du résumé vidéo.
Type	string	Le type de résumé. Valeurs valides : Video : Vidéo. Gif : Image animée.	Gif
MediaWorkflowId	string	L'identifiant du workflow qui a généré le résumé.	93ab850b4f6f44eab54b6e91d24d****
ActivityName	string	Le nom de l'activité du workflow de médias.	example-activity-****
MediaWorkflowName	string	Le nom du workflow qui a généré le résumé.	example-mediaworkflow-****
File	object	Le fichier source.
State	string	L'état du fichier. Valeurs valides : Normal : Normal. Deleted : Supprimé.	Normal
URL	string	Le compartiment OSS du fichier d'entrée.	http://example-bucket-****.o
PublishState	string	L'état de publication du média, qui indique si le média est publié. Valeurs valides : Initiated : État initial. UnPublish : Non publié. L'autorisation du fichier de lecture OSS est Privée. Published : Publié. L'autorisation du fichier de lecture OSS est Par défaut. Deleted : Supprimé.	Published
MediaInfo	object	Les informations sur le média.
Streams	object	Les informations sur le flux.
VideoStreamList	object
VideoStream	array<object>	La liste des flux vidéo.
	array<object>	Les données du flux vidéo.
Sar	string	Le rapport d'aspect des échantillons.	1:1
Height	string	La hauteur de la résolution vidéo.	360
CodecTagString	string	Le texte de la marque du format d'encodage.	avc1
NetworkCost	object	La consommation de bande passante réseau.
PreloadTime	string	Le temps de préchargement.	0.01
AvgBitrate	string	Le débit binaire moyen.	2659.326
CostBandwidth	string	La bande passante maximale consommée.	100
Width	string	La largeur de la résolution vidéo. La valeur doit être un nombre non négatif.	640
Index	string	L'index du flux vidéo, qui identifie la position du flux vidéo dans l'ensemble du flux média.	5
Timebase	string	La base de temps.	1/15360
AvgFPS	string	La fréquence d'images moyenne.	15.0
PixFmt	string	Le format de pixel.	yuv420p
Lang	string	La langue. Pour plus d'informations, consultez Définitions des langues FFmpeg.	und
CodecLongName	string	Le nom long du format d'encodage.	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	Le nombre total d'images.	12
Rotate	string	L'angle de rotation de la vidéo.	90
Bitrate	string	Le débit binaire.	512.701
HasBFrames	string	Indique si la vidéo contient des images B. Une valeur de 1 indique oui, et une valeur de 2 indique non.	2
Profile	string	Le profil d'encodage.	High
StartTime	string	L'heure de début.	0.046029
Dar	string	Le rapport d'aspect d'affichage.	16:9
CodecName	string	Le nom court du format d'encodage. Les formats d'encodage pris en charge incluent H264, mov, aac, avc et mpeg.	H264
Duration	string	La durée.	79.200000
Fps	string	La fréquence d'images.	15.0
CodecTag	string	La marque du format d'encodage.	0x31637661
CodecTimeBase	string	La base de temps du codec.	1/30
Level	string	Le niveau d'encodage.	31
AudioStreamList	object
AudioStream	array<object>	La liste des flux audio.
	object	Les données du flux audio.
Timebase	string	La base de temps.	1/44100
Index	string	L'index du flux audio, qui identifie la position du flux audio dans l'ensemble du flux média.	1
SampleFmt	string	Le format d'échantillon.	fltp
ChannelLayout	string	La disposition des canaux.	stereo
Lang	string	La langue. Pour plus d'informations, consultez Définitions des langues FFmpeg.	und
Samplerate	string	La fréquence d'échantillonnage.	44100
CodecLongName	string	Le nom long du format d'encodage.	AAC (Advanced Audio Coding)
Channels	string	Le nombre de canaux.	2
NumFrames	string	Le nombre total d'images.	100
Bitrate	string	Le débit binaire.	76.356
CodecTagString	string	Le texte de la marque du format d'encodage.	mp4a
StartTime	string	L'heure de début.	0.000000
CodecName	string	Le nom court du format d'encodage. Valeurs prises en charge : H264, mov, aac, avc et mpeg.	aac
Duration	string	La durée.	79.203265
CodecTag	string	La marque du format d'encodage.	0x6134706d
CodecTimeBase	string	La base de temps du codec.	1/44100
SubtitleStreamList	object
SubtitleStream	array<object>	La liste des flux de sous-titres.
	object	Les données du flux de sous-titres.
Index	string	L'index du flux de sous-titres. Cet index identifie la position du flux de sous-titres parmi tous les flux multimédias.	1
Lang	string	La langue. Pour plus d'informations, consultez Définitions des langues FFmpeg.	und
Format	object	Les informations de format.
StartTime	string	L'heure de début.	0.000000
NumPrograms	string	Le nombre total de flux de programme.	0
Size	string	La taille.	5872904
NumStreams	string	Le nombre total de flux multimédias.	2
FormatLongName	string	Le nom long du format d'encodage.	QuickTime/MOV
Duration	string	La durée.	79.204000
Bitrate	string	Le débit binaire.	593.192
FormatName	string	Le nom court du format de conteneur ou d'empaquetage. Valeurs prises en charge : mov, mp4, m4a, 3gp, 3g2 et mj2.	mov
Description	string	La description.	This is description ****
Size	string	La taille du fichier.	5872904
Width	string	La largeur.	640
CoverURL	string	Le compartiment OSS de l'image de couverture.	http://example-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example-**.png
SnapshotList	object
Snapshot	array<object>	La liste des instantanés.
	array<object>	Les informations détaillées sur le fichier d'instantané.
Type	string	Le type d'instantané. Valeurs valides : Single : Instantané unique. Sequence : Séquence d'instantanés.	Single
MediaWorkflowId	string	L'identifiant du flux de travail multimédia qui a généré le fichier d'instantané.	6cc3aa66d1cb4bb2adf14e726c0a****
ActivityName	string	Le nom de l'activité du flux de travail multimédia qui a généré le fichier d'instantané.	example-activity1-****
Count	string	Le nombre d'instantanés. Cette valeur n'est valide que lorsque Type est défini sur Sequence.	3
MediaWorkflowName	string	Le nom du flux de travail multimédia qui a généré le fichier d'instantané.	example-workflow-****
File	object	Le fichier d'instantané.
State	string	L'état du fichier. Valeurs valides : Normal : Normal. Deleted : Supprimé.	Normal
URL	string	Le compartiment OSS du fichier d'instantané.	http://example1-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example111-**.png
RunIdList	object
RunId	array	La liste des flux de travail multimédias.
	string	L'identifiant du flux de travail multimédia.	9343bd0e7bb54ae19228529908e5****
Duration	string	La durée.	79.204000
Fps	string	La fréquence d'images.	15.0
Title	string	Le titre.	kled.mp4
Format	string	Le format d'encodage. Valeurs prises en charge : mov, mp4, m4a, 3gp, 3g2 et mj2.	mov
NonExistFileURLs	object
FileURL	array	La liste des fichiers multimédias inexistants.
	string	L'identifiant du fichier multimédia inexistant. Ce paramètre n'est pas renvoyé si aucune donnée n'existe.	null
RequestId	string	L'identifiant de la requête.	1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42

Exemples

JSON format

{
  "MediaList": {
    "Media": [
      {
        "CreationTime": "2021-07-14T13:05:00Z",
        "CateId": 123,
        "Height": "360",
        "CensorState": "Initiated",
        "Tags": {
          "Tag": [
            "tag1,tag2"
          ]
        },
        "PlayList": {
          "Play": [
            {
              "Encryption": "1",
              "Height": "10",
              "Bitrate": "25.067",
              "File": {
                "State": "Normal",
                "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4"
              },
              "MediaWorkflowId": "6cc3aa66d1cb4bb2adf14e726c0a****",
              "Width": "11",
              "Size": "100",
              "Fps": "25.0",
              "Duration": "7.965000",
              "ActivityName": "nom de test",
              "Format": "mov",
              "MediaWorkflowName": "example-mediaworkflow-****"
            }
          ]
        },
        "Bitrate": "593.192",
        "MediaId": "52d7e98b05e648199612290bb819****",
        "File": {
          "State": "Normal",
          "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
        },
        "SummaryList": {
          "Summary": [
            {
              "Type": "Gif",
              "MediaWorkflowId": "93ab850b4f6f44eab54b6e91d24d****",
              "ActivityName": "example-activity-****",
              "MediaWorkflowName": "example-mediaworkflow-****",
              "File": {
                "State": "Normal",
                "URL": "http://example-bucket-****.o"
              }
            }
          ]
        },
        "PublishState": "Published",
        "MediaInfo": {
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "360",
                  "CodecTagString": "avc1",
                  "NetworkCost": {
                    "PreloadTime": "0.01",
                    "AvgBitrate": "2659.326",
                    "CostBandwidth": "100"
                  },
                  "Width": "640",
                  "Index": "5",
                  "Timebase": "1/15360",
                  "AvgFPS": "15.0",
                  "PixFmt": "yuv420p",
                  "Lang": "und",
                  "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                  "NumFrames": "12",
                  "Rotate": "90",
                  "Bitrate": "512.701",
                  "HasBFrames": "2",
                  "Profile": "High",
                  "StartTime": "0.046029",
                  "Dar": "16:9",
                  "CodecName": "H264",
                  "Duration": "79.200000",
                  "Fps": "15.0",
                  "CodecTag": "0x31637661",
                  "CodecTimeBase": "1/30",
                  "Level": "31"
                }
              ]
            },
            "AudioStreamList": {
              "AudioStream": [
                {
                  "Timebase": "1/44100",
                  "Index": "1",
                  "SampleFmt": "fltp",
                  "ChannelLayout": "stereo",
                  "Lang": "und",
                  "Samplerate": "44100",
                  "CodecLongName": "AAC (Advanced Audio Coding)",
                  "Channels": "2",
                  "NumFrames": "100",
                  "Bitrate": "76.356",
                  "CodecTagString": "mp4a",
                  "StartTime": "0.000000",
                  "CodecName": "aac",
                  "Duration": "79.203265",
                  "CodecTag": "0x6134706d",
                  "CodecTimeBase": "1/44100"
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Index": "1",
                  "Lang": "und"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.000000",
            "NumPrograms": "0",
            "Size": "5872904",
            "NumStreams": "2",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "79.204000",
            "Bitrate": "593.192",
            "FormatName": "mov"
          }
        },
        "Description": "Ceci est la description ****",
        "Size": "5872904",
        "Width": "640",
        "CoverURL": "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
        "SnapshotList": {
          "Snapshot": [
            {
              "Type": "Single",
              "MediaWorkflowId": "6cc3aa66d1cb4bb2adf14e726c0a****",
              "ActivityName": "example-activity1-****",
              "Count": "3",
              "MediaWorkflowName": "example-workflow-****",
              "File": {
                "State": "Normal",
                "URL": "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
              }
            }
          ]
        },
        "RunIdList": {
          "RunId": [
            "9343bd0e7bb54ae19228529908e5****"
          ]
        },
        "Duration": "79.204000",
        "Fps": "15.0",
        "Title": "kled.mp4",
        "Format": "mov"
      }
    ]
  },
  "NonExistFileURLs": {
    "FileURL": [
      "null"
    ]
  },
  "RequestId": "1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.