GetLiveEditingJob - - Centre de documentation Alibaba Cloud

Consulte les informations relatives à une tâche de montage en direct. Les informations demandées incluent l'état, la chronologie et le modèle de la tâche, l'identifiant et l'URL du fichier de sortie, ainsi que les configurations de la tâche. Seules les tâches de montage en direct créées au cours de l'année écoulée peuvent être interrogées.

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

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
JobId	string	Non	L'identifiant de la tâche de montage en direct.	**d80e4e4044975745c14b**

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	**36-3C1E-4417-BDB2-1E034F**
LiveEditingJob	object	Les informations relatives à la tâche de montage en direct.
JobId	string	L'identifiant de la tâche de montage en direct.	**cdb3e74639973036bc84**
ProjectId	string	L'identifiant du projet de montage en direct.	**fddd7748b58bf1d47e95**
Status	string	L'état de la tâche de montage en direct. Valeurs valides : Init, Queuing, Processing, Success et Failed.	Success
Clips	string	Les clips.	[{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" }]
UserData	string	Les données définies par l'utilisateur.	{"key": "value'}
CreationTime	string	L'heure de création de la tâche de montage en direct. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.	2020-12-23T13:33:40Z
ModifiedTime	string	L'heure de la dernière modification de la tâche de montage en direct. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.	2020-12-23T13:33:49Z
CompleteTime	string	L'heure de fin de la tâche de montage en direct. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.	2020-12-23T13:33:52Z
MediaId	string	L'identifiant de la ressource média du fichier de sortie.	**0cc6ba49eab379332c5b**
MediaURL	string	L'URL du fichier de sortie.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4
Code	string	Le code de réponse. Remarque : prêtez attention à ce paramètre en cas d'échec de la tâche.	InvalidParameter
Message	string	Le message renvoyé. Remarque : prêtez attention à ce paramètre en cas d'échec de la tâche.	Le paramètre spécifique LiveStreamConfig n'est pas valide
LiveStreamConfig	object	Les configurations de montage en direct.
AppName	string	The name of the application to which the live stream belongs.	app
DomainName	string	The domain name of the live stream.	domain.com
StreamName	string	The name of the live stream.	streamName
MediaProduceConfig	object	Les configurations de production.
Mode	string	The editing mode. Default value: Accurate.	Accurate
OutputMediaConfig	object	Les configurations de stockage du fichier de sortie.
MediaURL	string	The URL of the output file.	https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4
StorageLocation	string	If OutputMediaTarget is set to vod-media, this parameter indicates the storage location of the media asset in ApsaraVideo VOD. The storage location is the path of the file in ApsaraVideo VOD, excluding the prefix http://. Example: outin-xxxxxx.oss-cn-shanghai.aliyuncs.com.	outin-xxxxxx.oss-cn-shanghai.aliyuncs.com
FileName	string	If OutputMediaTarget is set to vod-media, this parameter indicates the file name of the output file. The value contains the file name extension but not the path.	test.mp4
Width	integer	The width of the output file. You can leave this parameter empty. The default value is the maximum width of the input materials.	640
Height	integer	The height of the output file. You can leave this parameter empty. The default value is the maximum height of the input materials.	480
Bitrate	integer	The bitrate of the output file. Unit: Kbit/s. You can leave this parameter empty. The default value is the maximum bitrate of the input materials.	1000
VodTemplateGroupId	string	The ID of the VOD transcoding template group. If VOD transcoding is not required, set the value to VOD_NO_TRANSCODE.	VOD_NO_TRANSCODE

Exemples

JSON format

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "LiveEditingJob": {
    "JobId": "****cdb3e74639973036bc84****",
    "ProjectId": "****fddd7748b58bf1d47e95****",
    "Status": "Success",
    "Clips": "[{\\\"StartTime\\\": \\\" 2021-06-21T08:01:00Z\\\",  \\\"EndTime\\\": \\\" 2021-06-21T08:03:00Z\\\" }]",
    "UserData": "{\"key\": \"value'}",
    "CreationTime": "2020-12-23T13:33:40Z",
    "ModifiedTime": "2020-12-23T13:33:49Z",
    "CompleteTime": "2020-12-23T13:33:52Z",
    "MediaId": "****0cc6ba49eab379332c5b****",
    "MediaURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4",
    "Code": "InvalidParameter",
    "Message": "The specific parameter LiveStreamConfig is not valid.",
    "LiveStreamConfig": {
      "AppName": "app",
      "DomainName": "domain.com",
      "StreamName": "streamName"
    },
    "MediaProduceConfig": {
      "Mode": "Accurate"
    },
    "OutputMediaConfig": {
      "MediaURL": "https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4",
      "StorageLocation": "outin-xxxxxx.oss-cn-shanghai.aliyuncs.com",
      "FileName": "test.mp4",
      "Width": 640,
      "Height": 480,
      "Bitrate": 1000,
      "VodTemplateGroupId": "VOD_NO_TRANSCODE"
    }
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.