서비스 사용 설정 및 중지

이 페이지에서는 Google Cloud Platform 프로젝트에서 서비스를 사용 설정하고 중지하는 방법을 설명합니다. 서비스 사용량을 사용하면 공개 Google Cloud Platform 서비스Cloud Endpoints를 사용하여 만든 비공개 서비스를 비롯해 사용 가능한 모든 서비스를 프로젝트에서 사용 설정하거나 중지할 수 있습니다. 공개 API 및 서비스와 비공개 API 및 서비스의 차이점에 대한 자세한 내용은 공개 및 비공개 서비스를 참조하세요.

대부분의 운영 사례에서 서비스를 사용 설정하고 중지하는 가장 간단한 방법은 Google Cloud Platform Console을 사용하는 것입니다. 스크립트를 작성해야 하는 경우 gcloud 명령줄 인터페이스를 사용할 수도 있습니다. Service Usage API와 달리 프로그래밍해야 하는 경우에는 제공된 클라이언트 라이브러리 중에 하나를 사용하는 것이 좋습니다. API를 실험하려면 이 가이드의 대체 안내를 따르고 curl 명령어를 사용하여 전체 애플리케이션 개발 환경을 설정하지 않고 API를 테스트할 수 있습니다.

시작하기 전에

API 및 서비스를 사용 설정하고 중지하려면 다음 사항이 필요합니다.

서비스 사용 설정

콘솔

프로젝트에서 API를 사용 설정하는 방법은 다음과 같습니다.

  1. GCP Console API 라이브러리 페이지로 이동합니다.
    API 라이브러리 페이지로 이동
  2. 선택을 클릭하여 GCP 프로젝트를 선택합니다.
  3. 사용 설정할 API를 클릭합니다. API를 찾는 데 도움이 필요하면 검색 필드를 사용하세요.
  4. 사용 설정을 클릭합니다.

gcloud

다음 명령어를 실행하여 현재 프로젝트에서 Cloud Pub/Sub API 서비스를 사용 설정합니다.

gcloud services enable pubsub.googleapis.com

이 명령어는 다음과 비슷한 출력을 생성합니다.

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

다음 명령어를 사용하여 작업 세부정보를 가져올 수 있습니다.

gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687

curl

services.enable을 사용하여 단일 서비스를 사용 설정할 수 있습니다. services.batchEnable 메소드를 사용하여 단일 작업에서 서비스 2~20개를 사용 설정할 수 있습니다.

다음 명령어는 프로젝트 번호 357084163378에서 Cloud Pub/Sub API 서비스를 사용 설정합니다.

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:enable

services.enable 메소드는 작업 상태를 확인하는 데 사용할 수 있는 장기 실행 작업 리소스를 반환합니다. 서비스 사용량 operations.get 메소드를 사용하여 작업 상태를 폴링할 수 있습니다.

다음 명령어는 프로젝트 번호 357084163378에서 Cloud Pub/Sub 서비스와 Cloud Dataflow API 서비스를 사용 설정합니다.

gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' https://serviceusage.googleapis.com/v1/projects/357084163378/services:batchEnable

services.batchEnable 메소드는 작업 상태를 확인하는 데 사용할 수 있는 장기 실행 작업 리소스를 반환합니다. 서비스 사용량 operations.get 메소드를 사용하여 작업 상태를 폴링할 수 있습니다.

서비스 사용 중지

API는 언제든지 프로젝트에서 사용 중지할 수 있습니다. 단, 미결제 비용은 계정으로 청구되며 프로젝트에서 청구 가능한 API 사용에 대해서도 요금이 부과됩니다. 자세한 내용은 API 및 결제를 참조하세요.

콘솔

프로젝트에서 API를 사용 중지하는 방법은 다음과 같습니다.

  1. GCP Console API 대시보드 페이지로 이동합니다.
    API 대시보드 페이지로 이동
  2. 선택을 클릭하여 GCP 프로젝트를 선택합니다.
  3. 사용 중지하려는 API 옆에 있는 사용 중지를 클릭합니다.

gcloud

다음 명령어를 실행하여 현재 프로젝트에서 Cloud Pub/Sub API 서비스를 사용 중지합니다.

gcloud services disable pubsub.googleapis.com

이 명령어는 다음과 비슷한 출력을 생성합니다.

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

다음 명령어를 사용하여 작업 세부정보를 가져올 수 있습니다.

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

다음 명령어는 프로젝트 번호 357084163378에서 Cloud Pub/Sub API 서비스를 사용 중지합니다.

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:disable

services.disable 메소드는 작업 상태를 확인하는 데 사용할 수 있는 장기 실행 작업 리소스를 반환합니다. 서비스 사용량 operations.get 메소드를 사용하여 작업 상태를 폴링할 수 있습니다.