DescribeLivePullToPushList - - Centre de documentation Alibaba Cloud

Effectue une recherche approximative des tâches de tirage et d'ingestion de flux.

Description de l'opération

Appelez cette opération pour interroger une liste de nœuds de tirage et d'ingestion de flux.
Prend en charge les requêtes paginées et la recherche approximative par identifiant de nœud, nom de nœud et URL d'ingestion de flux de destination. La pagination est prise en charge.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 10 appels par seconde. Le dépassement de cette limite déclenchera une limitation du débit, ce qui peut affecter votre activité. Appelez cette opération de manière appropriée.

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.

live:DescribeLivePullToPushList

get

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Non	L'identifiant de la région.	cn-shanghai
Region	string	Oui	Le centre de diffusion en direct à interroger. Valeurs valides : ap-southeast-1 (Singapour) ap-southeast-5 (Indonésie) cn-beijing (Pékin) cn-shanghai (Shanghai) Valeurs valides : cn-shenzhen : Shenzhen. cn-qingdao : Qingdao. preregion : Pré-version. cn-beijing : Pékin. cn-shanghai : Shanghai. ap-southeast-1 : Singapour. eu-central-1 : Allemagne (Francfort) ap-northeast-1 : Japon (Tokyo) ap-southeast-5 : Indonésie. me-central-1 : Arabie saoudite (Riyad)	cn-shanghai
TaskId	string	Non	L'identifiant de la tâche. Une recherche approximative est effectuée en fonction de l'identifiant de la tâche. Remarque L'identifiant de la tâche se compose de lettres majuscules et minuscules, de chiffres, de traits de soulignement et de traits d'union (-), avec un maximum de 55 caractères.	861009
TaskName	string	Non	Le nom de la tâche. Une recherche approximative est effectuée en fonction du nom de la tâche.	task
DstUrl	string	Non	L'URL d'ingestion de destination. Une recherche approximative est effectuée en fonction de l'URL d'ingestion de destination.	rtmp://qd
PageNumber	integer	Non	Le numéro de page. Remarque La valeur doit être supérieure à 0 et ne peut pas dépasser la valeur maximale du type de données Integer. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'enregistrements par page. Remarque Valeur par défaut : 10. Valeurs valides : 1 à 100.	10

É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.	a05e6b15-15af-405b-a4a2-0152245*****
Total	integer	Le nombre total de résultats de requête.	3
PageNumber	integer	Le numéro de page.	1
PageSize	integer	Le nombre d'enregistrements par page.	10
TaskList	array<object>	La liste des informations sur les tâches.
	array<object>	La liste des informations sur les tâches.
TaskId	string	L'identifiant de la tâche.	fb0d4ac7-c7e3-4978-9743-0bf2f6e8****
TaskStatus	integer	L'état actuel de la tâche. Valeurs valides : 0 : Non démarrée (l'heure de début n'a pas été atteinte). 1 : Fonctionnement normal (le tirage et l'ingestion de flux sont normaux). 2 : Fonctionnement anormal. 3 : Arrêtée (le tirage ou l'ingestion de flux est anormal, ou la tâche a été activement arrêtée en appelant une opération). -1 : Terminée.	0
TaskInvalidReason	string	La raison pour laquelle la tâche a arrêté de s'exécuter. Valeurs valides : PullStreamFailed : Le tirage du flux source est anormal. Nouvelle tentative en cours. PushStreamFailed : L'ingestion du flux de destination est anormale. Nouvelle tentative en cours. UnknownError : Erreur inconnue. Remarque Ce paramètre est renvoyé uniquement lorsque la tâche est à l'état arrêté.	PullStreamFailed
TaskExitTime	integer	L'heure à laquelle la tâche s'est terminée. La valeur est un horodatage UNIX en secondes. Remarque Ce paramètre est renvoyé uniquement lorsque la tâche est à l'état terminé.	1726354625
TaskExitReason	string	La raison pour laquelle la tâche s'est terminée. Valeurs valides : TriggerByUser : La tâche a été arrêtée manuellement par l'utilisateur. OverEndTime : L'heure de fin prédéfinie a été dépassée. Remarque Ce paramètre est renvoyé uniquement lorsque la tâche est à l'état terminé.	TriggerByUser
CurrentOffset	integer	Le décalage de lecture vidéo actuellement actif.	0
CurrentFileIndex	integer	Le décalage de séquence de liste de lecture actuellement actif.	0
TaskInfo	object	Les informations sur la tâche.
TaskId	string	L'identifiant de la tâche.	fb0d4ac7-c7e3-4978-9743-0bf2f6e8****
TaskName	string	Le nom de la tâche.	taskname
StartTime	string	L'heure de début de la tâche. Format : yyyy-MM-ddTHH:mm:ssZ (UTC).	2024-12-04T09:16:00Z
EndTime	string	L'heure de fin de la tâche. Format : yyyy-MM-ddTHH:mm:ssZ (UTC).	2024-12-30T14:30:00Z
SourceType	string	Le type de flux source. Valeurs valides : live : flux en direct. vod : ressource ApsaraVideo VOD. url : ressource de fichier vidéo tiers.	vod
SourceProtocol	string	Le protocole du flux source.	flv
SourceUrls	array	L'URL du flux source.
	string	L'URL du flux source.	rtmp://118.178.**.5:**/wwtestlive1/pulltest.jiugong.aliyunlive.com_livelight2?vhost=pulltest.jiugong.aliyun*****
DstUrl	string	L'URL d'ingestion de destination.	rtmp://qd.push.lgg.alivecdn.com/testhsc/streamhsc?live_rtmp_*******
CallbackURL	string	L'URL de rappel HTTP.	hahaha.com
Offset	integer	Le décalage de début du fichier vidéo. Unité : secondes. La valeur doit être supérieure à 0. Remarque Indique la position à partir de laquelle commencer la lecture, par rapport à la première image. Ce paramètre est valide uniquement pour les ressources de vidéo à la demande ou les fichiers vidéo.	0
FileIndex	integer	L'index du fichier. La lecture commence à partir du nième fichier.	0
RetryCount	integer	Le nombre de tentatives.	3
RetryInterval	integer	L'intervalle entre les tentatives. Unité : secondes.	60
RepeatNumber	integer	Le nombre de fois que la lecture se répète après son achèvement. Valeurs valides : 0 (par défaut) : Aucune répétition de lecture. -1 : Boucle infinie. Autres entiers positifs : le nombre de fois que la lecture se répète après son achèvement. Remarque Ce paramètre s'applique uniquement aux flux vidéo à la demande ou aux flux vidéo tiers.	0
ReqAuth	string	Indique si l'authentification doit être ajoutée pour les rappels.	no
AuthKey	string	La clé d'authentification. La valeur comporte de 16 à 64 caractères et prend en charge uniquement les caractères ASCII imprimables (0x21-0x7e). Cette clé peut être utilisée pour vérifier la source du rappel lors de la réception des rappels.	abcd
NotifyItemSwitch	string	Indique si des rappels doivent être reçus lorsque la liste de lecture change lors de tâches de tirage et d'ingestion de flux autres qu'en direct.	off

Exemples

JSON format

{
  "RequestId": "a05e6b15-15af-405b-a4a2-0152245*****",
  "Total": 3,
  "PageNumber": 1,
  "PageSize": 10,
  "TaskList": [
    {
      "TaskId": "fb0d4ac7-c7e3-4978-9743-0bf2f6e8****",
      "TaskStatus": 0,
      "TaskInvalidReason": "PullStreamFailed",
      "TaskExitTime": 1726354625,
      "TaskExitReason": "TriggerByUser",
      "CurrentOffset": 0,
      "CurrentFileIndex": 0,
      "TaskInfo": {
        "TaskId": "fb0d4ac7-c7e3-4978-9743-0bf2f6e8****",
        "TaskName": "taskname",
        "StartTime": "2024-12-04T09:16:00Z",
        "EndTime": "2024-12-30T14:30:00Z",
        "SourceType": "vod",
        "SourceProtocol": "flv",
        "SourceUrls": [
          "rtmp://118.178.***.*5:****/wwtestlive1/pulltest.jiugong.aliyunlive.com_livelight2?vhost=pulltest.jiugong.aliyun*******"
        ],
        "DstUrl": "rtmp://qd.push.lgg.alivecdn.com/testhsc/streamhsc?live_rtmp_*******",
        "CallbackURL": "hahaha.com",
        "Offset": 0,
        "FileIndex": 0,
        "RetryCount": 3,
        "RetryInterval": 60,
        "RepeatNumber": 0,
        "ReqAuth": "no",
        "AuthKey": "abcd",
        "NotifyItemSwitch": "off"
      }
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter	%s.	Les paramètres spécifiés sont invalides. Vérifiez si les paramètres d'entrée sont complets et corrects.
400	LiveServiceNotFound	Your account does not open Live service yet	Votre compte n'a pas activé ApsaraVideo Live.
400	CodeInvalidAliUid	This aliuid does not have a live domain name.	Il n'existe aucun domaine de diffusion en direct pour cet aluid.
400	CodeTaskNotExist	Task does not exist.	La tâche n'existe pas.
500	InternalError	%s.	Une erreur interne s'est produite. Réessayez. Si l'erreur persiste après plusieurs tentatives, soumettez un ticket.

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

Notes de version

Consultez Notes de version pour la liste complète.