Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione ed eliminazione mediante un comando batch
<a name="about-batch-update-schedule"></a>

Per creare ed eliminare operazioni nella pianificazione per un canale, utilizza il comando di pianificazione dell'aggiornamento in batch. Questo comando consente di eseguire più operazioni in una richiesta. Non esiste un comando per la creazione di operazioni e un altro per l'eliminazione di operazioni.

**Importante**  
Quando lavori con un canale avviato e in esecuzione, usa il **batch-update-schedule**comando per aggiungere o rimuovere azioni. Utilizzate il comando **delete-schedule** solo sui canali inattivi. Il comando **delete-schedule** eliminerà tutte le azioni pianificate e potrebbe causare interruzioni del servizio se utilizzato su un canale live. 

Puoi utilizzare il comando come riportato di seguito:
+ Invia una *singola* richiesta, ad esempio una richiesta per eseguire queste operazioni:
  + Creare un'operazione.
  + Eliminare un'operazione.
+ Invia una richiesta *batch*, ad esempio una richiesta per eseguire queste operazioni:
  + Creare diverse operazioni.
  + Eliminare diverse operazioni.
  + Creare una o più operazioni ed eliminare una o più operazioni.

**Importante**  
In un comando che combina operazioni di creazione ed eliminazione, le operazioni di eliminazione vengono *sempre* eseguite prima delle operazioni di creazione. Ciò significa che MediaLive rimuove le azioni di eliminazione dalla pianificazione prima di aggiungere le azioni di creazione alla pianificazione.

**Topics**
+ [

# Come funziona una richiesta batch
](how-batch-schedule-requests-work.md)
+ [

# Comando Batch in diverse interfacce
](batchupdatecommand-interfaces.md)
+ [

# Payload JSON in diverse interfacce
](batchupdatecommand-payloads.md)

# Come funziona una richiesta batch
<a name="how-batch-schedule-requests-work"></a>

L'intenzione del batch è quella di eseguire o meno tutte le operazioni contemporaneamente. Pertanto, AWS Elemental MediaLive convalida le azioni in batch insieme. MediaLive esegue la seguente convalida:
+ Assicura che ogni azione creata o eliminata abbia un'ora di inizio esplicita o implicita di almeno 15 secondi nel futuro. 
+ Se l'operazione si riferisce a un'operazione esistente nella pianificazione, la garanzia che il riferimento all'operazione esistente sia corretto. Ad esempio, un cambio di input di follow-up include un riferimento all'operazione che segue. Questa operazione deve esistere.

Se la convalida non riesce per una qualsiasi operazione, non riesce per tutte le operazioni del batch.

Se non vuoi che le operazioni abbiano tutte insieme lo stesso esito positivo o negativo, non impostare un batch. Al contrario, crea ogni operazione nel suo comando di pianificazione dell'aggiornamento in batch.

Se la convalida ha esito positivo, MediaLive elabora tutte le richieste di eliminazione prima delle richieste di creazione, indipendentemente dagli orari di inizio delle azioni.

**Esempio 1**  
Un uso importante del batching consiste nell'eseguire diverse azioni che devono avere esito positivo o negativo contemporaneamente. Ad esempio, supponiamo di voler rimuovere il logo aziendale e inserire immediatamente uno splice\$1insert (per poter usufruire di una disponibilità pubblicità). A tale scopo, è necessario creare un'operazione per rimuovere il logo e un'altra operazione per inserire splice\$1insert. Tuttavia, non è necessario inserire l'azione MediaLive di rimozione se l'azione splice\$1insert fallisce o viceversa. È preferibile che entrambe le operazioni non riescano perché ciò consente di correggere l'operazione con formato errato e quindi inviare nuovamente entrambe le operazioni.

Pertanto, invia le due operazioni insieme, in un unico comando di pianificazione dell'aggiornamento in batch. 

**Esempio 2**  
Un altro importante uso del batch è quello di correggere un errore in un'operazione nella pianificazione. Ad esempio, potresti voler correggere una sovrapposizione dell'immagine che non è ancora stata avviata e che è stata creata con un orario di inizio sbagliato. A tale scopo, invia un comando di pianificazione dell'aggiornamento in batch con JSON contenente quanto segue:
+ Un payload per rimuovere l'operazione originale per attivare la sovrapposizione dell'immagine. Questa operazione ha l'ora di inizio errata.
+ Un payload per aggiungere una nuova operazione per attivare la stessa sovrapposizione dell'immagine. Questa operazione ha l'ora di inizio corretta.

# Comando Batch in diverse interfacce
<a name="batchupdatecommand-interfaces"></a>

Il comando di pianificazione dell'aggiornamento in batch è rappresentato in modo diverso in diverse interfacce: 
+ Nel AWS CLI, il comando è`batch-update-schedule`.
+ Nell'API, il comando è rappresentato da un `HTTP PUT` su `channels/channelId/schedule`.
+ In AWS SDKs, il comando è rappresentato da costrutti adatti a quel linguaggio SDK.

# Payload JSON in diverse interfacce
<a name="batchupdatecommand-payloads"></a>

Il payload JSON per il comando è diverso per le diverse interfacce:
+ In AWS CLI, il contenuto del payload dipende da come si utilizza il comando:
  + Puoi immettere un comando con due parametri: `channel-id` e `--cli-input-json`. In questo caso, crea un file che ripete l'ID del canale e include il payload JSON. 
  + Puoi immettere un comando con tre parametri: uno per l'ID canale, uno per il payload JSON per le operazioni di creazione (se applicabile) e uno per il payload JSON per le operazioni di eliminazione (se applicabile). I payload vengono passati nel comando. Se entrambi i parametri sono presenti, ogni parametro richiede un payload separato. Tuttavia, i due payload vengono convalidati ed eseguiti come batch. 

  Il payload per il case AWS CLI è sempre pascal (upper camel case). 
+ Nell'API è presente un payload con due sezioni, una sezione `CREATES` e una sezione `DELETES`. Una richiesta può contenere una o entrambe le sezioni. 

  Il payload per l'API utilizza sempre il Camel Case per i nomi delle variabili e lo stile Pascal per le classi.
+ Nel AWS SDKs, il payload JSON è rappresentato da costrutti adatti a quel linguaggio SDK. 

Per acquisire maggiore familiarità con le singole azioni, ti consigliamo di utilizzare la MediaLive console per creare un'azione. Dopo aver creato l'azione, utilizza il [DescribeSchedule](viewing-schedule-using-cli.md)comando nell'interfaccia appropriata (ad esempio, AWS CLI o un SDK) per ottenere il payload JSON non elaborato per l'intera pianificazione. Puoi copiare singole operazioni e salvarle come modelli da utilizzare quando lavori a livello di programmazione.