Carregue ficheiros dos seus dispositivos para a nuvem

O IoT Central permite carregar mídia e outros arquivos de dispositivos conectados para o armazenamento em nuvem. Configure a capacidade de carregamento de ficheiros na aplicação IoT Central e, em seguida, implemente carregamentos de ficheiros no código do dispositivo.

Você também pode gerenciar e visualizar arquivos carregados por seus dispositivos dentro do aplicativo IoT Central.

Para saber como configurar carregamentos de arquivos usando a API REST do IoT Central, consulte Adicionar uma configuração de conta de armazenamento de carregamento de arquivo.

Pré-requisitos

Você precisa ser um administrador em seu aplicativo IoT Central para configurar carregamentos de arquivos.

Você precisa de uma conta de armazenamento do Azure e um contêiner para armazenar os arquivos carregados. Se você não tiver uma conta de armazenamento e um contêiner, crie uma conta de armazenamento no portal do Azure.

Configurar carregamentos de arquivos de dispositivo

Para configurar carregamentos de arquivos de dispositivo:

1. Vá para a seção Aplicativo em seu aplicativo.

2. Selecione Armazenamento de arquivos do dispositivo.

3. Selecione a conta de armazenamento e o contêiner a serem usados. Se a conta de armazenamento estiver em uma assinatura do Azure diferente do seu aplicativo, insira uma cadeia de conexão de conta de armazenamento.

4. Se necessário, ajuste o tempo limite de carregamento que define por quanto tempo uma solicitação é válida. Você pode configurá-lo de 1 a 24 horas.

5. Para permitir que os usuários visualizem e gerenciem arquivos carregados no IoT Central, defina Habilitar acesso como Ativado.

6. Selecione Guardar. Quando o status mostra Configurado, os dispositivos podem carregar arquivos.

Melhores práticas para evitar limitações inesperadas em cenários de upload de ficheiros

Para evitar limitações inesperadas ao utilizar carregamentos de ficheiros, considere as seguintes melhores práticas:

• Escalone os uploads entre dispositivos.
• Evite uploads sincronizados. Por exemplo, na hora exata.
• Implemente um backoff exponencial do lado do cliente sobre 429 / ThrottleBacklogTimeout erros.
• Considere mecanismos alternativos de ingestão, como a ingestão por ADX, pipelines do Fabric ou gravações diretas no armazenamento.
• Testar o comportamento do workload sob padrões de upload previstos em ambiente de produção.

Desativar carregamentos de ficheiros de dispositivo

Para desativar o carregamento de arquivos de dispositivo em seu aplicativo IoT Central:

1. Navegue até a seção Aplicativo em seu aplicativo.

2. Selecione Armazenamento de arquivos do dispositivo.

3. Selecione Eliminar.

Controlar o acesso aos ficheiros carregados

Use funções e permissões para controlar quem pode exibir e excluir arquivos carregados. Para saber mais, consulte Gerenciar usuários e funções em seu aplicativo > IoT Central Gerenciando dispositivos.

Carregar um ficheiro a partir de um dispositivo

O IoT Central usa o recurso de upload de arquivos do Hub IoT para permitir que os dispositivos carreguem arquivos. Para obter um código de exemplo que mostra como carregar arquivos de um dispositivo, consulte o Exemplo de dispositivo de carregamento de arquivos do IoT Central.

Ver e gerir ficheiros carregados

Se você ativar o acesso a arquivos na configuração de upload de arquivos, os usuários com as permissões corretas poderão visualizar e excluir os arquivos carregados.

Para ver e eliminar ficheiros carregados, aceda à vista Ficheiros de um dispositivo. Nesta página, pode ver miniaturas dos ficheiros carregados e alternar entre uma vista de galeria e de lista. Cada arquivo tem opções para baixá-lo ou excluí-lo:

Personalize a exibição de lista filtrando por nome de arquivo e escolhendo as colunas a serem exibidas.

Para visualizar o conteúdo do arquivo e obter mais informações sobre ele, selecione-o. O IoT Central suporta visualizações de tipos de arquivos comuns, como texto e imagens:

Upload de arquivo de teste

Depois de configurar os carregamentos de arquivos em seu aplicativo IoT Central, teste-o com o código de exemplo. Use os seguintes comandos para clonar o repositório de exemplo para um local adequado em sua máquina local e instalar as dependências:

git clone https://github.com/azure-Samples/iot-central-file-upload-device
cd iotc-file-upload-device
npm i
npm build

Criar o modelo de dispositivo e importar o modelo

Para testar o carregamento de ficheiros, execute a aplicação de dispositivo de exemplo. Primeiro, crie um modelo de dispositivo para o dispositivo de exemplo:

1. Abra seu aplicativo na interface do usuário do IoT Central.

2. Vá para Modelos de dispositivo no painel esquerdo e selecione + Novo.

3. Selecione Dispositivo IoT para o tipo de modelo.

4. Na página Personalizar , insira um nome, como Exemplo de dispositivo de carregamento de arquivo , para o modelo de dispositivo.

5. Na página Revisão, selecione Criar.

6. Selecione Importar um modelo e carregue o arquivo de modelo FileUploadDeviceDcm.json da iotc-file-upload-device\setup pasta no repositório que você baixou anteriormente.

7. Selecione Publicar para concluir a criação do modelo de dispositivo.

Adicionar um dispositivo

Para adicionar um dispositivo ao seu aplicativo do Azure IoT Central:

1. Vá para Dispositivos no painel esquerdo.

2. Selecione o modelo de dispositivo File Upload Device Sample criado anteriormente.

3. Selecione + Novo e, em seguida, selecione Criar.

4. Selecione o dispositivo que criou e, em seguida, selecione Ligar.

Copie os valores de ID scope, Device IDe Primary key. Use esses valores no código de exemplo do dispositivo.

Execute o código de exemplo

Abra o repositório git que você baixou no VS Code. Crie um arquivo ".env" na raiz do seu projeto e adicione os valores copiados anteriormente. O arquivo deve se parecer com este exemplo, com seus valores:

scopeId=<YOUR_SCOPE_ID>
deviceId=<YOUR_DEVICE_ID>
deviceKey=<YOUR_PRIMARY_KEY>
modelId=dtmi:IoTCentral:IotCentralFileUploadDevice;1

Abra o repositório git que você baixou no VS Code. Para executar ou depurar o exemplo, pressione F5. Na janela do terminal, você vê o registro do dispositivo e se conecta ao IoT Central:

Starting IoT Central device...
 > Machine: Windows_NT, 8 core, freemem=6674mb, totalmem=16157mb
Starting device registration...
DPS registration succeeded
Connecting the device...
IoT Central successfully connected device: 7z1xo26yd8
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}

O projeto de exemplo inclui um arquivo de exemplo chamado datafile.json. Esse arquivo é carregado quando você usa o comando Carregar arquivo em seu aplicativo IoT Central.

Para testar o upload, abra seu aplicativo e selecione o dispositivo que você criou. Selecione a guia Comando e selecione o botão Executar . Quando você seleciona Executar, o aplicativo IoT Central chama um método direto em seu dispositivo para carregar o arquivo. Você pode ver esse método direto no código de exemplo no arquivo /device.ts. O método é chamado uploadFileCommand. Para testar o upload, abra seu aplicativo e selecione o dispositivo que você criou. Selecione a guia Comando e, em seguida, selecione o botão Executar . Quando você seleciona Executar, o IoT Central chama um método direto em seu dispositivo para carregar o arquivo. Você pode ver esse método no código de exemplo no arquivo /device.ts . O método é chamado uploadFileCommand.

Selecione a guia Dados brutos para verificar o status de carregamento do arquivo.

Você também pode fazer uma chamada à API REST para verificar o status de carregamento do arquivo no contêiner de armazenamento.