서비스 사용 설정 및 중지

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

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

시작하기 전에

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

  • Cloud 프로젝트. Cloud 프로젝트를 만드는 방법은 프로젝트 만들기 및 관리를 참조하세요.
  • 올바른 ID 및 액세스 관리 권한 서비스 사용량에 대한 IAM 요구사항에 대해 알아보려면 액세스 제어를 참조하세요.
  • 이 가이드에서 gcloud 명령줄 예시를 실행하려면 Cloud SDK를 설치해야 합니다.
  • 이 가이드에서 curl 예시를 사용하려면 안내에 따라 시작하기의 초기 설정을 완료하세요.

서비스 사용 설정

콘솔

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

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

gcloud

현재 프로젝트에서 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에서 Pub/Sub API 서비스를 사용 설정합니다.

gcurl -d '{}' https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:enable

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

다음 명령어는 프로젝트 번호 357084163378에서 Pub/Sub 서비스 및 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. Cloud Console API 대시보드 페이지로 이동합니다.
    API 대시보드 페이지로 이동
  2. 선택을 클릭하여 Cloud 프로젝트를 선택합니다.
  3. 사용 중지하려는 API 옆에 있는 사용 중지를 클릭합니다.

gcloud

현재 프로젝트에서 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에서 Pub/Sub API 서비스를 사용 중지합니다.

gcurl -d '{}' https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:disable

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