Existen diferentes maneras de autenticarse en Compute Engine según la forma en que accedas a la API. Para obtener más información, consulta Autentícate en Compute Engine.
Más información sobre REST
Existen dos maneras de invocar la API:
Si decides no usar bibliotecas cliente, deberás comprender los aspectos básicos de REST.
Conceptos básicos de REST
REST es un estilo de arquitectura de software que proporciona un enfoque conveniente y coherente para solicitar y modificar datos.
El término REST es la abreviatura de "Representational State Transfer" (transferencia de estado representacional). En el contexto de las API de Google, se refiere al uso de los verbos HTTP para recuperar y modificar las representaciones de los datos almacenados por Google.
En un sistema RESTful, los recursos se almacenan en un almacén de datos; un cliente envía una solicitud para que el servidor ejecute una acción en particular (como crear, recuperar, actualizar o borrar un recurso) y el servidor ejecuta la acción y envía una respuesta que, por lo general, es una representación del recurso especificado.
En las API con tecnología REST de Google, el cliente especifica una acción con un verbo HTTP como POST, GET, PUT o DELETE. Especifica un recurso mediante un URI único a nivel global de la siguiente manera:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Dado que todos los recursos de API tienen URI únicos accesibles a través de HTTP, REST permite el almacenamiento de datos en caché y está optimizado para funcionar con la infraestructura distribuida de la Web.
Puedes encontrar las definiciones de métodos en la documentación de estándares del HTTP 1.1, los que incluyen especificaciones para GET, POST, PUT y DELETE.
REST en la API de Compute Engine
Las operaciones de la API de Compute Engine se asignan directamente a los verbos HTTP de REST.
La API de Compute Engine usa el siguiente formato para los URIs:
https://www.googleapis.com/compute/API_VERSION/RESOURCE_PATH
El URI contiene los siguientes valores:
API_VERSION: La versión de la API que deseas usar, que corresponde a la etapa de lanzamiento de un recurso de Compute Engine de la siguiente manera:
- Para recursos en GA:
v1
- Para recursos en versión preliminar pública:
beta
- Para los recursos de la vista previa privada:
alpha
RESOURCE_PATH: Es la ruta de acceso al recurso específico de Compute Engine, por ejemplo, projects/example-project/aggregated/instances. Para ver los recursos disponibles para cada versión de la API, consulta lo siguiente:
Si deseas incluir parámetros de consulta, inclúyelos en el URI después de un signo de interrogación (?):
https://www.googleapis.com/compute/API_VERSION/RESOURCE_PATH?QUERY_PARAMETERS
En el URI, QUERY_PARAMETERS es una lista de parámetros de consulta, separados por signos & (&), por ejemplo, format=json&filter=zone=us-central1-a.
