# Fazer upload de um objeto em um bucket do S3 on Outposts
<a name="S3OutpostsUploadObjects"></a>

Objetos são as entidades fundamentais armazenadas no Amazon S3 on Outposts. Cada objeto está contido em um bucket. É necessário usar pontos de acesso para acessar qualquer objeto em um bucket do Outpost. Ao especificar o bucket para operações de objeto, use o nome do recurso da Amazon (ARN) do ponto de acesso ou o alias do ponto de acesso. Para obter mais informações sobre alias de pontos de acesso, consulte [Usar um alias em estilo de bucket para seu ponto de acesso de bucket do S3 no Outposts](s3-outposts-access-points-alias.md).

O exemplo a seguir mostra o formato do ARN para pontos de acesso do S3 no Outposts, que inclui o código Região da AWS para a região em que o Outpost está hospedado, o ID da Conta da AWS, o ID do Outpost e o nome do ponto de acesso:

```
arn:aws:s3-outposts:region:account-id:outpost/outpost-id/accesspoint/accesspoint-name
```

Para obter mais informações sobre o S3 on Outposts, consulte [ARNs de recurso para S3 no Outposts](S3OutpostsIAM.md#S3OutpostsARN).

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.

Os exemplos de AWS CLI e AWS SDK para Java a seguir mostram como fazer upload de um objeto em um bucket do S3 on Outposts usando um ponto de acesso.

------
#### [ AWS CLI ]

**Example**  
O exemplo a seguir coloca um objeto chamado `sample-object.xml` em um bucket do S3 on Outposts (`s3-outposts:PutObject`) usando a AWS CLI. Para usar esse comando, substitua cada `user input placeholder` por suas próprias informações. Para obter mais informações sobre esse comando, consulte [put-object](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html) na *Referência da AWS CLI*.  

```
aws s3api put-object --bucket arn:aws:s3-outposts:Region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point --key sample-object.xml --body sample-object.xml
```

------
#### [ SDK for Java ]

**Example**  
Para ver exemplos de como fazer upload de um objeto em um bucket do S3 Outposts com o AWS SDK para Java, consulte PutObjectOnOutpost.java nos * exemplos de código do AWSSDK para Java 2.x*.

------