CreateUploadStream - - Centre de documentation Alibaba Cloud

Description de l'opération

Téléverser uniquement un flux multimédia local. Une fois le flux multimédia téléversé, il est associé à l'identifiant de la ressource multimédia spécifié.
Téléverser des flux multimédias uniquement vers ApsaraVideo VOD, et non vers vos propres compartiments Object Storage Service (OSS). Pour téléverser un flux multimédia vers votre propre compartiment OSS, vous pouvez téléverser le fichier vers votre compartiment OSS en utilisant le SDK OSS, puis appeler l'opération RegisterMediaStream pour associer le flux multimédia à l'identifiant de la ressource multimédia spécifié.
Cette opération n'est disponible que dans les régions Chine (Shanghai), Chine (Pékin) et Chine (Shenzhen).

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.

ice:CreateUploadStream

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
MediaId	string	Non	L'identifiant de la ressource multimédia.	**20b48fb04483915d4f2cd8ac**
Definition	string	Non	La qualité du flux multimédia. Valeurs valides : FD : définition faible. LD : définition standard. SD : haute définition. HD : ultra-haute définition. OD : qualité d'origine. 2K : résolution 2K. 4K : résolution 4K. SQ : qualité sonore standard. HQ : haute qualité sonore.	HD
FileExtension	string	Non	L'extension de fichier du flux multimédia.	MP4
HDRType	string	Non	Le format HDR (High Dynamic Range) du flux transcodé. Valeurs valides : HDR HDR10 HLG DolbyVision HDRVivid SDR+ Remarque La valeur n'est pas sensible à la casse. Vous pouvez laisser ce paramètre vide pour les flux non HDR.	HDR10
UserData	string	Non	Les données utilisateur.	{"MessageCallback":{"CallbackURL":"http://aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	****11-DB8D-4A9A-875B-275798****
MediaId	string	L'identifiant de la ressource multimédia.	**c469e944b5a856828dc2**
FileURL	string	L'URL Object Storage Service (OSS) du fichier. L'URL ne contient pas les informations utilisées pour l'authentification.	http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4
UploadAddress	string	L'URL de téléversement. Remarque L'URL de téléversement renvoyée est une URL encodée en Base64. Vous devez décoder l'URL de téléversement encodée en Base64 avant d'utiliser un SDK ou d'appeler une opération d'API pour téléverser des fichiers multimédias. Vous n'avez besoin d'analyser UploadAddress que si vous utilisez le SDK OSS ou appelez une opération d'API OSS pour téléverser des fichiers multimédias.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuth	string	Les informations d'identification de téléversement. Remarque Les informations d'identification de téléversement renvoyées sont une valeur encodée en Base64. Vous devez décoder les informations d'identification de téléversement encodées en Base64 avant d'utiliser un SDK ou d'appeler une opération d'API pour téléverser des fichiers multimédias. Vous n'avez besoin d'analyser UploadAuth que si vous utilisez le SDK OSS ou appelez une opération d'API OSS pour téléverser des fichiers multimédias.	eyJFbmRwb2ludCI6Imm****

Exemples

JSON format

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaId": "****c469e944b5a856828dc2****",
  "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.