UploadStreamByURL - - Centre de documentation Alibaba Cloud

Description de l'opération

Avant d'utiliser cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'ApsaraVideo VOD. L'import de fichiers média vers ApsaraVideo VOD entraîne des frais de stockage. Pour plus d'informations, consultez Facturation du stockage des ressources média. Si vous avez activé l'accélération du stockage et du transfert, l'import de fichiers média vers ApsaraVideo VOD entraîne également des frais d'accélération de l'import. Pour plus d'informations, consultez Facturation de l'accélération du stockage et du transfert.
Cette opération n'est actuellement prise en charge que dans les régions Chine (Shanghai), Chine (Pékin), Chine (Shenzhen), Singapour et États-Unis (Silicon Valley).
Appelez cette opération pour importer un fichier de flux transcodé depuis un stockage externe et l'associer à la ressource média ApsaraVideo VOD correspondante. Les types HDR pris en charge pour les flux transcodés sont HDR, HDR10, HLG, DolbyVision, HDRVivid et SDR+.
Vous pouvez appeler l'opération GetURLUploadInfos pour interroger l'état de l'import. Une fois l'import terminé, vous recevez la notification d'événement Import de flux transcodé par URL terminé.

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.

vod:UploadStreamByURL

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
StreamURL	string	Oui	L'URL du fichier de flux transcodé. Si l'URL du flux transcodé nécessite une authentification, incluez les paramètres d'authentification dans StreamURL et assurez-vous que l'URL est accessible via le réseau public. Remarque Vous pouvez obtenir l'URL audio ou vidéo depuis la console ou en appelant l'opération GetPlayInfo.	https://example.com/lesson-01.mp4
MediaId	string	Oui	L'identifiant de la ressource média ApsaraVideo VOD correspondant au flux transcodé.	ca3a8f6e49*****57b65806709586
Definition	string	Oui	La définition du flux vidéo. Pour plus de détails, consultez Description des paramètres de la ressource média - Définition.	HD
FileExtension	string	Non	L'extension du nom du fichier de flux transcodé. Pour les formats de fichiers audio et vidéo pris en charge, consultez Vue d'ensemble. Si ce paramètre n'est pas vide, il remplace l'extension du nom de fichier dans StreamURL. Important Ce paramètre est requis si StreamURL ne contient pas d'extension de nom de fichier.	mp4
HDRType	string	Non	Le type HDR du flux transcodé. Valeurs valides : HDR HDR10 HLG DolbyVision HDRVivid SDR+ Remarque Ce paramètre n'est pas sensible à la casse. Laissez ce paramètre vide pour les vidéos non HDR.	HDR10
UserData	string	Non	Le paramètre personnalisé. Pour plus d'informations, consultez UserData. Remarque Pour utiliser le rappel de message dans ce paramètre, configurez l'URL de rappel HTTP et sélectionnez les types d'événements de rappel correspondants dans la console. Sinon, les paramètres de rappel ne prennent pas effet. Pour plus d'informations sur la configuration des rappels HTTP dans la console, consultez Paramètres de rappel.	{"MessageCallback":{"CallbackURL":"http://aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}
UploadMetadata	string	Non	Les métadonnées du fichier média à importer. La valeur est une chaîne JSON. Pour plus d'informations, consultez le tableau UploadMetadata ci-dessous.	{"AddressMapping":"1","CustomPath":"test/xxx","CustomFileName":"xxx.mp4","isOverwritePath":"0"}

UploadMetadata

Nom	Type	Obligatoire	Description
AddressMapping	String	Non	La règle de mappage d'adresses. Valeurs valides : 1 : mappe l'URL du flux transcodé. 2 : utilise un chemin personnalisé.
CustomPath	String	Non	Le chemin de fichier personnalisé. La valeur peut comporter jusqu'à 1000 octets. Encodée en UTF-8.
CustomFileName	String	Non	Le nom de fichier personnalisé. La valeur peut comporter jusqu'à 1000 octets. Encodée en UTF-8.
IsOverwritePath	String	Non	Indique si le fichier doit être écrasé si le chemin de fichier personnalisé existe déjà. Valeurs valides : 0 : n'écrase pas. 1 : écrase.

Remarque

Lorsque AddressMapping est défini sur 2, ni CustomPath ni CustomFileName ne peuvent être vides.
Lorsque IsOverwritePath est défini sur 0, l'opération renvoie un échec si le chemin de fichier personnalisé existe déjà.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les informations de base.
RequestId	string	L'identifiant de la requête.	7AE96389-DF1E-598D-816B-7B40F13B4620
StreamJobId	string	L'identifiant de la tâche du flux transcodé. Vous pouvez utiliser cette valeur comme paramètre de requête de l'opération GetURLUploadInfos. ApsaraVideo VOD utilise l'identifiant de la tâche pour identifier de manière unique un fichier de flux transcodé. Pour plus d'informations, consultez Types de données de base - PlayInfo.	e304b34fb3d959f92baef97b6496****
FileURL	string	L'URL du fichier OSS du flux transcodé.	http://outin-31059bcee7810a200163e1c8dba****.oss-cn-shanghai.aliyuncs.com/lesson-01.mp4
SourceURL	string	L'URL d'entrée du flux transcodé. Vous pouvez utiliser cette valeur comme paramètre de requête de l'opération GetURLUploadInfos.	https://example.com/lesson-01.mp4

Exemples

JSON format

{
  "RequestId": "7AE96389-DF1E-598D-816B-7B40F13B4620",
  "StreamJobId": "e304b34fb3d959f92baef97b6496****",
  "FileURL": "http://outin-31059bcee7810a200163e1c8dba****.oss-cn-shanghai.aliyuncs.com/lesson-01.mp4",
  "SourceURL": "https://example.com/lesson-01.mp4"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.