Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création et suppression à l'aide d'une commande par lots
<a name="about-batch-update-schedule"></a>

Pour créer et supprimer des actions dans la planification d'un canal, vous utilisez la commande de planification de mise à jour par lot. Cette commande vous permet d'effectuer plusieurs actions dans une seule demande. Il n'existe pas de commande pour créer des actions et une autre pour supprimer des actions.

**Important**  
Lorsque vous travaillez avec un canal démarré et en cours d'exécution, utilisez la **batch-update-schedule**commande pour ajouter ou supprimer des actions. Utilisez la commande **delete-schedule** uniquement sur les canaux inactifs. La commande **delete-schedule** supprime toutes les actions planifiées et peut entraîner des interruptions de service si elle est utilisée sur une chaîne en direct. 

Vous pouvez utiliser la commande de la manière suivante :
+ Envoyez une *seule* demande, par exemple une demande pour effectuer les opérations suivantes :
  + Créer une action.
  + Supprimer une action.
+ Envoyez une demande de *traitement par lot*, par exemple une demande pour effectuer les opérations suivantes :
  + Créer plusieurs actions.
  + Supprimer plusieurs actions.
  + Créer une ou plusieurs actions et supprimer une ou plusieurs actions.

**Important**  
Dans une commande qui combine des actions de création et des actions de suppression, les actions de suppression sont *toujours* effectuées avant les actions de création. Cela signifie que MediaLive les actions de suppression sont supprimées du calendrier avant d'ajouter les actions de création au calendrier.

**Topics**
+ [Comment fonctionne une demande par lots](how-batch-schedule-requests-work.md)
+ [Commande Batch dans différentes interfaces](batchupdatecommand-interfaces.md)
+ [Charge utile JSON dans différentes interfaces](batchupdatecommand-payloads.md)

# Comment fonctionne une demande par lots
<a name="how-batch-schedule-requests-work"></a>

L'intérêt du traitement par lot consiste à faire réussir ou faire échouer toutes les actions ensemble. Par conséquent, AWS Elemental MediaLive valide les actions par lots ensemble. MediaLive effectue la validation suivante :
+ Cela garantit que chaque action créée ou supprimée a une heure de début explicite ou implicite d'au moins 15 secondes dans le futur. 
+ que la référence à une action existante est correcte, si l'action fait référence à une action existante dans la planification. Par exemple, un changement d'entrée de suivi inclut une référence à l'action qu'il suit. Cette action doit exister.

Si la validation échoue pour une action, elle échoue pour toutes les actions du lot.

Si vous ne souhaitez pas que les actions réussissent ou échouent ensemble, ne configurez pas de lot. Dans ce cas, créez chaque action dans sa propre commande de planification de mise à jour par lot.

Si la validation aboutit, MediaLive traite toutes les demandes de suppression avant les demandes de création, quelle que soit l'heure de début des actions.

**Exemple 1**  
Une utilisation importante du traitement par lots consiste à effectuer plusieurs actions qui doivent réussir ou échouer ensemble. Supposons par exemple que vous souhaitiez supprimer le logo de l'entreprise et insérer immédiatement un splice\$1insert (pour diriger vers une diffusion de publicités). Pour cela, vous devez créer une action pour supprimer le logo et une autre action pour insérer le splice\$1insert. Toutefois, vous ne MediaLive souhaitez pas insérer l'action de suppression si l'action splice\$1insert échoue, ou vice versa. Il est préférable que les deux actions échouent, car l'action incorrecte est alors plus facile à corriger. Vous soumettez ensuite à nouveau les deux actions.

Vous soumettez donc les deux actions ensemble, dans une commande de planification de mise à jour par lot. 

**Exemple 2**  
L'utilisation des lots représente également un réel intérêt pour corriger une erreur dans une action de la planification. Par exemple, si vous souhaitez corriger une superposition d'image qui n'a pas encore démarré et dont l'heure de début n'est pas correcte. Pour ce faire, vous soumettez une commande de planification de mise à jour par lot avec JSON qui contient les éléments suivants :
+ Une charge utile pour supprimer l'action d'origine pour d'activation de la superposition d'image. Cette action comporte la date de début incorrecte.
+ Une charge utile pour ajouter une nouvelle action d'activation de la même superposition d'image. Cette action comporte l'heure de début correcte.

# Commande Batch dans différentes interfaces
<a name="batchupdatecommand-interfaces"></a>

La commande de planification de mise à jour par lot est représentée différemment dans chaque interface : 
+ Dans le AWS CLI, la commande est`batch-update-schedule`.
+ Dans l'API, la commande est représentée par un `HTTP PUT` sur `channels/channelId/schedule`.
+ Dans le AWS SDKs, la commande est représentée par des constructions adaptées à ce langage du SDK.

# Charge utile JSON dans différentes interfaces
<a name="batchupdatecommand-payloads"></a>

La charge utile JSON de la commande est différente dans chaque interface :
+ Dans le AWS CLI, le contenu de la charge utile dépend de la façon dont vous utilisez la commande :
  + Vous pouvez entrer une commande avec deux paramètres : `channel-id` et `--cli-input-json`. Dans ce cas, vous créez un fichier qui répète l'ID de canal et inclut la charge utile JSON. 
  + Vous pouvez entrer une commande avec trois paramètres : un pour l'ID de canal, un pour la charge utile JSON pour les actions de création (le cas échéant) et un pour la charge utile JSON pour les actions de suppression (le cas échéant). Vous transmettez les charges utiles dans la commande. Si les deux paramètres sont présents, chaque paramètre prend une charge utile distincte. Cependant, les deux charges utiles sont validées et exécutées en tant que lot. 

  La charge utile du boîtier AWS CLI est toujours Pascal (étui supérieur en forme de chameau). 
+ Dans l'API, il existe une charge utile avec deux sections, une section `CREATES` et une section `DELETES`. Une demande peut contenir une section ou les deux. 

  La charge utile de l'API utilise toujours une casse mixte pour les noms de variables et une notation Pascal pour les classes.
+ Dans le AWS SDKs, la charge utile JSON est représentée par des constructions adaptées à ce langage du SDK. 

Pour vous familiariser avec les actions individuelles, nous vous recommandons d'utiliser la MediaLive console pour créer une action. Après avoir créé l'action, utilisez la [DescribeSchedule](viewing-schedule-using-cli.md)commande dans l'interface appropriée (par exemple, le AWS CLI ou un SDK) pour obtenir la charge utile JSON brute pour l'ensemble du planning. Vous pouvez alors copier des actions individuelles et les enregistrer en tant que modèles qui vous serviront lorsque vous travaillerez par programmation.