O IoT Platform permite que dispositivos enviem arquivos para buckets do Object Storage Service (OSS) ou para o armazenamento de arquivos do IoT Platform via MQTT , reduzindo a sobrecarga de hardware e os custos de desenvolvimento. Configure o C Link SDK para ative o upload de arquivos nos dispositivos.
Pré-requisitos
-
Para personalizar o SDK, na página SDK Customization, na área Advanced Features, selecione File Upload.
Informações básicas
O IoT Platform oferece o recurso de Gerenciamento de arquivos para arquivos enviados.
-
Após o envio de um arquivo pelo dispositivo, gerencie-o por meio destas APIs de nuvem:
Funcionamento
Os dispositivos enviam arquivos para o IoT Platform via MQTT :
Referência da API de upload via MQTT: aiot_mqtt_upload_api.h.
O upload de arquivos exige uma conexão MQTT.
Diagrama de sequência para ./demos/mqtt_upload_basic_demo.c:
Limites
O upload de arquivos via protocolo MQTT está disponível apenas nas regiões China (Shanghai), China (Beijing) e China (Shenzhen).
-
Requisitos para nomes de arquivos:
Caracteres permitidos: dígitos, letras, sublinhados (_) e pontos (.).
O primeiro caractere deve ser uma letra ou um número.
Tamanho máximo de 100 bytes.
Suporte a upload de múltiplos arquivos.
Armazenamento total máximo por instância: 1 GB.
Limite de arquivos por dispositivo: 1.000.
Tamanho máximo por arquivo individual: 16 MB.
-
O IoT Platform aplica uma política de conflitos baseada no nome do arquivo para cada solicitação de upload:
Se não existir nenhum arquivo com o mesmo nome, o sistema cria uma nova tarefa de upload.
-
Se já houver um arquivo com o mesmo nome, o IoT Platform segue a política configurada para tratamento de duplicatas. Código de exemplo: Etapa 4: Solicitar o upload de um arquivo.
Política (conflictStrategy)
Descrição
Modo de substituição (overwrite)
Padrão. Exclui o arquivo existente e mantém apenas o novo upload.
Modo de anexação (append)
O IoT Platform retorna informações sobre o arquivo existente. O dispositivo pode:
-
Retomar o upload se o arquivo foi enviado parcialmente.
NotaUploads incompletos são retidos por apenas 24 horas.
-
Usar o modo de substituição ou renomear o arquivo antes de reenviá-lo, caso o upload tenha sido concluído.
Modo de rejeição (reject)
O IoT Platform retorna um código de erro indicando que o arquivo já existe e rejeita a solicitação de upload.
-