Service Management API 시작하기

이 페이지에서는 Service Management API를 사용하도록 개발 환경을 설정하는 방법을 설명합니다. Service Management API(단순한 Google Cloud Console 웹 UI 사용과 다름)를 사용하기 위한 가장 간단하고 대부분의 사용 사례에 가장 적합한 방법은 gcloud 명령줄 인터페이스를 사용하는 것입니다. Service Management API와 달리 프로그래밍해야 하는 경우에는 제공된 클라이언트 라이브러리 중에 하나를 사용하는 것이 좋습니다. API를 실험하려면 아래의 대체 설정 안내를 따르고 curl 명령어를 사용하여 전체 애플리케이션 개발 환경을 설정하지 않고도 API를 사용할 수 있습니다.

gcloud를 사용하여 설정

  1. Google 계정으로 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Cloud Console의 프로젝트 선택기 페이지에서 Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기 페이지로 이동

  3. Service Management API를 사용 설정합니다.

    API 사용 설정

  4. Cloud SDK 설치 및 초기화

API를 직접 호출하도록 설정

이 섹션에서는 curl 명령어를 사용해서 Service Management API를 실험할 수 있도록 로컬 환경을 설정하는 데 필요한 기본 단계를 설명합니다. 이는 Service Management API에서 프로그래밍해야 하는 개발자를 대상으로 합니다.

초기 설정

  1. Cloud Console 서비스 계정 페이지로 이동합니다.
    서비스 계정 페이지로 이동
  2. 선택을 클릭하여 서비스 액세스를 위해 사용하려는 Google Cloud 프로젝트를 선택합니다.
  3. 서비스 계정 만들기 서비스 계정을 만드는 방법을 알아보려면 서비스 계정 만들기 및 관리를 참조하세요. 이 섹션의 안내를 따르기 위해서는 서비스 계정에 roles/servicemanagement.admin 역할을 부여해야 합니다. 서비스 계정에 역할을 부여하는 방법을 알아보려면 서비스 계정에 역할 부여를 참조하세요.
  4. Cloud Console API 사용자 인증 정보 페이지로 이동합니다.
    API 사용자 인증 정보 페이지로 이동
  5. 새 서비스 계정의 서비스 계정 키를 만들고 해당 JSON 사용자 인증 정보 파일을 로컬 머신에 다운로드합니다. 이 가이드의 예시에서는 파일 경로가 ~/credentials.json이라고 가정합니다. 서비스 계정 키를 만드는 방법을 알아보려면 서비스 계정 키 만들기 및 관리를 참조하세요.
  6. Google OAuth 시스템과 상호작용할 수 있도록 로컬 머신에 oauth2l을 설치합니다.

curl로 테스트

  1. 먼저 초기 설정을 확인합니다.

    $ oauth2l header --json ~/credentials.json cloud-platform
    
  2. OAuth 흐름을 완료하면 다음과 같은 출력이 표시됩니다.

    Authorization: Bearer y29.xxxxxxx
    
  3. Google REST API를 호출하기 위한 편리한 셸 별칭을 정의합니다.

    $ alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform)" -H "Content-Type: application/json"'
    
  4. 공개적으로 액세스할 수 있는 서비스를 나열해 봅니다.

    $ gcurl https://servicemanagement.googleapis.com/v1/services
    

    서비스 목록이 보이면 설정에 성공한 것입니다.

다음 단계

관리형 서비스를 만드는 중이며 Cloud Endpoints를 사용 중이지 않은 경우:

  1. 서비스 만들기 및 삭제에 따라 관리형 서비스를 만듭니다. 최상위 수준의 관리형 서비스 리소스가 만들어집니다.
  2. 서비스 구성 관리에 따라 서비스 구성을 제출하여 서비스에서 사용되는 기능을 설명합니다.

  3. 서비스 구성 배포에 따라 서비스 구성을 배포합니다.