기본 요건

이 문서에서는 Compute Engine API 사용을 위한 기본 요건을 설명합니다.

다음 몇 가지 사항을 아직 진행하지 않았다면 처음 클라이언트 애플리케이션의 코딩을 시작하기 전에 진행해야 합니다.

Google 계정 만들기

Compute Engine API에 액세스하려면 Google 계정이 필요합니다. 기존 계정이 있는 경우 이미 액세스 권한이 있습니다.

테스트 목적으로 별도의 Google 계정이 필요할 수 있습니다.

Compute Engine 가입 및 사용

시작하려면 다음 가이드 중 하나를 사용하여 Compute Engine에서 VM 인스턴스를 만듭니다.

계속하기 전에 Compute Engine에 대해 잘 알고 있어야 합니다. API 문서에서는 Compute Engine을 사용해 본 적이 있으며, 웹 프로그래밍 개념과 웹 데이터 형식을 잘 알고 있다고 가정합니다.

인증 알아보기

API 액세스 방법에 따라 Compute Engine에 인증하는 여러 방법이 있습니다. 자세한 내용은 Compute Engine에 인증을 참조하세요.

REST에 대해 자세히 알아보기

API를 호출하는 방법에는 2가지가 있습니다.

클라이언트 라이브러리를 사용하지 않으려는 경우에는 REST의 기본사항을 이해해야 합니다.

REST 기본사항

REST는 데이터 요청 및 수정에 대한 간편하고 일관성 있는 접근 방식을 제공하는 소프트웨어 아키텍처 스타일입니다.

REST는 'Representational State Transfer'의 줄임말로, Google API의 맥락에서 REST는 HTTP 동사를 사용하여 Google이 저장한 데이터 표현을 검색 및 수정하는 방법을 의미합니다.

RESTful 시스템에서는 리소스가 데이터 스토어에 저장되고, 클라이언트는 서버에서 특정 작업(리소스 생성, 검색, 업데이트, 삭제 등)을 수행하라는 요청을 전송하며, 서버는 작업을 수행하고 응답을 전송합니다. 이 응답은 지정된 리소스 표현의 형식을 취하는 경우가 많습니다.

Google의 RESTful API에서는 클라이언트가 POST, GET, PUT 또는 DELETE 등의 HTTP 동사를 사용하여 작업을 지정합니다. 다음과 같은 형식의 전역적으로 고유한 URI를 사용하여 리소스를 지정합니다.

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

모든 API 리소스에는 HTTP에서 액세스할 수 있는 고유 URI가 있으므로 REST는 데이터 캐싱을 지원하며 웹의 분산형 인프라와의 연동성이 뛰어납니다.

HTTP 1.1 표준 문서의 메서드 정의를 확인하면 유용합니다. 문서에 GET, POST, PUT, DELETE의 사양이 포함되어 있습니다.

Compute Engine API의 REST

Compute Engine API 작업은 REST HTTP 동사에 직접 매핑됩니다.

Compute Engine API는 URI에 다음 형식을 사용합니다.

https://www.googleapis.com/compute/API_VERSION/RESOURCE_PATH

URI에 다음 값이 포함됩니다.

  • API_VERSION: 사용하려는 API 버전입니다. Compute Engine 리소스의 출시 단계에 해당하며 다음과 같습니다.
    • 정식 버전의 리소스: v1
    • 공개 프리뷰의 리소스: beta
    • 비공개 프리뷰의 리소스: alpha
  • RESOURCE_PATH: 특정 Compute Engine 리소스의 경로입니다(예: projects/example-project/aggregated/instances). 각 API 버전에서 사용 가능한 리소스를 확인하려면 다음을 참조하세요.

쿼리 파라미터를 포함하려면 URI에서 물음표(?) 뒤에 포함하세요.

https://www.googleapis.com/compute/API_VERSION/RESOURCE_PATH?QUERY_PARAMETERS

URI에서 QUERY_PARAMETERS는 앰퍼샌드(&)로 구분된 쿼리 파라미터 목록입니다(예: format=json&filter=zone=us-central1-a).

JSON 데이터 형식에 대해 자세히 알아보기

Compute Engine API는 JSON 형식으로 데이터를 반환합니다.

JSON(JavaScript Object Notation)은 특정 언어에 의존하지 않는 일반적인 데이터 형식으로, 임의의 데이터 구조를 간단한 텍스트로 표현할 수 있습니다. 자세한 내용은 json.org를 참조하세요.