InvokeRESTAPI@0 – Invocar tarefa da API REST v0

Use essa tarefa para invocar uma API REST como parte do pipeline.

# Invoke REST API v0
# Invoke REST API as a part of your process.
- task: InvokeRESTAPI@0
  inputs:
    serviceConnection: # string. Alias: connectedServiceName. Required. Generic endpoint. 
    method: 'POST' # 'OPTIONS' | 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'TRACE' | 'PATCH'. Required. Method. Default: POST.
    #headers: # string. Headers. 
    #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)"}.
    #urlSuffix: # string. Url suffix string. 
  # Completion Options
    waitForCompletion: 'false' # 'true' | 'false'. Required. Complete based on. Default: false.
    #successCriteria: # string. Optional. Use when waitForCompletion = false. Success criteria.

serviceConnection - de ponto de extremidade genérico
Alias de entrada: connectedServiceName. string. Obrigatório

Especifica a conexão de serviço genérica que fornece o baseURL para a chamada e a autorização a ser usada para a tarefa.

Método method -
string. Obrigatório Valores permitidos: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, PATCH. Valor padrão: POST.

Especifica o método HTTP que invoca a API.

Cabeçalhos headers -
string. Valor padrão: {\n"Content-Type":"application/json"\n}.

Define o cabeçalho no formato JSON. O cabeçalho é anexado com a solicitação enviada à API.

body - corpo
string. Opcional. Use quando method != GET && method != HEAD. Valor padrão: {"JobId": "$(system.jobId)", "PlanId": "$(system.planId)", "TimelineId": "$(system.timelineId)", "ProjectId": "$(system.teamProjectId)", "VstsUrl": "$(system.CollectionUri)","AuthToken": "$(system.AccessToken)"}.

Especifica o corpo da solicitação para a chamada de função no formato JSON.

urlSuffix - cadeia de caracteres do sufixo url
string.

Especifica a cadeia de caracteres a ser acrescentada ao baseUrl da conexão de serviço genérica ao fazer a chamada HTTP.

Exemplo: se a URL de conexão de serviço for https:...TestProj/_apis/Release/releases e o sufixo de URL for /2/environments/1, a URL de conexão de serviço se tornará https:.../TestProj/_apis/Release/releases/2/environments/1. Se o sufixo de URL for ?definitionId=1&releaseCount=1, a URL de conexão de serviço se tornará https//...TestProj/_apis/Release/releases?definitionId=1&releaseCount=1.

waitForCompletion - Concluído com base em
string. Obrigatório Valores permitidos: true (retorno de chamada), false (ApiResponse). Valor padrão: false.

Especifica como a tarefa relata a conclusão. Os valores permitidos são:

• false - resposta à API: relata a conclusão quando a função retorna êxito dentro de 20 segundos e os critérios de êxito são avaliados como verdadeiros.
• true - de retorno de chamada: relata a conclusão quando o serviço externo faz um retorno de chamada para atualizar o registro da linha do tempo.

critérios de sucesso successCriteria -
string. Opcional. Use quando waitForCompletion = false.

Especifica os critérios da tarefa para êxito. O conteúdo da resposta não influenciará o resultado se nenhum critério for definido. Por padrão, a tarefa é passada quando a chamada retorna 200 OK.

Exemplo: para {"status" : "successful"}de resposta, a expressão pode ser eq(root['status'], 'successful'). Saiba mais sobre especificando condições.

Nenhum.