Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Importante
In Azure DevOps Services, AzureFunction@0 si ritira il 24 novembre 2026 ed è rimosso il 15 marzo 2027. Usa AzureFunction@2 invece. Per le indicazioni su programmazione e migrazione, consulta l'annuncio di ritiro dei compiti di Azure Pipelines.
Usare questa attività in un processo senza agente di una pipeline di versione per richiamare una funzione attivata tramite HTTP in un'app per le funzioni e analizzare la risposta. L'app per le funzioni deve essere creata e ospitata in Funzioni di Azure.
Sintassi
# Invoke Azure Function v0
# Invoke Azure function as a part of your process.
- task: AzureFunction@0
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: '{"JobId": "$(system.jobId)", "PlanId": "$(system.planId)", "TimelineId": "$(system.timelineId)", "ProjectId": "$(system.teamProjectId)", "VstsUrl": "$(system.CollectionUri)","AuthToken": "$(system.AccessToken)"}' # string. Optional. Use when method != GET && method != HEAD. Body. Default: {"JobId": "$(system.jobId)", "PlanId": "$(system.planId)", "TimelineId": "$(system.timelineId)", "ProjectId": "$(system.teamProjectId)", "VstsUrl": "$(system.CollectionUri)","AuthToken": "$(system.AccessToken)"}.
# Completion Options
waitForCompletion: 'false' # 'true' | 'false'. Required. Complete based on. Default: false.
#successCriteria: # string. Optional. Use when waitForCompletion = false. Success criteria.
Ingressi dati
function
-
url della funzione di Azure
string. Obbligatorio.
URL della funzione di Azure da richiamare. Esempio: https://azurefunctionapp.azurewebsites.net/api/HttpTriggerJS1.
key
-
tasto funzione
string. Obbligatorio.
Funzione o chiave host usata per accedere e richiamare la funzione. Per proteggere la chiave, usare una variabile della pipeline privata per archiviare la chiave della funzione. Esempio: $(myFunctionKey).
myFunctionKey è una variabile privata a livello di ambiente con un valore come chiave privata.
metodo method -
string. Obbligatorio. Valori consentiti: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, PATCH. Valore predefinito: POST
Metodo HTTP con cui verrà richiamata la funzione.
headers
-
intestazioni
string. Valore predefinito: {\n"Content-Type":"application/json"\n}
Intestazione in formato JSON da collegare alla richiesta inviata alla funzione.
queryParameters
-
parametri di query
string.
Query stringa da aggiungere all'URL della funzione. Non deve iniziare con ? o &.
body
-
corpo
string. Opzionale. Usare quando method != GET && method != HEAD. Valore predefinito: {"JobId": "$(system.jobId)", "PlanId": "$(system.planId)", "TimelineId": "$(system.timelineId)", "ProjectId": "$(system.teamProjectId)", "VstsUrl": "$(system.CollectionUri)","AuthToken": "$(system.AccessToken)"}
Corpo della richiesta in formato JSON.
waitForCompletion
-
Completato in base a
string. Obbligatorio. Valori consentiti: true (callback), false (ApiResponse). Valore predefinito: false
Come l'attività segnala il completamento.
-
false: di risposta API: la funzione restituisce i criteri di esito positivo e riuscito restituisce true. -
true- Callback - la funzione esegue un callback per aggiornare il record della sequenza temporale.
successCriteria
-
criteri di esito positivo
string. Opzionale. Usare quando waitForCompletion = false.
Criteri per un'attività riuscita. Per impostazione predefinita, l'attività restituisce 200 OK stato quando ha esito positivo.
Esempio: per la risposta {"status" : "successful"}, l'espressione può essere eq(root['status'], 'successful'). Altre informazioni su specifica delle condizioni.
Opzioni di controllo attività
Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.
Variabili di output
Nessuno.
Osservazioni:
AzureFunction@2 è una versione più recente dell'attività Richiama funzione di Azure.
Requisiti
| Requisito | Descrizione |
|---|---|
| Tipi di pipeline | Versione classica |
| Viene eseguito in | Server, ServerGate |
| richieste | Nessuno |
| funzionalità di |
Questa attività non soddisfa alcuna richiesta di attività successive nel processo. |
| restrizioni dei comandi | Qualunque |
| variabili impostabili | Qualunque |
| Versione dell'agente | Tutte le versioni dell'agente supportate. |
| Categoria attività | Utilità |
Vedere anche
- AzureFunction@2 è una versione più recente dell'attività Richiama funzione di Azure.