서비스 사용 설정 및 중지

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

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

시작하기 전에

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

• Google Cloud 프로젝트 Google Cloud 프로젝트를 만드는 방법은 프로젝트 만들기 및 관리를 참조하세요.
• 올바른 ID 및 액세스 관리 권한 서비스 사용량에 대한 IAM 요구사항에 대해 알아보려면 액세스 제어를 참조하세요.
• Google Cloud CLI를 설치하려면 다음 안내를 따르세요.
• 이 가이드의 curl 예시를 사용하려면 시작하기의 안내에 따라 초기 설정을 완료합니다. 이러한 단계에는 표준 curl 명령어의 인증된 별칭인 gcurl을 정의하고 환경 변수 PROJECT_NUMBER를 정의하는 과정이 포함됩니다.

서비스 사용 설정

서비스를 사용 설정하면 serviceusage.googleapis.com/mutate_requests 할당량 측정항목의 할당량이 사용됩니다. 사용 가능한 기본 할당량은 초당 쿼리 수(QPS) 2개입니다.

콘솔

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

1. Google Cloud Console API 라이브러리 페이지로 이동합니다.
   API 라이브러리 페이지로 이동

2. 다음 중 하나를 수행하여 API를 사용 설정할 Google Cloud 프로젝트를 선택합니다.

   • 최근 프로젝트 선택에서 Google Cloud 프로젝트를 클릭합니다.

   • 다음 단계를 수행하여 Google Cloud 프로젝트 브라우저를 사용합니다.

     1. 프로젝트 선택을 클릭하여 Google Cloud 프로젝트 브라우저를 엽니다.
     2. 프로젝트를 찾은 다음 Google Cloud 프로젝트 이름을 클릭합니다.
     3. 열기를 클릭하여 프로젝트를 엽니다.

3. 사용 설정할 API를 클릭합니다. API를 찾는 데 도움이 필요하면 페이지 상단의 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개의 서비스를 사용 설정할 수 있습니다.

단일 서비스 사용 설정

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

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

services.enable 메서드는 서버에서 진행 중인 작업을 나타내는 장기 실행 작업 리소스를 반환합니다. 각 작업에는 고유한 리소스 이름이 있습니다. 예를 들어 다음은 이름이 operations/acf.2e2fcfce-8327-4984-9040-a67777082687인 작업입니다.

{
  "name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}

서비스 사용량 operations.get 메서드를 사용하여 작업 상태를 폴링하려면 API에 작업 이름을 전달합니다.

OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

한 번에 여러 서비스 사용 설정

프로젝트에 여러 API 서비스를 사용 설정하려면 각 API 서비스에 대해 사용 설정 명령어를 하나씩 실행하거나, 일괄 작업 사용 설정 명령어를 실행하고 여러 API를 지정할 수 있습니다. 예를 들어 프로젝트에서 Pub/Sub 및 Dataflow API 서비스를 모두 사용 설정하려면 다음 안내를 따르세요.

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

services.enable과 마찬가지로 services.batchEnable은 name을 사용하여 폴링할 수 있는 작업 리소스를 반환합니다.

참고: API를 사용 설정하는 프로세스는 다양할 수 있습니다. 일부 API는 사용 설정하려면 서비스 약관에 동의하라는 메시지가 표시됩니다. 일부 API는 미리보기 모드이므로 사용하려면 가입과 허용 목록 추가가 따로 필요합니다. 그 밖에 조직의 연락처 정보와 개발 중인 애플리케이션 이름 등 추가 정보를 요구하는 API도 있습니다. 추가 정보를 요구한다고 해서 Google 외부에 공개하지는 않습니다. 이렇게 수집되는 추가 정보는 Google에서 API 사용 방식을 이해하는 데 도움을 제공하고 서비스 사용과 관련하여 연락해야 할 때 보조 연락처로 사용됩니다.

서비스 사용 중지

서비스를 사용 중지하면 serviceusage.googleapis.com/mutate_requests 할당량 측정항목의 할당량이 사용됩니다. 사용 가능한 기본 할당량은 초당 쿼리 수(QPS) 2개입니다.

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

Cloud Storage 및 BigQuery와 같은 많은 서비스에서 데이터 저장 요금이 청구됩니다. 서비스의 API 액세스를 중지해도 기본 데이터는 삭제되지 않고 계속 요금이 청구됩니다. 서비스 사용을 중단하고 이후 요금이 발생하지 않도록 하려면 서비스의 API 액세스를 중지하기 전에 서비스와 연결된 모든 데이터를 삭제해야 합니다.

참고: API의 v1에서 사용 설정된 다른 서비스가 종속된 서비스를 사용 중지하려고 하면 호출이 실패합니다. 서비스를 사용 중지하기 위해 API를 호출하면 오류 메시지가 표시됩니다. 지정된 서비스 및 이에 종속된 모든 서비스를 사용 중지하려면 services.disable 요청의 disable_dependent_services 매개 변수를 true로 설정합니다.

콘솔

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

1. Google Cloud Console API 대시보드 페이지로 이동합니다.
   API 대시보드 페이지로 이동

2. 다음 중 하나를 수행하여 API를 사용 중지할 Google Cloud 프로젝트를 선택합니다.

   • 최근 프로젝트 선택에서 Google Cloud 프로젝트를 클릭합니다.

   • 다음 단계를 수행하여 Google Cloud 프로젝트 브라우저를 사용합니다.

     1. 프로젝트 선택을 클릭하여 Google Cloud 프로젝트 브라우저를 엽니다.
     2. 프로젝트를 찾은 다음 Google Cloud 프로젝트 이름을 클릭합니다.
     3. 열기를 클릭하여 프로젝트를 엽니다.

3. 사용 중지할 API를 클릭합니다. API를 찾는 데 도움이 필요하면 페이지 상단의 API 및 서비스 검색 상자를 사용합니다. API를 설명하는 페이지가 나타납니다.

4. 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

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

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

services.enable과 마찬가지로 services.disable은 name을 사용하여 폴링할 수 있는 작업 리소스를 반환합니다.

다음 단계

프로젝트에 적용되는 할당량 측정항목 및 한도를 확인하고 관리하는 방법을 알아보려면 서비스 할당량 관리를 참조하세요.