InvokeRESTAPI@1 - Invocar a tarefa REST API v1

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

# Invoke REST API v1
# Invoke a REST API as a part of your pipeline.
- task: InvokeRESTAPI@1
  inputs:
    connectionType: 'connectedServiceName' # 'connectedServiceName' | 'connectedServiceNameARM'. Alias: connectedServiceNameSelector. Required. Connection type. Default: connectedServiceName.
    serviceConnection: # string. Alias: connectedServiceName | genericService. Required when connectedServiceNameSelector = connectedServiceName. Generic service connection. 
    #azureServiceConnection: # string. Alias: connectedServiceNameARM | azureSubscription. Required when connectedServiceNameSelector = connectedServiceNameARM. Azure subscription. 
    method: 'POST' # 'OPTIONS' | 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'TRACE' | 'PATCH'. Required. Method. Default: POST.
    #headers: # string. Headers. 
    #body: # string. Optional. Use when method != GET && method != HEAD. Body. 
    #urlSuffix: # string. URL suffix and parameters. 
  # Advanced
    waitForCompletion: 'false' # 'true' | 'false'. Required. Completion event. Default: false.
    #successCriteria: # string. Optional. Use when waitForCompletion = false. Success criteria.

connectionType - Tipo de conexão
Alias de entrada: connectedServiceNameSelector. string. Obrigatório. Valores permitidos: connectedServiceName (genérico), connectedServiceNameARM (Azure Resource Manager). Valor padrão: connectedServiceName.

Especifica o tipo de conexão de serviço a ser usado para invocar a API REST. Selecione do Azure Resource Manager para invocar uma API de gerenciamento do Azure ou Genérico para todas as outras APIs.

serviceConnection - de conexão de serviço genérico
Alias de entrada: connectedServiceName | genericService. string. Necessário quando connectedServiceNameSelector = connectedServiceName.

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.

azureServiceConnection - de assinatura do Azure
Alias de entrada: connectedServiceNameARM | azureSubscription. string. Necessário quando connectedServiceNameSelector = connectedServiceNameARM.

Especifica a assinatura do Azure Resource Manager a ser configurada e usada para invocar APIs de gerenciamento do Azure.

method - Método
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.

headers - Cabeçalhos
string. Valor padrão: {\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}.

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.

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

urlSuffix - sufixo e parâmetros de URL
string.

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

Exemplo: Se a URL de conexão de serviço estiver 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 - Evento de conclusão
string. Obrigatório. Valores permitidos: true (Callback), false (ApiResponse). Valor padrão: false.

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

• false - de resposta da API : informa a conclusão quando a função retorna o êxito em 20 segundos e o critério de sucesso é avaliado como verdadeiro.
• true - Callback: informa a conclusão quando o serviço externo faz um retorno de chamada para atualizar o registro da linha do tempo.

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

Especifica os critérios de sucesso da tarefa. O conteúdo da resposta não influencia o resultado se nenhum critério for definido. Por padrão, a tarefa passa quando a chamada retorna 200 OK.

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

Nenhum.