Met à jour l'état de publication d'un fichier multimédia.
Notes d'utilisation
L'état « publié » indique que la liste de contrôle d'accès (ACL) des ressources de lecture multimédia et des fichiers de capture d'écran hérite de l'ACL du bucket auquel ils appartiennent. L'état « non publié » signifie que l'ACL de ces ressources est définie sur « privée ».
Limite de QPS
Vous pouvez appeler cette opération jusqu'à 100 fois par seconde par compte. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation (throttling) se déclenche et peut affecter votre activité. Tenez compte de cette limite lorsque vous appelez cette opération. Pour plus d'informations, consultez la rubrique Limites de QPS.
Débogage
Paramètres de requête
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | UpdateMediaPublishState | Opération à effectuer. Définissez la valeur sur UpdateMediaPublishState. |
| MediaId | String | Yes | 3e6149d5a8c944c09b1a8d2dc3e4**** | ID du fichier multimédia dont vous souhaitez mettre à jour l'état de publication. Pour obtenir l'ID d'un fichier multimédia, appelez l'opération AddMedia. Vous pouvez également procéder comme suit dans la console MPS : dans le volet de navigation de gauche, choisissez Media Management > Media List. Recherchez la vidéo concernée et cliquez sur Manage. L'ID de la vidéo s'affiche dans l'onglet Basics. |
| Publish | Boolean | No | true | État de publication. Valeur par défaut : Initialed. Valeurs possibles :
|
État de publication par défaut d'un fichier multimédia et règles de changement d'état
État de publication par défaut :
L'état de publication par défaut d'un fichier multimédia est Initialed. Les deux types de fichiers multimédias suivants sont à l'état Initialed :
Nouveau fichier multimédia : lorsqu'un fichier multimédia est généré pour la première fois (déclenchement initial d'un workflow multimédia) et que l'exécution du workflow est en cours, le fichier se trouve à l'état Initialed. Une fois l'exécution du workflow multimédia terminée, l'état du fichier devient « publié » ou « non publié » selon la configuration du workflow.
Fichier multimédia supprimé : après la suppression d'un fichier multimédia, l'état de publication n'a plus de sens et le fichier passe à l'état Initialed. Si vous restaurez le fichier supprimé dans la bibliothèque multimédia, exécutez un workflow sur ce fichier comme s'il s'agissait d'un nouveau fichier.
Règles de changement d'état
L'état de publication change entre les états Initialed, publié et non publié. Les règles de changement d'état diffèrent selon que la modification est effectuée via l'API ou via l'exécution d'un workflow.
|
Caller |
Current state |
Changed status |
Allowed |
|
API |
Initialed |
Published |
No |
|
API |
Initialed |
Unpublished |
No |
|
API |
Published |
Unpublished |
Yes |
|
API |
Unpublished |
Published |
Yes |
|
Workflow execution |
Initialed |
Published |
Yes |
|
Workflow execution |
Initialed |
Unpublished |
Yes |
|
Workflow execution |
Published |
Unpublished |
No |
|
Workflow execution |
Unpublished |
Published |
No |
Paramètres de réponse
|
Parameter |
Type |
Example |
Description |
|
RequestId |
String |
91B6CAB9-034C-4E4E-A40B-E7F5C81E688C |
ID de la requête. |
Exemples
Exemple de requête
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMediaPublishState
&MediaId=3e6149d5a8c944c09b1a8d2dc3e4****
&Publish=true
&<Common request parameters>Exemple de réponse en cas de succès
Format XML
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateMediaPublishStateResponse>
<RequestId>91B6CAB9-034C-4E4E-A40B-E7F5C81E688C</RequestId>
</UpdateMediaPublishStateResponse>Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "91B6CAB9-034C-4E4E-A40B-E7F5C81E688C"
}Codes d'erreur
Pour une liste des codes d'erreur, visitez le Centre d'erreurs de l'API.