이 주제에서는 데이터 상주 규정을 준수하도록 새 Apigee Hybrid 설치를 구성하는 방법을 설명합니다.
데이터 상주 정보
Hybrid 버전 1.12부터는 새로운 Apigee Hybrid 설치로 데이터 상주를 사용할 수 있습니다. 데이터 상주를 사용하도록 기존 설치를 변환할 수는 없습니다.
데이터 상주는 Apigee 데이터가 저장되는 지리적 위치(리전)를 지정할 수 있게 허용함으로서 규정 준수 및 규제 요구사항을 충족합니다. 데이터 상주를 통해 컨트롤 플레인 위치를 선택하면 모든 고객 콘텐츠가 지정된 리전 내에 저장되도록 보장합니다.
데이터 상주 소개도 참조하세요.
데이터 상주 구성을 위한 기본 단계
데이터 상주를 위해 Apigee Hybrid를 구성하려면 다음과 같은 몇 가지 기본 단계를 수행해야 합니다.
Apigee 조직을 만들 때 데이터 상주를 사용하여 조직을 사용 설정할 수 있습니다. 데이터 상주가 있는 조직을 만들려면 두 가지 주요 위치 속성인 컨트롤 플레인 위치와 소비자 데이터 리전을 지정해야 합니다.
결제 유형도 지정해야 합니다. 자세한 내용은 2단계: 조직 만들기를 참조하세요.
소비자 데이터 리전: API 소비자 데이터가 저장되는 리전을 지정해야 합니다. 이 리전은 컨트롤 플레인 리전의 하위 리전이어야 합니다. 사용 가능한 소비자 데이터 리전 목록은 Apigee 위치를 참조하세요.
결제 유형: 유료 구독 조직에서만 데이터 상주를 사용할 수 있습니다.
Apigee API를 사용하여 환경 만들기
Apigee API를 사용하여 새 환경을 만드는 경우 컨트롤 플레인 위치를 지정해야 합니다. 환경 만들기를 참조하세요.
UI를 사용하여 환경을 만드는 경우 특별한 단계가 필요하지 않습니다.
새 데이터 파이프라인 사용 설정
데이터 상주가 새 Hybrid 1.13.1 조직에 대해 사용 설정되었으면 새 데이터 파이프라인 기능을 사용 설정해야 합니다. 이 기능을 사용 설정하면 분석 및 디버그 데이터를 Apigee 컨트롤 플레인으로 전송할 수 있습니다. 데이터 파이프라인을 사용 설정하려면 데이터 상주를 사용한 애널리틱스 및 디버그 데이터 수집의 안내를 따르세요.
새 데이터 파이프라인을 사용 설정하기 위해 변경사항 재정의
각 재정의 파일에 다음 구성 속성을 추가하고 적용합니다.
contractProvider:
Apigee 관리 API의 서비스 엔드포인트입니다. 예를 들면 https://us-apigee.googleapis.com입니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-15(UTC)"],[[["\u003cp\u003eData residency in Apigee hybrid installations, available from version 1.12 onward, allows new setups to comply with data storage location regulations, but cannot be applied to existing installations.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring Apigee hybrid for data residency involves creating an organization with specified control plane and consumer data regions, creating an environment via API with the control plane location, enabling a new data pipeline, and configuring override files.\u003c/p\u003e\n"],["\u003cp\u003eWhen setting up an organization for data residency, you must define the control plane location for core content storage, a consumer data region for API user data, and ensure a paid subscription billing type.\u003c/p\u003e\n"],["\u003cp\u003eEnabling the new data pipeline for hybrid version 1.13.1 is essential to allow analytics and debug data to be sent to the Apigee control plane and requires specific configuration properties in the overrides file.\u003c/p\u003e\n"],["\u003cp\u003eAccessing Apigee APIs for tasks in a hybrid setup requires calling APIs from within the specified control plane location, and special attention must be paid to non-forward proxy route and forward proxy URLs that need to be allowlisted.\u003c/p\u003e\n"]]],[],null,["# Using data residency with Apigee hybrid\n\n| You are currently viewing version 1.13 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nThis topic explains how to configure a new Apigee hybrid installation for data residency\ncompliance.\n\nAbout data residency\n--------------------\n\nStarting with hybrid version 1.12, you can use data residency with new Apigee\nhybrid installations. You cannot convert an existing installation to use data residency.\n\n\nData residency meets compliance and regulatory requirements by allowing you to specify\nthe geographic locations (regions) where Apigee data is stored. With data residency, selecting\nthe control plane location ensures that all customer content is stored within the specified region.\nSee also, see [Introduction to data residency](/apigee/docs/api-platform/get-started/drz-concepts).\n\nBasic steps for data residency configuration\n--------------------------------------------\n\nTo configure Apigee hybrid for data residency, you need to follow a few basic steps, including:\n\n- [Creating an Apigee organization with data residency](#creatinganorg)\n- [Creating an environment using the Apigee API](#createinganenv)\n- [Enabling the new data pipeline](#newpipeline)\n- [Configuring the overrides file(s)](#configureoverrides)\n\n### Creating an Apigee organization with data residency\n\nWhen you create an Apigee organization, you have the option of enabling the org with\ndata residency. Creating an org with data residency requires you to specify two\nkey location attributes: the **control plane location** and the **consumer data region** .\nYou will also need to specify the **billing type** . For details, see\n[Step 2: Create an organization](/apigee/docs/hybrid/v1.13/precog-provision).\n\n- **Control plane location** : You need to specify the location where customer core content like proxy bundles are stored. For a list see [Available Apigee API control plane regions](/apigee/docs/locations#available-apigee-api-control-plane-regions).\n\n\n The control plane location is the location of the service endpoint location, for example `us` for United States.\n\n\n The following table lists available hosting jurisdictions and regions for the Apigee control plane. \n\n ### Americas\n\n ### Europe\n\n ### Asia-Pacific\n\n ### Middle East\n\n- **Consumer data region** : You need to specify a region where API consumer data is stored. This must be a sub-region of the control plane region. For a list of available consumer data regions, see[Apigee locations](/apigee/docs/locations#consumer-data-region).\n- **Billing type**: You can only use data residency with paid subscription orgs.\n\n### Creating an environment using the Apigee API\n\n\nIf you create a new environment using the Apigee API, you must specify the\ncontrol plane location. See [Create an environment](/apigee/docs/hybrid/v1.13/precog-add-environment#apigee-apit).\nIf you use the UI to create an environment, no special steps are needed.\n\n### Enabling the new data pipeline\n\nIf data residency is enabled for a new hybrid 1.13.1 organization, then you must\nenable the new data pipeline feature. This feature enables analytics and debug data to be\nsent to the Apigee control plane. To enable the data pipeline, follow the instructions\nin [Configure hybrid to use the new data pipeline](/apigee/docs/hybrid/v1.13/data-collection-with-data-residency).\n\n\n#### Overrides changes to enable the new data pipeline\n\n\nAdd the following configuration properties to each overrides file and apply them:\n\n- [contractProvider](/apigee/docs/hybrid/v1.13/config-prop-ref#contractprovider): The service endpoint for Apigee management APIs. For example: `https://us-apigee.googleapis.com`.\n- [newDataPipeline.debugSession](/apigee/docs/hybrid/v1.13/config-prop-ref#newdatapipeline): Set this to `true` to use the new data pipeline.\n- [newDataPipeline.analytics](/apigee/docs/hybrid/v1.13/config-prop-ref#newdatapipeline): Set this to `true` to enable analytics to use the new data pipeline.\n\nFor example: \n\n```\ninstanceID: \"my_hybrid_example\"\nnamespace: apigee\n\ngcp:\n projectID: hybrid-example\n region: us-central1\n\nk8sCluster:\n name: apigee-hybrid\n region: us-central1\n\norg: hybrid-example\n\ncontractProvider: https://us-apigee.googleapis.com\nnewDataPipeline:\n debugSession: true\n analytics: true\n```\n\nSee [Step 6: Create the overrides](/apigee/docs/hybrid/v1.13/install-create-overrides)\n\n### When calling the Apigee APIs\n\nWhen you make `curl` calls to Apigee APIs to perform tasks in your hybrid installation, you will need to call APIs from within the control plane location: \n\n```\ncurl -H \"Authorization: Bearer $TOKEN\" \\\n \"https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups\"\n```\n\nFor example: \n\n```\ncurl -H \"Authorization: Bearer $TOKEN\" \\\n \"https://us-apigee.googleapis.com/v1/organizations/my-hybrid-org/envgroups\"\n```\n\n### URL allowlisting\n\nYou must enable a non-forward proxy route for Apigee hybrid data residency. This route\ncan be a NAT with allowlisting for:\n\n- `iamcredentials.googleapis.com`\n- `oauth2.googleapis.com`\n\nIf you are using forward proxy with data residency, you must allowlist in the forward proxy:\n\n- \u003cvar translate=\"no\"\u003eCONTROL_PLANE_LOCATION\u003c/var\u003e`-apigee.googleapis.com`\n- \u003cvar translate=\"no\"\u003eANALYTICS_REGION\u003c/var\u003e`-pubsub.googleapis.com`\n- URLs required by Apigee hybrid, see [Google Cloud URLs to allow for Hybrid](/apigee/docs/hybrid/v1.13/allow-gcp-urls).\n\n### Enable analytics and debug data collection with data residency\n\nTo enable analytics and debug data collection, follow the instructions\nin [Configure hybrid to use the new data pipeline](/apigee/docs/hybrid/v1.13/data-collection-with-data-residency)."]]
낮은 CO2