Azure 호출 REST API를 사용하여 변경 제어 구성

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분
  • YAML 또는 클래식 Azure 파이프라인에서 Azure 호출 REST API를 사용하여 에 대한 변경 제어를 구성할 수 있습니다 DevOps.

    호출 REST API를 사용하려면 속성을 사용하도록 설정 This property decides whether to create a Generic Connection on configure operation for Azure DevOps 해야 합니다.

    Azure 호출 REST API 세부 정보는 Microsoft 설명서 사이트를 방문하여 HTTP REST API 호출 작업 - Azure Pipelines를 검색합니다.

    중요사항:

    파이프라인 실행 단계에 중복되거나 재사용되는 작업 이름이 있는 경우 stageName 속성의 값에 azurestageName/jobName이 포함되어 있는지 확인합니다( 예: stageName = azureStageName/jobName). 아티팩트 등록 작업은 스테이지와 작업 이름을 모두 전송하여 아티팩트 버전을 올바른 작업 실행에 연결합니다.

    일반 서비스 연결

    Azure 호출 REST API를 사용하려면 에서 일반 서비스 연결을 Azure DevOps만들어야 합니다.

    Azure YAML REST API 변경 통제 연결

    YAML Azure 파이프라인

    에서 Azure DevOps서비스 연결을 변경 제어 엔드포인트로 사용하여 서버 작업을 만들어야 합니다.

    표 1. REST API 페이로드 요구 사항 호출
    Azure 파이프라인 유형
    빌드
    • buildNumber
    • isMultiBranch
    • 분기 이름
    릴리스
    • 릴리스 번호
    • 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 파이프라인의 경우 REST API 서버 호출 작업을 추가해야 합니다.

    그림 1. 클래식 Azure 빌드 파이프라인 예
    Azure Pipeline 호출 REST API 변경 통제
    그림 2. 클래식 Azure 릴리스 파이프라인 예
    DevOps Azure 클래식 릴리스 파이프라인