UpdateLivePullToPush - - Centre de documentation Alibaba Cloud

Met à jour une tâche d'extraction de flux en appelant UpdateLivePullToPush.

Description de l'opération

Appelez cette opération pour mettre à jour une tâche d'extraction de flux.
Si la tâche n'a pas atteint l'heure de début configurée, vous pouvez mettre à jour le paramètre Region.
Si la tâche est en cours d'exécution (y compris dans un état de nouvelle tentative anormale), seuls CallbackUrl et RepeatTime peuvent être mis à jour, et les mises à jour prennent effet immédiatement.
Si la tâche est arrêtée, tous les paramètres sauf Region peuvent être mis à jour.

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, l'appel d'API est limité, 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:UpdateLivePullToPush

update

*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
TaskId	string	Oui	L'identifiant de la tâche.	fd245384-4067-4f91-9d75-9666a6bc****
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) 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
StartTime	string	Non	L'heure de début de la tâche. Remarque Format : yyyy-MM-ddTHH:mm:ssZ (UTC). Si la tâche a déjà commencé à s'exécuter, la mise à jour ne prend pas effet.	2024-08-23T15:30:00Z
EndTime	string	Non	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. Si la tâche est terminée, la mise à jour ne prend pas effet.	2024-08-27T14:30:00Z
SourceUrls	array	Non	La liste des URL des flux sources. Remarque Pour le type live, une seule URL de streaming en direct complète est prise en charge. Pour les types vod et url, jusqu'à 30 URL peuvent être spécifiées. Le type live prend en charge les protocoles RTMP, SRT et HTTP-FLV. Pour le type vod, spécifiez les identifiants des ressources média ApsaraVideo VOD. Le type url prend en charge les protocoles MP4 et HTTP-FLV. Pour les flux sources en direct, la mise à jour prend effet immédiatement. Pour les flux sources de fichiers vidéo, la mise à jour prend effet après la fin de la vidéo en cours de lecture, et la lecture redémarre depuis le début de la liste de vidéos mise à jour. La mise à jour doit être effectuée lorsque la tâche est arrêtée et prend effet après le redémarrage de la tâche.	changedtesturl
	string	Non	L'URL du flux source. Remarque Pour le type live, une seule URL de streaming en direct complète est prise en charge. Pour les types vod et url, jusqu'à 30 URL peuvent être spécifiées. Le type live prend en charge les protocoles RTMP, SRT et HTTP-FLV. Pour le type vod, spécifiez les identifiants des ressources média ApsaraVideo VOD. Le type url prend en charge les protocoles MP4 et HTTP-FLV. Pour les flux sources en direct, la mise à jour prend effet immédiatement. Pour les flux sources de fichiers vidéo, la mise à jour prend effet après la fin de la vidéo en cours de lecture, et la lecture redémarre depuis le début de la liste de vidéos mise à jour. La mise à jour doit être effectuée lorsque la tâche est arrêtée et prend effet après le redémarrage de la tâche.	rtmp://pulltest.****.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 de la lecture. -1 : Boucle indéfiniment. Autres entiers positifs : Le nombre de répétitions de la lecture après la fin de la liste de lecture. Remarque Ce paramètre s'applique uniquement aux flux vidéo à la demande ou aux flux vidéo tiers. La mise à jour prend effet immédiatement.	0
Offset	integer	Non	Le décalage de début du fichier vidéo, en secondes. Valeurs valides : supérieur à 0. Remarque Spécifie la position à partir de laquelle commencer la lecture, par rapport à la première image. Ce paramètre s'applique uniquement aux flux vidéo à la demande ou aux flux vidéo tiers. Ce paramètre prend effet uniquement lorsque la première vidéo de la liste de lecture est lue. La mise à jour doit être effectuée lorsque la tâche est arrêtée et prend effet après le redémarrage de la tâche.	2
CallbackUrl	string	Non	L'URL de rappel. Valeur par défaut : vide. Remarque L'URL qui reçoit les rappels liés à la tâche. Longueur maximale : 2000 caractères. Si ce paramètre n'est pas spécifié, les événements de la tâche ne sont pas envoyés sous forme de rappels. La mise à jour prend effet uniquement lors du déclenchement de l'événement suivant.	https://callback*****.com
FileIndex	integer	Non	L'index de la vidéo. Valeur par défaut : 0. Remarque La mise à jour doit être effectuée lorsque la tâche est arrêtée et prend effet après le redémarrage de la tâche.	0
		Non
		Non
		Non

É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'opération réussit. Pour les exceptions, reportez-vous aux codes d'erreur listés ci-dessous.	0
Description	string	La description de l'erreur.	OK

Exemples

JSON format

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter	%s.	Le paramètre est invalide.
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.	Aucun domaine de diffusion en direct n'existe pour cet aluid.
400	CodeTaskNotExist	Task does not exist.	La tâche n'existe pas.
400	CodeTaskHasStarted	The task has already started.	La tâche a déjà démarré et ne peut pas être mise à jour.
500	InternalError	%s.	Une erreur interne s'est produite. Réessayez plus tard.

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

Notes de version

Consultez Notes de version pour la liste complète.