As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Configurando e iniciando o armazenamento compatível com o Amazon S3 no Snowball Edge
Instale e configure ferramentas de software em seu ambiente local AWS para interagir com o dispositivo ou cluster de dispositivos Snowball Edge e o armazenamento compatível com o Amazon S3 no Snowball Edge. Em seguida, use essas ferramentas para configurar o dispositivo ou cluster do Snowball Edge e iniciar o armazenamento compatível com o Amazon S3 no Snowball Edge.
## Pré-requisitos
O armazenamento compatível com o Amazon S3 no Snowball Edge exige que você tenha o cliente Snowball Edge e o AWS CLI instalado em seu ambiente local. Você também pode usar o SDK para .NET AWS Tools for Windows PowerShell para trabalhar com armazenamento compatível com Amazon S3 no Snowball Edge. AWS recomenda o uso das seguintes versões dessas ferramentas:
+ **Snowball Edge Client**: use a versão mais recente. Para ter mais informações, consulte [Baixar e instalar o Snowball Edge Client](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client) neste guia.
+ **AWS CLI**: versão 2.11.15 ou mais recente. Para obter mais informações, consulte [Instalando, atualizando e desinstalando o AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) no Guia do AWS Command Line Interface Usuário.
+ **SDK para .NET**— AWSSDK .S3Control 3.7.304.8 ou mais recente. Para obter mais informações, consulte [AWS SDK para .NET](https://docs.aws.amazon.com/sdk-for-net).
+ **AWS Ferramentas para Windows PowerShell** — Versão 4.1.476 ou mais recente. Para obter mais informações, consulte o [Guia do usuário do Ferramentas da AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/).
## Configurar o ambiente local
Esta seção descreve como instalar e configurar o cliente Snowball Edge e seu ambiente local para uso com armazenamento compatível com Amazon S3 no Snowball Edge.
1. Baixe e instale o Snowball Edge Client. Para ter mais informações, consulte [Baixar e instalar o Snowball Edge Client](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client).
1. Configure um perfil para o Snowball Edge Client. Para ter mais informações, consulte [Configurar um perfil para o Snowball Edge Client](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#client-configuration).
1. Se você estiver usando SDK para .NET, defina o valor do `clientConfig.AuthenticationRegion` parâmetro da seguinte forma:
```
clientConfig.AuthenticationRegion = "snow"
```
### Configuração de seu dispositivo Snowball Edge
#### Configurar o IAM no Snowball Edge
AWS Identity and Access Management (IAM) ajuda você a habilitar o acesso granular aos AWS recursos que são executados em seus dispositivos Snowball Edge. Você usa o IAM para controlar quem é autenticado (fez login) e autorizado (tem permissões) a usar os recursos.
O IAM é aceito localmente no Snowball Edge. É possível usar o serviço local do IAM para criar perfis e anexar políticas do IAM a eles. É possível usar essas políticas para permitir o acesso necessário para realizar as tarefas atribuídas.
O exemplo a seguir permite acesso total à API do Amazon S3:
------
#### [ JSON ]
****
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "s3:*",
"Resource": "*"
}
]
}
```
------
Para obter exemplos de políticas do IAM, consulte o [Guia do desenvolvedor da AWS Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-local-iam.html#policy-examples).
## Iniciando o armazenamento compatível com Amazon S3 no serviço Snowball Edge
Use as instruções a seguir para iniciar o serviço de armazenamento compatível com Amazon S3 no Snowball Edge em um dispositivo ou cluster do Snowball Edge.
Se preferir uma experiência mais fácil de usar, você pode iniciar o serviço de armazenamento compatível com Amazon S3 no Snowball Edge para um dispositivo independente ou um cluster de dispositivos usando. AWS OpsHub Consulte [Configure o armazenamento compatível com o Amazon S3 no Snowball Edge com AWS OpsHub](s3-edge-snow-opshub.md).
1. Desbloqueie seu dispositivo Snowball Edge ou cluster de dispositivos executando o seguinte comando:
+ Para um único dispositivo:
```
snowballEdge unlock-device --endpoint https://snow-device-ip
```
+ Para um cluster:
```
snowballEdge unlock-cluster
```
1. Execute o seguinte comando e verifique se o dispositivo Snowball Edge ou o cluster de dispositivos está desbloqueado:
+ Para um único dispositivo:
```
snowballEdge describe-device --endpoint https://snow-device-ip
```
+ Para um 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. Para cada dispositivo (se você tem um ou um cluster), para iniciar o armazenamento compatível com o Amazon S3 no Snowball Edge, faça o seguinte:
1. Obtenha os `PhysicalNetworkInterfaceId` dos dispositivos executando o comando `describe-device` a seguir:
```
snowballEdge describe-device --endpoint https://snow-device-ip
```
1. Execute o `create-virtual-network-interface` comando a seguir duas vezes para criar as interfaces de rede virtual (VNIs) para os endpoints `s3control` (para operações de bucket) e `s3api` (para operações de 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
```
O comando retorna uma estrutura JSON que inclui o endereço IP. Anote esse endereço IP.
Para obter detalhes sobre esses comandos, consulte [Configuração de uma interface de rede virtual (VNI) em um Snowball](https://docs.aws.amazon.com/snowball/latest/developer-guide/network-config-ec2.html#setup-vni) Edge.
**nota**
Iniciar o armazenamento compatível com o Amazon S3 no Snowball Edge consome recursos do dispositivo.
1. Inicie o armazenamento compatível com o Amazon S3 no serviço Snowball Edge executando o seguinte `start-service` comando, que inclui os endereços IP dos seus dispositivos e os nomes de recursos da Amazon (ARNs) dos VNIs que você criou para os endpoints e: `s3control` `s3api`
Para iniciar o serviço em um único 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
```
Como iniciar o serviço em um 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
```
Para`--virtual-network-interface-arns`, ARNs inclua tudo o VNIs que você criou na etapa anterior. Separe cada ARN usando um espaço.
1. Execute o comando `describe-service` a seguir para um único dispositivo:
```
snowballEdge describe-service --service-id s3-snow
```
Espere até que o status do serviço seja `Active`.
Execute o comando `describe-service` a seguir para um cluster:
```
snowballEdge describe-service --service-id s3-snow \
--device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip
```
## Visualização de informações sobre armazenamento compatível com Amazon S3 em endpoints do Snowball Edge
Quando o armazenamento compatível com o Amazon S3 no serviço Snowball Edge está em execução, você pode usar o comando `describe-service` Snowball Edge Client para visualizar os endereços IP associados aos endpoints s3control e s3api.
```
snowballEdge describe-service --service-id s3-snow --endpoint https://snow-device-ip-address --profile profile-name
```
**Example saída do comando `describe-service`**
Neste exemplo, o endereço IP do endpoint s3control é 192.168.1.222 e o endereço IP do endpoint s3api é 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"
}
}
]
}
```