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á.
# Configurar e usar o Snowball Edge Client
O cliente Snowball Edge é uma ferramenta de interface de linha de comando (CLI) AWS que você pode usar para trabalhar com um Snowball Edge ou um cluster do Snowball Edge. Você pode usar o cliente para desbloquear um Snowball Edge ou um cluster de dispositivos, configurar o Snowball Edge, iniciar e interromper serviços em dispositivos e transferir dados de ou para dispositivos. O Snowball Edge Client é aceito em computadores em execução nos sistemas operacionais Linux, macOS e Windows.
**Topics**
+ [Baixar e instalar o Snowball Edge Client](#download-the-client)
+ [Configurar um perfil para o Snowball Edge Client](#client-configuration)
+ [Encontrar a versão do Snowball Edge Client](#cli-version)
+ [Obtendo credenciais para um Snowball Edge](#client-credentials)
+ [Iniciando um serviço em um Snowball Edge](#edge-start-service)
+ [Interrompendo um serviço em um Snowball Edge](#edge-stop-service)
+ [Visualizando e baixando registros do Snowball Edge](#logs)
+ [Visualizando o status de um Snowball Edge](#client-status)
+ [Visualizando o status dos serviços em execução no Snowball Edge](#client-service-status)
+ [Visualizando o status dos recursos do Snowball Edge](#snowball-edge-describe-features)
+ [Configurando servidores de horário para o Snowball Edge](#client-set-ntp)
+ [Receber um código QR para validar as tags NFC do Snowball Edge](#client-qr-code)
+ [Atualizar o tamanho da MTU](#update-mtu-size)
## Baixar e instalar o Snowball Edge Client
É possível baixar o Snowball Edge Client por meio dos [Recursos do AWS Snowball Edge](https://aws.amazon.com/snowball/resources/). Nessa página, você pode encontrar o pacote de instalação para o sistema operacional.
Instale e configure o cliente de acordo com as instruções abaixo.
------
#### [ Linux ]
**nota**
O Snowball Edge Client só é compatível com distribuições Linux de 64 bits.
1. Extraia o arquivo `snowball-client-linux.tar.gz`. Ele cria a estrutura de pastas `/snowball-client-linux-build_number/bin` e extrai os arquivos.
1. Execute os comandos a seguir para configurar as pastas.
```
chmod u+x snowball-client-linux-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-linux-build_number/jre/bin/java
```
1. Adicione `/snowball-client-linux-build_number/bin` à variável de ambiente \$1PATH do sistema operacional para executar comandos do Snowball Edge Client em qualquer diretório. Para ter mais informações, consulte a documentação do sistema operacional do dispositivo ou o shell.
------
#### [ macOS ]
1. Extraia o arquivo `snowball-client-mac.tar.gz`. Ele cria a estrutura de pastas `/snowball-client-linux-build_number/bin` e extrai os arquivos.
1. Execute os comandos a seguir para configurar as pastas.
```
chmod u+x snowball-client-mac-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-mac-build_number/jre/bin/java
```
1. Adicione `/snowball-client-mac-build_number/bin` à variável de ambiente \$1PATH do sistema operacional para executar comandos do Snowball Edge Client em qualquer diretório. Para ter mais informações, consulte a documentação do sistema operacional do dispositivo ou o shell.
------
#### [ Windows ]
O cliente é embalado como um arquivo Microsoft Software Installer (MSI). Abra o arquivo e siga os prompts no assistente de instalação. Quando o cliente estiver instalado, ele poderá ser executado a por meio de qualquer diretório sem nenhuma preparação adicional.
------
## Configurar um perfil para o Snowball Edge Client
Toda vez que você executa um comando para o cliente Snowball Edge, você fornece seu arquivo manifesto, o código de desbloqueio e o endereço IP do Snowball Edge. Em vez de fornecê-las toda vez que você executa um comando, você pode usar o `configure` comando para armazenar o caminho para o arquivo de manifesto, o código de desbloqueio de 29 caracteres e o endpoint (o endereço IP do Snowball Edge) como um perfil. Após a configuração, é possível usar os comandos do Snowball Edge Client sem precisar inserir manualmente esses valores para cada comando, incluindo o nome do perfil com o comando. Depois de configurar o Snowball Edge Client, as informações serão salvas em um formato JSON de texto simples em `home directory/.aws/snowball/config/snowball-edge.config`. Assegure-se de que o ambiente esteja configurado para permitir a criação desse arquivo.
**Importante**
Qualquer pessoa que possa acessar o arquivo de configuração poderá acessar os dados nos seus dispositivos ou clusters do Snowball Edge. Gerenciar o controle de acesso local a este arquivo é uma das suas responsabilidades administrativas.
Você também pode usar AWS OpsHub para criar um perfil. Os perfis criados em AWS OpsHub estão disponíveis para uso com o Snowball Edge Client e os perfis criados em AWS OpsHub estão disponíveis para uso com o Snowball Edge Client. Para ter mais informações, consulte [Gerenciar perfis](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-device.html#manage-profile).
**Como criar um perfil**
1. Insira o comando na interface da linha de comandos do sistema operacional. O valor do parâmetro `profile-name` é o nome do perfil. Você o fornecerá no futuro ao executar os comandos do Snowball Edge Client.
```
snowballEdge configure --profile profile-name
```
1. O Snowball Edge Client solicitará que você forneça cada parâmetro. Quando solicitado, insira as informações do seu ambiente e do Snowball Edge.
**nota**
O valor do `endpoint` parâmetro é o endereço IP do Snowball Edge, precedido por. `https://` É possível localizar o endereço IP do dispositivo Snowball Edge na tela LCD, na parte frontal do dispositivo.
**Example saída do comando `configure`**
```
Configuration will stored at home directory\.aws\snowball\config\snowball-edge.config
Snowball Edge Manifest Path: /Path/to/manifest/file
Unlock Code: 29 character unlock code
Default Endpoint: https://192.0.2.0
```
O Snowball Edge Client vai conferir se o código de desbloqueio está correto para o arquivo de manifesto. Se eles não coincidirem, o comando será interrompido e não criará o perfil. Confira o código de desbloqueio e o arquivo de manifesto e execute o comando novamente.
Para usar o perfil, inclua `--profile profile-name` após a sintaxe do comando.
Se você estiver usando vários Snowball Edge autônomos, poderá criar um perfil para cada um. Para criar outro perfil, execute o comando `configure` novamente, forneça um valor diferente para o parâmetro `--profile` e forneça as informações para outro dispositivo.
**Example Exemplo de arquivo `snowball-edge.config`**
Este exemplo mostra um arquivo de perfil contendo três perfis: `SnowDevice1profile``SnowDevice2profile` e `SnowDevice3profile`.
```
{"version":1,"profiles":
{
"SnowDevice1profile":
{
"name":"SnowDevice1profile",
"jobId":"JID12345678-136f-45b4-b5c2-847db8adc749",
"unlockCode":"db223-12345-dbe46-44557-c7cc2",
"manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-136f-45b4-b5c2-847db8adc749_manifest-1670622989203.bin",
"defaultEndpoint":"https://10.16.0.1",
"isCluster":false,
"deviceIps":[]
},
},
"SnowDevice2profile":
{
"name":"SnowDevice2profile",
"jobId":"JID12345678-fdb2-436a-a4ff-7c510dec1bae",
"unlockCode":"b893b-54321-0f65c-6c5e1-7f748",
"manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-fdb2-436a-a4ff-7c510dec1bae_manifest-1670623746908.bin",
"defaultEndpoint":"https://10.16.0.2",
"isCluster":false,
"deviceIps":[]
},
"SnowDevice3profile":
{
"name":"SnowDevice3profile",
"jobId":"JID12345678-c384-4a5e-becd-ab5f38888463",
"unlockCode":"64c89-13524-4d054-13d93-c1b80",
"manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-c384-4a5e-becd-ab5f38888463_manifest-1670623999136.bin",
"defaultEndpoint":"https://10.16.0.3",
"isCluster":false,
"deviceIps":[]
}
}
```
Para editar ou excluir perfis, edite o arquivo de perfil em um editor de texto.
**Como editar um perfil**
1. Em um editor de texto, abra `snowball-edge.config` em `home directory\.aws\snowball\config`.
**nota**
Assegure-se de que o ambiente esteja configurado para permitir que você acesse para ler e gravar esse arquivo.
1. Edite esse arquivo conforme for necessário. Por exemplo, para alterar o endereço IP do Snowball Edge associado ao perfil, altere a `defaultEndpoint` entrada.
1. Salve e feche o arquivo.
**Como excluir um perfil**
1. Usando um editor de texto, abra `snowball-edge.config` em `home directory\.aws\snowball\config`.
**nota**
Assegure-se de que o ambiente esteja configurado para permitir que você acesse para ler e gravar esse arquivo.
1. Exclua a linha que contém o nome do perfil, os colchetes `{` `}` que seguem o nome do perfil e o conteúdo dentro desses colchetes.
1. Salve e feche o arquivo.
## Encontrar a versão do Snowball Edge Client
Use o comando `version` para ver a versão do cliente da interface de linha de comando (CLI) do Snowball Edge.
**Uso**
```
snowballEdge version
```
**Exemplo de saída**
```
Snowball Edge client version: 1.2.0 Build 661
```
## Obtendo credenciais para um Snowball Edge
Usando os `snowballEdge get-secret-access-key` comandos `snowballEdge list-access-keys` e, você pode obter as credenciais do usuário administrador do seu Conta da AWS no Snowball Edge. Você pode usar essas credenciais para criar AWS Identity and Access Management (usuários do IAM) e funções, além de autenticar suas solicitações ao usar o AWS CLI ou com um AWS SDK. Essas credenciais só estão associadas a um trabalho individual para o Snowball Edge, e você pode usá-las apenas no dispositivo ou cluster de dispositivos. Os dispositivos não têm permissões do IAM na Nuvem AWS.
**nota**
Se você estiver usando o AWS CLI com o Snowball Edge, deverá usar essas credenciais ao configurar a CLI. *Para obter informações sobre como configurar credenciais para o AWS CLI, consulte [Configurando o AWS CLI no Guia do](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration)AWS Command Line Interface Usuário.*
**Uso (Snowball Edge Client configurado)**
```
snowballEdge list-access-keys
```
**Example Saída**
```
{
"AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}
```
**Uso (Snowball Edge Client configurado)**
```
snowballEdge get-secret-access-key --access-key-id Access Key
```
**Example Saída**
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
## Iniciando um serviço em um Snowball Edge
Os dispositivos Snowball Edge aceitam vários serviços. Isso inclui instâncias de computação, a interface do Network File System (NFS), o Snowball Edge Device Management e. AWS IoT Greengrass O serviço de adaptador Amazon S3 EC2 AWS STS, Amazon e IAM são iniciados por padrão e não podem ser interrompidos ou reiniciados. No entanto, a interface NFS, Snowball Edge Device Management, AWS IoT Greengrass pode ser iniciada usando sua ID de serviço com `start-service` o comando. Para obter o ID de serviço para cada serviço, use o comando `list-services`.
Antes de executar esse comando, crie uma única interface de rede virtual para vincular ao serviço que está iniciando. Para obter mais informações, consulte [Criando uma interface de rede virtual em um Snowball Edge](using-ec2-edge-client.md#ec2-edge-create-vnic).
```
snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn --profile profile-name
```
**Example saída do comando `start-service`**
```
Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.
```
## Interrompendo um serviço em um Snowball Edge
Para interromper a execução de um serviço em um Snowball Edge, você pode usar o `stop-service` comando.
Os serviços do adaptador Amazon S3 EC2 AWS STS, Amazon e IAM não podem ser interrompidos.
**Atenção**
Poderá ocorrer perda de dados se o serviço NFS (Network File System) for interrompido antes que os dados em buffer restantes sejam gravados no dispositivo. Para ter mais informações sobre como usar o serviço NFS, consulte [Gerenciando a interface NFS no Snowball Edge](shared-using-nfs.md).
**nota**
A interrupção do armazenamento compatível com o Amazon S3 no serviço Snowball Edge desativa o acesso aos dados armazenados em seus buckets do S3 no dispositivo ou cluster. O acesso é restaurado quando o armazenamento compatível com Amazon S3 no Snowball Edge é reiniciado. Para dispositivos habilitados com armazenamento compatível com Amazon S3 no Snowball Edge, é recomendável iniciar o serviço depois que o dispositivo Snowball Edge for ligado. Consulte [Configuração do Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/s3compatible-on-snow.html#setting-up-s3-on-snow-cluster) neste guia.
```
snowballEdge stop-service --service-id service_id --profile profile-name
```
**Example saída do comando `stop-service`**
```
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.
```
## Visualizando e baixando registros do Snowball Edge
Ao transferir dados entre o datacenter local e um Snowball Edge, os logs são gerados automaticamente. Se forem encontrados erros inesperados durante a transferência de dados para o dispositivo, use os comandos a seguir para salvar uma cópia dos logs no servidor local.
Há três comandos relacionados a logs:
+ `list-logs`: retorna uma lista de logs no formato JSON. Esta lista relata o tamanho dos logs em bytes, além do ARN, ID de serviço e tipo dos logs.
**Uso**
```
snowballEdge list-logs --profile profile-name
```
**Example saída do comando `list-logs`**
```
{
"Logs" : [ {
"LogArn" : "arn:aws:snowball-device:::log/s3-storage-JIEXAMPLE2f-1234-4953-a7c4-dfEXAMPLE709",
"LogType" : "SUPPORT",
"ServiceId" : "s3",
"EstimatedSizeBytes" : 53132614
}, {
"LogArn" : "arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709",
"LogType" : "CUSTOMER",
"ServiceId" : "fileinterface",
"EstimatedSizeBytes" : 4446
}]
}
```
+ `get-log`: baixa uma cópia de um log específico do Snowball Edge para o dispositivo em um caminho especificado. Os logs `CUSTOMER` são salvos no formato `.zip`, e você pode extrair esse tipo de log para visualizar o conteúdo. Os logs do `SUPPORT` são criptografados e só podem ser lidos pelo AWS Support. Você tem a opção de especificar um nome e um caminho para o log.
**Uso**
```
snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709 --profile profile-name
```
**Example saída do comando `get-log`**
```
Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin
```
+ `get-support-logs`: baixa a cópia de todos os logs de tipo `SUPPORT` a partir do Snowball Edge para o seu serviço em um caminho específico.
**Uso**
```
snowballEdge get-support-logs --profile profile-name
```
**Example saída do comando `get-support-logs`**
```
Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
```
**Importante**
O tipo `CUSTOMER` pode conter informações confidenciais sobre seus próprios dados. Para proteger essas informações potencialmente confidenciais, sugerimos que você exclua esses logs assim que concluir o uso deles.
## Visualizando o status de um Snowball Edge
Você pode determinar o status e a integridade geral do Snowball Edge com o `describe-device` comando.
```
snowballEdge describe-device --profile profile-name
```
**Example saída do comando `describe-device`**
```
{
"DeviceId": "JID-EXAMPLE12345-123-456-7-890",
"UnlockStatus": {
"State": "UNLOCKED"
},
"ActiveNetworkInterface": {
"IpAddress": "192.0.2.0"
},
"PhysicalNetworkInterfaces": [
{
"PhysicalNetworkInterfaceId": "s.ni-EXAMPLEd9ecbf03e3",
"PhysicalConnectorType": "RJ45",
"IpAddressAssignment": "STATIC",
"IpAddress": "0.0.0.0",
"Netmask": "0.0.0.0",
"DefaultGateway": "192.0.2.1",
"MacAddress": "EX:AM:PL:E0:12:34"
},
{
"PhysicalNetworkInterfaceId": "s.ni-EXAMPLE4c3840068f",
"PhysicalConnectorType": "QSFP",
"IpAddressAssignment": "STATIC",
"IpAddress": "0.0.0.0",
"Netmask": "0.0.0.0",
"DefaultGateway": "192.0.2.2",
"MacAddress": "EX:AM:PL:E0:56:78"
},
{
"PhysicalNetworkInterfaceId": "s.ni-EXAMPLE0a3a6499fd",
"PhysicalConnectorType": "SFP_PLUS",
"IpAddressAssignment": "DHCP",
"IpAddress": "192.168.1.231",
"Netmask": "255.255.255.0",
"DefaultGateway": "192.0.2.3",
"MacAddress": "EX:AM:PL:E0:90:12"
}
]
}
```
## Visualizando o status dos serviços em execução no Snowball Edge
Você pode determinar o status e a integridade geral dos serviços que funcionam nos dispositivos Snowball Edge usando o comando `describe-service`. Você pode primeiro executar o comando `list-services` para ver quais serviços estão em execução.
+ `list-services`
**Uso**
```
snowballEdge list-services --profile profile-name
```
**Example saída do comando `list-services`**
```
{
"ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}
```
+ `describe-service`
Esse comando retorna um valor de status para um serviço. Ele também inclui informações de estado que podem ser úteis ao resolver problemas encontrados no serviço. Esses estados são os seguintes.
+ `ACTIVE` – o serviço está em execução e disponível para o uso.
+ `ACTIVATING` – o serviço está iniciando, mas ainda não está disponível para o uso.
+ `DEACTIVATING` – o serviço está no processo de desligamento.
+ `DEGRADED`— Para armazenamento compatível com Amazon S3 no Snowball Edge, esse status indica que um ou mais discos ou dispositivos no cluster estão inativos. O armazenamento compatível com o Amazon S3 no serviço Snowball Edge está funcionando sem interrupções, mas você deve recuperar ou substituir o dispositivo afetado antes que o quorum do cluster seja perdido para minimizar o risco de perda de dados. Consulte a [Visão geral do cluster](https://docs.aws.amazon.com/snowball/latest/developer-guide/ClusterOverview.html) neste guia.
+ `INACTIVE` – o serviço não está em execução e não está disponível para o uso.
**Uso**
```
snowballEdge describe-service --service-id service-id --profile profile-name
```
**Example saída do comando `describe-service`**
```
{
"ServiceId": "s3",
"Status": {
"State": "ACTIVE"
},
"Storage": {
"TotalSpaceBytes": 99608745492480,
"FreeSpaceBytes": 99608744468480
},
"Endpoints": [
{
"Protocol": "http",
"Port": 8080,
"Host": "192.0.2.0"
},
{
"Protocol": "https",
"Port": 8443,
"Host": "192.0.2.0",
"CertificateAssociation": {
"CertificateArn": "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
}
}
]
}
```
**Example Armazenamento compatível com Amazon S3 na saída do serviço Snowball Edge**
O comando `describe-service` fornece a seguinte saída para o valor *s3-snow* do parâmetro `service-id`.
```
{
"ServiceId" : "s3-snow",
"Autostart" : false,
"Status" : {
"State" : "ACTIVE"
},
"ServiceCapacities" : [ {
"Name" : "S3 Storage",
"Unit" : "Byte",
"Used" : 640303104,
"Available" : 219571981512
} ],
"Endpoints" : [ {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.123",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.202",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.63",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.243",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.220",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.55",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.213",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.144",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.143",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.224",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2",
"Status" : {
"State" : "ACTIVE"
}
} ]
}
```
## Visualizando o status dos recursos do Snowball Edge
Para listar o status dos recursos disponíveis em um Snowball Edge, use o `describe-features` comando.
`RemoteManagementState`indica o status do Gerenciamento de dispositivos do Snowball Edge e retorna um dos seguintes estados:
+ `INSTALLED_ONLY`: o atributo está instalado, mas não ativado.
+ `INSTALLED_AUTOSTART`— O recurso está ativado e o dispositivo tentará se conectar ao mesmo Região da AWS quando estiver ligado.
+ `NOT_INSTALLED`: o dispositivo não suporta o atributo ou já estava em campo antes de seu lançamento.
**Uso**
```
snowballEdge describe-features --profile profile-name
```
**Example saída do comando `describe-features`**
```
{
"RemoteManagementState" : String
}
```
## Configurando servidores de horário para o Snowball Edge
É possível usar os comandos do Snowball Edge Client para visualizar a configuração atual do Network Time Protocol (NTP) e escolher um servidor ou um par para fornecer a hora. É possível usar os comandos do Snowball Edge Client quando o dispositivo está nos estados bloqueado e desbloqueado.
É sua responsabilidade fornecer um servidor de horário NTP seguro. Para definir a quais servidores de horário NTP o dispositivo se conecta, use o comando `update-time-servers`.
### Verificando as fontes de tempo do Snowball Edge
Para ver a quais origens de horário de NTP o dispositivo está conectado atualmente, use o comando `describe-time-sources`.
```
snowballEdge describe-time-sources --profile profile-name
```
**Example saída do comando `describe-time-sources`**
```
{
"Sources" : [ {
"Address" : "172.31.2.71",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "172.31.3.203",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "172.31.0.178",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "172.31.3.178",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "216.239.35.12",
"State" : "CURRENT",
"Type" : "SERVER",
"Stratum" : 1
} ]
}
```
O comando `describe-time-sources` retorna uma lista dos estados da fonte de tempo. Cada estado da fonte de tempo contém os campos `Address`, `State`, `Type` e `Stratum` A seguir estão os significados desses campos.
+ `Address`: o nome DNS/endereço IP da fonte de horário.
+ `State`: o status atual da conexão entre o dispositivo e essa fonte de tempo. Existem cinco estados possíveis:
+ `CURRENT`: a fonte de tempo está sendo usada atualmente para sincronizar a hora.
+ `COMBINED`: a fonte de tempo é combinada com a fonte atual.
+ `EXCLUDED`: a fonte de tempo é excluída pelo algoritmo de combinação.
+ `LOST`: a conexão com a fonte de tempo foi perdida.
+ `UNACCEPTABLE`: uma fonte de tempo inválida em que o algoritmo de combinação foi considerado falso ou tem muita variabilidade.
+ `Type`: uma fonte de horário NTP pode ser um servidor ou um peer. Os servidores podem ser configurados pelo comando `update-time-servers`. Os pares só podem ser outros dispositivos Snowball Edge Edge no cluster e são configurados automaticamente quando o cluster é associado.
+ `Stratum`: esse campo mostra o estrato da fonte. O estrato 1 indica uma fonte com um relógio de referência conectado localmente. Uma fonte sincronizada com uma fonte do estrato 1 está no estrato 2. Uma fonte sincronizada com uma fonte do estrato 2 está no estrato 3 e assim por diante.
Uma fonte de horário NTP pode ser um servidor ou um peer. Um servidor pode ser configurado pelo usuário com o `update-time-servers` comando, enquanto um par só pode ser outros dispositivos Snowball Edge Edge no cluster. No exemplo de saída, `describe-time-sources` é chamado em um Snowball Edge Edge que está em um cluster de 5. A saída contém 4 pares e 1 servidor. Os pares têm um estrato de 10, enquanto o servidor tem um estrato de 1; portanto, o servidor é selecionado para ser a fonte de horário atual.
### Atualizar servidores de horário
Use o `update-time-servers` comando e o endereço do servidor de horário para configurar o Snowball Edge para usar um servidor NTP ou um peer para NTP.
```
snowballEdge update-time-servers time-server-address --profile profile-name
```
**nota**
O comando `update-time-servers` substituirá as configurações anteriores dos servidores de horário NTP.
**Example saída do comando `update-time-servers`**
```
Updating time servers now.
```
## Receber um código QR para validar as tags NFC do Snowball Edge
Você pode usar esse comando para gerar um código QR específico do dispositivo para uso com o aplicativo de verificação do AWS Snowball Edge . Para obter mais informações sobre validação de NFC, consulte [Validação de tags NFC](data-protection.md#nfc-validation).
**Uso**
```
snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png --profile profile-name
```
**Example Saída**
```
QR code is saved to ~/downloads/snowball-qr-code.png
```
## Atualizar o tamanho da MTU
Use o `update-mtu-size` comando para modificar o tamanho em bytes da unidade máxima de transmissão (MTU) de uma interface física de um dispositivo Snowball Edge. Todas as interfaces de rede virtual e a interface de rede direta associadas a essa interface de rede física serão configuradas com o mesmo tamanho de MTU.
**nota**
O tamanho mínimo da MTU é 1.500 bytes e o tamanho máximo é 9.216 bytes.
Você pode usar o `describe-device` comando para recuperar a interface de rede física IDs e os tamanhos atuais de MTU dessas interfaces. Para obter mais informações, consulte [Visualizando o status de um Snowball Edge](#client-status).
É possível usar os comandos `descibe-direct-network-interface` e `describe-virtual-network-interface` para recuperar os tamanhos atuais de MTU dessas interfaces.
**Uso**
```
snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes --profile profile-name
```
**Example Exemplo da saída `update-mtu-size`**
```
{
"PhysicalNetworkInterface": {
"PhysicalNetworkInterfaceId": "s.ni-8c1f891d7f5b87cfe",
"PhysicalConnectorType": "SFP_PLUS",
"IpAddressAssignment": "DHCP",
"IpAddress": "192.0.2.0",
"Netmask": "255.255.255.0",
"DefaultGateway": "192.0.2.255",
"MacAddress": "8A:2r:5G:9p:6Q:4s",
"MtuSize": "5743"
}
}
```