통합을 JSON 파일로 다운로드하여 로컬 시스템에 저장할 수 있습니다. 이렇게 하면 파일에서 전체 통합을 사용할 수 있으며 수정하지 않고 다른 통합 프로젝트에서 직접 업로드할 수 있습니다. 통합을 업로드하면 파일이 업로드된 프로젝트에 새 버전의 통합이 생성됩니다.
전체 통합을 하나의 파일 형식으로 지정함으로써 다음과 같은 이점이 있습니다.- 큰 어려움 없이 한 프로젝트에서 다른 프로젝트로 통합을 복사할 수 있습니다.
- 태스크 이름 바꾸기 또는 변수 이름 동적 수정과 같은 반복적인 변경사항을 위한 통합 파일 업데이트를 프로그래매틱 방식으로 수행할 수 있습니다.
통합 다운로드
통합을 다운로드하려면 다음 단계를 수행합니다.
- Apigee UI에서 Apigee 조직을 선택합니다.
- 개발 > 통합을 클릭합니다.
- 기존 통합을 선택합니다. 통합 편집기 페이지에서 통합이 열립니다.
- 버전 드롭다운을 클릭하고 다운로드할 버전을 선택합니다.
- 디자이너 툴바에서
INTEGRATION_NAME.json 파일은 웹브라우저의 기본 다운로드 폴더에 자동으로 저장됩니다.
(작업 메뉴)를 클릭하고 다운로드를 선택합니다.
통합 업로드
통합을 업로드하려면 다음 단계를 수행합니다.
- Apigee UI에서 Apigee 조직을 선택합니다.
- 개발 > 통합을 클릭합니다.
- 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
- 통합 만들기 대화상자에 이름과 설명을 입력합니다.
- 통합 리전을 선택합니다.
- 만들기를 클릭합니다.
통합 편집기 페이지에서 통합이 열립니다.
- 디자이너 툴바에서 (작업 메뉴)를 클릭하고 업로드를 선택합니다.
- 파일 브라우저 대화상자에서 업로드하려는 파일을 선택한 후 열기를 클릭합니다.
업로드된 파일을 통해 새 버전의 통합이 생성됩니다.
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"
자세한 내용은 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입니다.
- 통합을 위해 구성된 인증 프로필의 세부정보는 다운로드된 파일에 제공되지 않습니다. 파일을 업로드한 후 업로드된 통합에서 인증 프로필을 다시 구성해야 합니다.