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

# S3
<a name="s3-rule-action"></a>

A ação S3 (`s3`) grava os dados de uma mensagem MQTT em um bucket do Amazon Simple Storage Service (Amazon S3). 

## Requisitos
<a name="s3-rule-action-requirements"></a>

Esta ação de regra tem os seguintes requisitos:
+ Uma função do IAM que AWS IoT você pode assumir para realizar a `s3:PutObject` operação. Para obter mais informações, consulte [Conceder a uma AWS IoT regra o acesso que ela exige](iot-create-role.md).

  No AWS IoT console, você pode escolher ou criar uma função para permitir AWS IoT a execução dessa ação de regra.
+ Se você usa um AWS KMS cliente gerenciado AWS KMS key para criptografar dados em repouso no Amazon S3, o serviço deve ter permissão para usar o AWS KMS key em nome do chamador. Para obter mais informações, consulte [AWS gerenciado AWS KMS keys e gerenciado pelo cliente AWS KMS keys](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html#aws-managed-customer-managed-cmks) no *Guia do desenvolvedor do Amazon Simple Storage Service*.

## Parâmetros
<a name="s3-rule-action-parameters"></a>

Ao criar uma AWS IoT regra com essa ação, você deve especificar as seguintes informações:

`bucket`  
O bucket do Amazon S3 no qual gravar dados.  
Suporta [modelos de substituição](iot-substitution-templates.md): API e somente AWS CLI 

`cannedacl`  
(Opcional) A ACL predefinida do Amazon S3 que controla o acesso ao objeto identificado pela chave do objeto. Para obter mais informações, inclusive os valores permitidos, consulte [ACL predefinida](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl).   
Compatível com [modelos de substituição](iot-substitution-templates.md): Não

`key`  
O caminho para o arquivo em que os dados são gravados.  
Considere um exemplo em que esse parâmetro está `${topic()}/${timestamp()}` e a regra recebe uma mensagem em que o tópico está `some/topic`. Se o carimbo de data/hora atual for `1460685389`, essa ação grava os dados em um arquivo chamado `1460685389` na `some/topic` pasta do bucket do S3.  
Se você usar uma chave estática, AWS IoT substituirá um único arquivo sempre que a regra for invocada. Recomendamos que você use o carimbo de data/hora da mensagem ou outro identificador exclusivo de mensagem para que um novo arquivo seja salvo no Amazon S3 para cada mensagem recebida.
Compatível com [modelos de substituição](iot-substitution-templates.md): Sim

`roleArn`  
O perfil do IAM que permite o acesso ao bucket do Amazon S3. Para obter mais informações, consulte [Requisitos](#s3-rule-action-requirements).  
Compatível com [modelos de substituição](iot-substitution-templates.md): Não

## Exemplos
<a name="s3-rule-action-examples"></a>

O exemplo de JSON a seguir define uma ação do S3 em uma AWS IoT regra.

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "s3": {
                    "bucketName": "amzn-s3-demo-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}
```

## Consulte também
<a name="s3-rule-action-see-also"></a>
+ [O que é o Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) no *Guia do usuário do Amazon Simple Storage Service*