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

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 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 파이프라인 호출 REST API 변경 제어
    그림 2. 클래식 Azure 릴리스 파이프라인 예시
    DevOps Azure 클래식 릴리스 파이프라인