Defender-IoT-micro-agent para a API ThreadX do Eclipse (pré-visualização)

As APIs do Defender para IoT são regidas pela Licença da API da Microsoft e pelos Termos de utilização.

Esta API destina-se a ser utilizada apenas com o Defender-IoT-micro-agent para Eclipse ThreadX. Para obter recursos adicionais, veja o recurso do GitHub Defender-IoT-micro-agent para Eclipse ThreadX.

Nota

O Defender para IoT planeia extinguir o micro agente a 1 de agosto de 2025.

Ativar o Defender-IoT-micro-agente para o Eclipse ThreadX

nx_azure_iot_security_module_enable

Protótipo

UINT nx_azure_iot_security_module_enable(NX_AZURE_IOT *nx_azure_iot_ptr);

Descrição

Esta rotina ativa o subsistema Azure IoT Defender-IoT-micro-agent. Um computador de estado interno gere a recolha de eventos de segurança e envia-os para Hub IoT do Azure. Só é necessária uma NX_AZURE_IOT_SECURITY_MODULE instância para gerir a recolha de dados.

Parâmetros

Name Descrição
nx_azure_iot_ptr [em] Um ponteiro para um NX_AZURE_IOT.

Valores devolvidos

Valores devolvidos Descrição
NX_AZURE_IOT_SUCCESS Foi ativado com êxito Azure Módulo de Segurança IoT.
NX_AZURE_IOT_FAILURE Falha ao ativar o Módulo de Segurança Azure IoT devido a um erro interno.
NX_AZURE_IOT_INVALID_PARAMETER O módulo de segurança requer uma instância #NX_AZURE_IOT válida.

Permitido a partir de

Threads

Desativar Azure IoT Defender-IoT-micro-agent

nx_azure_iot_security_module_disable

Protótipo

UINT nx_azure_iot_security_module_disable(NX_AZURE_IOT *nx_azure_iot_ptr);

Descrição

Esta rotina desativa o subsistema Azure IoT Defender-IoT-micro-agente.

Parâmetros

Name Descrição
nx_azure_iot_ptr [em] Um ponteiro para NX_AZURE_IOT. Se NULL, a instância singleton está desativada.

Valores devolvidos

Valores devolvidos Descrição
NX_AZURE_IOT_SUCCESS O Azure Módulo de Segurança IoT é desativado com êxito.
NX_AZURE_IOT_INVALID_PARAMETER Hub IoT do Azure instância é diferente da instância composta singleton.
NX_AZURE_IOT_FAILURE Falha ao desativar a Azure Módulo de Segurança IoT devido a um erro interno.

Permitido a partir de

Threads

Passos seguintes

Para saber mais sobre como começar a utilizar o Eclipse ThreadX Defender-IoT-micro-agent, consulte os seguintes artigos:

  • Reveja a descrição geral do Defender para IoT Eclipse ThreadX Defender-IoT-micro-agent.