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à.

# Regole
<a name="msk-data-delivery-s3-template-rules"></a>

Se fornisci un modello, questo deve soddisfare tutti i seguenti requisiti.

## Struttura
<a name="msk-data-delivery-s3-template-rules-structure"></a>
+ **Lunghezza**: al massimo 1024 caratteri. Inoltre, la lunghezza del prefisso di output più la lunghezza del modello devono essere al massimo di 1024 caratteri (vengono concatenati nella chiave finale).
+ **Nessun percorso**: non deve contenere `..` o `./` e non deve iniziare con. `/`
+ **Non deve terminare con `/`**: la chiave deve risolversi in un oggetto, non in un confine di directory.
+ **Variabili bilanciate**: ognuna `!{` deve avere una corrispondenza`}`.
+ **Valori letterali consentiti**: i caratteri esterni `!{...}` devono corrispondere `[a-zA-Z0-9/_\-.+=]` (alfanumerici,,,,`/`, `_``-`,`.`). `+` `=` Gli spazi non sono consentiti.

## Variabili
<a name="msk-data-delivery-s3-template-rules-variables"></a>
+ **Solo nomi noti**: solo le variabili supportate sono valide; qualsiasi altra variabile viene rifiutata.
+ **Almeno una variabile**: un modello di soli valori letterali viene rifiutato.
+ **Esattamente un token di unicità**: deve contenere uno `!{sequence-number}` o più`!{kafka-offset}`, ma non entrambi (si escludono a vicenda).
+ **`kafka-offset`richiede `partition-id`**: se si utilizza`!{kafka-offset}`, il modello deve contenere anche. `!{partition-id}`
+ **Posizionamento del token di unicità**: il token (`!{sequence-number}`o`!{kafka-offset}`) scelto deve apparire nell'ultimo segmento `/` separato, in modo che ogni oggetto consegnato riceva una chiave distinta.

**Nota**  
**Perché è necessario un token di unicità: ** il canale scrive più record in ogni oggetto S3 (un batch), in modo che il token identifichi l'oggetto, non un singolo record. `!{sequence-number}`è un numero di batch monotono per oggetto; `!{kafka-offset}` è l'offset di Kafka del primo record dell'oggetto. Il modello richiede esattamente uno di questi token nel segmento finale del percorso in modo che ogni oggetto consegnato riceva una chiave distinta e gli oggetti non vengano sovrascritti.