UpdateMedia - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Les informations de base que vous pouvez mettre à jour en appelant cette opération incluent le titre, la description et la catégorie du fichier multimédia. Cette opération effectue une mise à jour complète. Vous devez définir tous les paramètres, sauf si vous souhaitez remplacer la valeur d'un paramètre spécifique par une valeur NULL.

Limites de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation du débit (throttling) est déclenché, ce qui peut affecter votre activité. Nous vous recommandons de prendre en compte cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limites de QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	UpdateMedia	L'opération que vous souhaitez effectuer. Définissez la valeur sur UpdateMedia.
MediaId	String	Yes	3e1cd21131a94525be55acf65888****	L'ID du fichier multimédia dont vous souhaitez mettre à jour les informations de base. Pour obtenir l'ID du fichier multimédia, connectez-vous à la ApsaraVideo Media Processing (MPS) console et choisissez Media Management > Media List dans le volet de navigation de gauche.
Title	String	No	hello	Le titre du fichier multimédia. Plusieurs types de caractères, tels que les lettres et les chiffres, sont pris en charge. Si vous ne spécifiez pas ce paramètre, la valeur est NULL. La valeur est encodée en UTF-8 et peut atteindre 128 octets.
Description	String	No	example description	La description du fichier multimédia. Plusieurs types de caractères, tels que les lettres et les chiffres, sont pris en charge. Si vous ne spécifiez pas ce paramètre, la valeur est NULL. La valeur est encodée en UTF-8 et peut atteindre 1 024 octets.
CoverURL	String	No	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/test**.jpg	L'emplacement de stockage de la vignette que vous souhaitez spécifier pour le fichier multimédia. Pour obtenir l'URL, connectez-vous à la MPS console et choisissez Workflows > Media Buckets. Vous pouvez également vous connecter à la Object Storage Service (OSS) console et cliquez sur My OSS Paths. La valeur peut atteindre 3 200 octets. L'URL est conforme à la norme RFC 2396 et est encodée en UTF-8, les caractères réservés étant codés en pourcentage.
CateId	Long	No	1	L'ID de la catégorie à laquelle appartient le fichier multimédia. La valeur doit être un entier. Si vous ne spécifiez pas ce paramètre, la valeur est NULL. La valeur ne peut pas être négative.
Tags	String	No	tag1,tag2	Les tags que vous souhaitez ajouter au fichier multimédia. Séparez plusieurs tags par des virgules (,). Vous pouvez spécifier jusqu'à 16 tags pour un fichier multimédia. Chaque tag peut atteindre 32 octets. La valeur est encodée en UTF-8.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	6A88246F-C91F-42BD-BABE-DB0DF993F960	L'ID de la requête.
Media	Object		Les informations détaillées sur le fichier multimédia.
CreationTime	String	2016-09-14T08:30:33Z	L'heure de création du fichier multimédia.
CateId	Long	1	L'ID de la catégorie à laquelle appartient le fichier multimédia.
Height	String	1080	La hauteur du fichier multimédia.
CensorState	String	Initiated	Le statut de modération de la vidéo. Valeurs valides : Initiated : Le fichier multimédia est téléchargé mais n'a pas été modéré. Pass : Le fichier multimédia est téléchargé et a passé la modération avec succès.
Tags	Array of String	tag1,tag2	Les tags du fichier multimédia.
Bitrate	String	2659.326	Le débit binaire du fichier multimédia.
MediaId	String	3e1cd21131a94525be55acf65888****	L'ID du fichier multimédia.
File	Object		Les informations sur le fichier d'entrée.
State	String	Normal	Le statut du fichier d'entrée. Valeurs valides : Normal : Le fichier d'entrée est normal. Deleted : Le fichier d'entrée est supprimé.
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4	L'URL du fichier d'entrée.
PublishState	String	Published	Le statut de publication du fichier multimédia. Valeurs valides : Initiated : Le fichier multimédia est à l'état initial. UnPublish : Le fichier multimédia n'a pas été publié et l'autorisation de lecture sur l'objet OSS est Private. Published : Le fichier multimédia a été publié et l'autorisation de lecture sur l'objet OSS est Default. Deleted : Le fichier multimédia est supprimé.
Description	String	example description	La description du fichier multimédia.
Width	String	1920	La largeur du fichier multimédia.
Size	String	2647692	La taille du fichier multimédia.
CoverURL	String	http://example-bucket-**.oss-cn-shanghai.aliyuncs.com/example-**.jpg	L'emplacement de stockage de la vignette multimédia.
RunIdList	Array of String	null	Les ID des instances d'exécution du workflow multimédia.
Duration	String	7.965000	La durée du fichier multimédia.
Fps	String	25.0	La fréquence d'images du fichier multimédia.
Title	String	hello	Le titre du fichier multimédia.
Format	String	mov	Le format du fichier multimédia. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.

Exemples

Exemple de requête

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMedia
&MediaId=3e1cd21131a94525be55acf65888****
&Title=hello
&Description=example description
&CoverURL=http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg
&CateId=1
&Tags=tag1,tag2
&<Common request parameters>

Exemple de réponse réussie

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateMediaResponse>
    <RequestId>6A88246F-C91F-42BD-BABE-DB0DF993F960</RequestId>
    <Media>
        <CreationTime>2016-09-14T08:30:33Z</CreationTime>
        <CateId>1</CateId>
        <Height>1080</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <Bitrate>2659.326</Bitrate>
        <MediaId>3e1cd21131a94525be55acf65888****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <PublishState>Published</PublishState>
        <Description>example description</Description>
        <Width>1920</Width>
        <Size>2647692</Size>
        <CoverURL>http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg</CoverURL>
        <RunIdList>{"RunId":["47b42486019c4f688bf144c1a6ba****"]}</RunIdList>
        <Duration>7.965000</Duration>
        <Fps>25.0</Fps>
        <Title>hello</Title>
        <Format>mov</Format>
    </Media>
</UpdateMediaResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "6A88246F-C91F-42BD-BABE-DB0DF993F960",
  "Media" : {
    "CreationTime" : "2016-09-14T08:30:33Z",
    "CateId" : 1,
    "Height" : "1080",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "Bitrate" : "2659.326",
    "MediaId" : "3e1cd21131a94525be55acf65888****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "PublishState" : "Published",
    "Description" : "example description",
    "Width" : "1920",
    "Size" : "2647692",
    "CoverURL" : "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg",
    "RunIdList" : [ "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}" ],
    "Duration" : "7.965000",
    "Fps" : "25.0",
    "Title" : "hello",
    "Format" : "mov"
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.