Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Configuración e inicio del almacenamiento compatible con Amazon S3 en Snowball Edge
Instale y configure herramientas de AWS software en su entorno local para interactuar con el dispositivo o el clúster de dispositivos Snowball Edge y el almacenamiento compatible con Amazon S3 en Snowball Edge. A continuación, utilice estas herramientas para configurar el dispositivo o el clúster de Snowball Edge e iniciar un almacenamiento compatible con Amazon S3 en Snowball Edge.
## Requisitos previos
El almacenamiento compatible con Amazon S3 en Snowball Edge requiere que tenga el cliente Snowball Edge y el AWS CLI instalado en su entorno local. También puede utilizar SDK para .NET AWS Herramientas para Windows PowerShell para trabajar con el almacenamiento compatible con Amazon S3 en Snowball Edge. AWS recomienda utilizar las siguientes versiones de estas herramientas:
+ **Cliente de Snowball Edge**: utilice la versión más reciente. Para obtener más información, consulte [Descarga e instalación del cliente de Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client) en esta guía.
+ **AWS CLI**: versión 2.11.15 o posterior. Para obtener más información, consulte [Instalación, actualización y desinstalación de AWS CLI en la](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) Guía del AWS Command Line Interface usuario.
+ **SDK para .NET**— AWSSDK .S3Control 3.7.304.8 o posterior. Para obtener más información, consulte [AWS SDK para .NET](https://docs.aws.amazon.com/sdk-for-net).
+ **AWS Herramientas para Windows PowerShell**: versión 4.1.476 o posterior. Si quiere obtener más información, consulte la [Guía del usuario de Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/).
## Configuración del entorno local
En esta sección se describe cómo instalar y configurar el cliente Snowball Edge y su entorno local para usarlos con el almacenamiento compatible con Amazon S3 en Snowball Edge.
1. Descargue e instale el cliente de Snowball Edge. Para obtener más información, consulte [Descarga e instalación del cliente de Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client).
1. Configure un perfil para el cliente de Snowball Edge. Para obtener más información, consulte [Configuración de un perfil para el cliente de Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#client-configuration).
1. Si lo está utilizando SDK para .NET, defina el valor del `clientConfig.AuthenticationRegion` parámetro de la siguiente manera:
```
clientConfig.AuthenticationRegion = "snow"
```
### Configuración del dispositivo Snowball Edge
#### Configuración de IAM en el dispositivo Snowball Edge
AWS Identity and Access Management (IAM) le ayuda a habilitar un acceso detallado a AWS los recursos que se ejecutan en sus dispositivos Snowball Edge. Utilice IAM para controlar quién está autenticado (ha iniciado sesión) y autorizado (tiene permisos) para utilizar recursos.
El dispositivo Snowball Edge admite IAM localmente. Puede utilizar el servicio local de IAM para crear nuevos roles y asociarles políticas de IAM. Puede utilizar estas políticas para permitir el acceso necesario para realizar tareas asignadas.
El siguiente ejemplo permite obtener acceso completo a la API de Amazon S3:
------
#### [ JSON ]
****
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "s3:*",
"Resource": "*"
}
]
}
```
------
Para ver más ejemplos de políticas de IAM, consulte la [Guía para desarrolladores de AWS Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-local-iam.html#policy-examples).
## Inicio del almacenamiento compatible con Amazon S3 en el servicio Snowball Edge
Siga las instrucciones siguientes para iniciar el servicio de almacenamiento compatible con Amazon S3 en Snowball Edge en un dispositivo o clúster de Snowball Edge.
Si prefiere una experiencia más fácil de usar, puede iniciar el servicio de almacenamiento en Snowball Edge compatible con Amazon S3 para un dispositivo independiente o un clúster de dispositivos que lo utilice. AWS OpsHub Consulte [Configure un almacenamiento compatible con Amazon S3 en Snowball Edge con AWS OpsHub](s3-edge-snow-opshub.md).
1. Desbloquee el dispositivo o el clúster de dispositivos Snowball Edge ejecutando el siguiente comando:
+ Para un solo dispositivo:
```
snowballEdge unlock-device --endpoint https://snow-device-ip
```
+ Para un clúster:
```
snowballEdge unlock-cluster
```
1. Ejecute el siguiente comando y asegúrese de que el dispositivo o el clúster de dispositivos Snowball Edge están desbloqueados:
+ Para un solo dispositivo:
```
snowballEdge describe-device --endpoint https://snow-device-ip
```
+ Para un clúster:
```
snowballEdge describe-cluster --device-ip-addresses [snow-device-1-ip] [snow-device-2-ip] /
[snow-device-3-ip] [snow-device-4-ip] [snow-device-5-ip] /
[snow-device-6-ip]
```
1. Para cada dispositivo (ya sea que tenga uno o un clúster), para iniciar el almacenamiento compatible con Amazon S3 en Snowball Edge, haga lo siguiente:
1. Ejecute el siguiente comando `describe-device` para obtener el `PhysicalNetworkInterfaceId` del dispositivo:
```
snowballEdge describe-device --endpoint https://snow-device-ip
```
1. Ejecute el siguiente `create-virtual-network-interface` comando dos veces para crear las interfaces de red virtuales (VNIs) para los puntos finales `s3control` (para las operaciones de bucket) y `s3api` (para las operaciones con objetos).
```
snowballEdge create-virtual-network-interface --ip-address-assignment dhcp --manifest-file manifest --physical-network-interface-id "PhysicalNetworkInterfaceId" --unlock-code unlockcode --endpoint https://snow-device-ip
```
El comando devuelve una estructura JSON que incluye la dirección IP. Anote la dirección IP.
Para obtener más información sobre estos comandos, consulte [Configuración de una interfaz de red virtual (VNI) en un Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/network-config-ec2.html#setup-vni).
**nota**
Iniciar un almacenamiento compatible con Amazon S3 en Snowball Edge consume recursos del dispositivo.
1. Inicie el servicio de almacenamiento compatible con Amazon S3 en Snowball Edge ejecutando el siguiente `start-service` comando, que incluye las direcciones IP de sus dispositivos y los nombres de recursos de Amazon (ARNs) del VNIs que creó para los `s3control` puntos de enlace y: `s3api`
Inicio del servicio en un solo dispositivo:
```
snowballEdge start-service --service-id s3-snow --device-ip-addresses snow-device-1-ip --virtual-network-interface-arns vni-arn-1 vni-arn-2
```
Inicio del servicio en un clúster:
```
snowballEdge start-service --service-id s3-snow --device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip --virtual-network-interface-arns vni-arn-1 vni-arn-2 vni-arn-3 vni-arn-4 vni-arn-5 vni-arn-6
```
Para`--virtual-network-interface-arns`, incluya ARNs todo lo VNIs que creó en el paso anterior. Separe cada ARN con un espacio.
1. Ejecute el siguiente comando `describe-service` para un solo dispositivo:
```
snowballEdge describe-service --service-id s3-snow
```
Espere hasta que el estado del servicio sea `Active`.
Ejecute el siguiente comando `describe-service` para un clúster:
```
snowballEdge describe-service --service-id s3-snow \
--device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip
```
## Visualización de información sobre el almacenamiento compatible con Amazon S3 en los puntos finales de Snowball Edge
Cuando se esté ejecutando el servicio de almacenamiento compatible con Amazon S3 en Snowball Edge, puede utilizar el comando `describe-service` Snowball Edge Client para ver las direcciones IP asociadas a los puntos de enlace s3control y s3api.
```
snowballEdge describe-service --service-id s3-snow --endpoint https://snow-device-ip-address --profile profile-name
```
**Example resultado del comando `describe-service`**
En este ejemplo, la dirección IP del punto de conexión de s3control es 192.168.1.222 y la dirección IP del punto de conexión de s3api es 192.168.1.152.
```
{
"ServiceId": "s3-snow",
"Autostart": true,
"Status": {
"State": "ACTIVATING",
"Details": "Attaching storage"
},
"ServiceCapacities": [
{
"Name": "S3 Storage",
"Unit": "Byte",
"Used": 148599705600,
"Available": 19351400294400
}
],
"Endpoints": [
{
"Protocol": "https",
"Port": 443,
"Host": "192.168.1.222",
"CertificateAssociation": {
"CertificateArn": "arn:aws:snowball-device:::certificate/30c563f1124707705117f57f6c3accd42a4528ed6dba1e35c1822a391a717199d8c49973d3c0283494d987463e826f2c"
},
"Description": "s3-snow bucket API endpoint (for s3control SDK)",
"DeviceId": "JID-beta-207429000001-23-12-28-03-51-11",
"Status": {
"State": "ACTIVE"
}
},
{
"Protocol": "https",
"Port": 443,
"Host": "192.168.1.152",
"CertificateAssociation": {
"CertificateArn": "arn:aws:snowball-device:::certificate/30c563f1124707705117f57f6c3accd42a4528ed6dba1e35c1822a391a717199d8c49973d3c0283494d987463e826f2c"
},
"Description": "s3-snow object & bucket API endpoint (for s3api SDK)",
"DeviceId": "JID-beta-207429000001-23-12-28-03-51-11",
"Status": {
"State": "ACTIVATING"
}
}
]
}
```