Configurar o controle de mudanças usando a REST API do Azure Invoke

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • Você pode usar a REST API Invocar do Azure no pipeline YAML ou do Azure clássico para configurar o controle de mudanças para DevOps.

    Você deve habilitar This property decides whether to create a Generic Connection on configure operation for Azure DevOpsInvocar REST API.

    Para obter detalhes da REST API de Invocação do Azure, visite Site de documentação da Microsoft e pesquise Invoque a tarefa HTTP REST API - Pipelines do Azure .

    Importante:

    Se você tiver nomes de trabalho duplicados ou reutilizados nas etapas de execução do pipeline, certifique-se de que o atributo stageName contenha azurestageName/JobName em seu valor, ou seja AzureStageName/JobName . As tarefas de registro de artefato enviam nomes de fase e trabalho para associar a versão do artefato à execução da tarefa correta.

    Conexão de serviço genérica

    Usar a REST API do Azure Invoke requer a criação de uma conexão de serviço genérica em Azure DevOps.

    Conexão de controle de mudanças da REST API do Azure YAML

    Pipeline do YAML Azure

    Em Azure DevOps uma tarefa do servidor deve ser criada com a conexão de serviço como o endpoint de controle de mudanças.

    Tabela 1. Invocar requisitos de carga da REST API
    Tipo de pipeline do Azure Valores
    Compilação
    • buildNumber
    • IsMultiBranch
    • BranchName
    Versão
    • Release Number
    • projectName
    Nota:
    Para pipelines de versão, defina Condições de pré-implantação > Avançado > Evento de conclusão Campo para Retorno de chamada.
    Criar pipeline:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "buildNumber": "$(build.buildId)",
                "isMultiBranch": "true",
                "branchName": "$(build.sourceBranchName)"
             }
            waitForCompletion: 'true'
    Pipeline de versão:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "releaseNumber": "$(Release.ReleaseId)",
                "projectName": "$(System.TeamProject)"
             }
            waitForCompletion: 'true'

    Pipeline clássico do Azure

    Para um pipeline do Azure clássico, uma tarefa do servidor Invocar REST API deve ser adicionada.

    Figura 1. Exemplo de pipeline de compilação do Azure clássico
    Invoque o controle de mudanças da REST API
    Figura 2. Exemplo de pipeline de versão clássica do Azure
    Pipeline de versão clássica do DevOps Azure