API de funciones para servicios agrupados en paquetes heredados

Con la API de funciones, tu aplicación puede detectar interrupciones y tiempos de inactividad programados para funciones de API específicas. Puedes usar esta API para reducir el tiempo de inactividad en tu aplicación detectando funciones que no estén disponibles para luego saltearlas. Para ver el contenido del paquete capability, consulta la referencia del paquete capability. .

Esta API es compatible con entornos de ejecución de primera generación y se puede usar en actualizaciones a los entornos de ejecución de segunda generación correspondientes. Si actualizas al entorno de ejecución de Go 1.12+ de App Engine, consulta la guía de migración para obtener información sobre tus opciones de migración para servicios empaquetados heredados.

Cada solicitud de estado a esta API siempre muestra ENABLED, excepto la función “Operaciones de escritura de Datastore”, que muestra DISABLED si Datastore está en modo de solo lectura en tu app.

Por ejemplo, si usas la API de Datastore, puedes utilizar la API de Funciones para detectar cuándo la API de Datastore no está disponible e informar sobre el error al usuario.

func handler(w http.ResponseWriter, r *http.Request) {
	ctx := appengine.NewContext(r)
	// Check if the Datastore API is available
	if !capability.Enabled(ctx, "datastore_v3", "*") {
		http.Error(w, "This service is currently unavailable.", 503)
		return
	}
	// do Datastore lookup ...
}

Puedes consultar por separado si hay disponibilidad de operaciones de lectura y escritura en Datastore. El ejemplo que aparece a continuación muestra cómo detectar la disponibilidad de opciones de escritura en Datastore y cómo enviar un mensaje a los usuarios durante el tiempo de inactividad:

func checkDatastoreMode(w http.ResponseWriter, r *http.Request) {
	ctx := appengine.NewContext(r)
	// Check if the Datastore service is in read-only mode.
	if !capability.Enabled(ctx, "datastore_v3", "write") {
		// Datastore is in read-only mode.
	}

}

Usa la API de funciones en Go 1.11

La función capability.Enabled muestra “true” si la API y la función proporcionadas están disponibles. Debes pasar un nombre de función (como "write") o el comodín "*" para consultar todas las funciones de la API.

Funciones compatibles

Por el momento, la API admite las siguientes funciones:

Función	Argumentos para Enabled
Disponibilidad de Blobstore	"blobstore", "*"
Opciones de lectura de Datastore	"datastore_v3", "*"
Opciones de escritura de Datastore	"datastore_v3", "write"
Disponibilidad del servicio de correo	"mail", "*"
Disponibilidad del servicio de Memcache	"memcache", "*"
Disponibilidad del servicio de lista de tareas en cola	"taskqueue", "*"
Disponibilidad del servicio de recuperación de URL	"urlfetch", "*"