Executar uma função do Azure com um pedido HTTP
Um pedido HTTP é uma operação comum na maioria das plataformas e dispositivos. Quer se trate de um pedido para procurar uma palavra num dicionário ou obter a meteorologia local, enviamos constantemente pedidos HTTP. As Funções do Azure permitem criar rapidamente uma parte de lógica para ser executada quando for recebido um pedido HTTP.
Nesta unidade, você aprenderá como criar e invocar uma função usando um gatilho HTTP. Você também explorará algumas das opções de personalização disponíveis para gatilhos HTTP.
O que é um acionador HTTP?
Um gatilho HTTP é um gatilho que executa código quando recebe uma solicitação HTTP. Os acionadores HTTP têm muitas capacidades e personalizações, incluindo:
- Fornecer acesso autorizado através do fornecimento de chaves.
- Restringindo quais verbos HTTP são suportados.
- Retornando dados para o chamador.
- Recebimento de dados por meio de parâmetros de cadeia de caracteres de consulta ou através do corpo da solicitação.
- Suporte a modelos de rota de URL para modificar a URL da função.
Ao criar um gatilho HTTP, você precisa fornecer um nome para o gatilho e escolher um nível de autorização.
O que é um nível de Autorização de acionador HTTP?
Um gatilho HTTP Nível de autorização é um sinalizador que indica se uma solicitação HTTP de entrada precisa de uma chave de API para autorização.
Existem três níveis de Autorização:
- Function
- Anónimo
- Administrador
Os níveis Função e Administrador baseiam-se na "chave". Para enviar uma solicitação HTTP, você deve fornecer uma chave para autorização. Existem dois tipos de chaves: função e anfitrião. A diferença entre as duas chaves é o seu âmbito. As chaves de função são específicas de uma função. As chaves de anfitrião aplicam-se a todas as funções na aplicação de funções. Se o nível de Autorização estiver definido como Função, pode utilizar uma chave de função ou de anfitrião. Se o nível de Autorização estiver definido como Administrador, tem de fornecer uma chave de anfitrião.
Importante
Como as chaves de host fornecem acesso elevado ao seu aplicativo de função, você deve transportá-las e armazená-las com segurança.
O nível Anonymous significa que a autorização não é necessária. Este exercício usa o nível de autorização Anônimo.
Como criar um acionador HTTP
Tal como um acionador de temporizador, pode criar um acionador HTTP através do portal do Azure. Dentro da sua função do Azure, selecione Gatilho HTTP na lista de tipos de gatilho predefinidos, insira a lógica que você deseja executar e faça personalizações, como restringir o uso de determinados verbos HTTP.
Uma definição importante de compreender é o Nome do parâmetro de pedido. Esta definição é uma cadeia de carateres que representa o nome do parâmetro que contém as informações sobre um pedido HTTP recebido. Por predefinição, o nome do parâmetro é req.
Como invocar um acionador HTTP
Para invocar um acionador HTTP, envie um pedido HTTP para o URL da função. Para obter este URL, vá para a página de códigos da função e selecione a ligação Obter URL da função.
Depois de obter o URL da função, pode enviar pedidos HTTP. Se sua função receber dados, lembre-se de que você pode usar parâmetros de cadeia de caracteres de consulta ou fornecer os dados através do corpo da solicitação.
Um gatilho HTTP é executado quando recebe uma solicitação HTTP para sua URL de função. Os gatilhos HTTP permitem que você receba dados, execute lógica e, opcionalmente, retorne dados ao chamador.