통합 호출 태스크

통합 호출 태스크를 통해 Google Cloud 프로젝트 내에서 생성된 다른 통합을 호출할 수 있습니다.

통합 호출 태스크는 기본 통합(상위 통합)을 사용하여 제어되는 여러 개의 작은 통합(하위 통합)을 정의해야 하는 시나리오에서 유용합니다. 하위 통합을 실행한 후 기본 통합에서 하위 통합의 응답을 읽을 수도 있습니다.

시작하기 전에

통합 호출 태스크는 API 트리거를 사용하여 다른 통합 및 하위 통합을 식별하고 호출합니다. 따라서 호출하려는 통합이 API 트리거를 통해 구성되었는지 확인해야 합니다. API 트리거 구성에 대한 자세한 내용은 API 트리거를 참조하세요.
통합에 사용자 관리형 서비스 계정을 연결했는지 확인합니다. 통합에 사용자 관리형 서비스 계정이 구성되어 있지 않으면 기본적으로 인증에 기본 서비스 계정(service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com)이 사용됩니다.
서비스 계정에 Application Integration 호출자 IAM 역할이 있는지 확인합니다. 서비스 계정에 역할 부여에 대한 자세한 내용은 서비스 계정에 대한 액세스 관리를 참조하세요.

통합 호출 태스크 구성

통합 호출 태스크를 구성하려면 다음 안내를 따르세요.

Apigee UI에서 Apigee 조직을 선택합니다.
개발 > 통합을 클릭합니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
2. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
3. 만들기를 클릭합니다.
통합 디자이너 페이지에서 통합이 열립니다.
통합 설계자 탐색 메뉴에서 +태스크/트리거 추가 > 태스크를 클릭하여 사용 가능한 태스크 목록을 봅니다.
통합 편집기에서 통합 호출 요소를 클릭하여 배치합니다.
디자이너에서 통합 호출 태스크 요소를 클릭하여 통합 호출 태스크 구성 창을 봅니다.
다음 하위 통합 세부정보를 구성합니다.
1. API 트리거 ID: 호출할 통합의 API 트리거 ID를 입력합니다. 동일한 트리거 ID로 단일 통합 또는 여러 통합을 호출할 수 있습니다.
2. 이 API 트리거 ID로 모든 통합 실행: API 트리거 ID가 동일한 모든 통합을 호출하려면 이 옵션을 선택합니다.
  예를 들어 통합 A 및 통합 B에 동일한 API 트리거 ID가 있는 경우 A 및 B 통합 모두 실행됩니다.
  
  참고: 이 옵션을 선택하면 하위 통합의 응답을 기본 통합에서 사용할 수 없습니다. 하위 통합 응답에 액세스하려면 단일 통합 실행 옵션을 선택합니다.
3. 단일 통합 실행: 통합 이름 필드에 지정된 통합만 호출하려면 이 옵션을 선택합니다. 하위 통합 응답 변수 매핑에 설명된 필드를 구성하여 하위 통합의 응답에 액세스하고 매핑할 수 있습니다.
4. 실행 전략: 호출할 하위 통합의 실행 모드를 선택합니다.
  - SYNC - 동기 모드로 하위 통합을 실행합니다. 이 모드에서 기본 통합은 하위 통합이 완료될 때까지 기다린 후 다운스트림 태스크를 계속 진행합니다.
  - ASYNC - 비동기 모드로 하위 통합을 실행합니다. 이 모드에서 기본 통합은 하위 통합이 완료될 때까지 기다리지 않습니다. 하위 통합을 호출한 직후에는 기본 통합에서 다운스트림 태스크를 실행합니다.
    
    이 옵션을 선택한 경우 실행 지연(밀리초)을 설정합니다. 이 옵션을 설정하면 통합이 실행될 때까지의 지연 시간을 지정합니다.
  모든 변경사항은 자동으로 저장됩니다.

하위 통합 응답 변수 매핑

다음 표에서는 기본 통합과 하위 통합 간에 변수를 매핑하는 구성 속성을 설명합니다.

속성 설명

속성	설명
`Map to sub-integration input(s)`	기본 통합에서 하위 통합으로 값을 매핑합니다. 이 필드는 키-값 쌍의 형태로 값을 사용합니다. 여기서 키는 기본 통합의 변수이며 값은 하위 통합의 해당 입력 변수입니다. 예를 들어 기본 통합의 `productID` 변수를 `subIntProductID` 하위 통합 변수로 매핑하려는 경우 매핑할 통합 변수 필드에서 `productID`를 선택하고 매핑할 하위 통합 입력 필드에 `subIntProductID`를 입력합니다.
`Map values to sub-integration output(s)`	하위 통합 출력 변수를 기본 통합 변수에 매핑합니다. 매핑할 하위 통합 출력을 클릭하고 하위 통합을 선택합니다. 매핑할 통합 변수를 클릭하고 해당 기본 통합 변수를 선택합니다. 참고: 이 필드는 SYNC 실행 전략에서 단일 통합 실행 옵션을 선택한 경우에만 표시됩니다.

Map to sub-integration input(s)

기본 통합에서 하위 통합으로 값을 매핑합니다. 이 필드는 키-값 쌍의 형태로 값을 사용합니다. 여기서 키는 기본 통합의 변수이며 값은 하위 통합의 해당 입력 변수입니다.

예를 들어 기본 통합의 productID 변수를 subIntProductID 하위 통합 변수로 매핑하려는 경우 매핑할 통합 변수 필드에서 productID를 선택하고 매핑할 하위 통합 입력 필드에 subIntProductID를 입력합니다.

Map values to sub-integration output(s)

하위 통합 출력 변수를 기본 통합 변수에 매핑합니다.

매핑할 하위 통합 출력을 클릭하고 하위 통합을 선택합니다. 매핑할 통합 변수를 클릭하고 해당 기본 통합 변수를 선택합니다.

권장사항

통합 호출 태스크에 적용되는 사용량 한도에 대한 자세한 내용은 사용량 한도를 참조하세요.

오류 처리 전략

태스크의 오류 처리 전략은 일시적인 오류로 인해 태스크가 실패할 경우 수행할 태스크를 지정합니다. 오류 처리 전략을 사용하는 방법과 다양한 유형의 오류 처리 전략에 대한 자세한 내용은 오류 처리 전략을 참조하세요.