Provisionar dispositivos do Sidewalk em massa - AWS IoT Wireless
Provisionar dispositivos do Sidewalk em massa (console)Provisionar dispositivos do Sidewalk em massa (CLI)Atualizar ou excluir tarefas de importação

Provisionar dispositivos do Sidewalk em massa

Esta seção mostra como é possível provisionar dispositivos Sidewalk em massa para o AWS IoT Core para Amazon Sidewalk utilizando o console do AWS IoT e a AWS CLI.

Provisionar dispositivos do Sidewalk em massa (console)

Para adicionar seu dispositivo do Sidewalk usando o console de AWS IoT, acesse a guia Sidewalk do hub de dispositivos, escolha Provisionar dispositivos em massa e execute as etapas a seguir.

  1. Escolher o método de importação

    Especifique como você deseja importar os dispositivos a serem integrados em massa ao AWS IoT Core para Amazon Sidewalk.

    • Para provisionar dispositivos individuais usando o SMSN deles, escolha Provisionar dispositivo individual com suporte de fábrica.

    • Para provisionar dispositivos em massa fornecendo um arquivo CSV que contenha uma lista de dispositivos e seus SMS, escolha Usar o bucket do S3.

  2. Especificar os dispositivos a serem integrados

    Dependendo do método escolhido para integrar seus dispositivos, adicione as informações do dispositivo e seus números de série.

    1. Se você escolher Provisionar um dispositivo individual com suporte de fábrica, especifique as seguintes informações:

      1. Um Nome para cada dispositivo a ser integrado. O nome deve ser exclusivo na sua Conta da AWS e Região da AWS.

      2. O número de série de fabricação do Sidewalk (SMSN) no campo Inserir SMSN.

      3. Um Destino que descreva a regra de IoT para encaminhar mensagens do dispositivo para outros Serviços da AWS.

    2. Se você escolher Usar bucket do S3:

      1. Forneça as informações de Destino do S3 Bucket, que consistem nas informações de URL do S3. Para fornecer o arquivo CSV, escolha Procurar no S3 e, em seguida, escolha o arquivo CSV que deseja usar.

        O AWS IoT Core para Amazon Sidewalk preenche automaticamente o URL do S3, que é o caminho para o arquivo CSV no bucket do S3. O formato do caminho é s3://bucket_name/file_name. Para visualizar o arquivo no console do Amazon Simple Storage Service, selecione Exibir.

      2. Forneça a Função de provisionamento do S3, que permite que o AWS IoT Core para Amazon Sidewalk acesse o arquivo CSV no bucket do S3 em seu nome. É possível criar um novo perfil de serviço ou escolher um existente.

        Para criar um novo perfil, você pode fornecer um Nome de perfil ou deixar em branco, para que um nome aleatório seja gerado automaticamente.

      3. Forneça um Destino que descreva a regra de IoT para encaminhar mensagens do dispositivo para outros Serviços da AWS.

  3. Iniciar tarefa de importação

    Forneça tags opcionais como pares de nome-valor e escolha Enviar para iniciar a tarefa de importação do dispositivo sem fio.

Provisionar dispositivos do Sidewalk em massa (CLI)

Para integrar os dispositivos Sidewalk à sua conta para o AWS IoT Core para Amazon Sidewalk, utilize qualquer uma das operações de API a seguir, dependendo do que você deseja fazer: adicionar dispositivos individualmente ou fornecer o arquivo CSV contido em um bucket do S3.

  • Fazer upload de dispositivos em massa usando um arquivo CSV do S3

    Para fazer upload de dispositivos em massa fornecendo o arquivo CSV em um bucket do S3, use a operação da API StartWirelessDeviceImportTask ou o comando start-wireless-device-import-task da AWS CLI. Ao criar a tarefa, especifique o caminho para o arquivo CSV no bucket do Amazon S3 e o perfil do IAM que concede ao AWS IoT Core para Amazon Sidewalk permissões para acessar o arquivo CSV.

    Quando a tarefa começar a ser executada, o AWS IoT Core para Amazon Sidewalk começará a ler o arquivo CSV e comparará os números de série (SMSN) no arquivo com as informações correspondentes no log de controle recebido do Amazon Sidewalk. Quando os números de série corresponderem, ele começará a criar registros de dispositivos sem fio que corresponderem a esses números de série.

    O comando a seguir mostra um exemplo de criação de uma tarefa de importação:

    aws iotwireless start-wireless-device-import-task \ 
    --cli-input-json "file://task.json"

    O exemplo a seguir mostra o conteúdo do arquivo task.json.

    Conteúdo do task.json

    {
    "DestinationName": "Sidewalk_Destination",
    "Sidewalk": {
        "DeviceCreationFile": "s3://import_task_bucket/import_file1", 
        "Role": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI"     
    }
}

    A execução desse comando retorna um ID e um ARN para a tarefa de importação.

    {    
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
    "Id": "a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
}
  • Provisionar dispositivos individualmente usando o SMSN deles

    Para provisionar dispositivos individualmente usando o SMSN deles, use a operação da API StartSingleWirelessDeviceImportTask ou o comando start-single-wireless-device-import-taskda AWS CLI. Ao criar a tarefa, especifique o destino do Sidewalk e o número de série do dispositivo que você deseja integrar.

    Quando o número de série corresponder às informações no log de controle recebido do Amazon Sidewalk, a tarefa será executada e criará o registro do dispositivo sem fio.

    O comando a seguir mostra um exemplo de criação de uma tarefa de importação:

    aws iotwireless start-single-wireless-device-import-task \ 
    --destination-name sidewalk_destination \    
    --sidewalk '{"SidewalkManufacturingSn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A"}'

    A execução desse comando retorna um ID e um ARN para a tarefa de importação.

    {
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"    
    "Id": "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
}

Atualizar ou excluir tarefas de importação

Se quiser adicionar mais dispositivos a uma tarefa de importação, você poderá atualizá-la. Você também pode excluir uma tarefa se não precisar mais dela ou se ela falhar. Para obter informações sobre quando atualizar ou excluir uma tarefa, consulte Como utilizar o provisionamento em massa do Sidewalk.

Atenção

Uma ação de exclusão é permanente e não pode ser desfeita. A exclusão de uma tarefa de importação que já tinha sido concluída com êxito não removerá os dispositivos finais que a utilizaram para a integração.

Atualizar ou excluir tarefas de importação:

  • Usar o console de AWS IoT

    As etapas a seguir explicam como atualizar ou excluir suas tarefas de importação usando o console de AWS IoT.

    Atualizar uma tarefa de importação:

    1. Acesse o hub de dispositivos do Sidewalk no console de AWS IoT.

    2. Escolha a tarefa de importação que você deseja atualizar e, em seguida, escolha Editar.

    3. Forneça outro arquivo S3 que contenha os números de série dos dispositivos que você deseja adicionar à tarefa e escolha Enviar.

    Excluir uma tarefa de importação:

    1. Acesse o hub de dispositivos do Sidewalk no console de AWS IoT.

    2. Escolha a tarefa que você deseja excluir e, em seguida, escolha Excluir.

  • Utilizar a API do AWS IoT Wireless ou a AWS CLI

    Utilize as operações de API do AWS IoT Wireless ou os comandos da CLI a seguir para atualizar ou excluir a tarefa de importação.