

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Configuration et démarrage du stockage compatible Amazon S3 sur Snowball Edge
<a name="s3-edge-snow-setting-up"></a>

Installez et configurez des outils logiciels depuis AWS votre environnement local pour interagir avec l'appareil ou le cluster d'appareils Snowball Edge et le stockage compatible Amazon S3 sur Snowball Edge. Utilisez ensuite ces outils pour configurer l'appareil ou le cluster Snowball Edge et démarrer le stockage compatible avec Amazon S3 sur Snowball Edge.

## Prérequis
<a name="s3-snow-prereq"></a>

Le stockage compatible avec Amazon S3 sur Snowball Edge nécessite que le client Snowball Edge soit AWS CLI installé dans votre environnement local. Vous pouvez également utiliser SDK pour .NET et AWS Tools for Windows PowerShell pour travailler avec le stockage compatible Amazon S3 sur Snowball Edge. AWS recommande d'utiliser les versions suivantes de ces outils :
+ **Snowball Edge Client** : utilisez la dernière version. Pour plus d'informations, consultez la section [Téléchargement et installation du client Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client) dans ce guide.
+ **AWS CLI**— Version 2.11.15 ou ultérieure. Pour plus d'informations, consultez la section [Installation, mise à jour et désinstallation du AWS CLI dans le](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) guide de l' AWS Command Line Interface utilisateur.
+ **SDK pour .NET**— AWSSDK .S3Control 3.7.304.8 ou version ultérieure. Pour de plus amples informations, veuillez consulter [AWS SDK pour .NET](https://docs.aws.amazon.com/sdk-for-net).
+ **AWS Outils pour Windows PowerShell** — Version 4.1.476 ou ultérieure. Pour plus d’informations, consultez le [Outils AWS pour PowerShell guide de l’utilisateur](https://docs.aws.amazon.com/powershell/latest/userguide/).

## Configuration de votre environnement local
<a name="s3-snow-local-environment-config"></a>

Cette section explique comment configurer le client Snowball Edge et votre environnement local pour une utilisation avec le stockage compatible Amazon S3 sur Snowball Edge.

1. Téléchargez et installez le client Snowball Edge. Pour plus d'informations, voir [Téléchargement et installation du client Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client).

1. Configurez un profil pour le client Snowball Edge. Pour plus d'informations, voir [Configuration d'un profil pour le client Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#client-configuration).

1. Si vous utilisez SDK pour .NET, définissez la valeur du `clientConfig.AuthenticationRegion` paramètre comme suit :

   ```
     clientConfig.AuthenticationRegion = "snow"                        
   ```

### Configuration de votre appareil Snowball Edge
<a name="s3-edge-snow-setup"></a>

#### Configuration de l'IAM sur le Snowball Edge
<a name="setting-up-s3-on-snow-iam"></a>

Gestion des identités et des accès AWS (IAM) vous aide à permettre un accès granulaire aux AWS ressources qui s'exécutent sur vos appareils Snowball Edge. Vous pouvez utiliser IAM pour contrôler les personnes qui s’authentifient (sont connectées) et sont autorisées (disposent d’autorisations) à utiliser des ressources.

L'IAM est pris en charge localement sur le Snowball Edge. Vous pouvez utiliser le service IAM local pour créer des rôles et leur associer des politiques IAM. Vous pouvez utiliser ces stratégies pour autoriser l'accès nécessaire à l'exécution des tâches assignées.

L'exemple suivant permet un accès complet à l'API Amazon S3 :

------
#### [ JSON ]

****  

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "s3:*",
            "Resource": "*"
        }
    ]
}
```

------

Pour d'autres exemples de politique IAM, consultez le [guide du AWS Snowball Edge développeur](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-local-iam.html#policy-examples).

## Démarrage du service de stockage compatible Amazon S3 sur Snowball Edge
<a name="setting-up-s3-on-snow-cluster"></a>

Suivez les instructions suivantes pour démarrer le service de stockage compatible Amazon S3 sur Snowball Edge sur un appareil ou un cluster Snowball Edge.

Si vous préférez une expérience plus conviviale, vous pouvez démarrer le service de stockage compatible Amazon S3 sur Snowball Edge pour un appareil autonome ou un cluster d'appareils à l'aide de. AWS OpsHub Consultez [Configurez un stockage compatible Amazon S3 sur Snowball Edge avec AWS OpsHub](s3-edge-snow-opshub.md).

1. Déverrouillez votre appareil ou groupe d'appareils Snowball Edge en exécutant la commande suivante :
   + Pour un seul appareil :

     ```
       snowballEdge unlock-device --endpoint https://snow-device-ip
     ```
   + Pour un cluster :

     ```
      snowballEdge unlock-cluster
     ```

1. Exécutez la commande suivante et assurez-vous que le périphérique ou le groupe d'appareils Snowball Edge est déverrouillé :
   + Pour un seul appareil :

     ```
       snowballEdge describe-device --endpoint https://snow-device-ip
     ```
   + Pour un cluster :

     ```
       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. Pour chaque appareil (que vous en possédiez un ou un cluster), pour démarrer un stockage compatible avec Amazon S3 sur Snowball Edge, procédez comme suit :

   1. Récupérez l'appareil `PhysicalNetworkInterfaceId` en exécutant la `describe-device` commande suivante :

      ```
        snowballEdge describe-device --endpoint https://snow-device-ip
      ```

   1. Exécutez deux fois la `create-virtual-network-interface` commande suivante pour créer les interfaces réseau virtuelles (VNIs) pour les points de terminaison `s3control` (pour les opérations sur les compartiments) et `s3api` (pour les opérations sur les objets).

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

      La commande renvoie une structure JSON qui inclut l'adresse IP. Notez cette adresse IP.

      Pour plus de détails sur ces commandes, consultez [Configuration d'une interface réseau virtuelle (VNI) sur un Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/network-config-ec2.html#setup-vni).
**Note**  
Le démarrage d'un stockage compatible avec Amazon S3 sur Snowball Edge consomme les ressources de l'appareil.

1. Démarrez le service de stockage compatible Amazon S3 sur Snowball Edge en exécutant la `start-service` commande suivante, qui inclut les adresses IP de vos appareils et les Amazon Resource Names (ARNs) des appareils VNIs que vous avez créés pour les `s3control` points de terminaison et : `s3api`

   Pour démarrer le service sur un seul appareil :

   ```
     snowballEdge start-service --service-id s3-snow --device-ip-addresses snow-device-1-ip --virtual-network-interface-arns vni-arn-1 vni-arn-2
   ```

   Pour démarrer le service sur un cluster :

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

   Pour`--virtual-network-interface-arns`, incluez ARNs pour tout VNIs ce que vous avez créé à l'étape précédente. Séparez chaque ARN par un espace.

1. Exécutez la `describe-service` commande suivante pour un seul appareil :

   ```
     snowballEdge describe-service --service-id s3-snow
   ```

   Attendez que l'état du service soit rétabli`Active`.

   Exécutez la `describe-service` commande suivante pour un cluster :

   ```
     snowballEdge describe-service --service-id s3-snow \ 
       --device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip
   ```

## Affichage des informations relatives au stockage compatible avec Amazon S3 sur les points de terminaison Snowball Edge
<a name="s3-snow-endpoints"></a>

Lorsque le service de stockage compatible Amazon S3 sur Snowball Edge est en cours d'exécution, vous pouvez utiliser la commande `describe-service` Snowball Edge Client pour afficher les adresses IP associées aux points de terminaison s3control et s3api.

```
snowballEdge describe-service --service-id s3-snow --endpoint https://snow-device-ip-address --profile profile-name
```

**Example sortie de `describe-service` commande**  
Dans cet exemple, l'adresse IP du point de terminaison s3control est 192.168.1.222 et l'adresse IP du point de terminaison s3api est 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"
      }
    }
  ]
}
```