통합 업로드 및 다운로드

통합을 JSON 파일로 다운로드하여 로컬 시스템에 저장할 수 있습니다. 이렇게 하면 파일에서 전체 통합을 사용할 수 있으며 수정하지 않고 다른 통합 프로젝트에서 직접 업로드할 수 있습니다. 통합을 업로드하면 파일이 업로드된 프로젝트에 새 버전의 통합이 생성됩니다.

전체 통합을 하나의 파일 형식으로 지정함으로써 다음과 같은 이점이 있습니다.

큰 어려움 없이 한 프로젝트에서 다른 프로젝트로 통합을 복사할 수 있습니다.
태스크 이름 바꾸기 또는 변수 이름 동적 수정과 같은 반복적인 변경사항을 위한 통합 파일 업데이트를 프로그래매틱 방식으로 수행할 수 있습니다.

통합 다운로드

통합을 다운로드하려면 다음 단계를 수행합니다.

Apigee UI에서 Apigee 조직을 선택합니다.
개발 > 통합을 클릭합니다.
기존 통합을 선택합니다. 통합 편집기 페이지에서 통합이 열립니다.
버전 드롭다운을 클릭하고 다운로드할 버전을 선택합니다.
디자이너 툴바에서 (작업 메뉴)를 클릭하고 다운로드를 선택합니다.
INTEGRATION_NAME.json 파일은 웹브라우저의 기본 다운로드 폴더에 자동으로 저장됩니다.

참고: 다운로드된 JSON 파일은 DownloadIntegrationVersionResponse 유형의 구조를 갖습니다. JSON 파일을 수정하려면 수정된 파일이 DownloadIntegrationVersionResponse 구조를 준수하는지 확인합니다.

통합 업로드

통합을 업로드하려면 다음 단계를 수행합니다.

Apigee UI에서 Apigee 조직을 선택합니다.
개발 > 통합을 클릭합니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
2. 통합 리전을 선택합니다.
  참고: 리전 드롭다운에는 Google Cloud 프로젝트에 프로비저닝된 리전만 나열됩니다. 새 리전을 프로비저닝하려면 리전 사용 설정을 클릭합니다. 자세한 내용은 새 리전 사용 설정을 참조하세요.
3. 만들기를 클릭합니다.
통합 편집기 페이지에서 통합이 열립니다.
디자이너 툴바에서 (작업 메뉴)를 클릭하고 업로드를 선택합니다.
파일 브라우저 대화상자에서 업로드하려는 파일을 선택한 후 열기를 클릭합니다.
업로드된 파일을 통해 새 버전의 통합이 생성됩니다.

API를 사용해서 다운로드 및 업로드

통합 API를 사용해서 통합을 업로드 또는 다운로드할 수 있습니다.

API를 사용하여 통합 다운로드

통합을 다운로드하려면 다음 API에 대해 GET 요청을 실행합니다.

https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

다음 예시는 통합의 특정 버전을 다운로드하는 방법을 보여줍니다.

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/products/apigee/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

참고: 이전 예시에서 통합 버전 번호는 0e90d453-5fcf-4aae-b164-2e8344d1ac11입니다. 통합 버전을 가져오려면 UI에서 필요한 통합 버전을 열고 URL에서 ../integrations/integration/INTEGRATION_NAME/ 다음에 있는 자동 생성된 고유한 ID 문자열을 복사합니다.

자세한 내용은 projects.locations.products.integrations.versions.download를 참조하세요.

API를 사용하여 통합 업로드

통합을 업로드하려면 다음 API에 대해 POST 요청을 실행합니다.

  https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}:upload

다음 예시는 통합 업로드 방법을 보여줍니다.

curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
-X POST -d '{"content":
  "{\"name\":\"projects/450954726404/locations/us-east1/products/apigee/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
  \"origin\":\"UI\",
  \"snapshotNumber\":\"3\",
  \"updateTime\":\"2022-01-06T04:26:58.137Z\",
  \"lockHolder\":\"abc@test.com\",
  \"createTime\":\"2022-01-06T04:26:42.734Z\",
  \"lastModifierEmail\":\"abc@test.com\",
  \"state\":\"DRAFT\",
  \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
  \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}'
  \https://integrations.googleapis.com/v1/projects/apigee-1/locations/us-east1/products/apigee/integrations/test-integration/versions:upload

API에 대한 자세한 내용은 projects.locations.products.integrations.versions.upload를 참조하세요.

고려사항

업로드 또는 다운로드 기능을 사용할 때는 다음 항목을 고려하세요.

통합을 업로드하면 새 버전의 통합이 생성됩니다. 예를 들어 이름이 IP-Test이고 버전이 5인 통합이 있을 때 IP-Test에서 통합 파일을 업로드하면 이 통합에 대해 새 버전 6이 생성됩니다.
파일을 업로드할 수 있는 기존 통합이 없으면 먼저 새 통합을 만든 후 업로드해야 합니다. 이 경우 생성되는 새 통합은 버전이 1이고 업로드된 통합은 버전이 2입니다.
통합을 위해 구성된 인증 프로필의 세부정보는 다운로드된 파일에 제공되지 않습니다. 파일을 업로드한 후 업로드된 통합에서 인증 프로필을 다시 구성해야 합니다.