Compartilhar via

Enviar dados para um ponto de extremidade HTTP

  • Artigo

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.

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 destino HTTP para gravar dados processados e limpos em um ponto de extremidade HTTP para processamento adicional.

Quando você envia dados para um ponto de extremidade HTTP de um estágio de destino, qualquer resposta é descartada.

Pré-requisitos

Para configurar e usar esse estágio de pipeline de destino, você precisa:

  • Uma instância implantada da Versão Prévia do Processador de Dados do Azure IoT que inclui o componente opcional do Processador de Dados.
  • Um servidor HTTP acessível na instância do Processador de Dados.

Configurar a fase de destino

A configuração JSON do estágio de destino HTTP define os detalhes do estágio. Para criar a fase, você pode interagir com a interface do usuário baseada em formulários ou fornecer a configuração JSON na guia Avançado:

Campo Type Descrição Obrigatório? Padrão Exemplo
url string URL da solicitação. Há suporte para HTTP e HTTPS. Sim https://contoso.com/some/url/path
method string enum O método HTTP a ser usado. Um de: POST, PUT Sim POST
request Solicitação Um objeto que representa o corpo da solicitação e os cabeçalhos. Não (vazio) Consulte Solicitação
retry Repetir O mecanismo de repetição a ser usado se a chamada falhar. Não (vazio) {"type": "fixed"}
authentication Tipo de autenticação Informações de autenticação para o ponto de extremidade. Dá suporte a tipos de autenticação none, usernamePassword e header. Não {"type": "none"} {"type": "none"}

Solicitação

Campo Type Descrição Obrigatório? Padrão Exemplo
body Objeção. Informações de formatação, incluindo o local em que o corpo está localizado na mensagem. Não (vazio) {"type": "json", "path": ".payload"}
headers Uma matriz de objetos . Lista de cabeçalhos a serem enviados com a solicitação. Chaves e valores podem ser estáticos ou dinâmicos. Não [] Veja exemplos

Configurações de exemplo

O JSON a seguir mostra uma definição de exemplo para um estágio de destino HTTP:

{
    "displayName": "HTTP Output Example",
    "description": "Sample HTTP output stage",
    "type": "output/http@v1",
    "url": "https://contoso.com/some/url/path",
    "method": "POST",
    "request": {
        "body": {
            "format": "json",
            "path": ".payload",
        },
        "headers": [
            {
                "key": {
                    "type": "static",
                    "value": "asset"
                },
                "value": {
                    "type": "dynamic",
                    "value": ".payload.assetId"
                }
            },
            {
                "key": {
                    "type": "static",
                    "value": "revision"
                },
                "value": {
                    "type": "static",
                    "value": "12"
                }
            }
        ]
    },
    "retry": {
        "type": "fixed",
        "interval": "20s",
        "maxRetries": 4
    },
    "next": ["next-stage-id"]
}

Conteúdo relacionado