이 주제에서는 데이터 상주 규정을 준수하도록 새 Apigee Hybrid 설치를 구성하는 방법을 설명합니다.
데이터 상주 정보
Hybrid 버전 1.12부터는 새로운 Apigee Hybrid 설치로 데이터 상주를 사용할 수 있습니다. 데이터 상주를 사용하도록 기존 설치를 변환할 수는 없습니다.
데이터 상주는 Apigee 데이터가 저장되는 지리적 위치(리전)를 지정할 수 있게 허용함으로서 규정 준수 및 규제 요구사항을 충족합니다. 데이터 상주를 통해 컨트롤 플레인 위치를 선택하면 모든 고객 콘텐츠가 지정된 리전 내에 저장되도록 보장합니다.
데이터 상주 소개도 참조하세요.
데이터 상주 구성을 위한 기본 단계
데이터 상주를 위해 Apigee Hybrid를 구성하려면 다음과 같은 몇 가지 기본 단계를 수행해야 합니다.
Apigee 조직을 만들 때 데이터 상주를 사용하여 조직을 사용 설정할 수 있습니다. 데이터 상주가 있는 조직을 만들려면 두 가지 주요 위치 속성인 컨트롤 플레인 위치와 소비자 데이터 리전을 지정해야 합니다.
결제 유형도 지정해야 합니다. 자세한 내용은 2단계: 조직 만들기를 참조하세요.
소비자 데이터 리전: API 소비자 데이터가 저장되는 리전을 지정해야 합니다. 이 리전은 컨트롤 플레인 리전의 하위 리전이어야 합니다. 사용 가능한 소비자 데이터 리전 목록은 Apigee 위치를 참조하세요.
결제 유형: 유료 구독 조직에서만 데이터 상주를 사용할 수 있습니다.
Apigee API를 사용하여 환경 만들기
Apigee API를 사용하여 새 환경을 만드는 경우 컨트롤 플레인 위치를 지정해야 합니다. 환경 만들기를 참조하세요.
UI를 사용하여 환경을 만드는 경우 특별한 단계가 필요하지 않습니다.
새 데이터 파이프라인 사용 설정
새 조직에 대해 데이터 상주가 사용 설정된 경우 새 데이터 파이프라인 기능을 사용 설정해야 합니다. 이 기능을 사용 설정하면 분석 및 디버그 데이터를 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-10(UTC)"],[[["\u003cp\u003eData residency in Apigee hybrid installations, available from version 1.12 onward, allows for specifying geographic locations for data storage to meet compliance and regulatory requirements.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring data residency requires creating a new Apigee organization, specifying a control plane location for core content and a consumer data region for API consumer data.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating an environment using the Apigee API with data residency, the control plane location must be specified, while creating it via the UI does not require this.\u003c/p\u003e\n"],["\u003cp\u003eEnabling the new data pipeline feature is mandatory for data residency organizations, allowing analytics and debug data to be sent to the Apigee control plane.\u003c/p\u003e\n"],["\u003cp\u003eThe overrides files must be updated with properties such as the control plane service endpoint and enabling the new data pipeline to ensure data residency is correctly configured.\u003c/p\u003e\n"]]],[],null,["# Using data residency with Apigee hybrid\n\n| You are currently viewing version 1.14 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.14/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](./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\nWhen data residency is enabled for a new hybrid v1.13 organization, you must enable the new data pipeline\nfeature. This feature enables analytics and debug data to be sent to the Apigee control plane. To\nenable the data pipeline, follow the instructions in\n[Configure hybrid to use the new data pipeline](/apigee/docs/hybrid/v1.14/data-collection-with-data-residency).\n\n`newDataPipeline.debugSession` and `newDataPipeline.analytics` are set to `true` by default in hybrid v1.14.0 and later. You will not need to explicitly set these values unless you have previously set them to `false`.\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.14/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.14/config-prop-ref#newdatapipeline): Set this to `true` to use the new data pipeline.\n- [newDataPipeline.analytics](/apigee/docs/hybrid/v1.14/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.14/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\nIf you are using forward proxies with data residency, you must additionally 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.14/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.14/data-collection-with-data-residency)."]]
낮은 CO2