고급 사용 사례의 경우 Service Management API를 사용하여 프로그래매틱 방식으로 서비스를 관리할 수 있습니다. 자세한 내용은 Service Management API 시작하기를 참조하세요.
소개
관리형 서비스는 Gmail API 및 Spanner API와 같은 Service Infrastructure와 통합된 서비스를 논리적으로 나타내는 간단한 리소스입니다. 관리형 서비스 자체에는 서비스 이름 및 생산자 프로젝트라는 변경할 수 없는 두 가지 속성만 있지만 관리형 서비스를 구현하면 다양한 기능을 제공할 수 있습니다. 예를 들어 Cloud Storage API는 수백만 명의 개발자와 기업을 위한 전 세계적 규모의 객체 스토리지를 제공합니다.
관리형 서비스에는 서비스 소비자 집합, 변경할 수 없는 서비스 구성 내역, 변경할 수 없는 서비스 롤아웃 내역이 있습니다.
최신 서비스 출시에서 참조하는 서비스 구성은 표시 이름, 측정항목 정의, 비율 제한 등 서비스의 모든 측면을 다루는 서비스의 현재 상태를 나타냅니다. 사양은 google.api.Service를 참조하세요.
이 페이지에서는 서비스 수명 주기를 만들고 관리하는 방법을 설명합니다.
Service Management에 대한 자세한 내용은 안내 가이드를 참조하세요.
서비스를 호스팅할 전용 제작자 프로젝트를 만듭니다. 전용 프로젝트는 서비스에 최고의 보안과 격리를 제공합니다.
또한 서비스 소유권을 다른 팀이나 다른 회사로 이전할 수도 있습니다.
프로젝트에 Service Management API 및 Service Control API를 사용 설정합니다.
프로젝트에 Cloud Billing을 사용 설정합니다. 서비스를 Service Infrastructure와 통합하려면 Service Control API, Cloud Logging API, Cloud Monitoring API를 비롯한 여러 유료 Google Cloud 제품을 사용해야 합니다.
Service Management API는 서비스 관리에 선언적 모델을 사용합니다.
서비스를 만든 후에 원하는 서비스 상태에 도달하려면 변경할 수 없는 서비스 구성 및 서비스 롤아웃을 푸시해야 합니다. 서비스 구성은 Cloud Billing, Cloud Logging, Cloud Monitoring, Identity and Access Management를 비롯한 서비스를 지원하도록 Google Cloud 인프라 서비스를 구성하는 데 사용됩니다.
서비스 구성에 대한 자세한 내용은 서비스 구성 관리를 참조하세요.
서비스 출시에 대한 자세한 내용은 서비스 출시 관리를 참조하세요.
[[["이해하기 쉬움","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)"],[],[],null,["# Managing Service Lifecycles\n\nThis page describes how to manage the lifecycles of\n[managed services](/service-infrastructure/docs/glossary#managed) using the Google Cloud CLI\n[`gcloud endpoints services`](https://cloud.google.com/sdk/gcloud/reference/endpoints/services)\ncommands.\n\nFor advanced use cases, you can use the Service Management API\nto manage services programmatically. For more information, see\n[Getting Started with the Service Management\nAPI](/service-infrastructure/docs/service-management/getting-started)\n\nIntroduction\n------------\n\nA [managed service](/service-infrastructure/docs/service-management/reference/rest/v1/services)\nis a simple resource that logically represents a service integrated with Service\nInfrastructure, such as Gmail API and Spanner API. A managed service itself\nhas only two immutable properties, a *service name* and a *producer project* ,\nbut the implementation of a managed service can provide a wide range of\nfunctionality. For example, [Cloud Storage API](/storage/docs) provides\nplanet-scale object storage for millions of developers and enterprises.\n\nA managed service has a set of\n[service consumers](/service-infrastructure/docs/service-management/reference/rest/v1/services.consumers),\na history of immutable\n[service configurations](/service-infrastructure/docs/service-management/reference/rest/v1/services.configs),\nand a history of immutable\n[service rollouts](/service-infrastructure/docs/service-management/reference/rest/v1/services.rollouts).\nThe service configurations referenced by the latest service rollout represents\nthe current state of the service, which covers all aspects of the service, from\nthe display name to metrics definitions to rate limits. For the specification,\nsee\n[`google.api.Service`](https://github.com/googleapis/googleapis/blob/master/google/api/service.proto#L73).\n\nWe will describe how to create and manage your service lifecycles in this page.\nFor more information about the service management, see\n[How-to Guides](/service-infrastructure/docs/how-to).\n\nCreating a service\n------------------\n\nTo create a service, you need to complete the following steps.\n\n1. Install and initialize\n [gcloud CLI](https://cloud.google.com/sdk/docs/initializing) on your\n computer.\n\n2. Create a dedicated producer project to host your service. A dedicated\n project provides the best security and isolation for your service.\n It also allows you to transfer the ownership of your service to another\n team or even another company.\n\n3. Enable the Service Management API and Service Control API for your project.\n\n4. Enable Cloud Billing for your project. To integrate your service with\n Service Infrastructure, you will depend on several paid Google Cloud\n products, including the Service Control API, Cloud Logging API, and\n Cloud Monitoring API.\n\n5. Prepare a simple service configuration yaml file for your service\n as follows:\n\n # Filename: endpointsapis.yaml\n type: google.api.Service\n config_version: 3\n # Update the next line to use your own service name.\n name: endpointsapis.appspot.com\n # Update the next line to use your own producer project id.\n producer_project_id: endpointsapis\n\n6. Run `gcloud` command to create your service by deploying a blank service\n configuration:\n\n gcloud endpoints services deploy endpointsapis.yaml\n\nThe service creation process takes about a minute. After that, you should be\nable to see your service listed on the\n[Endpoints](https://console.cloud.google.com/endpoints?project=_) page\nin Google Cloud console.\n\nListing services\n----------------\n\nTo list services in a project, you can use the following command: \n\n gcloud endpoints services list --project endpointsapis\n\nDescribing a service\n--------------------\n\nTo describe a service and its configuration, you can use the following command: \n\n gcloud endpoints services describe endpointsapis.appspot.com\n\nDeleting a service\n------------------\n\nIf you no longer need a service, you can delete it using the following command: \n\n gcloud endpoints services delete endpointsapis.appspot.com\n\nNOTE: Every service has a mandatory 30-day deletion retention.\n\nUndeleting a service\n--------------------\n\nYou can undelete a service within its retention window using the following\ncommand: \n\n gcloud endpoints services undelete endpointsapis.appspot.com\n\nNext steps\n----------\n\nThe Service Management API uses a declarative model for service management.\nAfter the service is created, you need to push immutable service\nconfigurations and service rollouts to reach the desired state\nof your service. Your service configurations are used to configure\nGoogle Cloud infrastructure services to support your service,\nincluding Cloud Billing, Cloud Logging, Cloud Monitoring, and\nIdentity and Access Management.\n\nFor more information about service configurations, see\n[Managing Service Configurations](/service-infrastructure/docs/manage-config).\nFor more information about service rollouts, see\n[Managing Service Rollouts](/service-infrastructure/docs/rollout)."]]
