# Trabalhar com endpoints do Amazon S3 on Outposts
Trabalhar com endpoints do

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 ter mais informações, consulte [Endpoints](S3OutpostsWorkingBuckets.md#S3OutpostsEP).

Depois de criar um endpoint, você pode usar o campo “Status” para entender o estado do endpoint. Se seu Outposts estiver offline, ele retornará um CREATE\$1FAILED. Você pode conferir sua conexão de link de serviço, excluir o endpoint e repetir a operação de criação depois que sua conexão for retomada. Para ter uma lista de códigos de erro adicionais, veja abaixo. Para ter mais informações, consulte [Endpoints](S3OutpostsWorkingBuckets.md#S3OutpostsEP).


| API | Status | Código de erro do motivo da falha | Mensagem: motivo da falha | 
| --- | --- | --- | --- | 
| CreateEndpoint | Create\$1Failed | OutpostNotReachable | O endpoint não pôde ser criado porque a conexão do link de serviço com sua região de origem do Outposts está inativa. Confira sua conexão, exclua o endpoint e tente novamente. | 
| CreateEndpoint | Create\$1Failed | InternalError | O endpoint não pôde ser criado devido a um erro interno. Exclua o endpoint e crie novamente. | 
| DeleteEndpoint | Delete\$1Failed | OutpostNotReachable | O endpoint não pôde ser excluído porque a conexão do link de serviço com sua região de origem do Outposts está inativa. Confira sua conexão e tente novamente. | 
| DeleteEndpoint | Delete\$1Failed | InternalError | O endpoint não pôde ser excluído devido a um erro interno. Tente novamente. | 

Para obter mais informações sobre como trabalhar com buckets no S3 on Outposts, consulte [Trabalhar com buckets do S3 on Outposts](S3OutpostsWorkingBuckets.md).

As seções a seguir descrevem como criar e gerenciar endpoints para o S3 on Outposts.

**Topics**
+ [

# Criar um endpoint em um Outpost
](S3OutpostsCreateEndpoint.md)
+ [

# Visualizar uma lista de endpoints do Amazon S3 on Outposts
](S3OutpostsListEndpoints.md)
+ [

# Excluir um endpoint do Amazon S3 on Outposts
](S3OutpostsDeleteEndpoints.md)

# Criar um endpoint em um Outpost
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 ter mais informações, consulte [Endpoints](S3OutpostsWorkingBuckets.md#S3OutpostsEP).

**Permissões**  
Para obter mais informações sobre as permissões necessárias para criar um endpoint, consulte [Permissões para os endpoints do S3 on Outposts](S3OutpostsIAM.md#S3OutpostsEndpointPermissions).

Ao criar um endpoint, o S3 no Outposts também cria um perfil vinculado a serviço na Conta da AWS. Para ter mais informações, consulte [Usar perfis vinculados a serviço para o Amazon S3 no Outposts](S3OutpostsServiceLinkedRoles.md).

Os exemplos a seguir mostram como criar um endpoint do S3 on Outposts usando o Console de gerenciamento da AWS, a AWS Command Line Interface (AWS CLI) e o AWS SDK para Java. 

## Usar o console do S3


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 access points** (Pontos de acesso do Outposts).

1. Escolha a guia **Outposts endpoints** (Endpoints do Outposts).

1. Escolha **Create Outposts endpoint** (Criar endpoint do Outposts).

1. Em **Outpost**, escolha o Outpost no qual o endpoint será criado.

1. Em **VPC**, escolha uma VPC que ainda não tenha um endpoint e que esteja em conformidade com as regras para endpoints do Outposts.

   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. 

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

1. Escolha **Create Outposts endpoint** (Criar endpoint do Outposts).

## Como usar a 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
```

## Usar o AWS SDK para 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*.

# Visualizar uma lista de endpoints do Amazon S3 on Outposts
Listar endpoints

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

Os exemplos a seguir mostram como retornar uma lista de seus endpoints do S3 on Outposts usando o Console de gerenciamento da AWS, a AWS Command Line Interface (AWS CLI) e o AWS SDK para Java.

## Usar o console do S3


1. 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 access points** (Pontos de acesso do Outposts).

1. Na página **Outposts access points** (Pontos de acesso do Outposts), escolha a guia **Outposts endpoints** (Endpoints do Outposts).

1. Em **Outposts endpoints** (Endpoints do Outposts), você pode visualizar uma lista de endpoints do S3 on Outposts.

## Como usar o AWS CLI


O exemplo a seguir da AWS CLI lista os endpoints para os recursos do AWS Outposts associados à sua conta. Para obter mais informações sobre esse comando, consulte [list-endpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3outposts/list-endpoints.html) na *Referência da AWS CLI*.

```
aws s3outposts list-endpoints
```

## Usar o AWS SDK para Java


O exemplo do SDK para Java a seguir lista os endpoints para um Outpost. Para obter mais informações, consulte [ListEndpoints](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3outposts_ListEndpoints.html) na *Referência da API do Amazon Simple Storage Service*.

```
import com.amazonaws.services.s3outposts.AmazonS3Outposts;
import com.amazonaws.services.s3outposts.AmazonS3OutpostsClientBuilder;
import com.amazonaws.services.s3outposts.model.ListEndpointsRequest;
import com.amazonaws.services.s3outposts.model.ListEndpointsResult;

public void listEndpoints() {
    AmazonS3Outposts s3OutpostsClient = AmazonS3OutpostsClientBuilder
                .standard().build();
                
    ListEndpointsRequest listEndpointsRequest = new ListEndpointsRequest();
    ListEndpointsResult listEndpointsResult = s3OutpostsClient.listEndpoints(listEndpointsRequest);
    System.out.println("List endpoints result is " + listEndpointsResult);
}
```

# Excluir um endpoint do Amazon S3 on Outposts
Excluir 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).

Os exemplos a seguir mostram como excluir os endpoints do S3 on Outposts usando o Console de gerenciamento da AWS, a AWS Command Line Interface (AWS CLI) e o AWS SDK para Java.

## Usar o console do S3


1. 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 access points** (Pontos de acesso do Outposts).

1. Na página **Outposts access points** (Pontos de acesso do Outposts), escolha a guia **Outposts endpoints** (Endpoints do Outposts).

1. Em **Outposts endpoints** (Endpoints do Outposts), escolha o endpoint que você deseja excluir e escolha **Delete** (Excluir).

## Como usar o AWS CLI


O exemplo da AWS CLI a seguir exclui um endpoint de um Outpost. Para executar esse comando, substitua os `user input placeholders` por suas próprias informações.

```
aws s3outposts delete-endpoint --endpoint-id example-endpoint-id --outpost-id op-01ac5d28a6a232904
```

## Usar o AWS SDK para Java


O exemplo do SDK for Java a seguir exclui um endpoint de um Outpost. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

```
import com.amazonaws.arn.Arn;
import com.amazonaws.services.s3outposts.AmazonS3Outposts;
import com.amazonaws.services.s3outposts.AmazonS3OutpostsClientBuilder;
import com.amazonaws.services.s3outposts.model.DeleteEndpointRequest;

public void deleteEndpoint(String endpointArnInput) {
    String outpostId = "op-01ac5d28a6a232904";
    AmazonS3Outposts s3OutpostsClient = AmazonS3OutpostsClientBuilder
                .standard().build();
                
    Arn endpointArn = Arn.fromString(endpointArnInput);
    String[] resourceParts = endpointArn.getResource().getResource().split("/");
    String endpointId = resourceParts[resourceParts.length - 1];
    DeleteEndpointRequest deleteEndpointRequest = new DeleteEndpointRequest()
                .withEndpointId(endpointId)
                .withOutpostId(outpostId);
    s3OutpostsClient.deleteEndpoint(deleteEndpointRequest);
    System.out.println("Endpoint with id " + endpointId + " is deleted.");
}
```