Compute Engine 用戶端程式庫

Google Compute Engine API 建置於 HTTP 與 JSON 中,因此任何標準 HTTP 用戶端都可以將要求傳送至這個 API 以及剖析回應。

不過,您可能會希望透過用戶端程式庫完成,而不是手動建立 HTTP 要求以及剖析回應。用戶端程式庫可提供更好的語言整合、提升的安全性以及支援需要使用者授權的呼叫功能。

您可以透過許多 Google 提供的程式庫或是已知可在 Compute Engine 上運行的第三方開放原始碼程式庫來使用 Compute Engine API。本文件介紹 Google 提供的程式庫,以及可供使用的第三方開放原始碼程式庫。

可用的程式庫

社群程式庫

程式庫 語言 供應商 網站 Compute Engine 入門指南
libcloud Python 社群 網站 說明文件
jclouds Java、Clojure 社群 網站 說明文件
fog.io Ruby 社群 網站 說明文件

Google Cloud 用戶端程式庫

程式庫 語言 供應商 網站 Compute Engine 入門指南
Google Cloud Node.js 用戶端程式庫 Node.js Google 網站 說明文件

Google API 用戶端程式庫

程式庫 語言 供應商 網站 Compute Engine 入門指南
Google API Java 用戶端程式庫 Java Google 網站 說明文件
Google API .NET 用戶端程式庫 .NET Google 網站 說明文件
Google API Go 用戶端程式庫 Go Google 網站 說明文件
Google API JavaScript 用戶端程式庫 JavaScript Google 網站 說明文件
Google API Ruby 用戶端程式庫 Ruby Google 網站 說明文件
Google API Node.js 用戶端程式庫 Node.js Google 網站 說明文件
Google API Objective C 用戶端程式庫 Objective C Google 網站 說明文件
Google API PHP 用戶端程式庫 PHP Google 網站 說明文件
Google API Python 用戶端程式庫 Python Google 網站 說明文件

libcloud

libcloud 是一個 Python 程式庫,用來透過單一整合式 API 與許多主流 Cloud 服務供應商進行互動。

Compute Engine 須知

自 2013 年 7 月起,Apache libcloud API 專案持續接受有關 Compute Engine 的可靠支持和更新。該專案支援多種 Compute Engine 功能,包含執行個體、磁碟、網路/防火牆,以及負載平衡器支援。實用的入門示範提供如何使用 libcloud 和 Compute Engine 的良好程式碼範例。

jclouds

jclouds 是一個開放原始碼程式庫,可讓您透過多個 Cloud 供應商使用 Java 和 Clojure。

Compute Engine 須知

jclouds cloud API 支援 Compute Engine,並允許使用者管理虛擬機器、磁碟及網路等資源。自 1.9 版起,Compute Engine 已升級為 jclouds 核心。

fog.io

fog.io fog.io 是一個開放原始碼 Ruby 程式庫,可讓您透過單一 API 與多種 Cloud 服務互動。

Compute Engine 須知

自 2013 年 5 月的 1.11.0 版起,fog.io cloud API 已開始支援 Compute Engine。查看 fog.io 說明文件,開始使用 Compute Engine 和 fog。fog.io 支援建立、刪除和啟動等執行個體操作,也支援管理其他資源,例如磁碟、網路以及負載平衡器。

Google Cloud Node.js 用戶端程式庫

請參閱 Compute Engine Node.js 入門指南

Google API Java 用戶端程式庫

本頁提供了透過適用於 Java 的 Google API 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

取樣

compute-engine-cmdline-sample 可協助您開始使用用戶端程式庫。

將程式庫新增到您的專案

從下列分頁選取您的建構環境 (Maven 或 Gradle),或是下載包含所有您需要 Jar 的 ZIP 檔:

下載

下載適用於 Java 的 Compute Engine API v1 用戶端程式庫

請參閱 compute/readme.html 檔案瞭解有關下列項目的詳細資料:

  • 壓縮檔案包含的內容。
  • 每種應用程式類型 (網路應用程式、已安裝應用程式或 Android 應用程式) 需要哪些相依的 Jar。

libs 資料夾包含所有應用程式類型需要的所有全域適用依附元件。

Google API .NET 用戶端程式庫

本頁提供了透過適用於 .NET 的 Google API 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

下載程式庫

請安裝 Google.Apis.compute 提供的 NuGet 套件。

Google API Go 用戶端程式庫

本節提供透過 Google API Go 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

下載和安裝程式庫

如要安裝程式庫,請執行下列指令:

go get google.golang.org/api/compute/v1

使用程式庫

請將程式庫匯入程式碼:

package main

  import (
      "google.golang.org/api/compute/v1"
  )

Google API JavaScript 用戶端程式庫

本節提供透過 Google API JavaScript 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

使用 API

如要使用這個 API,您必須先載入程式庫。新增以下內容至您的程式碼:

<script src="https://apis.google.com/js/client.js?onload=handleClientLoad"></script>

Google API Ruby 用戶端程式庫

本頁提供了透過適用於 Ruby 的 Google API 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

安裝 google-api-client gem

如果您尚未安裝適用於 Ruby 的 Google API 用戶端程式庫,請開啟終端機並使用 RubyGems 開始安裝:

$ gem install google-api-client

假如您已安裝 gem,並且只想更新至最新版本:

$ gem update -y google-api-client

視您的系統而定,您可能必須在這些指令前加上 sudo

適用於 Ruby 的 Google API 用戶端程式庫入門指南

請務必查看我們完善的入門指南,快速瞭解如何提出第一個要求。

Google API Node.js 用戶端程式庫

請參閱 Compute Engine Node.js 入門指南

Google API Objective C 用戶端程式庫

本節提供透過 Google API Objective C 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

連結至程式庫

請按照操作說明將 Google API Objective-C 用戶端程式庫新增至專案

Google API PHP 用戶端程式庫

本節提供透過 Google API PHP 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

下載程式庫

新增程式庫做為 composer.json 的依存性項目,即可安裝程式庫。

"require": {
  "google/apiclient": "1.0.*"
}

GitHub 同時提供程式庫。如有需要,您也可以使用 git clone 方法將程式庫複製到本機存放區。

git clone https://github.com/google/google-api-php-client.git .

使用程式庫

定義程式庫檔案位置的最佳方式,就是將它新增至 PHP.ini 設定檔的路徑中。

include_path = ".:/usr/local/lib/php:/path/to/google-api-php-client/src"

此外,同樣的 ini 指令也能在程式碼中動態設定。

set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/google-api-php-client/src');

Google API Python 用戶端程式庫

本頁提供了透過適用於 Python 的 Google API 用戶端程式庫,開始使用 Compute Engine API 的資訊。此外,您還可能對以下文件有興趣:

系統需求

安裝用戶端程式庫

您可以使用套件管理員或是手動下載並安裝 Python 用戶端程式庫:

代管安裝

使用 Pip 或 Setuptools 來管理作業 (您可能必須先執行 sudo):

  • pip (建議選項):
    $ pip install --upgrade google-api-python-client
  • Setuptools:使用 setuptools 套件隨附的 easy_install 工具:
    $ easy_install --upgrade google-api-python-client

手動安裝

下載最新版的 Python 用戶端程式庫,解壓縮程式碼,然後執行 python setup.py install

App Engine

由於App Engine Python 執行階段環境並未安裝 Python 用戶端程式庫,因此您必須將這類程式庫加入您的應用程式,方法與加入第三方用戶端程式庫相同。