+ 만들기를 클릭합니다. UI에서 해당 조직에 적합한 새 인스턴스 만들기 권한이 있는지 확인하는 동안 지연이 발생할 수 있습니다.
새 인스턴스 만들기 페이지에 다음이 표시됩니다.
필드에 새 인스턴스에 대한 세부정보를 입력합니다.
필드
필수
설명
Runtime hosting location
필수
새 인스턴스를 만들 리전을 선택합니다. 인스턴스가 이미 있는 리전에서는 새 인스턴스를 만들 수 없습니다. 여러 리전을 사용하는 작업에 대한 자세한 내용은 여러 리전 사용을 참조하세요.
Name
필수
새 인스턴스의 ID를 입력합니다.
기본값은 선택한 리전을 호스팅하는 런타임의 이름이지만 이름 지정 규칙을 따르는 한 필요에 따라 적합한 이름으로 변경할 수 있습니다.
최소 길이는 2입니다.
최대 길이는 32입니다.
소문자, 숫자, 하이픈만 사용합니다(/^[a-z0-9\-]+$/ 패턴 사용).
문자로 시작하고 숫자 또는 하이픈으로 시작하지 않아야 합니다.
숫자 또는 문자로 끝나고 하이픈으로 끝나지 않아야 합니다.
조직 전체에서 고유해야 합니다.
IP range allocation
필수
IP 범위를 할당할 방법을 지정합니다. 다음 옵션 중에서 선택하세요.
자동(권장) - Apigee는 프리픽스 크기가 /22인 사용 가능한 CIDR 범위를 선택합니다. 추가 조치는 필요하지 않습니다.
커스텀 - 고급 사용 사례에서는 Apigee가 사용할 IP 범위를 정확하게 지정해야 할 수 있습니다. 이러한 경우 커스텀 IP 범위를 지정하되, 프리픽스 크기가 /22여야 합니다. 범위는 프로젝트와 Apigee 간의 비공개 연결의 일부로 사용 가능해야 합니다.
Disk encryption key
필수
디스크 암호화 키에서 고객 관리 암호화 키를 선택합니다. 키가 이미 있으면 이를 선택할 수 있습니다. 마법사가 모든 키링 간의 런타임 호스팅 리전과 동일한 위치에 있는 모든 키를 나열합니다. 키가 존재하지 않거나 기존 키를 사용하지 않으려는 경우 마법사 내에서 새 키를 만들 수 있습니다. 키를 만들려면 다음 안내를 따르세요.
키 만들기를 클릭합니다.
키링을 선택하거나 키링이 없으면 키링 만들기를 사용 설정한 후 키링 이름을 입력하고 키링 위치를 선택합니다. 키링 이름에는 문자, 숫자, 밑줄(_), 하이픈(-)을 포함할 수 있습니다. 키링 이름을 변경하거나 키링을 삭제할 수 없습니다.
계속을 클릭합니다.
키를 만듭니다. 이름 및 보호 수준을 입력합니다.
키 이름은 문자, 숫자, 밑줄(_), 하이픈(-)을 포함할 수 있습니다. 키는 이름을 바꾸거나 삭제할 수 없습니다. 보호 수준의 경우 소프트웨어가 적합합니다. Cloud KMS에 사용되는 동일 기본값이지만, 필요한 경우 이를 변경할 수 있습니다.
계속을 클릭하고 선택한 내용을 검토합니다.
만들기를 클릭합니다.
권한 부여를 클릭하여 선택한 키로 암호화 및 복호화할 수 있는 권한을 서비스 계정에 부여합니다.
Environments
선택사항
이 인스턴스에 연결할 환경을 선택합니다. 이렇게 하려면 환경 드롭다운 목록을 클릭하고 연결할 환경 옆의 체크박스를 선택합니다. 이 작업은 원하는 만큼 여러 환경에 대해 수행할 수 있습니다. 확인을 클릭합니다.
모든 인스턴스의 환경은 할당할 수 있는 총 환경 수에 포함됩니다. 자세한 내용은 환경 및 환경 그룹 정보를 참조하세요.
수락된 프로젝트 추가를 클릭하여 Cloud 프로젝트를 하나 이상 선택합니다. 선택한 프로젝트는 인스턴스의 서비스 연결에 비공개로 연결될 수 있습니다.
기본적으로 Apigee 조직과 연결된 프로젝트가 이 목록에 포함됩니다.
Enable logging
선택사항
로깅 사용 설정 전환 버튼을 클릭하여 인스턴스에 대해 Cloud Logging 인그레스 액세스 로그를 사용 설정합니다.
이 기능을 사용하면 외부 애플리케이션 부하 분산기 또는 Anthos 게이트웨이와 같은 Apigee 인프라의 인그레스 게이트웨이에서 생성된 로그를 보고 Apigee API 호출 문제를 해결할 수 있습니다.
지정된 Google Cloud 리전에는 하나의 Apigee 인스턴스만 존재할 수 있습니다. 인스턴스를 삭제하면 인스턴스가 해당 리전에서 완전히 삭제됩니다. 멀티 리전 설치도 참조하세요.
경고: 인스턴스를 삭제하면 해당 인스턴스에 연결된 모든 데이터가 손실됩니다. 이 단계는 실행 취소할 수 없습니다. 그러나 멀티 리전 설치와 같이 인스턴스가 여러 개 있는 경우 모든 인스턴스를 삭제하는 경우에만 데이터가 손실됩니다. 마지막 인스턴스를 삭제하기 전에 손실하지 않으려는 데이터를 추출하고 백업해야 합니다.
다음 데이터는 Apigee 인스턴스에 저장되며 인스턴스를 삭제하면 삭제됩니다.
데이터 유형
설명
키 관리 시스템(KMS)
KMS 데이터에는 API 제품, 개발자, 개발자 앱, OAuth 토큰(액세스 토큰, 갱신 토큰, 승인 코드 포함), API 키가 포함됩니다.
AccessEntity 정책 또는 관련 Apigee API를 사용하여 저장하려는 데이터를 검색합니다.
키-값 맵(KVM)
KVM 정책을 사용하여 만들거나 관리할 수 있는 모든 데이터입니다. KVM 검색을 참조하세요.
할당량
할당량 정의, 버킷, 카운터
환경 캐시
캐시된 모든 데이터
Cloud 콘솔에서 Apigee UI를 사용하여 Apigee 인스턴스를 삭제하려면 다음 안내를 따르세요.
[[["이해하기 쉬움","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-21(UTC)"],[[["\u003cp\u003eThis page outlines how to manage Apigee instances, which are virtual machines storing your API project and services, and it's important to note that this content does not apply to Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a new instance via the Apigee UI or Instances API, each requiring a unique disk encryption key and non-overlapping CIDR ranges for network peering.\u003c/p\u003e\n"],["\u003cp\u003eInstances can have environments attached or removed, and these associations can be managed through the Apigee UI or the Instances attachment create API.\u003c/p\u003e\n"],["\u003cp\u003eThe list of Cloud projects that can connect to an instance can be managed by adding or removing projects in the "Accepted projects" list, and this can be done through the UI.\u003c/p\u003e\n"],["\u003cp\u003eDeleting an instance will remove all associated data, including KMS, KVM, quota data, and environment cache, and it will also remove the association for any attached environments.\u003c/p\u003e\n"]]],[],null,["# Managing instances\n\n*This page\napplies to **Apigee** , but not to **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nAn [instance](/apigee/docs/api-platform/get-started/create-instance) is a virtual\nmachine where your API project and related services are stored. Instances correspond to regions.\nTypically, you start with a single instance and add new instances as your organization expands\ninto more regions. This section explains how to:\n\n- [Create a new instance](#create-a-new-instance).\n- [Attach or remove environments from an instance](#add-envs).\n- [Edit the accepted projects list](#accepted-projects)\n- [Enable or disable ingress access logs for an instance](#enable-logging).\n- [Delete an instance](#delete-an-instance).\n\n| **Note:** Evaluation organizations can only have one instance (region).\n| To expand beyond a single region and instance, you must have a\n| [paid organization](/apigee/docs/api-platform/fundamentals/organization-structure#org_types). Your subscription entitlements limit the number of instances (regions) you can add.\n| You can add more instances (regions) by purchasing an Org Pack. For more information,\n| see [Subscription entitlements](/apigee/docs/api-platform/reference/subscription-entitlements).\n\nCreate a new instance\n---------------------\n\nTo create a new instance, you can use the [Instances API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances) or the Apigee UI. Each instance requires:\n\n- its own disk encryption key for the network. Apigee recommends that you also create a separate key ring for the new instance. For more information, see [About the Apigee encryption keys](/apigee/docs/api-platform/security/encryption-keys).\n- its own non-overlapping /22 and /28 CIDR ranges for network peering. The ranges cannot be shared between instances.\n\n**Note:** You must have a paid organization to add an instance. Evaluation accounts are limited to one region or instance and cannot be expanded to a second. Your entitlements limit the number of regions you can add. For more information, see [Apigee Pricing](https://cloud.google.com/apigee/pricing). \n\n### Apigee in Cloud console\n\n| **Important:** This topic only applies to organizations that were created with VPC peering enabled. See also [Apigee networking options](/apigee/docs/api-platform/get-started/networking-options).\n\nTo create a new instance in Apigee in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n The **Instances** pane displays a list of existing instances.\n\n \u003cbr /\u003e\n\n2. Click **+ Create**. There might be a delay while the UI determines if\n your org has the proper entitlements to create a new instance.\n\n The **Create new instance** page displays.\n3. Enter details about your new instance in the fields:\n\n If your org cannot create a new instance, contact [Apigee Sales](https://pages.apigee.com/contact-sales-reg.html).\n4. Click **Create**.\n\n Apigee begins a long-running operation that can take 20 minutes\n or more to complete. When it's done, the new instance will appear in the list of instances in\n the **Instances** UI.\n\n### Apigee API\n\nIf Apigee was provisioned without VPC-peering, see [Create a runtime instance](/apigee/docs/api-platform/get-started/install-cli-non-peered#runtime-instance) in the non-VPC peering provisioning steps.\n\nIf Apigee was provisioned with VPC-peering, see [Create a runtime instance](/apigee/docs/api-platform/get-started/install-cli#runtime-instance) in the VPC peering provisioning steps.\n\nAttach or remove environments from an instance\n----------------------------------------------\n\nWhen you create an environment using the Apigee UI in Google Cloud console, you have the option to assign the\nenvironment to an existing instance. For more information, see [Creating a new environment in the UI](/apigee/docs/api-platform/fundamentals/environments-working-with#creating-a-new-environment-in-the-ui).\n\nIf you did not attach your environment to an instance during environment creation, or you want to remove an\nenvironment from an instance, you can follow these steps. For more information on environments and instances, see [Environments and instances](/apigee/docs/api-platform/fundamentals/environments-working-with#environments-and-instances).\n\nTo attach or remove an environment from an instance using Apigee in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. In the **Edit Instance** page, click the **Environments (optional)** field and select the environment you want to attach to the instance, or deselect the environment you want to remove.\n5. Click **OK**.\n6. Click **Save** to save your changes.\n\nIn addition to using the UI, you can also attach environments to an instance using the\n[Instances attachment create API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances.attachments/create). For an example, see\n[Create\nan environment](/apigee/docs/api-platform/get-started/install-cli#create-environment) in the command-line provisioning documentation.\n\nEdit the accepted projects list\n-------------------------------\n\nYou can add or remove projects from the **Accepted projects** list:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. In the **Accepted projects** section of the **Edit Instance** page, click delete **Delete** next to a project to remove it. To add a project click **Add accepted project** and enter the ID of the project to add.\n5. Click **Save** to save your changes.\n\nEnable or disable ingress access logs for an instance\n-----------------------------------------------------\n\nAfter you create an instance, you can enable and disable Cloud Logging ingress access logs for the instance:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. the **Edit Instance** page, click the **Enable logging** toggle to disable the feature.\n5. Click **Save** to save your changes.\n\nDelete an instance\n------------------\n\nYou can use the Apigee UI to delete an existing instance, as described in this section.\nAlternatively, you can delete an instance using the [Instances API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances).\n\nOnly one Apigee instance can be in a given Google Cloud region. When you delete an instance,\nit is completely removed from its region. See also\n[multi-region installation](/apigee/docs/api-platform/system-administration/multi-region).\n**Warning:** When you delete an instance, all data associated with that instance is lost. This step cannot be undone. Note, however, that if you have multiple instances, such as in a multi-region installation, your data will be lost only if you delete all of the instances. Before deleting the last instance, be sure to extract and back up any data you do not wish to lose. **Note:** Deleting an instance removes the association for any attached environments. You may need to move any attached environments to new instances by [Attaching and removing environments from an instance](#add-envs) before deleting the instance. All environments must be attached to at least one instance for their proxies to function.\n\nThe following data is stored in an Apigee instance and will be deleted if you delete\nthe instance:\n\nTo delete an Apigee instance using the Apigee UI in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to delete.\n3. In the **Instance Details** page, click **Delete**."]]
