Crea una API

En esta página, se describe cómo crear una API.

Requisitos previos

Antes de crear una API, haz lo siguiente:

Prepara tu entorno de desarrollo como se describe en Configura el entorno de desarrollo.

Requisitos de ID de API

Muchos de los comandos gcloud que se muestran requieren que especifiques el ID de la API, en el formato API_ID. API Gateway aplica los siguientes requisitos para el ID de la API:

Debe tener una longitud máxima de 63 caracteres.
Debe contener solo letras en minúscula, números o guiones.
No debe comenzar con un guion.
No debe contener un guion bajo.

Crea una API

Crear una API

Consola deGoogle Cloud

Crea e implementa una API, como se describe en Implementa una API en una puerta de enlace.

Google Cloud CLI

Para crear una API, revisa las siguientes secciones:

Pasos para crear una API
Opciones de Google Cloud CLI
Proyectos con alcance de dominio

Pasos para crear una API

Valida el ID del proyecto que muestra el siguiente comando para asegurarte de que el servicio no se cree en el proyecto equivocado.
```
gcloud config list project
```
Si necesitas cambiar el proyecto predeterminado, ejecuta el siguiente comando y reemplaza PROJECT_ID por el ID del proyecto Google Cloud en el que quieres crear el servicio:
```
gcloud config set project PROJECT_ID
```
Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con permiso de dominio para obtener detalles adicionales sobre cómo crear una API en tu proyecto.
Consulta la ayuda para el comando apis create:
```
gcloud api-gateway apis create --help
```
Ejecuta el siguiente comando para crear la API:
```
gcloud api-gateway apis create API_ID
```
Donde:
- API_ID especifica el ID de la nueva API. Consulta los requisitos de ID de API para conocer los lineamientos de nomenclatura de las APIs.
Mientras se crea la API, API Gateway envía información a la terminal.

Cuando el proceso finalice con éxito, puedes usar el siguiente comando para ver los detalles de la nueva API:

gcloud api-gateway apis describe API_ID

Este comando devuelve lo siguiente:

      createTime: '2020-02-29T21:52:20.297426875Z'
      displayName: API_ID
      managedService: MANAGED_SERVICE_NAME.apigateway.PROJECT_ID.cloud.goog
      name: projects/PROJECT_ID/locations/global/apis/API_ID
      state: ACTIVE
      updateTime: '2020-02-29T21:52:20.647923711Z'

Opciones de Google Cloud CLI

La CLI de Google Cloud admite muchas opciones, incluidas las que se describen en la Referencia de gcloud. Además, en API Gateway, puedes establecer las siguientes opciones cuando creas una API:

--async: Devuelve el control a la terminal de inmediato, sin esperar a que se complete la operación.
--display-name=NAME: Especifica el nombre visible de la API, es decir, el nombre que se muestra en la IU. No uses espacios en el nombre. En su lugar, usa guiones y guiones bajos. El valor predeterminado es API_ID.
--labels=KEY1=VALUE1,KEY2=VALUE2,...: Especifica etiquetas asociadas con la configuración de la API.
--managed-service: Especifica un servicio administrado preexistente para la API. Consulta también Proyectos con alcance de dominio

Proyectos con alcance de dominio

Si tu proyecto tiene alcance para tu dominio, el ID del proyecto incluye el nombre del dominio seguido de dos puntos (:), por ejemplo, example.com:my-project. Debes proporcionar un servicio administrado válido cuando crees una API en un proyecto con alcance de dominio.

Si usas gcloud, proporciona el nombre del servicio administrado con la marca --managed-service, como se describe en Opciones de Google Cloud CLI.

Enumera APIs

Enumera todas las APIs de un proyecto.

Consola deGoogle Cloud

En la consola de Google Cloud , ve a la página API Gateway.

Ir a API Gateway

Google Cloud CLI

gcloud api-gateway apis list

Este comando devuelve un resultado con el siguiente formato:

  NAME                                              DISPLAY_NAME  MANAGED_SERVICE                          STATE
  projects/PROJECT_ID/locations/global/apis/API_ID  API_ID        MANAGED_SERVICE_NAME.apigateway.PROJECT_ID.cloud.goog  ACTIVE

Usa el ID de la API para obtener información detallada sobre ella:

gcloud api-gateway apis describe API_ID

Actualiza una API

Después de la creación, puedes actualizar las etiquetas y el nombre visible de una API existente.

Consola deGoogle Cloud

En la consola de Google Cloud , ve a la página API Gateway.

Ir a API Gateway
Haz clic en la API requerida.
Haz clic en la pestaña Detalles.
Haz clic en editar Editar.
Edita Nombre visible o Etiquetas y, luego, haz clic en Guardar.

Google Cloud CLI

Usa las siguientes opciones de gcloud para actualizar una API existente:

--display-name
--update-labels
--clear-labels
--remove-labels

Por ejemplo:

  gcloud api-gateway apis update API_ID \
    --update-labels=a=1,b=2

Usa el siguiente comando para ver todas las opciones de actualización:

gcloud api-gateway apis update --help

Borra una API

Para borrar una API, debes hacer lo siguiente:

Borra las API Gateways asociadas con la API y sus configuraciones de API.
Borra los parámetros de configuración de la API asociados con la API.
Borra la API.

Consola deGoogle Cloud

En la consola de Google Cloud , ve a la página API Gateway.

Ir a API Gateway
Haz clic en la API que elegiste borrar.
Haz clic en la pestaña Configs.
Selecciona las configuraciones de API y haz clic en Más y, luego, en Borrar.
Haz clic en para volver a la página principal de API Gateway.
Haz clic en Más y, luego, en Borrar para borrar la API elegida.

Google Cloud CLI

Determina la lista de API Gateways asociados con la API:

gcloud api-gateway gateways list --filter='apiConfig:"projects/PROJECT_ID/locations/global/apis/API_ID"'

Borra cada configuración de API asociada con la API:

gcloud api-gateway api-configs delete CONFIG_ID --api=API_ID

Borra la API:
```
gcloud api-gateway apis delete API_ID 
```

¿Qué sigue?

Crea una configuración de API