> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-revert-104359-revert-104251-parquet-single.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Como criar um usuário do IAM da AWS e um bucket do S3

> Como criar um usuário do IAM da AWS e um bucket do S3.

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> Este guia mostra como configurar um usuário do IAM da AWS e um bucket do S3 na AWS,
> uma etapa prévia necessária para fazer backups no S3 ou configurar o ClickHouse para
> armazenar dados no S3

<div id="create-an-aws-iam-user">
  ## Criar um usuário do IAM da AWS
</div>

Neste procedimento, vamos criar um usuário para uma conta de serviço, não um usuário de login.

1. Faça login no Console de Gerenciamento do AWS IAM.

2. Na guia `Users`, selecione `Create user`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-1.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=97e23c0fcab454432e586eabb68627da" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1940" data-path="images/_snippets/s3/2025/s3-1.webp" />

3. Insira um nome de usuário

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-2.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=a6281569eed2825164c98f86414b10f6" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1408" data-path="images/_snippets/s3/2025/s3-2.webp" />

4. Selecione `Next`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-3.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=e1788d31d59cd33dd9a0ddde557182bb" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1860" data-path="images/_snippets/s3/2025/s3-3.webp" />

5. Selecione `Next`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-4.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=5a51aba134d1ce9bd09f17da172614df" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1850" data-path="images/_snippets/s3/2025/s3-4.webp" />

6. Selecione `Create user`

O usuário foi criado.
Clique no usuário recém-criado

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-5.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=5bf2faecd71fdd7760f5ffbc833035f4" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="792" data-path="images/_snippets/s3/2025/s3-5.webp" />

7. Selecione `Create access key`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-6.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=91b9b5cd843e941f856ad2143f56807f" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1900" data-path="images/_snippets/s3/2025/s3-6.webp" />

8. Selecione `Application running outside AWS`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-7.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=28ad0465527cf9426b4e6e6a1d3ee8c4" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1942" data-path="images/_snippets/s3/2025/s3-7.webp" />

9. Selecione `Create access key`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-8.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=d1f440c17ba5790f008d5578a0a278ec" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1080" data-path="images/_snippets/s3/2025/s3-8.webp" />

10. Baixe sua chave de acesso e a chave secreta como um arquivo .csv para usar mais tarde

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-9.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=d8701d019b17c7afb38e9301fb5e6919" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="3912" height="2036" data-path="images/_snippets/s3/2025/s3-9.webp" />

<div id="create-an-s3-bucket">
  ## Criar um bucket do S3
</div>

1. Na seção de bucket do S3, selecione **Create bucket**

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-10.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=a0949a26205b4228d3a5d8edeab00f5d" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="2518" data-path="images/_snippets/s3/2025/s3-10.webp" />

2. Insira um nome para o bucket e deixe as demais opções com os valores padrão

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-11.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=aee63edfeb2c4f9a213c0fdeb660353d" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1118" data-path="images/_snippets/s3/2025/s3-11.webp" />

<Note>
  O nome do bucket deve ser exclusivo em toda a AWS, não apenas na sua organização, ou ocorrerá um erro.
</Note>

3. Deixe `Block all Public Access` enabled; o acesso público não é necessário.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-12.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=ada7512dfe392378334a15fad4b462e7" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1106" data-path="images/_snippets/s3/2025/s3-12.webp" />

4. Selecione **Create Bucket** na parte inferior da página

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-13.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=ff1bc23955538df735e79103d51054b4" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1872" data-path="images/_snippets/s3/2025/s3-13.webp" />

5. Selecione o link, copie o ARN e salve-o para usar ao configurar a política de acesso do bucket

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-14.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=82e3c9cfa533c99431d20ab921ded420" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="934" data-path="images/_snippets/s3/2025/s3-14.webp" />

6. Depois que o bucket for criado, localize o novo bucket do S3 na lista de buckets do S3 e selecione o nome dele; isso levará você à página mostrada abaixo:

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-15.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=fe549f6e29cb485a1f6bfb2a41878b9f" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1400" data-path="images/_snippets/s3/2025/s3-15.webp" />

7. Selecione `Create folder`

8. Insira um nome de pasta que será o destino do disco S3 ou do backup do ClickHouse e selecione `Create folder` na parte inferior da página

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-16.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=595b13ecca469fe8e913b5cfff513338" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="3992" height="1352" data-path="images/_snippets/s3/2025/s3-16.webp" />

9. A pasta agora deve estar visível na lista do bucket

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-17.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=69790de071ff530935498c7736a310c4" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="1330" data-path="images/_snippets/s3/2025/s3-17.webp" />

10. Marque a caixa de seleção da nova pasta e clique em `Copy URL`. Salve a URL para usar na configuração de armazenamento do ClickHouse na próxima seção.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-18.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=c40d9c60605399a26311f233bfb72cc6" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="992" data-path="images/_snippets/s3/2025/s3-18.webp" />

11. Selecione a guia **Permissions** e clique no botão **Edit** na seção **Bucket Policy**

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/TDqdecUP67s0OrmN/images/_snippets/s3/2025/s3-19.webp?fit=max&auto=format&n=TDqdecUP67s0OrmN&q=85&s=8db667a0089e26ee0aa00e4f744a044e" alt="Console de Gerenciamento do AWS IAM - Adicionando um novo usuário" width="4040" height="954" data-path="images/_snippets/s3/2025/s3-19.webp" />

12. Adicione uma política de bucket, conforme o exemplo abaixo

```json theme={null}
{
    "Version": "2012-10-17",
    "Id": "Policy123456",
    "Statement": [
        {
            "Sid": "abc123",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::782985192762:user/docs-s3-user"
            },
            "Action": "s3:*",
            "Resource": [
                "arn:aws:s3:::ch-docs-s3-bucket",
                "arn:aws:s3:::ch-docs-s3-bucket/*"
            ]
        }
    ]
}
```

<Note>
  A política acima permite executar todas as ações no bucket
</Note>

| Parâmetro | Descrição                                                 | Valor de exemplo                                                      |
| --------- | --------------------------------------------------------- | --------------------------------------------------------------------- |
| Version   | Versão do interpretador de políticas, deixe como está     | 2012-10-17                                                            |
| Sid       | ID da política definido pelo usuário                      | abc123                                                                |
| Effect    | Se as solicitações do usuário serão permitidas ou negadas | Allow                                                                 |
| Principal | A conta ou o usuário que terá permissão                   | arn:aws:iam::782985192762:user/docs-s3-user                           |
| Action    | Quais operações são permitidas no bucket                  | s3:\*                                                                 |
| Resource  | Em quais recursos do bucket as operações serão permitidas | "arn:aws:s3:::ch-docs-s3-bucket", "arn:aws:s3:::ch-docs-s3-bucket/\*" |

<Note>
  Você deve trabalhar com sua equipe de segurança para determinar quais permissões usar; considere estas como um ponto de partida.
  Para mais informações sobre políticas e configurações, consulte a documentação da AWS:
  [https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html)
</Note>

13. Salve a configuração da política
