Configuration du contrôle du changement à l'aide de l'API REST Azure Invoke

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • Vous pouvez utiliser l'API REST Azure Invoke dans votre pipeline YAML ou Azure classique pour configurer le contrôle du changement pour DevOps.

    Vous devez activer la propriété This property decides whether to create a Generic Connection on configure operation for Azure DevOps pour utiliser l'API REST Invoke.

    Pour plus d'informations sur l'API REST Azure Invoke, consultez le site de documentation de Microsoft et recherchez Tâche Invoke API REST HTTP API - Pipelines Azure.

    Important :

    Si vous avez défini ou réutilisé des noms de tâches en double dans vos étapes d'exécution de pipeline, assurez-vous que la valeur de l'attribut stageName contient azurestageName/jobName, c'est-à-dire stageName = azureStageName/jobName. Les tâches d'enregistrement d' artefact envoient à la fois les noms d'étape et de tâche pour associer la version de l'artefact à l'exécution de tâche correcte.

    Connexion de service générique

    Pour utiliser l'API REST Azure Invoke, il est nécessaire de créer une connexion de service générique dans Azure DevOps.

    Connexion de contrôle du changement de l'API REST Azure YAML

    Pipeline Azure YAML

    Dans Azure DevOps, vous devez créer une tâche de serveur avec la connexion de service comme point de terminaison de contrôle du changement.

    Tableau 1. Exigences relatives à la charge utile de l'API REST Invoke
    Type de pipeline Azure Valeurs
    Version
    • buildNumber
    • isMultiBranch
    • branchName
    Version
    • releaseNumber
    • projectName
    Remarque :
    Pour les pipelines de mise en production, définissez l’icône Conditions de prédéploiement > Avancé > Événement d’achèvement champ à Callback.
    Pipeline de version :
    
- task: InvokeRESTAPI@1
      inputs:
        connectionType: 'connectedServiceName'
        serviceConnection: 'change1'
        method: 'POST'
        body: |
         {
            "buildNumber": "$(build.buildId)",
            "isMultiBranch": "true",
            "branchName": "$(build.sourceBranchName)"
         }
        waitForCompletion: 'true'
    Pipeline de mise en production :
    
- task: InvokeRESTAPI@1
      inputs:
        connectionType: 'connectedServiceName'
        serviceConnection: 'change1'
        method: 'POST'
        body: |
         {
            "releaseNumber": "$(Release.ReleaseId)",
            "projectName": "$(System.TeamProject)"
         }
        waitForCompletion: 'true'

    Pipeline Azure classique

    Pour un pipeline Azure classique, il convient d'ajouter une tâche de serveur d'API REST Invoke.

    Figure 1. Exemple de pipeline de version Azure classique
    Contrôle du changement de l'API REST Invoke du pipeline Azure
    Figure 2. Exemple de pipeline de mise en production Azure classique
    Pipeline de mise en production DevOps Azure classique