A API do Google Compute Engine é baseada em HTTP e JSON. Portanto, qualquer cliente HTTP padrão é pode de enviar solicitações a ela e analisar as respostas.
No entanto, em vez de criar solicitações HTTP e analisar respostas manualmente, convém usar as bibliotecas de cliente para isso. Nas bibliotecas de cliente há melhor integração de linguagens, mais segurança e compatibilidade na realização de chamadas que requerem autorização do usuário.
Use a API do Compute Engine em diversas bibliotecas fornecidas pelo Google ou em bibliotecas de código-fonte aberto de terceiros que funcionem no Compute Engine. Neste documento, descrevemos as bibliotecas fornecidas pelo Google, bem como algumas bibliotecas de código aberto de terceiros disponíveis.
Bibliotecas Disponíveis
Bibliotecas comunitárias
Biblioteca | Linguagem(ns) | Fornecedor | Site | Primeiros passos no Compute Engine |
---|---|---|---|---|
libcloud | Python | Comunidade | Site | Documentação |
jclouds | Java, Clojure | Comunidade | Site | Documentação |
fog.io | Ruby | Comunitária | Site | Documentação |
Bibliotecas de cliente do Google Cloud
Biblioteca | Linguagem(ns) | Fornecedor | Site | Introdução ao Compute Engine |
---|---|---|---|---|
Biblioteca de cliente Node.js do Google Cloud | Node.js | Site | Documentação |
Bibliotecas de cliente da Google API
Biblioteca | Linguagem(ns) | Fornecedor | Site | Primeiros passos no Compute Engine |
---|---|---|---|---|
Biblioteca de cliente Java das APIs do Google | Java | Site | Documentação | |
Biblioteca de cliente .NET das APIs do Google | .NET | Site | Documentação | |
Biblioteca de cliente Go das APIs do Google | Go | Site | Documentação | |
Biblioteca de cliente JavaScript das APIs do Google | JavaScript | Site | Documentação | |
Biblioteca de cliente Ruby das APIs do Google | Ruby | Site | Documentação | |
Biblioteca de cliente Node.js das APIs do Google | Node.js | Site | Documentação | |
Biblioteca de cliente Objective C da Google API | Objective C | Site | Documentação | |
Biblioteca de cliente PHP da Google API | PHP | Site | Documentação | |
Biblioteca de cliente Python da API do Google | Python | Site | Documentação |
libcloud
libcloud é uma biblioteca Python que proporciona interação com muitos provedores de serviços famosos do Cloud por meio de uma API unificada.
Notas do Compute Engine
O projeto Apache libcloud API tem grande compatibilidade com o Compute Engine e recebe atualizações para ele desde julho de 2013. Ele é compatível com um conjunto amplo de recursos do Compute Engine, inclusive instâncias, discos, redes/firewalls e balanceador de carga. A demonstração de primeiros passos é muito útil e oferece um bom exemplo em código de como usar a libcloud e o Compute Engine.
jclouds
jclouds é uma biblioteca de código aberto que permite o uso de Java e Clojure em vários provedores do Cloud.
Notas do Compute Engine
A Cloud API da jclouds é compatível com o Compute Engine e permite que os usuários gerenciem diversos recursos, como máquinas virtuais, discos e redes. A partir da versão 1.9, o Compute Engine foi promovido ao núcleo da jclouds.
fog.io
fog.io é uma biblioteca Ruby de código aberto que permite interagir com vários serviços do Cloud por meio de uma API.
Notas do Compute Engine
A Cloud API da fog.io é compatível com o Compute Engine desde a versão 1.11.0, de maio de 2013. Confira a documentação da fog.io para começar a usar o Compute Engine e a fog. Ela é compatível com operações de instância, como criar, destruir e executar bootstrap, além de permitir o gerenciamento de outros recursos, como discos, redes e balanceadores de carga.
Biblioteca de cliente Node.js do Google Cloud
Leia o guia de primeiros passos do Node.js do Compute Engine.
Biblioteca de cliente Java das APIs do Google
Nesta página, descrevemos como começar a usar a API do Compute Engine usando a Biblioteca de cliente da API do Google para Java. Além disso, talvez você se interesse pela seguinte documentação:
- Procure a referência do JavaDoc para a API do Compute Engine.
- Leia o Guia do desenvolvedor para a biblioteca de cliente da API do Google para Java.
- Interaja com essa API no navegador usando o APIs Explorer para a API do Compute Engine.
Amostra
A compute-engine-cmdline-sample o ajudará nos primeiros passos com o uso da biblioteca de cliente.
Adicionar biblioteca ao seu projeto
Selecione o ambiente de criação Maven ou Gradle nas guias abaixo ou faça o download de um arquivo zip com todos os jars necessários:
Faça o download da biblioteca de cliente da v1 da API do Compute Engine para Java.
No arquivo compute/readme.html
, veja detalhes sobre:
- O que o arquivo zip contém.
- Quais jars dependentes são necessários para cada tipo de aplicativo, seja ele da Web, instalado ou Android.
A pasta libs
contém todas as dependências aplicáveis globalmente necessárias em todos os tipos de aplicativos.
Adicione a seguinte instrução ao arquivo pom.xml
:
Veja todas as versões disponíveis no Repositório Central Maven.
Adicione a seguinte instrução ao arquivo build.gradle
:
Veja todas as versões disponíveis no Repositório Central Maven.
Biblioteca de cliente .NET das APIs do Google
Esta página contém informações sobre como começar a usar a Compute Engine API usando a biblioteca de cliente da Google API para .NET. Além disso, a documentação a seguir pode ser do seu interesse:
- Consulte a documentação de referência do .NET para a Compute Engine API.
- Leia o Guia do desenvolvedor da biblioteca de cliente da Google API para .NET.
- Interaja com essa API no navegador usando o APIs Explorer para a Compute Engine API.
Fazer o download da biblioteca
Instale um pacote NuGet disponível em Google.Apis.compute.
Biblioteca de cliente Go das APIs do Google
Esta seção contém informações sobre como começar a usar a Compute Engine API usando a biblioteca de cliente Go das Google APIs. Além disso, talvez você se interesse pela seguinte documentação:
- Leia o guia de primeiros passos para a biblioteca de cliente da Google APIs Go.
- Interaja com a API no navegador usando o Google APIs Explorer.
Como fazer o download e a instalação da biblioteca
Para instalar a biblioteca, execute o comando a seguir:
go get google.golang.org/api/compute/v1
Como usar a biblioteca
Importe a biblioteca no seu código:
package main
import (
"google.golang.org/api/compute/v1"
)
Biblioteca de cliente JavaScript das APIs do Google
Nesta seção, você encontra informações sobre os primeiros passos no uso da API do Compute Engine usando a biblioteca cliente JavaScript das APIs do Google. Além disso, talvez você se interesse pela seguinte documentação:
- Leia o guia de primeiros passos.
- Aprenda a desenvolver usando a biblioteca de cliente JavaScript.
- Veja o exemplo de primeiros passos com o JavaScript específico para o Compute Engine.
- Interaja com a API no navegador usando o Google APIs Explorer.
Como usar a API
Para usar a API, primeiro carregue a biblioteca. No seu código, adicione:
<script src="https://apis.google.com/js/client.js?onload=handleClientLoad"></script>
Biblioteca de cliente Ruby das APIs do Google
Nesta página, você encontra informações sobre como começar a usar a API do Compute Engine usando a Biblioteca de cliente da API do Google para Ruby. Além disso, talvez você se interesse pela seguinte documentação:
- Leia o Guia de primeiros passos da biblioteca de cliente da API do Google para Ruby.
- Interaja com essa API no navegador usando o APIs Explorer para a API do Compute Engine.
Como instalar a gem google-api-client
Caso a biblioteca de cliente da API do Google para Ruby ainda não esteja instalada, abra um terminal e instale-a usando o RubyGems
:
$ gem install google-api-client
Caso você já tenha a gem instalada e simplesmente queira atualizar para a versão mais recente:
$ gem update -y google-api-client
Dependendo do sistema, talvez seja necessário prefixar esses comandos com o sudo
.
Primeiros passos com a biblioteca de cliente da API do Google para Ruby
Consulte o nosso Guia de primeiros passos completo para uma visão geral de como fazer sua primeira solicitação.
Biblioteca de cliente Node.js das APIs do Google
Leia o guia de primeiros passos do Node.js do Compute Engine.
Biblioteca de cliente Objective C das APIs do Google
Nesta seção, você encontra informações sobre os primeiros passos no uso da API do Compute Engine com a biblioteca de cliente Objective C das APIs do Google. Além disso, talvez você se interesse pela seguinte documentação:
- Leia a visão geral.
- Interaja com a API no navegador usando o Google APIs Explorer.
Como fazer a vinculação com a biblioteca
Siga as instruções para adicionar a biblioteca de cliente Objective-C das APIs do Google a um projeto.
Biblioteca de cliente PHP das APIs do Google
Nesta seção, você encontra informações sobre os primeiros passos com a API do Compute Engine usando a biblioteca de cliente PHP das APIs do Google. Além disso, talvez você se interesse pela seguinte documentação:
- Leia o guia de instalação.
- Acesse a biblioteca do GitHub.
- Interaja com a API no navegador usando o Google APIs Explorer.
Como fazer o download da biblioteca
Instale a biblioteca adicionando-a como dependência ao composer.json.
"require": {
"google/apiclient": "1.0.*"
}
Caso prefira, faça a clonagem da biblioteca disponível no GitHub em um repositório local com o método git clone
.
git clone https://github.com/google/google-api-php-client.git .
Como usar a biblioteca
A melhor maneira de definir a localização dos arquivos das bibliotecas é adicioná-la ao caminho no arquivo de configuração PHP.ini.
include_path = ".:/usr/local/lib/php:/path/to/google-api-php-client/src"
Como alternativa, é possível definir a mesma diretiva ini dinamicamente no código.
set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/google-api-php-client/src');
Biblioteca de cliente Python das APIs do Google
Esta página contém informações sobre como começar com a Compute Engine API usando a biblioteca de cliente da Google API para Python. Além disso, a documentação a seguir pode ser do seu interesse:
- Consulte a referência de PyDoc para a Compute Engine API.
- Leia o Guia do desenvolvedor para a biblioteca de cliente da Google API para Python.
- Interaja com essa API no navegador usando o APIs Explorer para a Compute Engine API.
Requisitos do sistema
-
Sistemas operacionais:
- Linux
- Mac OS X
- Windows
- Python 2.7, 3.4 ou posterior
Como instalar a biblioteca de cliente
Use um gerenciador de pacotes ou faça o download e instale manualmente a biblioteca de cliente em Python:
Instalação gerenciada
Use o pip ou setuptools para gerenciar sua instalação. Talvez seja necessário executar primeiro o sudo
:
- pip (preferencial):
$ pip install --upgrade google-api-python-client
-
Setuptools: use a ferramenta
easy_install
incluída no pacote setuptools:$ easy_install --upgrade google-api-python-client
Instalação manual
Faça o download da biblioteca de cliente mais recente do Python, descompacte o código e execute
python setup.py install
.
App Engine
Como as bibliotecas de cliente do Python não estão instaladas no ambiente de execução do App Engine para Python, é preciso disponibilizá-las no aplicativo, assim como as bibliotecas de terceiros.