AzureFunction@2 - Aufrufe Azure Funktion v2 Aufgabe

Verwenden Sie diese Aufgabe in einem agentlosen Job einer Release-Pipeline, um eine HTTP-ausgelöste Funktion in einer Funktions-App aufzurufen und die Antwort zu parsen. Die Funktions-App muss in Azure Functions erstellt und gehostet werden.

# Invoke Azure Function v2
# Invoke an Azure Function.
- task: AzureFunction@2
  inputs:
    #azureSubscription: # string. Alias: azureServiceConnection | connectedServiceARM. Azure Service Connection. 
    function: # string. Required. Azure function URL. 
    #key: # string. 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.

azureSubscription - Azure Serviceverbindung
Eingabe-Alias: azureServiceConnection | connectedServiceARM. string.

Serviceverbindung, die zur Authentifizierung beim Aufruf der Azure-Funktion verwendet wird. Bietet einen Entra Access Token für Service Principal- oder Managed Identity-Zugriff.

function - Azure Funktion URL
string. Required.

URL der Azure-Funktion, die aufgerufen werden muss. Beispiel: https://azurefunctionapp.azurewebsites.net/api/HttpTriggerJS1.

key - Funktionstaste
string.

Die Funktion oder der Host-Schlüssel, mit dem man auf die Funktion zugreift und sie aufruft. Um den Schlüssel sicher zu halten, verwenden Sie eine geheime Pipeline-Variable, um den Funktionsschlüssel zu speichern. Beispiel: $(myFunctionKey). myFunctionKey ist eine geheime Variable auf Umweltebene mit einem Wert als geheimer Schlüssel.

method - Methode
string. Required. Zulässige Werte: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, PATCH. Standardwert: POST.

Die HTTP-Methode, mit der die Funktion aufgerufen wird.

headers - Überschriften
string. Standardwert: {\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}.

Der Header im JSON-Format soll an die an die Funktion gesendete Anfrage angehängt werden.

queryParameters - Abfrageparameter
string.

Die String-Abfrage, um an die Funktions-URL anzuhängen. Man darf nicht mit ? oder &beginnen.

body - Karosserie
string. Dies ist optional. Wird verwendet, wenn method != GET && method != HEAD.

JSON-formatierter Nachrichtentext für die Anfrage.

waitForCompletion - Abschluss-Event
string. Required. Erlaubte Werte: true (Callback), false (ApiResponse). Standardwert: false.

Wie die Aufgabe den Abschluss meldet.

• false - API-Antwort – die Funktion gibt Erfolgs- und Erfolgskriterien als wahr zurück.
• true - Callback – die Funktion führt einen Callback durch, um den Timeline-Datensatz zu aktualisieren.

successCriteria - Erfolgskriterien
string. Dies ist optional. Wird verwendet, wenn waitForCompletion = false.

Die Kriterien für eine erfolgreiche Aufgabe. Standardmäßig gibt die Aufgabe bei Erfolg den Status zurück 200 OK . Wenn diese Eingabe nicht angegeben ist, beeinflusst der Antwortinhalt das Ergebnis nicht.

Beispiel: Für die Antwort {"status" : "successful"}kann der Ausdruck sein eq(root['status'], 'successful'). Erfahren Sie mehr über die Festlegung von Bedingungen.

Keiner.