# Conceitos básicos do Amazon S3 on Outposts
Com o Amazon S3 on Outposts, é possível criar buckets do S3 no AWS Outposts, além de armazenar e recuperar facilmente objetos no local para aplicações que exigem acesso a dados locais, processamento de dados local e residência de dados. O S3 on Outposts fornece uma nova classe de armazenamento, o S3 Outposts (`OUTPOSTS`), que usa as APIs do Amazon S3 e é projetado para armazenar dados de forma duradoura e redundante em vários dispositivos e servidores em seu AWS Outposts. Você se comunica com o bucket do Outposts usando um ponto de acesso e uma conexão de endpoint em uma nuvem privada virtual (VPC). É possível usar os mesmos recursos e APIs nos buckets do Outposts da mesma maneira que em buckets do Amazon S3, incluindo políticas de acesso, criptografia e marcação. Só é possível usar o S3 on Outposts por meio do Console de gerenciamento da AWS, da AWS Command Line Interface (AWS CLI), de AWS SDKs ou da API REST.
Com o Amazon S3 on Outposts, você pode usar as APIs e recursos do Amazon S3, como armazenamento de objetos, políticas de acesso, criptografia e marcação, no AWS Outposts da mesma forma que no Amazon S3. Para obter informações sobre o S3 on Outposts, consulte [O que é o Amazon S3 on Outposts?](S3onOutposts.md).
**Topics**
+ [Conceitos básicos do uso do Console de gerenciamento da AWS](S3OutpostsGSConsole.md)
+ [Como começar a usar a AWS CLI e o SDK para Java](S3OutpostsGSCLIJava.md)
# Conceitos básicos do uso do Console de gerenciamento da AWS
Com o Amazon S3 on Outposts, é possível criar buckets do S3 no AWS Outposts, além de armazenar e recuperar facilmente objetos no local para aplicações que exigem acesso a dados locais, processamento de dados local e residência de dados. O S3 on Outposts fornece uma nova classe de armazenamento, o S3 Outposts (`OUTPOSTS`), que usa as APIs do Amazon S3 e é projetado para armazenar dados de forma duradoura e redundante em vários dispositivos e servidores em seu AWS Outposts. Você se comunica com o bucket do Outposts usando um ponto de acesso e uma conexão de endpoint em uma nuvem privada virtual (VPC). É possível usar os mesmos recursos e APIs nos buckets do Outposts da mesma maneira que em buckets do Amazon S3, incluindo políticas de acesso, criptografia e marcação. Só é possível usar o S3 on Outposts por meio do Console de gerenciamento da AWS, da AWS Command Line Interface (AWS CLI), de AWS SDKs ou da API REST. Para obter mais informações, consulte [O que é o Amazon S3 on Outposts?](S3onOutposts.md)
Para começar a usar o S3 on Outposts utilizando o console, consulte os tópicos a seguir. Para começar a usar a AWS CLI ou o AWS SDK para Java, consulte.
**Topics**
+ [Criar um bucket, um ponto de acesso e um endpoint](#S3OutpostsGSConsoleCreateBucket)
+ [Próximas etapas](#S3OutpostsGSConsoleNext)
## Criar um bucket, um ponto de acesso e um endpoint
O procedimento a seguir mostra como criar seu primeiro bucket no S3 on Outposts. Ao criar um bucket pela primeira vez usando o console, você também cria um ponto de acesso e um endpoint associados ao bucket para que possa começar a armazenar objetos no bucket imediatamente.
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Outposts buckets** (Buckets do Outposts).
1. Escolha **Create Outposts bucket (Criar bucket do Outposts)**.
1. Em **Bucket name** (Nome do bucket), insira um nome compatível com o Sistema de Nome de Domínio (DNS) para seu bucket.
O nome do bucket deve:
+ Ser único dentro da Conta da AWS, do Outpost e da Região da AWS na qual o Outpost está alojado.
+ Ter entre 3 e 63 caracteres.
+ Não contém caracteres maiúsculos.
+ Começar com uma letra minúscula ou um número.
Depois de criado o bucket, você não pode mudar seu nome. Consulte informações sobre como nomear buckets em [Regras de nomenclatura de buckets de diretório](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html) no *Guia do usuário do Amazon S3*.
**Importante**
Evite incluir informações confidenciais, como números de conta, no nome do bucket. O nome do bucket é visível nos URLs que apontam para os objetos no bucket.
1. Em **Outpost**, escolha o Outpost onde você quer que o bucket resida.
1. Em **Bucket Versioning** (Versionamento de bucket), defina o estado de versionamento do S3 para seu bucket do S3 no Outposts como uma das seguintes opções:
+ **Disable** (Desabilitar) (padrão): o bucket permanece sem versão.
+ **Enable** (Habilitar): habilita o versionamento do S3 para os objetos no bucket. Todos os objetos adicionados ao bucket recebem um ID de versão exclusivo.
Para obter mais informações sobre o S3 Versioning, consulte [Gerenciar o versionamento do S3 para um bucket do S3 no Outposts](S3OutpostsManagingVersioning.md).
1. (Opcional) Adicione as **optional tags** (etiquetas opcionais) que você gostaria de associar ao bucket do Outposts. Você pode usar etiquetas para monitorar os critérios para projetos específicos ou grupos de projetos ou para rotular seus buckets usando etiquetas de alocação de custo.
Por padrão, todos os objetos armazenados no bucket do Outposts são armazenados usando criptografia no lado do servidor com chaves de criptografia gerenciadas pelo Amazon S3 (SSE-S3). Você também pode optar explicitamente por armazenar objetos usando a criptografia no lado do servidor com chaves de criptografia fornecidas pelo cliente (SSE-C). Para alterar o tipo de criptografia, você deve usar a API REST, a AWS Command Line Interface (AWS CLI) ou os AWS SDKs.
1. Na seção **Outposts access point settings** (Configurações do ponto de acesso do Outposts), insira o nome do ponto de acesso.
Os pontos de acesso do S3 on Outposts simplificam o gerenciamento de acesso a dados em escala para conjuntos de dados compartilhados no S3 on Outposts. Os pontos de acesso são endpoints de rede nomeados que são anexados a buckets do Outposts que você pode usar para executar operações de objeto S3. Para obter mais informações, consulte [Pontos de acesso](S3OutpostsWorkingBuckets.md#S3OutpostsAP).
Os nomes de pontos de acesso devem ser exclusivos dentro da conta para essa região e Outpost, além de cumprir com as [limitações e restrições do ponto de acesso](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-restrictions-limitations.html).
1. Escolha a **VPC** para este ponto de acesso do Amazon S3 no Outposts.
Se você não tiver uma VPC, escolha **Create VPC** (Criar VPC). Consulte mais informações em [Criar pontos de acesso restritos a uma nuvem privada virtual](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-vpc.html) no *Guia do usuário do Amazon S3*.
A Virtual Private Cloud (VPC) permite iniciar recursos da AWS em uma rede virtual definida por você. Essa rede virtual se assemelha a uma rede tradicional que você operaria no seu próprio datacenter, com os benefícios de usar a infraestrutura escalável da AWS.
1. (Opcional para uma VPC existente) Escolha uma **Sub-rede de endpoint** para o endpoint.
Uma sub-rede é uma gama de endereços IP na VPC. Se você não tiver a sub-rede desejada, escolha **Create subnet** (Criar sub-rede). Para obter mais informações, consulte [Redes para S3 on Outposts](S3OutpostsNetworking.md).
1. (Opcional para uma VPC existente) Escolha um **Grupo de segurança de endpoint** para o endpoint.
Um [grupo de segurança](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html) atua como um firewall virtual para controlar o tráfego de entrada e saída.
1. (Opcional para uma VPC existente) Escolha o **Tipo de acesso ao endpoint**:
+ **Private** (Privado): a ser usado com a VPC.
+ **Customer owned IP** (IP de propriedade do cliente): a ser usado com um grupo de endereços IP (grupo CoIP) de propriedade do cliente em sua rede on-premises.
1. (Opcional) Especifique a **política de ponto de acesso do Outpost**. O console exibe automaticamente o **nome do recurso da Amazon (ARN)** do ponto de acesso, que você pode usar na política.
1. Escolha **Create Outposts bucket (Criar bucket do Outposts)**.
**nota**
Pode levar até cinco minutos para que seu endpoint do Outpost seja criado e seu bucket esteja pronto para uso. Para definir configurações de bucket adicionais, escolha **View details** (Visualizar detalhes).
## Próximas etapas
Com o Amazon S3 on Outposts, os dados do objeto são sempre armazenados no Outpost. Quando a AWS instala um rack do Outpost, seus dados permanecem no local do Outpost para atender aos requisitos de residência de dados. Seus objetos nunca saem do Outpost e não estão em uma Região da AWS. Como o Console de gerenciamento da AWS está hospedado na região, você não pode usá-lo para fazer upload de objetos no Outpost nem os gerenciar. No entanto, você pode usar a API REST, a AWS Command Line Interface (AWS CLI) e os SDKs para fazer upload de objetos e gerenciá-los por meio de seus pontos de acesso.
Depois de criar um bucket no S3 on Outposts, um ponto de acesso e um endpoint, você pode usar a AWS CLI ou o SDK para Java para carregar um objeto no bucket. Para obter mais informações, consulte [Fazer upload de um objeto em um bucket do S3 on Outposts](S3OutpostsUploadObjects.md).
# Como começar a usar a AWS CLI e o SDK para Java
Com o Amazon S3 on Outposts, é possível criar buckets do S3 no AWS Outposts, além de armazenar e recuperar facilmente objetos no local para aplicações que exigem acesso a dados locais, processamento de dados local e residência de dados. O S3 on Outposts fornece uma nova classe de armazenamento, o S3 Outposts (`OUTPOSTS`), que usa as APIs do Amazon S3 e é projetado para armazenar dados de forma duradoura e redundante em vários dispositivos e servidores em seu AWS Outposts. Você se comunica com o bucket do Outposts usando um ponto de acesso e uma conexão de endpoint em uma nuvem privada virtual (VPC). É possível usar os mesmos recursos e APIs nos buckets do Outposts da mesma maneira que em buckets do Amazon S3, incluindo políticas de acesso, criptografia e marcação. Só é possível usar o S3 on Outposts por meio do Console de gerenciamento da AWS, da AWS Command Line Interface (AWS CLI), de AWS SDKs ou da API REST. Para obter mais informações, consulte [O que é o Amazon S3 on Outposts?](S3onOutposts.md)
Para começar a usar o S3 on Outposts, você deve criar um bucket, um ponto de acesso e um endpoint. Depois, você pode carregar objetos no bucket. Os exemplos a seguir mostram como começar a usar o S3 on Outposts com a AWS CLI e o SDK para Java. Para começar a usar o console, consulte [Conceitos básicos do uso do Console de gerenciamento da AWS](S3OutpostsGSConsole.md).
**Topics**
+ [Etapa 1: Criar um bucket](#S3OutpostsGSCreateBucket)
+ [Etapa 2: Criar um ponto de acesso](#S3OutpostsGSCreateAccessPoint)
+ [Etapa 3: Criar um endpoint](#S3OutpostsGSCreateEndpoint)
+ [Etapa 4: Fazer upload de um objeto em um bucket do S3 on Outposts](#S3OutpostsGSUploadObject)
## Etapa 1: Criar um bucket
Os exemplos de AWS CLI e SDK para Java a seguir mostram como criar um bucket do S3 on Outposts.
------
#### [ AWS CLI ]
**Example**
O exemplo a seguir cria um bucket do S3 on Outposts (`s3-outposts:CreateBucket`) usando a AWS CLI. Para executar esse comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control create-bucket --bucket example-outposts-bucket --outpost-id op-01ac5d28a6a232904
```
------
#### [ SDK for Java ]
**Example**
Para ver exemplos de como criar um bucket do S3 Outposts com o AWS SDK para Java, consulte [CreateOutpostsBucket.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javav2/example_code/s3/src/main/java/com/example/s3/outposts/CreateOutpostsBucket.java) nos *exemplos de código do AWS SDK for Java 2.x*.
------
## Etapa 2: Criar um ponto de acesso
Para acessar o bucket do Amazon S3 on Outposts, você deve criar e configurar um ponto de acesso. Esses exemplos mostram como criar um ponto de acesso usando a AWS CLI e o SDK para Java.
Os pontos de acesso simplificam o gerenciamento do acesso a dados em escala para conjuntos de dados compartilhados no Amazon S3. Os pontos de acesso são endpoints de rede nomeados e anexados a buckets que você pode usar para realizar operações de objeto do Amazon S3, como `GetObject` e `PutObject`. Com o S3 on Outposts, você deve usar pontos de acesso para acessar qualquer objeto em um bucket do Outposts. Os pontos de acesso são compatíveis apenas com o endereçamento em estilo de host virtual.
------
#### [ AWS CLI ]
**Example**
O exemplo da AWS CLI a seguir cria um ponto de acesso para um bucket do Outposts. Para executar esse comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control create-access-point --account-id 123456789012 --name example-outposts-access-point --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket" --vpc-configuration VpcId=example-vpc-12345
```
------
#### [ SDK for Java ]
**Example**
Para ver exemplos de como criar um ponto de acesso para um bucket do S3 Outposts com o AWS SDK para Java, consulte [CreateOutpostsAccessPoint.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javav2/example_code/s3/src/main/java/com/example/s3/outposts/CreateOutpostsAccessPoint.java) nos *exemplos de código do AWS SDK para Java 2.x*.
------
## Etapa 3: Criar um endpoint
Para rotear solicitações para um ponto de acesso do Amazon S3 on Outposts, você deve criar e configurar um endpoint do S3 on Outposts. Para criar um endpoint, você precisará de uma conexão ativa com seu link de serviço com sua região de origem do Outposts. Cada nuvem privada virtual (VPC) em seu Outpost pode ter um endpoint associado. Para obter mais informações sobre cotas de endpoints, consulte [Requisitos de rede do S3 on Outposts](S3OnOutpostsRestrictionsLimitations.md#S3OnOutpostsConnectivityRestrictions). Você deve criar um endpoint para poder acessar seus buckets do Outposts e executar operações de objeto. Para obter mais informações, consulte [Endpoints](S3OutpostsWorkingBuckets.md#S3OutpostsEP).
Esses exemplos mostram como criar um endpoint usando a AWS CLI e o SDK para Java. Para obter mais informações sobre as permissões necessárias para criar e gerenciar endpoints, consulte [Permissões para os endpoints do S3 on Outposts](S3OutpostsIAM.md#S3OutpostsEndpointPermissions).
------
#### [ AWS CLI ]
**Example**
O seguinte exemplo da AWS CLI cria um endpoint para um Outpost usando o tipo de acesso a recursos da VPC. A VPC é derivada da sub-rede. Para executar esse comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1
```
O exemplo a seguir da AWS CLI cria um endpoint para um Outpost usando o tipo de acesso do grupo de endereços IP de propriedade do cliente (grupo do CoIP). Para executar esse comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1 --access-type CustomerOwnedIp --customer-owned-ipv4-pool ipv4pool-coip-12345678901234567
```
------
#### [ SDK for Java ]
**Example**
Para ver exemplos de como criar um endpoint para um S3 Outpost com o AWS SDK para Java, consulte [CreateOutpostsEndPoint.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javav2/example_code/s3/src/main/java/com/example/s3/outposts/CreateOutpostsEndPoint.java) nos *exemplos de código do AWS SDK para Java 2.x*.
------
## Etapa 4: Fazer upload de um objeto em um bucket do S3 on Outposts
Para carregar um objeto, consulte [Fazer upload de um objeto em um bucket do S3 on Outposts](S3OutpostsUploadObjects.md).