Azure Invoke REST API を使用した変更管理の構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • YAML またはクラシック Azure パイプラインで Azure Invoke REST API を使用して、DevOps の変更管理を構成できます。

    Invoke REST API を使用するには、 This property decides whether to create a Generic Connection on configure operation for Azure DevOps プロパティを有効にする必要があります。

    Azure Invoke REST API の詳細については、 Microsoft ドキュメントサイト にアクセスし、「 Invoke HTTP REST API task- Azure Pipelines」を検索してください。

    重要:

    パイプライン実行ステップに重複または再利用されたジョブ名がある場合は、stageName 属性の値に azurestageName/jobName が含まれていることを確認します (stageName = azureStageName/jobName)。アーティファクト登録タスクは、ステージ名とジョブ名の両方を送信して、アーティファクトバージョンを正しいタスク実行に関連付けます。

    汎用サービス接続

    Azure Invoke REST API を使用するには、 Azure DevOps で汎用サービス接続を作成する必要があります。

    Azure YAML REST API 変更コントロール接続

    YAML Azure パイプライン

    Azure DevOps では、サービス接続を変更コントロールのエンドポイントとしてサーバータスクを作成する必要があります。

    表 : 1. Invoke REST API ペイロードの要件
    Azure パイプラインのタイプ
    ビルド
    • buildNumber
    • isMultiBranch
    • branchName
    リリース
    • releaseNumber
    • projectName
    注:
    リリースパイプラインの場合は、 展開前の条件 > 詳細 > 完了イベント フィールドをコールバックに設定します。
    ビルドパイプライン:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "buildNumber": "$(build.buildId)",
                "isMultiBranch": "true",
                "branchName": "$(build.sourceBranchName)"
             }
            waitForCompletion: 'true'
    リリースパイプライン:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "releaseNumber": "$(Release.ReleaseId)",
                "projectName": "$(System.TeamProject)"
             }
            waitForCompletion: 'true'

    クラシック Azure パイプライン

    クラシック Azure パイプラインの場合は、Invoke REST API サーバータスクを追加する必要があります。

    図 : 1. クラシック Azure ビルドパイプラインの例
    Azure パイプライン呼び出し REST API 変更コントロール
    図 : 2. クラシック Azure リリースのパイプラインの例
    DevOps Azure クラシックリリースパイプライン