# 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk), escolha **Provisionar dispositivos em massa** e execute as etapas a seguir. ![](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/images/sidewalk-bulk-provision.PNG) 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**. 1. **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. 1. O número de série de fabricação do Sidewalk (SMSN) no campo **Inserir SMSN**. 1. Um **Destino** que descreva a regra de IoT para encaminhar mensagens do dispositivo para outros Serviços da AWS. 1. 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](https://console.aws.amazon.com/s3/), selecione **Exibir**. 1. 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. 1. Forneça um **Destino** que descreva a regra de IoT para encaminhar mensagens do dispositivo para outros Serviços da AWS. 1. 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html) 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html)da 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](sidewalk-provision-bulk-import.md#provision-bulk-use). **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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) no console de AWS IoT. 1. Escolha a tarefa de importação que você deseja atualizar e, em seguida, escolha **Editar**. 1. 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) no console de AWS IoT. 1. 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. + **API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html) ou CLI [https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html)** Essa operação da API anexa o conteúdo de um arquivo CSV do Amazon S3 a uma tarefa de importação existente. Você só pode adicionar números de série de dispositivos que não foram incluídos anteriormente na tarefa. + **API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html) ou CLI [https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html)** Essa operação da API exclui a tarefa de importação que foi marcada para exclusão usando o ID da tarefa de importação.