Cloud Endpoints는 Google이 자체 API에 사용하는 인프라와 동일한 인프라를 사용하여 API의 보안, 모니터링, 분석, 할당량 설정을 지원하는 API 관리 시스템입니다. Endpoints는 Extensible Service Proxy(ESP) 및 Extensible Service Proxy V2(ESPv2)와 함께 작동하여 API 관리 기능을 제공합니다. Endpoints, ESP, ESPv2에 대한 자세한 내용은 엔드포인트 정보를 참조하세요.
Endpoints는 REST API를 정의하는 업계 표준인 OpenAPI 사양(이전 Swagger 사양) 버전 2를 지원합니다. OpenAPI 사양에 대해 잘 모르는 경우 OpenAPI 개요를 참조하세요.
이 문서에서는 OpenAPI에 Endpoints를 사용하는 방법을 보여줍니다. 다른 Endpoints 옵션에 대한 문서는 모든 Endpoints 문서를 참조하세요.
시작하려면 다음과 같은 순서에 따라 문서를 확인하는 것이 좋습니다.
Endpoints 기능 작동을 확인하려면 Cloud Endpoints 빠른 시작을 참조하세요. 이 문서에서는 스크립트를 사용하여 App Engine 가변형 환경에 샘플 API를 배포합니다.
[[["이해하기 쉬움","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-09-04(UTC)"],[[["\u003cp\u003eCloud Endpoints is an API management system that utilizes the Extensible Service Proxy (ESP) and Extensible Service Proxy V2 (ESPv2) to help secure, monitor, analyze, and set quotas on APIs.\u003c/p\u003e\n"],["\u003cp\u003eEndpoints supports version 2 of the OpenAPI Specification, the industry standard for defining REST APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation recommends starting with the Quickstart to see Endpoints in action, then choosing a compute platform, followed by a tutorial for that platform.\u003c/p\u003e\n"],["\u003cp\u003eESP and ESPv2, which are open source, can be run in various environments including App Engine, Compute Engine, Kubernetes, and locally.\u003c/p\u003e\n"],["\u003cp\u003eWhile ESP is automatically deployed on the App Engine flexible environment, ESPv2 is not supported there, and the App Engine standard environment requires Endpoints Frameworks instead.\u003c/p\u003e\n"]]],[],null,["# Cloud Endpoints for OpenAPI\n\nCloud Endpoints is an API management system that helps you secure, monitor,\nanalyze, and set quotas on your APIs using the same infrastructure Google uses\nfor its own APIs. Endpoints works with the [Extensible Service\nProxy (ESP)](/endpoints/docs/openapi/glossary#extensible_service_proxy) and the [Extensible Service Proxy V2](/endpoints/docs/openapi/glossary#extensible_service_proxy_v2) (ESPv2) to\nprovide API management. You can find out more about Endpoints, ESP, and ESPv2 in [About\nEndpoints](/endpoints/docs/openapi/about-cloud-endpoints).\n\nEndpoints supports version 2 of the\n[OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md)\n(formerly known as the Swagger spec)---the industry standard for defining REST\nAPIs. If you are unfamiliar with the OpenAPI Specification, see\n[OpenAPI Overview](/endpoints/docs/openapi/openapi-overview).\n\nThis documentation set shows you how to use Endpoints with OpenAPI. For\ndocumentation on the other Endpoints options, see\n[All Endpoints Docs](/endpoints/docs).\n\nTo get started, we recommend the following path through the documentation:\n\n1. To see Endpoints features in action, do the [Quickstart for\n Cloud Endpoints](/endpoints/docs/deploy-api), which uses scripts to\n deploy a sample API to the App Engine flexible environment.\n\n2. Now you need to decide which compute platform you want to use for your API.\n To help you make that decision,\n see [Choosing a Computing Option](/docs/choosing-a-compute-option),\n and see the [Supported compute platforms](#supported_compute_platforms)\n section below.\n\n3. After you have decided on the backend for your API, walk through a\n [tutorial](/endpoints/docs/openapi/tutorials) for your preferred\n compute platform.\n\nSupported compute platforms\n---------------------------\n\nEndpoints for OpenAPI depends on either ESP or ESPv2 for API management. Both ESP and ESPv2 are Open Source projects and are available to you in the following ways:\n\n- A container in Artifact Registry.\n - See the [ESP release notes](https://github.com/cloudendpoints/esp/releases) for the current ESP Docker image.\n - See the [ESPv2 release notes](https:/github.com/GoogleCloudPlatform/esp-v2/releases) for the current ESPv2 Docker image.\n- Source code in GitHub.\n - See the [ESP README](https://github.com/cloudendpoints/esp/blob/master/README.md) for details on building ESP.\n - See the [ESPv2 README](https://github.com/GoogleCloudPlatform/esp-v2/blob/master/README.md) for details on building ESPv2.\n\nYou can run the ESP container on the following:\n\n- App Engine flexible environment\n- Compute Engine\n- Kubernetes, including Google Kubernetes Engine\n- A [Linux or macOS computer or another platform](/endpoints/docs/openapi/running-esp-localdev)\n\nYou can run the ESPv2 container on the following:\n\n- App Engine\n- Cloud Run functions\n- Cloud Run\n- Knative serving\n- GKE\n- Compute Engine\n- Kubernetes\n\nSee [About Cloud Endpoints](/endpoints/docs/openapi/about-cloud-endpoints) for more.\n\nOn the [App Engine flexible environment](/appengine/docs/flexible), ESP is\nautomatically deployed for you when you add a few lines to your\n[`app.yaml`](/appengine/docs/flexible/nodejs/reference/app-yaml) file. For more\ninformation, see [Deploying your API and\nESP](/endpoints/docs/openapi/deploy-api-backend#deploying_your_api_and_esp). ESPv2 does not support App Engine flexible environment.\n\nFor the [App Engine standard generation 1 environment](/appengine/docs/standard),\nyou must use [Endpoints\nFrameworks](/endpoints/docs/frameworks/about-cloud-endpoints-frameworks). If you\ninstead deploy the container to one of the compute options above, you can proxy\nto either generation of App Engine standard runtime."]]
