Application Integration에 지원되는 커넥터를 참조하세요.

API 트리거

API 트리거는 통합 실행을 직접 호출하는 데 사용됩니다.

통합에서 API 트리거를 구성하면 다음 작업을 할 수 있습니다.

API 트리거를 시작하려면 API 처리 튜토리얼을 참고하세요. 이 튜토리얼에서는 고객 정보를 검색하기 위한 API 요청을 수신하는 API 트리거와의 통합을 만드는 방법을 보여줍니다.

API 트리거 추가

통합에 API 트리거를 추가하려면 다음 단계를 따르세요.
  1. Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.

    Application Integration으로 이동

  2. 탐색 메뉴에서 통합을 클릭합니다.

    Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 목록 페이지가 나타납니다.

  3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

    새 통합을 만드는 경우:

    1. 통합 만들기 창에 이름과 설명을 입력합니다.
    2. 통합 리전을 선택합니다.
    3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
    4. 만들기를 클릭합니다.

    통합 편집기 페이지에서 통합이 열립니다.

  4. 통합 편집기 탐색 메뉴에서 트리거를 클릭하여 사용 가능한 트리거 목록을 확인합니다.
  5. API 트리거 요소를 클릭하여 디자이너에 배치합니다.

API 트리거 구성

API 트리거를 구성하려면 통합 편집기에서 API 트리거 요소를 클릭합니다. API 트리거 구성 창이 표시되며 다음 필드가 표시됩니다.

  • 라벨: 통합에서 API 트리거의 표시 이름입니다. 라벨을 원하는 이름으로 변경할 수 있습니다.
  • 참고: API 트리거에 메모를 추가하여 트리거에 관한 추가 정보를 제공할 수 있습니다.
  • 트리거 ID: API 트리거에 할당되는 고유 ID로 api_trigger/TRIGGER_NAME 형식입니다.
  • 입력 변수: API 트리거의 요청 페이로드를 설정하는 데 사용할 수 있는 트리거별 입력 변수입니다.
    • API 트리거에 기존 통합 변수를 추가하거나 삭제하려면 수정을 클릭하고 API 트리거 입력 변수 창에서 필요한 변수를 선택합니다.
    • 특히 선택한 API 트리거에 새 변수를 추가하려면 수정을 클릭하고 API 트리거 입력 변수 창에서 + 새 변수 추가를 선택합니다. 지원되는 데이터 유형에 대한 자세한 내용은 지원되는 변수 데이터 유형을 참고하세요.
  • 출력 변수: API 트리거의 응답 페이로드를 설정하는 데 사용할 수 있는 트리거별 출력 변수입니다.
    • API 트리거에 기존 통합 변수를 추가하거나 삭제하려면 수정을 클릭하고 API 트리거 출력 변수 창에서 필요한 변수를 선택합니다.
    • 특히 선택한 API 트리거에 새 변수를 추가하려면 수정을 클릭하고 API 트리거 출력 변수 창에서 + 새 변수 추가를 선택합니다. 지원되는 데이터 유형에 대한 자세한 내용은 지원되는 변수 데이터 유형을 참고하세요.

API 트리거의 OpenAPI 사양 보기

애플리케이션 통합은 하나 이상의 API 트리거로 구성된 게시된 통합의 OpenAPI 사양을 동적으로 생성하고 볼 수 있는 기능을 제공합니다. OpenAPI 사양을 보는 방법에 대한 자세한 내용은 통합의 OpenAPI 사양 보기를 참고하세요.

API 호출을 사용하여 API 트리거 호출

API 트리거가 구성된 통합을 게시한 후 projects.locations.integrations.execute 메서드를 사용하여 모든 애플리케이션에서 해당 트리거를 호출할 수 있습니다. 이 메서드는 동기 모드에서 실행을 트리거합니다.

구문

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Server-Timeout: TIMEOUT_SECONDS" \
    -d '{"trigger_id":"api_trigger/TRIGGER_NAME"}' \
    "https://LOCATION-integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

다음을 바꿉니다.

  • TIMEOUT_SECONDS: API 호출의 제한 시간(초)입니다. 기본적으로 제한 시간은 120초입니다. 사전 정의된 요청 매개변수 집합의 목록은 시스템 매개변수를 참조하세요.
  • TRIGGER_NAME: 통합의 API 트리거 이름
  • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
  • LOCATION: Google Cloud 프로젝트의 위치입니다.

예시

다음 예시에서는 demo-project Google Cloud 프로젝트에 test_API_1 API 트리거가 포함된 us-east1 리전의 통합을 호출합니다.

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)"
    -H "Content-Type: application/json" \
    -H "X-Server-Timeout: 300"
    -d '{"trigger_id":"api_trigger/test_API_1"}' \
    "https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-central1/integrations/-:execute"

고려사항

API 트리거를 사용하는 경우 모든 입력 변수의 누적 크기가 최대 8MB일 수 있습니다. 크기가 8MB를 초과하면 Application Integration에서 통합이 실행되지 않고 오류가 표시됩니다.

할당량 및 한도

할당량 및 한도에 대한 자세한 내용은 할당량 및 한도를 참조하세요.

다음 단계