API Capabilities per servizi in bundle legacy

Con l'API Capabilities, la tua applicazione può rilevare interruzioni e tempi di inattività programmati per specifiche funzionalità dell'API. Puoi utilizzare questa API per ridurre i tempi di inattività della tua applicazione rilevando quando una funzionalità non è disponibile e poi bypassandola. Per visualizzare i contenuti del pacchetto capability, consulta la pagina di riferimento del pacchetto capability. .

Ad esempio, se utilizzi l'API Datastore, puoi utilizzare l'API Capabilities per rilevare quando l'API Datastore non è disponibile e segnalare un errore all'utente:

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 ...
}

Puoi eseguire query separate per verificare la disponibilità delle letture e delle scritture di Datastore. L'esempio seguente mostra come rilevare la disponibilità delle scritture in Datastore e, durante il tempo di riposo, fornire un messaggio agli utenti:

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.
	}

}

Utilizzo dell'API Capabilities in Go 1.11

La funzione capability.Enabled restituisce true se l'API e la funzionalità fornite sono disponibili. Devi passare un nome di funzionalità (ad esempio "write") o il carattere jolly "*" per eseguire query su tutte le funzionalità dell'API.

Funzionalità supportate

Al momento l'API supporta le seguenti funzionalità:

Capacità Argomenti per Enabled
Disponibilità del blobstore "blobstore", "*"
Letture del datastore "datastore_v3", "*"
Scritture datastore "datastore_v3", "write"
Disponibilità del servizio Posta "mail", "*"
Disponibilità del servizio Memcache "memcache", "*"
Disponibilità del servizio Task Queue "taskqueue", "*"
Disponibilità del servizio di recupero URL "urlfetch", "*"