UpdateLivePullToPush - - Centre de documentation Alibaba Cloud

Met à jour une tâche de pull-to-push de flux en appelant UpdateLivePullToPush.

Description de l'opération

Appelez cette opération pour mettre à jour une tâche de pull-to-push 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 suite à une exception), 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, cette 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 déjà terminée, cette mise à jour ne prend pas effet.	2024-08-27T14:30:00Z
SourceUrls	array	Non	La liste des URL des 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 source en direct, la mise à jour prend effet immédiatement. Pour les flux source de fichiers vidéo, la mise à jour prend effet après la fin de la lecture de la vidéo en cours. Une fois la mise à jour effective, la lecture reprend depuis le début de la dernière liste de vidéos. 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 source en direct, la mise à jour prend effet immédiatement. Pour les flux source de fichiers vidéo, la mise à jour prend effet après la fin de la lecture de la vidéo en cours. Une fois la mise à jour effective, la lecture reprend depuis le début de la dernière liste de vidéos. 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 une fois la liste de lecture terminée. Valeurs valides : 0 (par défaut) : Aucune répétition de lecture. -1 : Boucle indéfiniment. Autres entiers positifs : Le nombre de répétitions de la lecture une fois la liste de lecture terminée. 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. La valeur doit être supérieure à 0. Remarque Spécifie la position par rapport à la première image à partir de laquelle commencer la lecture. Ce paramètre s'applique uniquement aux flux vidéo à la demande ou aux flux vidéo tiers. Ce paramètre prend effet uniquement lors de la lecture de la première vidéo de la liste de lecture. 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 : 2 000 caractères. Si ce paramètre n'est pas spécifié, les événements de tâche ne font pas l'objet 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
ReqAuth	string	Non	Indique si l'authentification doit être ajoutée pour les rappels.	no
AuthKey	string	Non	La clé d'authentification. La clé comporte de 16 à 64 caractères et ne prend en charge que les 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 lors du changement de liste de lecture pendant les tâches de pull-to-push de flux non 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 pour les cas normaux. Pour les exceptions, reportez-vous aux codes d'erreur répertorié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.	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	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. 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.