Algumas ou todas as informações nesta página podem não se aplicar à nuvem confiável da S3NS.
Pré-requisitos
Antes de começar a programar seu primeiro aplicativo cliente, há algumas coisas que você precisa fazer, se ainda não tiver feito.
Criar uma Conta do Google
Você precisa de uma Conta do Google para ter acesso ao Compute Engine no Console de APIs do Google. Se você já tem uma conta, então está tudo pronto.
Para fins de teste, utilize uma Conta do Google separada.
Inscrever-se e testar o Compute Engine
Para começar, crie uma instância de VM no Compute Engine usando um dos
seguintes guias:
É importante familiarizar-se com os fundamentos do Compute Engine antes de continuar.
Na documentação da API, presumimos que você já usou o Compute Engine e conhece os conceitos de programação e formatos de dados da Web.
Aprenda sobre autenticação
Há maneiras diferentes de fazer a autenticação no Compute Engine, dependendo de como você acessa a
API. Para mais informações, consulte
Autenticar no Compute Engine.
Como funciona o REST
Há duas maneiras de invocar a API:
Se você não quer usar as bibliotecas de cliente, precisa entender os fundamentos da REST.
O REST é um estilo de arquitetura de software que fornece uma abordagem conveniente e consistente para solicitar e modificar dados.
O termo REST é a abreviação de "Representational State Transfer (Transferência de Estado Representacional)". No contexto das APIs do Google, ele se refere ao uso de verbos HTTP para recuperar e modificar representações de dados armazenados pelo Google.
Em um sistema RESTful, os recursos são mantidos em um armazenamento de dados. Um cliente envia uma solicitação para que uma ação específica seja executada no servidor, como a criação, recuperação, atualização ou exclusão de um recurso. Essa ação é executada e uma resposta é enviada, geralmente no formato de uma representação do recurso especificado.
Nas APIs RESTful do Google, uma ação é especificada no cliente usando um verbo HTTP como POST
, GET
, PUT
ou DELETE
. Um recurso é definido por meio de um URI global exclusivo no seguinte formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Como todos os recursos da API têm URIs exclusivos acessíveis por HTTP, a REST permite o armazenamento em cache dos dados e é otimizada para funcionar na infraestrutura distribuída da Web.
As definições de método (em inglês) encontradas na documentação dos padrões HTTP 1.1 podem ser úteis. Nelas estão incluídas as especificações GET
, POST
, PUT
e DELETE
.
REST na API Compute Engine
As operações da API Compute Engine estão mapeadas diretamente nos verbos HTTP do REST.
Os formatos específicos dos URIs da API Compute Engine são:
https://www.googleapis.com/compute/v1/resourcePath?parameters
O conjunto completo de URIs usados para cada operação suportada na API está resumido no documento de referência da API Compute Engine.
A API Compute Engine retorna dados no formato JSON.
JSON (JavaScript Object Notation) é um formato de dados comum e independente de linguagem que oferece uma representação de texto simples das estruturas de dados arbitrárias. Para mais informações, acesse json.org (em inglês).
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-05-29 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-05-29 UTC."],[[["A Google Account is required to access Compute Engine in the Google APIs Console, and you may want a separate one for testing."],["You can create either a Linux or Windows VM instance to get started with Compute Engine, which is recommended for familiarization before using the API."],["Authentication to Compute Engine varies depending on your method of API access, and details can be found in the documentation provided."],["The Compute Engine API can be invoked through HTTP requests or by using client libraries, and using HTTP requests requires an understanding of REST principles."],["The Compute Engine API uses RESTful architecture, with operations mapping directly to HTTP verbs, and the API returns data in JSON format."]]],[]]