이 가이드에서는 Cloud Billing Budget API 사용을 시작하기 위해 필요한 모든 설정 단계를 제공합니다.
시작하기 전에
이 가이드를 읽기 전에 다음을 수행해야 합니다.
- Cloud Billing Budget API 개요를 읽어보세요.
- Cloud Billing Budget API 기본 요건을 읽어보세요.
Google Cloud 콘솔 정보
Google Cloud 콘솔(문서 보기, 콘솔 열기)은 Google Cloud 제품을 사용하는 시스템을 프로비저닝, 구성, 관리, 모니터링하는 데 사용되는 웹 UI입니다. Google Cloud 콘솔을 사용하여 Google Cloud 및 Cloud Billing 리소스를 설정하고 관리할 수 있습니다.
1. 프로젝트 선택 또는 만들기
Google Cloud에서 제공하는 서비스를 사용하려면 프로젝트를 만들어야 합니다. 프로젝트는 모든 Google Cloud 리소스를 구성합니다. 프로젝트는 공동작업자, 사용 설정된 API(및 기타 리소스), 모니터링 도구, 결제 정보, 인증, 액세스 제어로 구성됩니다. 프로젝트를 하나 또는 여러 개 만들 수 있으며 이를 사용하여 Google Cloud 리소스를 리소스 계층 구조로 구성할 수도 있습니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.
권장사항: Cloud Billing Budget API를 포함하여 모든 결제 관리 니즈를 포함하도록 별개의 단일 Google Cloud 프로젝트를 구성하는 것이 좋습니다. 또한 Cloud Billing Account API 액세스, Cloud Billing 내보낸 데이터, 프로그래매틱 예산 알림에 대한 Pub/Sub 채널 등에도 결제 관리 Google Cloud 프로젝트를 사용할 수 있습니다.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
2. 결제 사용 설정
Cloud Billing Budget API를 호출하기 위해 사용 중인 프로젝트에 결제가 사용 설정되었는지 확인해야 합니다. 프로젝트 섹션의 권장사항을 따랐다면 이는 사용자의 결제 관리 Google Cloud 프로젝트입니다.
Cloud Billing 계정은 정해진 Google Cloud 리소스 집합의 비용을 지불할 사람을 정의하기 위해 사용됩니다. 사용 설정된 API와 같은 리소스는 프로젝트에 구성됩니다. Cloud Billing 계정을 하나 이상의 프로젝트에 연결할 수 있습니다. 프로젝트 사용량의 비용은 연결된 결제 계정으로 청구됩니다. 대부분의 경우 프로젝트를 만들 때 결제를 구성합니다. 자세한 내용은 결제 문서를 참조하세요.
Cloud Billing 계정을 모니터링하도록 Cloud Billing 예산을 설정합니다. 모니터링 중인 Cloud Billing 계정은 Cloud Billing Budget API를 호출하기 위해 사용하는 프로젝트에 연결된 Cloud Billing 계정과 동일할 수 있습니다. Google Cloud 고객은 Cloud Billing Budget API를 무료로 사용할 수 있습니다. 프로그래매틱 예산 알림을 구성하도록 선택하면 표준 Pub/Sub 가격이 청구됩니다.
Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
3. API 사용 설정
Cloud Billing Budget API를 호출하기 위해 사용하는 프로젝트에서 Cloud Billing Budget API를 사용 설정해야 합니다. 프로젝트 섹션의 권장사항을 따랐다면 이는 사용자의 결제 관리 Google Cloud 프로젝트입니다.
API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.
Enable the Cloud Billing Budget API.
4. 인증 및 승인 설정
Cloud Billing Budget API를 사용하려면 인증을 설정해야 합니다. API를 사용하는 모든 클라이언트 애플리케이션은 인증을 통해 ID를 확인해야 합니다. 자세한 내용은 Cloud Billing에 인증을 참조하세요.
개발자는 Google 계정 또는 서비스 계정과 같은 특정 주 구성원으로 인증합니다. 이 주 구성원에게는 Cloud Billing Budget API에 필요한 권한이 포함된 Identity and Access Management(IAM) 역할이 있어야 합니다.
주 구성원에게 예산을 관리하는 데 필요한 권한이 있게 하려면 관리자에게 결제 계정에 대한 결제 계정 관리자(roles/billing.admin) IAM 역할을 주 구성원에게 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.
관리자는 커스텀 역할이나 다른 사전 정의된 역할을 통해 주 구성원에게 필요한 권한을 부여할 수도 있습니다.
결제 계정에 대한 역할을 부여하는 방법은 Cloud Billing 권한 업데이트를 참조하세요.
5. gcloud CLI 설치 및 초기화
Cloud Billing Budget API를 사용하려면 Google Cloud CLI를 설치하고 초기화해야 합니다. Google Cloud CLI는 Google Cloud에서 호스팅되는 리소스와 애플리케이션을 관리하는 데 사용할 수 있는 도구 집합입니다. 여기에는 gcloud CLI가 포함됩니다. 다음 링크에서 안내를 제공합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
6. SDK 및 인증 테스트
이전 단계에서 인증을 설정한 경우 gcloud CLI를 사용하여 인증 환경을 테스트할 수 있습니다. 다음 명령어를 실행하여 오류가 발생하지 않고 사용자 인증 정보가 반환되는지 확인합니다.
gcloud auth print-access-token
이 명령어는 모든 Cloud Billing Budget API 명령줄 REST 샘플에서 API 호출을 인증하는 데 사용됩니다.
7. Cloud Billing Budget API 클라이언트 라이브러리 설치
Cloud Billing Budget API는 HTTP 및 JSON에 기반하므로 모든 표준 HTTP 클라이언트가 여기에 요청을 보내고 응답을 파싱할 수 있습니다.
API 호출에는 세 가지 옵션이 있습니다.
-
클라이언트 라이브러리는 우수한 언어 통합, 향상된 보안, 사용자 승인이 필요한 호출에 대한 지원을 제공합니다. Google 지원 클라이언트 라이브러리는 여러 언어용으로 제공되며, 추천되는 옵션입니다.