本页面介绍如何开始使用 Compute Engine API 的 Cloud 客户端库。通过客户端库,您可以更轻松地使用支持的语言访问 Google Cloud API。虽然您可以通过向服务器发出原始请求来直接使用 Google Cloud API,但客户端库可实现简化,从而显著减少您需要编写的代码量。
请参阅客户端库说明,详细了解 Cloud 客户端库和旧版 Google API 客户端库。
如需在 Google Cloud 控制台中直接遵循有关此任务的分步指导,请点击操作演示:
安装客户端库
C++
请遵循 Quickstart
。
C#
安装 NuGet 提供的 Google.Cloud.Compute.V1
软件包。
如需了解详情,请参阅设置 C# 开发环境。
Go
go get cloud.google.com/go/compute/apiv1
如需了解详情,请参阅设置 Go 开发环境。
Java
如果您使用的是 Maven,请将以下代码添加到您的 pom.xml
文件中。如需详细了解 BOM,请参阅 Google Cloud Platform 库 BOM。
如果您使用的是 Gradle,请将以下代码添加到您的依赖项中:
如果您使用的是 sbt,请将以下代码添加到您的依赖项中:
适用于 Compute Engine 的 Java 版 Cloud 客户端库的旧版本可用作 Maven 工件中的 0.120.x 版或更早版本。该库的 0.120.x 版及更早版本与更高版本向前不兼容。
如需了解详情,请参阅设置 Java 开发环境。
Node.js
npm install @google-cloud/compute
适用于 Compute Engine 的 Node.js 版 Cloud 客户端库的旧版本可用作 npm 软件包 中的 2.5.x 版或更早版本。该库的 2.5.x 版及更早版本与更高版本向前不兼容。
如需了解详情,请参阅设置 Node.js 开发环境。
PHP
composer require google/cloud-compute
如需了解详情,请参阅在 Google Cloud 上使用 PHP。
Python
pip install --upgrade google-cloud-compute
如需了解详情,请参阅设置 Python 开发环境。
Ruby
gem install google-cloud-compute-v1
如需了解详情,请参阅设置 Ruby 开发环境。
设置身份验证
为了对 Google Cloud API 的调用进行身份验证,客户端库支持应用默认凭据 (ADC);这些库会在一组指定的位置查找凭据,并使用这些凭据对发送到 API 的请求进行身份验证。借助 ADC,您可以在各种环境(例如本地开发或生产环境)中为您的应用提供凭据,而无需修改应用代码。对于生产环境,设置 ADC 的方式取决于服务和上下文。如需了解详情,请参阅设置应用默认凭据。
对于本地开发环境,您可以使用与您的 Google 账号关联的凭据设置 ADC:
-
初始化 gcloud CLI 时,请务必指定您在其中有权访问应用所需的资源的 Google Cloud 项目。
创建凭据文件:
gcloud auth application-default login
登录屏幕随即出现。在您登录后,您的凭据会存储在 ADC 使用的本地凭据文件中。
使用客户端库
以下示例展示了如何使用客户端库列出特定可用区中的实例。如需查看更多示例,请参阅使用客户端库。
C#
Go
Java
Node.js
PHP
Python
Ruby
其他资源
C++
以下列表包含与 C++ 版客户端库相关的更多资源的链接:
C#
以下列表包含与 C# 版客户端库相关的更多资源的链接:
Go
以下列表包含与 Go 版客户端库相关的更多资源的链接:
Java
以下列表包含与 Java 版客户端库相关的更多资源的链接:
Node.js
以下列表包含与 Node.js 版客户端库相关的更多资源的链接:
PHP
以下列表包含与 PHP 版客户端库相关的更多资源的链接:
Python
以下列表包含与 Python 版客户端库相关的更多资源的链接:
Ruby
以下列表包含与 Ruby 版客户端库相关的更多资源的链接:
旧版客户端库
Cloud 客户端库使用我们最新的客户端库模型,推荐通过它以编程方式访问 Cloud API。
如果您无法使用 Cloud 客户端库,可以使用以下 Google API 客户端库:
语言 | 库 | 资源 |
---|---|---|
Go | Google API Go 客户端库 | 文档 |
Java | Google API Java 客户端库 | 文档 |
JavaScript | Google API JavaScript 客户端库 | 文档 |
.NET | Google API .NET 客户端库 | 文档 |
Node.js | Google API Node.js 客户端库 | 文档 |
Objective-C | Google API Objective-C 客户端库 | 文档 |
PHP | Google API PHP 客户端库 | 文档 |
Python | Google API Python 客户端库 | 文档 |
Ruby | Google API Ruby 客户端库 | 文档 |
Dart | Google API Dart 客户端库 | 文档 |
第三方 Compute Engine API 客户端库
libcloud
libcloud 是一个 Python 库,用于通过一个统一的 API 与多个云服务提供商进行交互。
自 2013 年 7 月以来,Apache libcloud API 项目获得了对 Compute Engine 的支持和更新。它支持广泛的 Compute Engine 功能,包括实例、磁盘、网络和负载均衡器。使用入门演示提供了一个如何将 libcloud 和 Compute Engine 结合使用的代码示例。
jclouds
jclouds 是一个开源库,可让您跨多个云提供商使用 Java 和 Clojure。
jclouds cloud API 支持 Compute Engine,可让您管理虚拟机、磁盘和网络等资源。从 1.9 版开始,Compute Engine 已提升至 jclouds 核心。
fog.io
fog.io 是一个开源 Ruby 库,可让您通过一个 API 与多个云服务进行交互。
自 2013 年 5 月的 1.11.0 版起,fog.io cloud API 可支持 Compute Engine。它支持创建和删除等实例操作,以及磁盘、网络和负载均衡器等其他资源的管理操作。