CreateLivePullToPush - - Centre de documentation Alibaba Cloud

Crée une tâche de tirage et de poussée de flux en appelant CreateLivePullToPush.

Description de l'opération

Important Le tirage et la poussée de flux sont des fonctionnalités payantes. La facturation commence officiellement à 00h00 le 5 décembre 2025.

Pour plus de détails sur la facturation, consultez Frais de tirage et de poussée de flux.
Appelez cette opération pour créer une tâche de tirage et de poussée de flux.
Vous pouvez créer une tâche de tirage de flux en direct ou une tâche de tirage de flux à la demande.
Une fois la tâche créée, elle démarre à l'heure de début spécifiée, puis s'arrête et est supprimée automatiquement à l'heure de fin spécifiée.
Assurez-vous que l'URL d'ingestion de destination spécifiée dans la tâche n'est pas utilisée par d'autres tâches. Sinon, l'ingestion de flux échoue car plusieurs tâches poussent des flux vers la même URL en même temps.
Les rappels pour les événements de tirage et de poussée de flux incluent les rappels de changement d'état d'exécution de la tâche et les rappels de sortie de la tâche. Pour plus d'informations, consultez Rappels d'événements de tirage et de poussée de flux.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 10 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, 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:CreateLivePullToPush

create

*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-beijing
Region	string	Oui	La région où la tâche est démarrée. Valeurs valides : ap-southeast-1 (Singapour) ap-southeast-5 (Indonésie) cn-beijing (Pékin) cn-shanghai (Shanghai) cn-shenzhen (Shenzhen) 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
TaskName	string	Non	Le nom de la tâche, qui prend en charge la correspondance approximative. Valeur par défaut : "".	test
StartTime	string	Oui	L'heure de début de la tâche. Remarque Format : yyyy-MM-ddTHH:mm:ssZ (UTC).	2024-08-26T10:30:00Z
EndTime	string	Oui	L'heure de fin de la tâche. Remarque Format : yyyy-MM-ddTHH:mm:ssZ (UTC). EndTime doit être postérieur à StartTime. EndTime doit être postérieur à l'heure actuelle.	2024-08-27T14:30:00Z
SourceType	string	Oui	Le type de flux source. Valeurs valides : live : flux en direct. vod : ressource ApsaraVideo VOD. url : ressource de fichier vidéo tierce. Valeurs valides : vod : Ressource ApsaraVideo VOD. live : Flux en direct. url : Ressource de fichier vidéo tierce.	live
SourceProtocol	string	Non	Le protocole du flux source. Valeurs valides : rtmp srt http-flv hls Remarque Ce paramètre est requis uniquement lorsque SourceType est défini sur live. Ce paramètre ne prend pas effet lorsque SourceType est défini sur vod ou url.	rtmp
SourceUrls	array	Oui	La liste des URL de flux source. Remarque Pour le type live, une seule URL de diffusion en direct complète est prise en charge. Pour les types vod et url, jusqu'à 30 URL sont prises en charge. Le type live prend en charge les protocoles rtmp, srt et http-flv. Pour le type vod, spécifiez les identifiants de ressources multimédias ApsaraVideo VOD. Le type url prend en charge les protocoles mp4 et http-flv.
	string	Non	L'URL du flux source. Remarque Pour le type live, une seule URL de diffusion en direct complète est prise en charge. Pour les types vod et url, jusqu'à 30 URL sont prises en charge. Le type live prend en charge les protocoles rtmp, srt et http-flv. Pour le type vod, spécifiez les identifiants de ressources multimédias ApsaraVideo VOD. Le type url prend en charge les protocoles mp4 et http-flv.	rtmp://pulltest.****.aliyunlive.com/pulltest493/pulltest-w434
DstUrl	string	Oui	L'URL d'ingestion de destination. Remarque Le protocole rtmp est pris en charge. La longueur maximale est de 2 000 caractères.	rtmp://pushtest.********.aliyunlive.com/pulltest493/pulltest-w434
RepeatNumber	integer	Non	Le nombre de répétitions de la lecture après la fin de la liste de lecture. Valeurs valides : 0 (par défaut) : aucune répétition. -1 : boucle infinie. Autres entiers positifs : le nombre de répétitions de la lecture. Remarque Ce paramètre s'applique uniquement aux flux vidéo à la demande ou aux flux vidéo tiers.	0
FileIndex	integer	Non	L'index du fichier. La lecture commence à partir du nième fichier.	0
Offset	integer	Non	Le décalage de début par rapport au début du fichier vidéo. Unité : secondes. La valeur doit être supérieure à 0. Remarque Spécifie le décalage par rapport à la première image comme position de début de lecture (pour la première vidéo). Ce paramètre s'applique uniquement aux flux vidéo à la demande ou aux flux vidéo tiers.	2
CallbackUrl	string	Non	L'URL de rappel HTTP. Valeur par défaut : vide. Remarque L'URL qui reçoit les rappels liés à la tâche. La longueur maximale est de 2 000 caractères. Si ce paramètre n'est pas spécifié, les événements de tâche ne sont pas envoyés via des rappels.	https://callback*****.com
RetryInterval	integer	Non	L'intervalle de nouvelle tentative. Unité : secondes. Valeurs valides : 60 à 300. Valeur par défaut : 60.	60
RetryCount	integer	Non	Le nombre de nouvelles tentatives. Valeur par défaut : 3.	3
ReqAuth	string	Non	Indique si l'authentification doit être ajoutée aux rappels.	no
AuthKey	string	Non	La clé d'authentification. La clé doit comporter entre 16 et 64 caractères et ne peut contenir que des caractères ASCII imprimables (0x21-0x7e). La clé peut être utilisée pour vérifier la source du rappel lors de la réception des rappels.	abcd
NotifyItemSwitch	string	Non	Indique si des rappels doivent être reçus lorsque la liste de lecture change lors de tâches de tirage et de poussée de flux autres qu'en direct.	off

É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.	16A96B9A-F203-4EC5-8E43-CB92E68*****
RetCode	integer	Le code de retour. Remarque La valeur « 0 » est renvoyée si l'appel réussit. Pour les exceptions, consultez les codes d'erreur listés ci-dessous.	0
Description	string	La description de l'erreur.	OK
TaskId	string	L'identifiant de la tâche.	fd245384-4067-4f91-9d75-9666a6bc9****

Exemples

JSON format

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK",
  "TaskId": "fd245384-4067-4f91-9d75-9666a6bc9****"
}

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	InvalidParam.CodeIllegalDuration	%s.	L'heure de début doit être antérieure à l'heure de fin.
400	CodeInvalidAliUid	This aliuid does not have a live domain name.	Il n'existe aucun domaine de diffusion en direct pour cet aluid.
400	CodeNotEnoughResource	Exceeded configuration limits or insufficient resources.	La limite de configuration est dépassée ou les ressources disponibles sont insuffisantes.
400	CodeConfigAlreadyExists	Code Config Already Exists	La configuration existe déjà.
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.