서비스 나열

이 문서에서는 Google Cloud 프로젝트에서 사용 설정되었거나 사용 가능한 API 및 서비스를 나열하는 방법을 설명합니다. 사용 가능하거나 사용 설정된 API 및 서비스 목록에는 Pub/Sub와 같은 공개 Google Cloud 서비스 및 Cloud Endpoints를 사용하여 생성된 서비스와 같이 비공개로 공유된 모든 API와 서비스가 포함될 수 있습니다. 공개 API 및 서비스와 비공개 API 및 서비스의 차이점에 대한 자세한 내용은 공개 및 비공개 서비스를 참조하세요.

  • 조직에 사용 설정된 서비스를 가져오거나 모니터링하려면 조직의 사용 설정된 서비스 나열을 참조하세요.
  • 프로젝트의 서비스를 나열하려면 Google Cloud 콘솔 또는 Google Cloud CLI를 사용하는 것이 좋습니다. 이 문서에서는 두 인터페이스 모두를 사용한 방법을 설명합니다.
  • Service Usage API를 프로그래밍하려면 Google에서 제공하는 클라이언트 라이브러리 중 하나를 사용합니다.
  • API를 실험하려면 curl 명령어를 사용하는 것이 좋습니다. 전체 애플리케이션 환경을 설정할 필요는 없지만 몇 가지 필수 설정이 있습니다.

시작하기 전에

사용 설정된 API 및 서비스와 사용 가능한 API 및 서비스를 나열하려면 다음 사항이 필요합니다.

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

조직의 사용 설정된 서비스 나열

조직 전체에서 사용 설정된 서비스를 나열하려면 Cloud 애셋 인벤토리를 사용합니다. 단일 RPC 호출로 조직에서 관리하는 모든 프로젝트의 상태를 내보낼 수 있습니다. Cloud 애셋 인벤토리는 상태 변경을 모니터링하는 데 사용될 수도 있습니다. 특정 조직에 사용 설정된 모든 서비스를 내보내려면 애셋 나열에 대한 Cloud 애셋 인벤토리 문서를 따르세요.

조직에 사용 설정된 API를 나열하려면 조직 및 결제 프로젝트 ID를 설정한 후 다음 명령어를 실행합니다.

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--organization='ORGANIZATION_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

위의 명령어를 실행하면 충분한 권한을 가진 사용자가 조직의 모든 프로젝트에 사용 설정된 서비스 집합을 나열할 수 있습니다.

Cloud 애셋 인벤토리 명령어를 실험하려면 이러한 명령어를 특정 프로젝트에 적용합니다. 예를 들어 다음 명령어는 특정 프로젝트에 사용 설정된 모든 서비스를 나열합니다.

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--project='PROJECT_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

프로젝트의 사용 설정된 서비스 나열

사용 설정된 서비스 나열은 serviceusage.googleapis.com/list_enabled_requests 할당량 측정항목의 할당량을 사용합니다. 사용 가능한 기본 할당량은 초당 쿼리 수(QPS) 10개입니다.

콘솔

프로젝트에서 사용 설정된 API와 서비스를 나열하려면 다음 단계를 따르세요.

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

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

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

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

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

    API 및 서비스 페이지가 나타납니다. 이 페이지의 표에서 Google Cloud 프로젝트에 사용 설정된 API 목록을 확인할 수 있습니다.

gcloud

현재 프로젝트에서 사용 설정된 API 및 서비스를 나열하려면 다음 명령어를 실행합니다.

gcloud services list

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

NAME                                              TITLE
pubsub.googleapis.com             Google Cloud Pub/Sub API
bigquery.googleapis.com           BigQuery API
cloudtrace.googleapis.com         Stackdriver Trace API
servicemanagement.googleapis.com  Google Service Management API
monitoring.googleapis.com         Stackdriver Monitoring API
storage-api.googleapis.com        Google Cloud Storage JSON API
logging.googleapis.com            Stackdriver Logging API
clouddebugger.googleapis.com      Stackdriver Debugger API
...

curl

사용 가능한 서비스를 나열하려면 state:ENABLED 필터를 사용하여 services.list 메서드를 호출합니다.

프로젝트에서 사용 설정된 API 및 서비스를 나열하려면 다음 명령어를 실행합니다.

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"

프로젝트의 사용 가능한 서비스 나열

사용 가능한 모든 서비스를 나열하면 serviceusage.googleapis.com/list_available_requests 할당량의 할당량이 사용됩니다. 사용 가능한 기본 할당량은 1QPS입니다. 사용 가능한 서비스 집합은 거의 변경되지 않으며 장기간 캐시될 수 있습니다.

콘솔

프로젝트에서 사용 가능한 API와 서비스를 나열하려면 다음 단계를 따르세요.

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

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

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

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

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

    API 라이브러리 화면이 표시됩니다. 이 화면에서 사용 가능한 API를 검색하거나 스크롤할 수 있습니다.

gcloud

현재 프로젝트에서 사용 가능한 API 및 서비스를 나열하려면 다음 명령어를 실행합니다.

gcloud services list --available

이미 사용 설정된 모든 서비스와 현재 프로젝트에서 사용 설정할 수 있는 서비스가 결과에 포함됩니다. 이 명령어는 다음과 비슷한 출력을 생성합니다.

NAME                                              TITLE
places-backend.googleapis.com                  Google Places API Web Service
clouderrorreporting.googleapis.com             Stackdriver Error Reporting API
analyticsreporting.googleapis.com              Google Analytics Reporting API
youtube.googleapis.com                         YouTube Data API v3
adsense.googleapis.com                         AdSense Management API
sqladmin.googleapis.com                        Google Cloud SQL API
genomics.googleapis.com                        Genomics API
adexchangebuyer.googleapis.com                 Ad Exchange Buyer API II
...

curl

사용 가능한 서비스를 나열하려면 services.list 메서드를 호출합니다.

프로젝트에서 사용 가능한 API 및 서비스를 나열하려면 다음 명령어를 실행합니다.

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"

결과에는 모든 공개 서비스, 호출하는 사용자에게 servicemanagement.services.bind 권한이 있는 모든 서비스, 프로젝트에서 이미 활성화된 모든 서비스가 포함됩니다.

이전 호출에 filter=state:DISABLED를 전달하면 프로젝트에서 현재 활성 상태인 서비스를 제외할 수 있습니다.

다음 단계

Google Cloud 프로젝트에서 서비스를 사용 설정하거나 중지하는 방법에 대한 자세한 내용은 서비스 사용 설정 및 중지를 참고하세요.