Partilhar via

plugin de requisição HTTP POST

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

O http_request_post plugin envia uma solicitação HTTP POST e converte a resposta em uma tabela.

Pré-requisitos

Sintaxe

evaluate http_request_post ( Uri [,RequestHeaders [,Opções [,Conteúdo]]] )

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
Uri string ✔️ O URI de destino para a solicitação HTTPS.
RequestHeaders dynamic Um pacote de propriedades contendo cabeçalhos HTTP para enviar com a solicitação.
Opções dynamic Um saco de propriedades contendo propriedades adicionais da solicitação.
Conteúdo string O conteúdo do corpo a ser enviado com a solicitação. O conteúdo é codificado e UTF-8 o tipo de mídia para o Content-Type atributo é application/json.

Observação

  • Para especificar um parâmetro opcional que segue um parâmetro opcional, certifique-se de fornecer um valor para o parâmetro opcional anterior. Para obter mais informações, consulte Trabalhando com parâmetros opcionais.
  • Use sempre o protocolo HTTPS. Tentativas de usar HTTP com autenticação resultam em um erro.

Autenticação e autorização

Para autenticar, use o cabeçalho padrão Authorization HTTP ou qualquer cabeçalho personalizado suportado pelo serviço Web.

Observação

Se a consulta incluir informações confidenciais, certifique-se de que as partes relevantes do texto da consulta sejam ofuscadas para que sejam omitidas de qualquer rastreamento. Para obter mais informações, consulte literais de cadeia de caracteres ofuscadas.

Devoluções

O plug-in retorna uma tabela que tem um único registro com as seguintes colunas dinâmicas:

  • ResponseHeaders: um conjunto de propriedades com o cabeçalho de resposta.
  • ResponseBody: O corpo da resposta analisado como um valor do tipo dynamic.

Se a resposta HTTP indicar (através do cabeçalho de Content-Type resposta) que o tipo de mídia é application/json, o corpo da resposta será analisado automaticamente as-if for um objeto JSON. Caso contrário, ele será retornado as-is.

Cabeçalhos

O argumento RequestHeaders pode ser usado para adicionar cabeçalhos personalizados à solicitação HTTP de saída. Além dos cabeçalhos de solicitação HTTP padrão e dos cabeçalhos personalizados fornecidos pelo usuário, o plug-in também adiciona os seguintes cabeçalhos personalizados:

Nome Descrição
x-ms-client-request-id Uma ID de correlação que identifica a solicitação. Várias invocações do plugin na mesma consulta terão todas o mesmo ID.
x-ms-readonly Um sinalizador indicando que o processador dessa solicitação não deve fazer alterações persistentes.

Advertência

O x-ms-readonly sinalizador é definido para cada solicitação HTTP enviada pelo plug-in que foi acionada por uma consulta e não por um comando de gerenciamento. Os serviços da Web devem tratar quaisquer solicitações com esse sinalizador como uma solicitação que não faz alterações internas de estado, caso contrário, eles devem recusar a solicitação. Isso protege os usuários de serem enviados consultas aparentemente inocentes que acabam fazendo alterações indesejadas usando uma consulta Kusto como a plataforma de lançamento para tais ataques.

Exemplo

O exemplo a seguir é para um serviço Web HTTPS hipotético que aceita cabeçalhos de solicitação adicionais e deve ser autenticado usando o Microsoft Entra ID:

let uri='https://example.com/node/js/on/eniac';
let headers=dynamic({'x-ms-correlation-vector':'abc.0.1.0', 'authorization':'bearer ...Azure-AD-bearer-token-for-target-endpoint...'});
evaluate http_request_post(uri, headers)