

# Trabajo con puntos de conexión de Amazon S3 en Outposts
Trabajo con puntos de conexión

Para dirigir solicitudes a un punto de acceso de Amazon S3 en Outposts, debe crear y configurar un punto de conexión de S3 en Outposts. Para crear un punto de conexión, necesita una conexión activa con el enlace de servicio a la región de origen de Outposts. Cada nube virtual privada (VPC) de su Outpost puede tener un punto de conexión asociado. Para obtener más información acerca de las cuotas de los puntos de conexión, consulte [Requisitos de red de S3 en Outposts](S3OnOutpostsRestrictionsLimitations.md#S3OnOutpostsConnectivityRestrictions). Debe crear un punto de conexión para poder acceder a los buckets de Outposts y realizar operaciones de objetos. Para obtener más información, consulte [Puntos de conexión](S3OutpostsWorkingBuckets.md#S3OutpostsEP).

Después de crear un punto de conexión, puede utilizar el campo Estado para comprender el estado del punto de conexión. Si Outposts está desconectado, devolverá un error CREATE\$1FAILED. Puede comprobar la conexión del enlace de servicio, eliminar el punto de conexión y volver a intentar la operación de creación cuando se haya reanudado la conexión. Para obtener una lista de códigos de error adicionales, consulte la siguiente tabla. Para obtener más información, consulte [Puntos de conexión](S3OutpostsWorkingBuckets.md#S3OutpostsEP).


| API | Status | Código de error de motivo de error | Mensaje - Motivo del error | 
| --- | --- | --- | --- | 
| CreateEndpoint | Create\$1Failed | OutpostNotReachable | No se ha podido crear un punto de conexión porque la conexión del enlace de servicio a la región de origen de Outposts está inactiva. Compruebe la conexión, borre el punto de conexión e inténtelo de nuevo. | 
| CreateEndpoint | Create\$1Failed | InternalError | No se ha podido crear el punto de conexión debido a un error interno. Elimine el punto de conexión y vuelva a crearlo. | 
| DeleteEndpoint | Delete\$1Failed | OutpostNotReachable | No se ha podido eliminar un punto de conexión porque la conexión del enlace de servicio a la región de origen de Outposts está inactiva. Compruebe la conexión e inténtelo de nuevo. | 
| DeleteEndpoint | Delete\$1Failed | InternalError | No se ha podido eliminar el punto de conexión debido a un error interno. Inténtelo de nuevo. | 

Para obtener más información acerca de trabajar con buckets en S3 en Outposts, consulte [Trabajo con buckets de S3 en Outposts](S3OutpostsWorkingBuckets.md).

En las secciones siguientes, se describe cómo crear y administrar puntos de conexión para S3 en Outposts.

**Topics**
+ [

# Creación de un punto de conexión en un Outpost
](S3OutpostsCreateEndpoint.md)
+ [

# Obtención de una lista de puntos de conexión de Amazon S3 en Outposts
](S3OutpostsListEndpoints.md)
+ [

# Eliminación de un punto de conexión de Amazon S3 en Outposts
](S3OutpostsDeleteEndpoints.md)

# Creación de un punto de conexión en un Outpost
Creación de un punto de conexión

Para dirigir solicitudes a un punto de acceso de Amazon S3 en Outposts, debe crear y configurar un punto de conexión de S3 en Outposts. Para crear un punto de conexión, necesita una conexión activa con el enlace de servicio a la región de origen de Outposts. Cada nube virtual privada (VPC) de su Outpost puede tener un punto de conexión asociado. Para obtener más información acerca de las cuotas de los puntos de conexión, consulte [Requisitos de red de S3 en Outposts](S3OnOutpostsRestrictionsLimitations.md#S3OnOutpostsConnectivityRestrictions). Debe crear un punto de conexión para poder acceder a los buckets de Outposts y realizar operaciones de objetos. Para obtener más información, consulte [Puntos de conexión](S3OutpostsWorkingBuckets.md#S3OutpostsEP).

**Permisos**  
Para obtener más información sobre los permisos necesarios para crear un punto de conexión, consulte [Permisos para los puntos de conexión de S3 en Outposts](S3OutpostsIAM.md#S3OutpostsEndpointPermissions).

Al crear un punto de conexión, S3 en Outposts también crea un rol vinculado a un servicio en la Cuenta de AWS. Para obtener más información, consulte [Uso de roles vinculados a servicios para Amazon S3 en Outposts](S3OutpostsServiceLinkedRoles.md).

En los siguientes ejemplos, se muestra cómo crear un punto de conexión de S3 en Outposts con Consola de administración de AWS, AWS Command Line Interface (AWS CLI) y AWS SDK para Java. 

## Uso de la consola de S3


1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación de la izquierda, elija **Outposts access points (Puntos de acceso de Outposts)**.

1. Seleccione la pestaña **Outposts endpoints (Puntos de acceso de Outposts)**.

1. Elija **Create Outposts endpoint (Crear punto de conexión de Outposts)**.

1. En **Outpost**, elija el Outpost en el que crear este punto de conexión.

1. En **VPC**, elija una VPC que aún no tenga punto de conexión y que también cumpla las reglas de los puntos de conexión de Outposts.

   Una nube virtual privada (VPC) le permite lanzar recursos de AWS en una red virtual que defina. Dicha red virtual es prácticamente idéntica a las redes tradicionales que se utilizarían en sus propios centros de datos, con los beneficios que supone utilizar la infraestructura escalable de AWS. 

   Si no tiene una VPC, elija **Create VPC (Crear VPC)**. Para obtener más información, consulte [Crear puntos de acceso restringidos a una nube privada virtual (VPC)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-vpc.html) en la *Guía del usuario de Amazon S3*.

1. Elija **Create Outposts endpoint (Crear punto de conexión de Outposts)**.

## Uso de AWS CLI


**Example**  
En el siguiente ejemplo de la AWS CLI, se crea un punto de conexión para un Outpost con el tipo de acceso a recursos de la VPC. La VPC se obtiene de la subred. Para ejecutar este comando, sustituya los `user input placeholders` con su propia información.  

```
aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1
```
En el siguiente ejemplo de la AWS CLI, se crea un punto de conexión para un Outpost con el tipo de acceso de grupo de direcciones IP propiedad del cliente (grupo de CoIP). Para ejecutar este comando, sustituya los `user input placeholders` con su propia información.  

```
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
```

## Uso de AWS SDK para Java


**Example**  
Para ver ejemplos de cómo crear un punto de conexión para un S3 Outpost con el SDK de AWS 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) en los *ejemplos de código del SDK de AWS para Java 2.x*.

# Obtención de una lista de puntos de conexión de Amazon S3 en Outposts
Obtención de una lista de puntos de conexión

Para dirigir solicitudes a un punto de acceso de Amazon S3 en Outposts, debe crear y configurar un punto de conexión de S3 en Outposts. Para crear un punto de conexión, necesita una conexión activa con el enlace de servicio a la región de origen de Outposts. Cada nube virtual privada (VPC) de su Outpost puede tener un punto de conexión asociado. Para obtener más información acerca de las cuotas de los puntos de conexión, consulte [Requisitos de red de S3 en Outposts](S3OnOutpostsRestrictionsLimitations.md#S3OnOutpostsConnectivityRestrictions). Debe crear un punto de conexión para poder acceder a los buckets de Outposts y realizar operaciones de objetos. Para obtener más información, consulte [Puntos de conexión](S3OutpostsWorkingBuckets.md#S3OutpostsEP).

En los siguientes ejemplos, se muestra cómo devolver una lista de los puntos de conexión de S3 en Outposts con Consola de administración de AWS, AWS Command Line Interface (AWS CLI) y AWS SDK para Java.

## Uso de la consola de S3


1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3](https://console.aws.amazon.com/s3/).

1. En el panel de navegación de la izquierda, elija **Outposts access points (Puntos de acceso de Outposts)**.

1. En la página **Outposts access points (Puntos de acceso de Outposts)**, seleccione la pestaña **Outposts endpoints (Puntos de conexión de Outposts)**.

1. En **Outposts endpoints (Puntos de conexión de Outposts)**, puede ver una lista de sus puntos de conexión de S3 en Outposts.

## Uso de AWS CLI


En el siguiente ejemplo de AWS CLI, se muestran los puntos de conexión para recursos de AWS Outposts asociados a la cuenta. Para obtener más información acerca de este comando, consulte [list-endpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3outposts/list-endpoints.html) en la *Referencia de AWS CLI*.

```
aws s3outposts list-endpoints
```

## Uso de AWS SDK para Java


En el siguiente ejemplo del SDK para Java, se enumeran los puntos de enlace para un Outpost. Para obtener más información, consulte [ListEndpoints](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3outposts_ListEndpoints.html) en la *Referencia de la API de 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);
}
```

# Eliminación de un punto de conexión de Amazon S3 en Outposts
Eliminación de un punto de conexión

Para dirigir solicitudes a un punto de acceso de Amazon S3 en Outposts, debe crear y configurar un punto de conexión de S3 en Outposts. Para crear un punto de conexión, necesita una conexión activa con el enlace de servicio a la región de origen de Outposts. Cada nube virtual privada (VPC) de su Outpost puede tener un punto de conexión asociado. Para obtener más información acerca de las cuotas de los puntos de conexión, consulte [Requisitos de red de S3 en Outposts](S3OnOutpostsRestrictionsLimitations.md#S3OnOutpostsConnectivityRestrictions). Debe crear un punto de conexión para poder acceder a los buckets de Outposts y realizar operaciones de objetos. Para obtener más información, consulte [Puntos de conexión](S3OutpostsWorkingBuckets.md#S3OutpostsEP).

En los siguientes ejemplos, se muestra cómo eliminar los puntos de conexión de S3 en Outposts con la Consola de administración de AWS, AWS Command Line Interface (AWS CLI) y AWS SDK para Java.

## Uso de la consola de S3


1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3](https://console.aws.amazon.com/s3/).

1. En el panel de navegación de la izquierda, elija **Outposts access points (Puntos de acceso de Outposts)**.

1. En la página **Outposts access points (Puntos de acceso de Outposts)**, seleccione la pestaña **Outposts endpoints (Puntos de conexión de Outposts)**.

1. En **Outposts endpoints (Puntos de conexión de Outposts)**, seleccione el punto de conexión que desea eliminar y elija **Delete (Eliminar)**.

## Uso de AWS CLI


En el siguiente ejemplo de la AWS CLI, se elimina un punto de enlace para un Outpost. Para ejecutar este comando, sustituya los `user input placeholders` con su propia información.

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

## Uso de AWS SDK para Java


En el siguiente ejemplo del SDK para Java, se elimina un punto de enlace para un Outpost. Para utilizar este ejemplo, reemplace los `user input placeholders` con su propia información.

```
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.");
}
```