As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Modelo de chave de saída S3 para entrega do Amazon S3
<a name="data-delivery-s3-key-template"></a>

 Ao entregar para buckets do Amazon S3 de uso geral, você pode configurar um modelo de chave de saída do S3 para controlar a estrutura da chave de objeto dos arquivos entregues. O modelo de chave é opcional — se não for especificado, a entrega do Amazon S3 usa o modelo padrão. 

## Modelo padrão
<a name="data-delivery-s3-key-template-default"></a>

 Se você não especificar um modelo de chave personalizado, a entrega do Amazon S3 usará o seguinte padrão: 

```
kinesis-channel/!{channel-name}/!{channel-id}/!{yyyy}/!{MM}/!{dd}/!{HH}/!{channel-name}-!{channel-id}-!{yyyy}-!{MM}-!{dd}-!{HH}-!{mm}!{extension}
```

 A parte antes da última barra (`/`) forma o prefixo da chave do objeto (a estrutura da pasta) e o último segmento forma o nome do objeto. O modelo padrão organiza os objetos entregues por canal e por hora e repete os mesmos valores no nome do objeto para que cada objeto seja autodescritivo. O Amazon Kinesis Data Streams anexa automaticamente um sufixo exclusivo a cada chave de objeto, portanto, as chaves de objeto são exclusivas mesmo quando o modelo não inclui um componente de tempo suficiente para diferenciá-las. 

## Variáveis de modelo
<a name="data-delivery-s3-key-template-variables"></a>

 As variáveis a seguir estão disponíveis para uso em seu modelo de chave: 


**Variáveis de modelo principais do S3**  

| Variável | Description | Valor de exemplo | 
| --- | --- | --- | 
| \!{channel-name} | O nome da entrega. | my-channel | 
| \!{channel-id} | O identificador exclusivo da entrega. | abc123def456 | 
| \!{stream-name} | O nome do stream de origem do Kinesis Data Streams. | my-stream | 
| \!{yyyy} | Four-digit ano (UTC). | 2026 | 
| \!{yy} | Two-digit ano (UTC). | 26 | 
| \!{MM} | Two-digit mês (UTC), preenchido com zero. | 07 | 
| \!{dd} | Two-digit dia do mês (UTC), preenchido com zero. | 20 | 
| \!{HH} | Two-digit hora (UTC, 24 horas), preenchida com zero. | 14 | 
| \!{mm} | Two-digit minuto (UTC), preenchido com zero. | 30 | 
| \!{extension} | Uma extensão de arquivo derivada do tipo de compactação configurado (por exemplo, .gz para GZIP ou .zst ZSTD). Se estiver presente, ele deve aparecer no final do modelo. | .gz | 
| \!{extension:.{{literal}}} | Uma extensão de arquivo literal que você especifica. Deve começar com um ponto e conter somente letras minúsculas e pontos. Se estiver presente, ele deve aparecer no final do modelo. | \!{extension:.json} | 

## Regras de modelo
<a name="data-delivery-s3-key-template-rules"></a>

 Os modelos principais devem estar em conformidade com as seguintes regras: 
+ Depois que todas as variáveis forem expandidas, a chave de objeto resultante não deve exceder o limite de chave de objeto do Amazon S3 de 1.024 caracteres. Como o Amazon Kinesis Data Streams acrescenta um sufixo exclusivo de até 38 caracteres, o modelo expandido em si não deve exceder 986 caracteres.
+ Não deve conter travessia de caminho: nenhum ponto consecutivo (`..`), nenhum segmento de caminho somente de período (`.`) e não deve começar com uma barra (). `/`
+ Não deve conter barras consecutivas (`//`).
+ Cada espaço reservado para variável deve ser fechado (cada um `!{` deve ter uma correspondência`}`) e usar um nome de variável compatível.
+ Os caracteres literais permitidos são caracteres alfanuméricos e os seguintes:`! - _ ' . * ( ) / =`. O `=` caractere permite que você expresse o Hive-style particionamento, como. `year=!{yyyy}/month=!{MM}/`
+ O modelo pode conter no máximo um espaço reservado para extensão (`!{extension}`ou`!{extension:.{{literal}}}`) e, se estiver presente, deve aparecer no final do modelo.
+ Quando a compactação (GZIP ou ZSTD) está ativada, o modelo deve incluir um espaço reservado para a extensão.

**nota**  
 Você não precisa incluir uma variável de exclusividade no modelo. O Amazon Kinesis Data Streams anexa automaticamente um sufixo exclusivo a cada chave de objeto entregue. 

## Exemplos válidos e inválidos
<a name="data-delivery-s3-key-template-examples"></a>


**Principais exemplos de modelos**  

| Modelo | Válido | Motivo | 
| --- | --- | --- | 
| \!{channel-name}/\!{yyyy}/\!{MM}/\!{dd}/\!{HH}/records\!{extension} | Sim | Usa variáveis suportadas e termina com um único espaço reservado para extensão. | 
| data/stream=\!{stream-name}/\!{yyyy}-\!{MM}-\!{dd}/\!{HH}\!{mm}\!{extension:.json} | Sim | Hive-style particionamento com uma extensão literal no final. | 
| \!{channel-name}/\!{channel-id} | Sim | Modelo mínimo. O Kinesis Data Streams acrescenta automaticamente um sufixo exclusivo. | 
| /data/\!{channel-name}\!{extension} | Não | Começa com uma barra para frente. | 
| data/../\!{channel-name}\!{extension} | Não | Contém traversal de caminho ()... | 
| data//\!{channel-name}\!{extension} | Não | Contém barras consecutivas (//). | 
| \!{channel-name}\!{extension}/\!{yyyy} | Não | O espaço reservado para a extensão não está no final do modelo. | 
| data/\!{partition-id}\!{extension} | Não | \!{partition-id}não é uma variável suportada. | 
| data/\!{channel-name}(com compressão GZIP ou ZSTD) | Não | A compactação está ativada, mas o modelo não tem espaço reservado para extensão. | 
| data/\!{channel-name}/\!{yyyy}(sem chave de fechamento) | Não | Espaço reservado para variável não fechado. |