AzureFunction@1. Вызов задачи функции Azure версии 1

Статья
03/24/2025

Используйте эту задачу в задании без агента конвейера выпуска, чтобы вызвать триггерную функцию HTTP в приложении-функции и проанализировать ответ. Приложение-функция должно быть создано и размещено в Функциях Azure.

Синтаксис

# Invoke Azure Function v1
# Invoke an Azure Function.
- task: AzureFunction@1
  inputs:
    function: # string. Required. Azure function URL. 
    key: # string. Required. Function key. 
    method: 'POST' # 'OPTIONS' | 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'TRACE' | 'PATCH'. Required. Method. Default: POST.
    #headers: # string. Headers. 
    #queryParameters: # string. Query parameters. 
    #body: # string. Optional. Use when method != GET && method != HEAD. Body. 
  # Advanced
    waitForCompletion: 'false' # 'true' | 'false'. Required. Completion event. Default: false.
    #successCriteria: # string. Optional. Use when waitForCompletion = false. Success criteria.

Входные данные

function - URL-адрес функции Azure
string. Обязательное.

URL-адрес вызываемой функции Azure. Пример: https://azurefunctionapp.azurewebsites.net/api/HttpTriggerJS1.

ключа функции key -
string. Обязательное.

Функция или ключ узла, используемые для доступа и вызова функции. Чтобы обеспечить безопасность ключа, используйте переменную секретного конвейера для хранения ключа функции. Пример: $(myFunctionKey). myFunctionKey — это переменная секрета уровня среды со значением в качестве секретного ключа.

Метод method -
string. Обязательное. Допустимые значения: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, PATCH. Значение по умолчанию: POST.

Метод HTTP, с которым будет вызвана функция.

headers - заголовки
string. Значение по умолчанию: {\n"Content-Type":"application/json", \n"PlanUrl": "$(system.CollectionUri)", \n"ProjectId": "$(system.TeamProjectId)", \n"HubName": "$(system.HostType)", \n"PlanId": "$(system.PlanId)", \n"JobId": "$(system.JobId)", \n"TimelineId": "$(system.TimelineId)", \n"TaskInstanceId": "$(system.TaskInstanceId)", \n"AuthToken": "$(system.AccessToken)"\n}.

Заголовок в формате JSON, который должен быть присоединен к запросу, отправленному функции.

queryParameters - параметры запроса
string.

Строковый запрос, добавляемый к URL-адресу функции. Не следует начинать с ? или &.

body - текст
string. Необязательно. Используется при method != GET && method != HEAD.

Текст запроса в формате JSON.

событие завершения waitForCompletion -
string. Обязательное. Допустимые значения: true (обратный вызов), false (ApiResponse). Значение по умолчанию: false.

Как выполняется завершение задачи.

false — ответ API — функция возвращает критерии успешности и успешности.
true — обратный вызов — функция выполняет обратный вызов для обновления записи временной шкалы.

successCriteria - критерии успешности
string. Необязательно. Используется при waitForCompletion = false.

Критерии успешной задачи. По умолчанию задача возвращает состояние 200 OK при успешном выполнении.

Пример: для {"status" : "successful"}ответа выражение может быть eq(root['status'], 'successful'). Дополнительные сведения об указании условий.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Замечания

Используйте эту задачу в задании без агента конвейера выпуска, чтобы вызвать триггерную функцию HTTP в приложении-функции, созданном и размещенном в Функциях Azure, и проанализировать ответ.

Где должно быть завершено выполнение задачи при выборе обратного вызова в качестве события завершения?

Чтобы сигнализировать о завершении, функция должна отправлять данные завершения POST в следующую конечную точку REST конвейеров.

{planUri}/{projectId}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/events?api-version=2.0-preview.1

**Request Body**
{ "name": "TaskCompleted", "taskId": "taskInstanceId", "jobId": "jobId", "result": "succeeded" }

Дополнительные сведения см. в этом простом приложения cmdline. Кроме того, вспомогающая библиотека C# доступна для включения динамического ведения журнала и управления состоянием задачи без агента. Подробнее

Почему задача завершается сбоем в течение 1 минуты, когда время ожидания больше?

Если функция выполняется более 1 минуты, используйте событие завершения обратного вызова . Параметр завершения ответа API поддерживается для запросов, которые выполняются в течение 60 секунд.

Примеры

Пример функции Azure, использующего режим завершения обратного вызова

#r "Newtonsoft.Json"

using System;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Primitives;
using Newtonsoft.Json;

public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
{
    var url = req.Headers["PlanUrl"];
    var projectId = req.Headers["ProjectId"];
    var hubName = req.Headers["HubName"];
    var planId = req.Headers["PlanId"];
    var jobId = req.Headers["JobId"];
    var timelineId = req.Headers["TimelineId"];
    var taskInstanceId = req.Headers["TaskinstanceId"];
    var authToken = req.Headers["AuthToken"];

    var callbackUrl = $"{url}/{projectId}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/events?api-version=2.0-preview.1";
  
    var successBody = JsonConvert.SerializeObject(new {
        name = "TaskCompleted",
        taskId = taskInstanceId.ToString(),
        jobId = jobId.ToString(),
        result = "succeeded"
    });

    // the following call does not block
    Task.Run(() =>
    {
        Thread.Sleep(70000); // simulate long running work
        PostEvent(callbackUrl, successBody, authToken, log);
    });
   
    return new OkObjectResult("Long-running job successfully scheduled!");
}
    
public static void PostEvent(String callbackUrl, String body, String authToken, ILogger log)
{
    try
    {
        var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", authToken);
        var requestContent = new StringContent(body, Encoding.UTF8, "application/json");
        var response = client.PostAsync(new Uri(callbackUrl), requestContent).Result;
        var responseContent = response.Content.ReadAsStringAsync().Result;
        log.LogInformation(response.StatusCode.ToString());
        log.LogInformation(responseContent);
    }
    catch (Exception ex)
    {
        log.LogError(ex.Message);
    }
}

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Сервер, ServerGate
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	Все поддерживаемые версии агента.
Категория задач	Полезность

Поделиться через