Konfigurieren der Change-Steuerung mit der Azure-REST-API aufrufen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer
  • Sie können die Azure-REST-API aufrufen in Ihrer YAML- oder Classic Azure-Pipeline verwenden, um die Change-Steuerung für zu konfigurieren DevOps.

    Sie müssen aktivieren This property decides whether to create a Generic Connection on configure operation for Azure DevOpsEigenschaft zur Verwendung der REST-API aufrufen.

    Informationen zu Details der Azure-Aufrufungs-REST-API finden Sie unter Microsoft-Dokumentationswebsite Und suchen Sie nach HTTP-REST-API-Aufgabe aufrufen – Azure-Pipelines .

    Wichtig:

    Wenn Sie doppelte oder wiederverwendete Auftragsnamen in Ihren Pipeline-Ausführungsschritten haben, stellen Sie sicher, dass das Attribut „stageName“ „azurestageName/jobName“ in seinem Wert enthält, d. h. StageName = azureStageName/jobName . Die Artefaktregistrierungsaufgaben senden sowohl Phasen- als auch Auftragsnamen, um die Artefaktversion der richtigen Aufgabenausführung zuzuordnen.

    Generische Serviceverbindung

    Die Verwendung der Azure-REST-API zum Aufrufen erfordert die Erstellung einer generischen Serviceverbindung in Azure DevOps.

    Azure YAML REST API Change Control-Verbindung

    YAML Azure-Pipeline

    In Azure DevOps, Eine Serveraufgabe muss mit der Serviceverbindung als Change-Steuerungsendpunkt erstellt werden.

    Tabelle : 1. Rufen Sie die REST-API-Nutzlastanforderungen auf
    Azure-Pipeline-Typ Werte
    Build
    • buildNumber
    • Ist mehrere Verzweigungen
    • BranchName
    Release
    • ReleaseNummer
    • projectName
    Hinweis:
    Legen Sie für Release-Pipelines fest Bedingungen vor der Bereitstellung > Erweitert > Abschlussereignis Feld für Rückruf.
    Pipeline erstellen:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "buildNumber": "$(build.buildId)",
                "isMultiBranch": "true",
                "branchName": "$(build.sourceBranchName)"
             }
            waitForCompletion: 'true'
    Release-Pipeline:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "releaseNumber": "$(Release.ReleaseId)",
                "projectName": "$(System.TeamProject)"
             }
            waitForCompletion: 'true'

    Klassische Azure-Pipeline

    Für eine klassische Azure-Pipeline muss eine Aufgabe „REST-API-Server aufrufen“ hinzugefügt werden.

    Abbildung : 1. Beispiel für eine klassische Azure-Build-Pipeline
    Azure-Pipeline ruft DIE REST-API-Change-Steuerung auf
    Abbildung : 2. Beispiel für eine klassische Azure-Release-Pipeline
    DevOps Azure – klassische Release-Pipeline