Usando os comandos do cliente Snowball Edge - AWS Snowball Edge Guia do desenvolvedor

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á.

Usando os comandos do cliente Snowball Edge

A seguir, você encontrará informações sobre os comandos do cliente Snowball Edge para uso com o dispositivo da família Snow. Cada comando inclui exemplos de uso e exemplos de saídas. O cliente Snowball Edge é um aplicativo de linha de comando autônomo que você executa em seu dispositivo para desbloquear, configurar e controlar o dispositivo da família Snow. Você também pode usar o cliente com clusters de dispositivos da família Snow. Ao usar o Snowball Edge Client, você pode obter informações de suporte adicionais executando o comando snowballEdge help.

Para baixar o cliente Snowball Edge, consulte. Baixar e instalar o cliente do Snowball Edge

Configurar um perfil para o Snowball Edge Client

Toda vez que você executar um comando para o Snowball Edge Client, forneça o arquivo manifesto, código de desbloqueio e um endereço IP. Você pode obter os dois primeiros na API de gerenciamento de tarefas Console de Gerenciamento da família AWS Snow ou na API de gerenciamento de tarefas. Para obter mais informações sobre como obter o código de manifesto e de desbloqueio, consulte Obter credenciais para acessar um dispositivo Snow Family.

Você tem a opção de usar o comando snowballEdge configure para armazenar o caminho até o manifesto, o código de desbloqueio de 29 caracteres e o endpoint como um perfil. Após a configuração, será possível usar outros comandos do Snowball Edge Client sem precisar inserir manualmente esses valores para um trabalho específico. 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.

O endpoint é o endereço IP, com https:// adicionado a ele. Você pode localizar o endereço IP do AWS Snowball Edge dispositivo na tela LCD do AWS Snowball Edge dispositivo. Quando o AWS Snowball Edge dispositivo é conectado à sua rede pela primeira vez, ele obtém automaticamente um endereço IP DHCP, se um servidor DHCP estiver disponível. Se quiser usar um endereço IP diferente, é possível alterá-lo na tela LCD. Para ter mais informações, consulte Usando um dispositivo AWS Snowball Edge.

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.

Uso

Você pode usar esse comando de duas formas: em linha ou quando solicitado. Este exemplo de uso mostra o método solicitado.

snowballEdge configure
exemplo Saída
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

Você pode ter múltiplos perfis se tiver vários trabalhos ao mesmo tempo ou se quiser a opção de gerenciar um cluster a partir de diferentes endpoints. Para obter mais informações sobre vários AWS CLI perfis, consulte Perfis nomeados no Guia AWS Command Line Interface do usuário.

Obter o código QR para validação NFC

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.

Uso

snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png
exemplo Saída
QR code is saved to ~/downloads/snowball-qr-code.png

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

Desbloquear dispositivos do Snowball Edge

Para desbloquear um AWS Snowball Edge dispositivo independente, execute o snowballEdge unlock-device comando. Para desbloquear um cluster, use o comando snowballEdge unlock-cluster. Esses comandos autenticam seu acesso ao dispositivo AWS Snowball Edge .

nota

Para desbloquear os dispositivos associados ao seu trabalho, eles devem estar no local, ligados e conectados à rede e à alimentação. Além disso, o display LCD na parte frontal do AWS Snowball Edge dispositivo deve indicar que o dispositivo está pronto para uso.

Uso

snowballEdge unlock-device --endpoint https://192.0.2.0 --manifest-file Path/to/manifest/file --unlock-code 01234-abcde-ABCDE-01234
exemplo Entrada de desbloqueio de dispositivo individual
snowballEdge unlock-device --endpoint https://192.0.2.0 --manifest-file /usr/home/manifest.bin --unlock-code 01234-abcde-ABCDE-01234
exemplo Saída de desbloqueio de dispositivo individual
Your Snowball Edge device is unlocking. You may determine the unlock state of your device using the describe-device command. Your Snowball Edge device will be available for use when it is in the UNLOCKED state.

Uso do cluster

Ao desbloquear um cluster, forneça o endpoint para um dos seus nós, além de todos os endereços IP para os outros dispositivos no seu cluster.

snowballEdge unlock-cluster --endpoint https://192.0.2.0 --manifest-file Path/to/manifest/file --unlock-code 01234-abcde-ABCDE-01234 --device-ip-addresses 192.0.2.0 192.0.2.1 192.0.2.2 192.0.2.3 192.0.2.4
exemplo Saída de desbloqueio de cluster
Your Snowball Edge Cluster is unlocking. You may determine the unlock state of your cluster using the describe-device command. Your Snowball Edge Cluster will be available for use when your Snowball Edge devices are in the UNLOCKED state.

Atualização de um Snowball Edge

Use os comandos a seguir para fazer download e instalar atualizações para seu dispositivo Snowball Edge. Para obter os procedimentos que usam esses comandos, consulte Atualização de software em dispositivos Snowball Edge.

snowballEdge check-for-updates: retorna informações sobre a versão do software Snowball Edge disponível na nuvem e a versão atual instalada no dispositivo.

Uso (Snowball Edge Client configurado)

snowballEdge check-for-updates
exemplo Saída
Latest version: 102 Installed version: 101

snowballEdge describe-device-software: retorna a versão atual do software e a data de validade do certificado SSL do dispositivo. Além disso, se a atualização do software estiver sendo baixada ou instalada, o estado do download também será exibido. Uma lista das saídas possíveis é mostrada a seguir:

  • NA: nenhuma atualização de software está em andamento no momento.

  • Downloading: novo software está sendo obtido por download.

  • Installing: novo software está sendo instalado.

  • Requires Reboot: novo software foi instalado, e o dispositivo precisa ser reiniciado.

    Atenção

    É altamente recomendável suspender todas as atividades no dispositivo antes de reiniciá-lo. A reinicialização de um dispositivo interrompe a execução de instâncias e interrompe qualquer gravação nos buckets do Amazon S3 no dispositivo. Todos esses processos podem resultar em perda de dados.

Uso (Snowball Edge Client configurado)

snowballEdge describe-device-software
exemplo Saída
Installed version: 101 Installing version: 102 Install State: Downloading CertificateExpiry: Thur Jan 01 00:00:00 UTC 1970

snowballEdge download-updates: inicia o download das atualizações mais recentes do Snowball Edge.

Uso (Snowball Edge Client configurado)

snowballEdge download-updates
exemplo Saída
Download started. Run describe-device-software API for additional information.

snowballEdge install-updates: inicia a instalação das atualizações mais recentes do Snowball Edge que já foram baixadas.

Uso (Snowball Edge Client configurado)

snowballEdge install-updates
exemplo Saída
Installation started.

snowballEdge reboot-device: reinicia o dispositivo.

Atenção

É altamente recomendável suspender todas as atividades no dispositivo antes de reiniciá-lo. A reinicialização de um dispositivo interrompe a execução de instâncias e interrompe qualquer gravação nos buckets do Amazon S3 no dispositivo. Todos esses processos podem resultar em perda de dados.

Uso (Snowball Edge Client configurado)

snowballEdge reboot-device
exemplo Saída
Rebooting device now.

snowballEdge configure-auto-update-strategies: configura uma estratégia de atualização automática.

Uso (Snowball Edge Client configurado)

snowballEdge configure-auto-update-strategy --auto-check autoCheck [--auto-check-frequency autoCheckFreq] --auto-download autoDownload [--auto-download-frequency autoDownloadFreq] --auto-install autoInstall [--auto-install-frequency autoInstallFreq] --auto-reboot autoReboot [--endpoint endpoint]
exemplo Saída
Successfully configured auto update strategy. Run describe-auto-update-strategies for additional information.

snowballEdge describe-auto-update-strategies: retorna qualquer estratégia de atualização automática configurada atualmente.

Uso (Snowball Edge Client configurado)

snowballEdge describe-auto-update-strategies
exemplo Saída
auto-update-strategy {[ auto-check:true, auto-check-frequency: "0 0 * * FRI", // CRON Expression String, Every Friday at midnight auto-download:true, auto-download-frequency: "0 0 * * SAT", // CRON Expression String, Every Saturday at midnight auto-install:true, auto-install-frequency: "0 13 * * Sun", // CRON Expression String, Every Saturday at midnight auto-reboot: false; ]}

Como obter as credenciais

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 doAWS Command Line Interface Usuário.

Uso (Snowball Edge Client configurado)

snowballEdge list-access-keys
exemplo Saída
{ "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ] }

Uso (Snowball Edge Client configurado)

snowballEdge get-secret-access-key --access-key-id Access Key
exemplo Saída
[snowballEdge] aws_access_key_id = AKIAIOSFODNN7EXAMPLE aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Inicialização de um serviço no Snowball Edge

Os dispositivos Snowball Edge oferecem suporte a vários serviços, além do Amazon S3. Isso inclui instâncias de computação, a interface de arquivos e. AWS IoT Greengrass O Amazon S3 e o Amazon EC2 sempre estão ativados por padrão e não podem ser interrompidos ou reiniciados com o Snowball Edge Client. No entanto, a interface do arquivo AWS IoT Greengrass pode ser iniciada com o snowballEdge start-service comando. Para obter o ID de serviço para cada serviço, use o comando snowballEdge list-services.

Antes de executar esse comando, crie uma única interface de rede virtual para vincular ao serviço que está iniciando. Para ter mais informações, consulte Criação de uma interface de rede virtual.

Uso (Snowball Edge Client configurado)

snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn
exemplo Saída
Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Interrupção de um serviço no Snowball Edge

Para interromper um serviço em execução no Snowball Edge, use o comando snowballEdge stop-service.

O adaptador Amazon S3, o Amazon EC2 e os serviços do IAM não AWS STS podem ser interrompidos.

Atenção

A perda de dados pode ocorrer se a interface de arquivos for interrompida antes que os dados em buffer restantes sejam gravados no dispositivo. Para obter mais informações sobre como usar a interface de arquivos, consulte Gerenciando a interface NFS.

nota

A interrupção do serviço de armazenamento compatível com o Amazon S3 em dispositivos da Família Snow desativa o acesso aos dados armazenados em seus buckets do S3 no dispositivo ou cluster. O acesso é restaurado quando o armazenamento compatível com o Amazon S3 nos dispositivos da Família Snow é reiniciado. Para dispositivos habilitados com armazenamento compatível com o Amazon S3 em dispositivos da Família Snow, é recomendável iniciar o serviço depois que o dispositivo Snowball Edge for ligado. Consulte Configuração do Snowball Edge neste guia.

Uso (Snowball Edge Client configurado)

snowballEdge stop-service --service-id service_id
exemplo Saída
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Iniciando o NFS e restringindo o acesso

Importante

Não inicie o serviço NFS se você pretende usar o Amazon Elastic Block Store (Amazon EBS). Na primeira vez que o NFS é iniciado, todo o armazenamento é alocado ao NFS. Não é possível realocar o armazenamento NFS para o Amazon EBS, mesmo que o serviço NFS seja interrompido.

nota

É possível fornecer blocos CIDR para intervalos de IP que têm permissão para montar os compartilhamentos do NFS expostos pelo dispositivo. Por exemplo, 10.0.0.0/16. Se você não fornecer blocos CIDR permitidos, todas as solicitações de montagem serão negadas.

Lembre-se de que os dados transferidos por meio do NFS não são criptografados em trânsito.

Além dos hosts permitidos pelos blocos CIDR, o Snowcone não fornece nenhum mecanismo de autenticação ou de autorização para os compartilhamentos do NFS.

Inicie o NFS com o comando snowballEdge start-service. Para obter o ID de serviço para cada serviço, use o comando snowballEdge 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 Como criar uma interface de rede virtual. Você pode restringir o acesso aos seus compartilhamentos de arquivos e dados em seus buckets do Amazon S3 e ver quais restrições estão em vigor no momento. Você faz isso alocando blocos CIDR para hosts permitidos que podem acessar seu compartilhamento de arquivos e buckets do S3 quando você inicia o serviço NFS.

Uso (Snowball Edge Client configurado)

snowballEdge start-service --service-id nfs --virtual-network-interface-arns arn:aws:snowball-device:::interface/s.ni-12345fgh45678j --service-configuration AllowedHosts=ip address-1/32,ip address-2/24
exemplo Exemplos de resultado
Starting the service on your Snowball Edge. You can determine the status of the service using the describe-service command.

Restringindo o acesso aos compartilhamentos NFS quando o NFS está em execução

Você pode restringir o acesso aos seus compartilhamentos de arquivos e dados em seus buckets do Amazon S3 depois de iniciar o NFS. Você pode ver quais restrições estão em vigor no momento e atribuir restrições de acesso diferentes a cada bucket. Você faz isso alocando blocos CIDR para hosts que podem acessar seu compartilhamento de arquivos e buckets S3 quando você inicia o serviço NFS. O comando a seguir é um exemplo.

Uso (Snowball Edge Client configurado)

snowballEdge start-service \ --service-id nfs \ --virtual-network-interface-arns virtual-network-interface-arn --service-configuration AllowedHosts=ip-address-1/32,ip-address-1/24

Para ver as restrições atuais, use o comando describe-service.

snowballEdge describe-service --service-id nfs

AWS Snowball Edge Registros

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 (Snowball Edge Client configurado)

    snowballEdge list-logs
    exemplo Saída
    { "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— Faz o download de uma cópia de um registro específico do Snowball Edge para o seu servidor em um caminho especificado. CUSTOMERos registros são salvos no .zip formato e você pode extrair esse tipo de registro para visualizar seu conteúdo. SUPPORTos registros são criptografados e só podem ser lidos por AWS Support engenheiros. Você tem a opção de especificar um nome e um caminho para o log.

    Uso (Snowball Edge Client configurado)

    snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709
    exemplo Saída
    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 (Snowball Edge Client configurado)

    Snowball Edge Client

    snowballEdge get-support-logs
    exemplo Saída
    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.

Ver status do dispositivo

Você pode determinar o status e a integridade geral do seu dispositivo Snowball Edge usando os seguintes comandos do Snowball Edge Client:

  • describe-device

    Uso (Snowball Edge Client configurado)

    snowballEdge describe-device
    exemplo Saída
    { "DeviceId" : "JID-EXAMPLE12345-123-456-7-890", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.0" }, "PhysicalNetworkInterfaces" : [ { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLEd9ecbf03e3", "PhysicalConnectorType" : "QSFP", "IpAddressAssignment" : "STATIC", "IpAddress" : "0.0.0.0", "Netmask" : "0.0.0.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E0:12:34", "MtuSize" : "1500" }, { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLE4c3840068f", "PhysicalConnectorType" : "SFP_PLUS", "IpAddressAssignment" : "DHCP", "IpAddress" : "192.0.2.2", "Netmask" : "255.255.255.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E0:56:78", "MtuSize" : "5743" }, { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLE0a3a6499fd", "PhysicalConnectorType" : "RJ45", "IpAddressAssignment" : "STATIC", "IpAddress" : "0.0.0.0", "Netmask" : "0.0.0.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E0:90:12", "MtuSize" : "1500" } ], "DeviceCapacities" : [ { "Name" : "HDD Storage", "Unit" : "Byte", "Total" : 39736350227824, "Available" : 39707789471744 }, { "Name" : "SSD Storage", "Unit" : "Byte", "Total" : 6979321856000, "Available" : 6884832575488 }, { "Name" : "vCPU", "Unit" : "Number", "Total" : 52, "Available" : 49 }, { "Name" : "Memory", "Unit" : "Byte", "Total" : 223338299392, "Available" : 216895848448 }, { "Name" : "GPU", "Unit" : "Number", "Total" : 0, "Available" : 0 } ], "DeviceType" : "EDGE_C" }
  • describe-cluster

    Uso (Snowball Edge Client configurado)

    snowballEdge describe-cluster
    exemplo Saída
    { "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5", "Devices" : [ { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.0" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.1" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.2" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.3" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.4" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } } ] }

Ver status do serviço

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 (Snowball Edge Client configurado)

    snowballEdge list-services
    exemplo Saída
    { "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 o Amazon S3 em dispositivos da Família Snow, esse status indica que um ou mais discos ou dispositivos no cluster estão inativos. O serviço de armazenamento compatível com o Amazon S3 em dispositivos da Família Snow 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 neste guia.

    • INACTIVE – o serviço não está em execução e não está disponível para o uso.

    Uso (Snowball Edge Client configurado)

    snowballEdge describe-service --service-id service-id
    exemplo Saída
    { "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" } } ] }
    exemplo Saída de serviço de armazenamento compatível com Amazon S3 em dispositivos da Família Snow

    O describe-service comando fornece a seguinte saída para o valor s3-snow do service-id parâmetro.

    { "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" } } ] }

Remoção de um nó a partir de um cluster

O comando disassociate-device remove um nó de um cluster Snowball Edge. Se você quiser substituir um nó não íntegro, use este comando. Para obter mais informações sobre clusters, consulte Visão geral do cluster neste guia.

Importante

Use o comando disassociate-device somente quando você estiver removendo um nó não íntegro. Este comando falhará e retornará um erro se você tentar remover um nó íntegro.

Não use esse comando para remover um nó que foi desligado acidentalmente ou desconectado da rede e, portanto, está temporariamente indisponível para o resto do cluster. Os nós removidos com este comando não podem ser adicionados a nenhum cluster e devem ser retornados à AWS.

Se um nó foi acidentalmente desligado ou desconectado da rede, conecte o nó de volta à alimentação e à rede e usar o comando associate-device. Não é possível usar o comando disassociate-device para desassociar um nó se ele estiver ligado e for íntegro.

Uso (Snowball Edge Client configurado)

snowballEdge disassociate-device --device-id Job ID for the Device
exemplo Saída
Disassociating your Snowball Edge device from the cluster. Your Snowball Edge device will be disassociated from the cluster when it is in the "DISASSOCIATED" state. You can use the describe-cluster command to determine the state of your cluster.

Como adicionar um nó a um cluster

O comando associate-device adiciona um nó a um cluster de dispositivos Snowball Edge. Se você desligar um nó, ele reverterá seu estado de desbloqueado para bloqueado. Para desbloquear esse nó, você pode usar este comando. Use esse comando para substituir um nó indisponível por um novo nó que você tenha solicitado como substituto. Para obter mais informações sobre clusters, consulte Visão geral do cluster neste guia.

Uso (Snowball Edge Client configurado)

snowballEdge associate-device --device-ip-address IP Address
exemplo Saída
Associating your Snowball Edge device with the cluster. Your Snowball Edge device will be associated with the cluster when it is in the ASSOCIATED state. You can use the describe-cluster command to determine the state of your cluster.

Criar tags para o dispositivo

Adiciona ou substitui as tags especificadas no dispositivo. É possível criar no máximo 50 tags. Cada tag consiste em um par de chave-valor. O valor é opcional.

nota

Não coloque dados confidenciais nas tags.

Uso (Snowball Edge Client configurado)

snowballEdge create-tags --tag Key=Name,Value=user-test --tag Key=Stage,Value=beta

Para obter mais informações, execute o comando describe-tags.

exemplo Saída
Tag(s) [Key=Name,Value=test, Key=Stage,Value=beta] created.

Excluir tags do dispositivo

O comando delete-tags exclui as tags especificadas do dispositivo Snowball Edge.

Uso (Snowball Edge Client configurado)

snowballEdge delete-tags --tag Key=Stage,Value=beta Tag(s) [Key=Stage,Value=beta] deleted.

Para obter mais informações, execute o comando describe-tags.

nota

Se você quiser excluir várias tags ao mesmo tempo, poderá especificar vários pares de chave-valor, como o seguinte:

delete-tags --tag Key=Name,Value=test --tag Key=Stage,Value=Beta

Se você especificar uma chave de tag sem um valor de tag, qualquer tag com essa chave, independentemente de seu valor, será excluída. Se você especificar uma chave de tag com uma string vazia como o valor da tag, somente as tags que têm uma string vazia como valor serão excluídas.

Descrever tags no dispositivo

O comando describe-tags descreve as tags no dispositivo Snowball Edge.

Uso (Snowball Edge Client configurado)

snowballEdge describe-tags

Para obter mais informações, execute o comando describe-tags.

exemplo Saída
{ "Tags" : [ { "Key" : "Name", "Value" : "user-test" }, { "Key" : "Stage", "Value" : "beta" } ] }

Criando uma interface de rede direta

Use o create-direct-network-interface comando para criar interfaces de rede diretas nos dispositivos da família Snow. Uma interface de rede direta (DNI) deve estar associada a uma instância de AMI. Você pode usar o vlan parâmetro para atribuir uma ID de rede local virtual (VLAN) à interface para marcar todo o tráfego da interface com essa ID de VLAN. Além disso, você pode atribuir um endereço de controle de acesso à mídia (MAC) ao DNI com o mac parâmetro. Se você não fornecer o mac parâmetro e um valor, um endereço MAC será atribuído automaticamente.

Você pode usar o describe-device comando para recuperar o ID da interface de rede física. Para ter mais informações, consulte Ver status do dispositivo.

snowballEdge create-direct-network-interface --instance-id AMI-instance-id --physical-network-interface-id physical-network-interface-id --vlan vlan-id --mac MAC-address
exemplo da saída create-direct-network-interface do comando
{ "DirectNetworkInterface" : { "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o", "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w", "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q", "Driver" : "mlx5 core", "MacAddress" : "1A:2B:3C:4D:5E:6F", "MtuSize": "1500" } }

Obter informações sobre uma interface de rede direta

Use o describe-direct-network-interface comando para ver informações sobre as interfaces de rede diretas em um dispositivo da família Snow.

snowballEdge describe-direct-network-interfaces --endpoint https://snow-device-ip-address --manifest-file path/to/manifest/file.bin --unlock-code unlock-code
exemplo da saída descibe-direct-network-interfaces do comando
{ "DirectNetworkInterface" : { "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o", "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w", "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q", "Driver" : "mlx5 core", "MacAddress" : "1A:2B:3C:4D:5E:6F", "MtuSize": "1500" } }

Atualizando uma interface de rede direta

Use o update-direct-network-interface para alterar as propriedades de uma interface de rede direta (DNI). Quando você altera um DNI anexado a uma instância compatível com o Amazon EC2, a interface será desanexada. Para alterar a unidade de transmissão máxima (MTU) da interface física que o DNI está usando, use o comando. update-mtu-size Para ter mais informações, consulte Atualizando o tamanho da MTU.

snowballEdge update-direct-network-interface --direct-network-interface-arn directNetworkInterfaceArn // --endpoint https://snow-device-ip-address [--mac macAddress] // --manifest-file path/to/manifest/file.bin --unlock-code unlock-code // [--vlan vlanId] [--attach-instance-id instanceId | --detach]
exemplo da saída update-direct-network-interface do comando
{ "DirectNetworkInterface" : { "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o", "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w", "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q", "Driver" : "mlx5 core", "MacAddress" : "2A:3B:5C:5D:6E:7F", "MtuSize": "1500" } }

Excluindo uma interface de rede direta

Use o delete-direct-network-interface comando para excluir uma interface de rede direta (DNI). Para excluir um DNI associado a uma instância computacional compatível com o Amazon EC2, primeiro use o detatch parâmetro do update-direct-network-interface comando para separar o DNI da instância. Para ter mais informações, consulte Atualizando uma interface de rede direta.

snowballEdge delete-direct-network-interface --direct-network-interface-arn directNetworkInterfaceArn // --endpoint https://snow-device-ip-address --manifest-file path/to/manifest/file.bin // [--profile profile] --unlock-code unlock-code
exemplo da saída delete-direct-network-interface do comando
The direct network interface has been deleted from your Snowball Edge. You can determine the direct network interfaces available on your Snowball Edge using the describe-direct-network-interfaces command.

Crie uma interface de rede virtual (VNI)

Use o create-virtual-network-interface comando para criar interfaces de rede virtual no dispositivo Snowball Edge. Você pode usar o describe-device comando para recuperar o ID da interface de rede física. Para ter mais informações, consulte Ver status do dispositivo.

nota

O static-ip-address-configuration parâmetro é válido somente ao usar o STATIC valor do ip-address-assignment parâmetro.

snowballEdge create-virtual-network-interface --endpoint https://ip-address-of-snow-device --manifest-file /path/to/manifest/file.bin --unlock-code unlock-code --ip-address-assignment DHCP or STATIC --physical-network-interface-id [physical network interface id] --static-ip-address-configuration IpAddress=IP-address,NetMask=netmask
exemplo da saída create-virtual-network-interface do comando
{ "VirtualNetworkInterface": { "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf", "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment": "DHCP", "IpAddress": "192.0.2.0", "Netmask": "255.255.255.0", "DefaultGateway": "192.0.2.1", "MacAddress": "EX:AM:PL:E1:23:45", "MtuSize" : "1500" } }

Obter informações sobre uma interface de rede virtual

Use o describe-virtual-network-interface comando para ver informações sobre as interfaces de rede virtual no dispositivo da família Snow.

snowballEdge describe-direct-network-interfaces --endpoint https://ip-address-of-snow-device --manifest-file path/to/manifest/file.bin --unlock-code unlock-code
exemplo da saída descibe-virtual-network-interfaces do comando
{ "VirtualNetworkInterface": { "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf", "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment": "DHCP", "IpAddress": "192.0.2.0", "Netmask": "255.255.255.0", "DefaultGateway": "192.0.2.1", "MacAddress": "EX:AM:PL:E1:23:45", "MtuSize" : "1500" } }

Atualizando uma interface de rede virtual

Use o update-virtual-network-interface comando para atualizar as interfaces de rede virtual no dispositivo Snow Family. Para alterar a unidade de transmissão máxima (MTU) da interface física que o DNI está usando, use o comando. update-mtu-size Para ter mais informações, consulte Atualizando o tamanho da MTU.

snowballEdge update-virtual-network-interface --direct-network-interface-arn directNetworkInterfaceArn --endpoint https://ip-address-of-snow-device // --unlock-code unlock-code [--mac macAddress] --manifest-file path/to/manifest/file.bin // [--vlan vlanId] [--attach-instance-id instanceId | --detach]
exemplo da saída update-virtual-network-interface do comando
{ "VirtualNetworkInterface": { "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf", "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment": "DHCP", "IpAddress": "192.0.2.9", "Netmask": "255.255.255.0", "DefaultGateway": "192.0.2.1", "MacAddress": "EX:AM:PL:E1:23:45", "MtuSize" : "1500" } }

Excluindo uma interface de rede virtual

Use o delete-direct-network-interface comando para excluir uma interface de rede virtual (VNI).

snowballEdge delete-virtual-network-interface --virtual-network-interface-arn virtual-network-interface-ARN --endpoint https://endpoint // --manifest-file path/to/manifest/file.bin] [--profile profile] --unlock-code unlock-code]
exemplo da saída delte-direct-network-interface do comando
The virtual network interface has been deleted from your Snowball Edge. You can determine the virtual network interfaces available on your Snowball Edge using the describe-virtual-network-interfaces command.

Verificação do status do atributo

Para listar o status dos recursos disponíveis no seu dispositivo, use o describe-features comando.

RemoteManagementState: indica o status do Snow Device Management 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 (Snowball Edge Client configurado)

snowballEdge describe-features \ --manifest-file manifest.bin path \ --unlock-code unlock-code \ --endpoint https://device-local-ip:9091

Exemplos de resultado

{ "RemoteManagementState" : String }

Configurando servidores de horário

Você pode configurar um servidor NTP (Network Time Protocol). Você pode usar os comandos NTP CLI quando o dispositivo está nos estados bloqueado e desbloqueado. O manifesto e o código de desbloqueio são obrigatórios. Você pode defini-las com o comando snowballEdge configure ou usando as opções --unlock-code e --manifest-file. Observe que você pode usar a snowballEdge CLI no AWS Snowcone Edge e. AWS Snowcone

É 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 do CLI update-time-servers.

nota

O comando update-time-servers substituirá as configurações anteriores dos servidores de horário NTP.

Tipos de dispositivos NTP e versões de software compatíveis

O NTP não está disponível em nenhum tipo de dispositivo de armazenamento e computação da versão 2. No entanto, os tipos de dispositivos de armazenamento e computação do Snowball Edge versão 3 com software versão 77 ou posterior oferecem suporte a NTP. Para verificar se o NTP está ativado, use o comando describe-time-sources da CLI do Snowball Edge.

Uso

snowballEdge update-time-servers time.google.com
exemplo Exemplos de resultado
Updating time servers now.

Verificando fontes de tempo

Para ver a quais fontes de horário de NTP o dispositivo está conectado atualmente, use o comando do CLI describe-time-sources para o Snowball Edge.

Uso

snowballEdge describe-time-sources
exemplo Exemplos de resultado
{ "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 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 comandoupdate-time-servers, enquanto um par só pode ser outros dispositivos Snowball Edge no cluster. No exemplo de saída, describe-time-sources é chamado em um Snowball 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.

Atualizando 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 da família Snow. 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 é 1500 bytes e o tamanho máximo é 9216 bytes.

Você pode usar o describe-device comando para recuperar os IDs da interface de rede física e os tamanhos atuais de MTU dessas interfaces. Para ter mais informações, consulte Ver status do dispositivo.

Você pode usar os describe-virtual-network-interface comandos descibe-direct-network-interface e para recuperar os tamanhos atuais de MTU dessas interfaces. Para obter mais informações, consulte Obter informações sobre uma interface de rede direta e Obter informações sobre uma interface de rede virtual.

Uso

snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes
exemplo 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" } }