Chame um ponto de extremidade HTTP de um pipeline do processador de dados
Importante
O recurso Pré-visualização de Operações do Azure IoT — habilitado pelo Azure Arc — está atualmente em VERSÃO PRÉVIA. Você não deve usar esse software em versão prévia em ambientes de produção.
Você precisará implantar uma nova instalação do Azure IoT Operations quando uma versão geralmente disponível for disponibilizada, você não poderá atualizar uma instalação de visualização.
Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.
Use o estágio de chamada HTTP para chamar um ponto de extremidade HTTP externo com um corpo da solicitação opcional e receber uma resposta opcional. A fase de chamada permite que você incorpore a lógica de processamento de dados personalizada, como a execução de modelos de machine learning, no processamento de pipeline.
- Cada partição em um pipeline executa independentemente as chamadas HTTP em paralelo.
- As chamadas HTTP são síncronas, o estágio aguarda o retorno da chamada antes de continuar com o processamento de pipeline adicional.
Pré-requisitos
Para configurar e usar um estágio de pipeline agregado, você precisa de uma:
- Instância implantada do processador de dados que inclui o componente opcional do processador de dados.
- Um servidor HTTP acessível a partir da instância do processador de dados.
Configurar um estágio de chamada HTTP
A configuração JSON do estágio de chamada HTTP define os detalhes do estágio. Para criar o estágio, você pode interagir com a interface do usuário baseada em formulário ou fornecer a configuração JSON na guia Avançado :
Nome | Tipo | Descrição | Obrigatório | Padrão | Exemplo |
---|---|---|---|---|---|
Nome | string | Um nome a ser mostrado na interface do usuário do processador de dados. | Sim | - | MLCall1 |
Descrição | string | Uma descrição amigável do que o estágio de chamada faz. | Não | Call ML endpoint 1 |
|
Método | string enum | O método HTTP. | Não | POST |
GET |
URL | string | O URL HTTP. | Sim | - | http://localhost:8080 |
Autenticação | string | O tipo de autenticação a ser usado. None /Username/Password /Header . |
Sim | None |
None |
Nome de Usuário | string | O nome de usuário a ser usado quando Authentication for definida como Username/Password . |
Não | - | myusername |
Segredo | string | A referência do segredo da senha a ser usada quando Authentication for definida como Username/Password . |
Não | - | mysecret |
Chave de cabeçalho | string | A chave de cabeçalho a ser usada quando Authentication for definida como Header . O valor deve ser authorization . |
Não | authorization |
authorization |
Segredo | string | A referência do segredo a ser usada quando a Authentication for definida como Header . |
Não | - | mysecret |
Formato dos Dados > Solicitação da API | string | O formato em que o corpo da solicitação deve estar e quaisquer detalhes de serialização. | Não | - | JSON |
Caminho > Solicitação da API | Caminho | O Caminho para a propriedade na mensagem de entrada a ser enviada como o corpo da solicitação. Deixe vazio se você não precisar enviar um corpo da solicitação. | Não | - | .payload.httpPayload |
Cabeçalho > Solicitação da API > Chave1 | Campo Estático/Dinâmico | A chave do cabeçalho a ser definida na solicitação. | Não | Campo Estático/Dinâmico | |
Cabeçalho > Solicitação da API > Valor1 | Campo Estático/Dinâmico | O valor do cabeçalho a ser definido na solicitação. | Não | Campo Estático/Dinâmico | |
Formato dos Dados > Resposta da API | string | O formato em que o corpo da resposta está e todos os detalhes de desserialização. | Não | - | JSON |
Caminho > Resposta da API | Caminho | O Caminho para a propriedade na mensagem de saída na qual armazenar a resposta. Deixe vazio se você não precisar do corpo da resposta. | Não | - | .payload.httpResponse |
Cabeçalho > Resposta da API | Caminho | O Caminho para a propriedade na mensagem de saída na qual armazenar o cabeçalho da resposta. Deixe vazio se você não precisar dos metadados da resposta. | Não | - | .payload.httpResponseHeader |
Resposta da API > Status | Caminho | O Caminho para a propriedade na mensagem de saída na qual armazenar o status da resposta. Deixe vazio se você não precisar do status da resposta. | Não | - | .payload.httpResponseStatus |
1Solicitação da API >Cabeçalho: cada elemento na matriz do cabeçalho é um par de valores de chave. Você pode definir a chave ou o valor dinamicamente com base no conteúdo da mensagem de entrada ou como uma cadeia de caracteres estática.
Formatos de mensagem
Você pode usar o estágio de chamada HTTP com qualquer formato de dados. Use o serializador e o desserializador internos para serializar e desserializar os formatos de dados com suporte. Use Raw
para lidar com outros formatos de dados.
Autenticação
Atualmente, há suporte apenas para autenticação baseada em cabeçalho.