API Capabilities per servizi in bundle legacy

Con l'API Capabilities, l'applicazione può rilevare interruzioni e tempi di inattività pianificati per funzionalità dell'API specifiche. Puoi utilizzare questa API per ridurre i tempi di inattività nell'applicazione rilevando quando una funzionalità non è disponibile e quindi ignorandola. Per visualizzare i contenuti del pacchetto capability, consulta il riferimento al 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 separatamente sulla disponibilità di letture e scritture Datastore. Il seguente esempio mostra come rilevare la disponibilità delle scritture Datastore e, durante il tempo di inattività, 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 sono disponibili l'API e la funzionalità fornite. Devi passare un nome di funzionalità (ad esempio "write") o il carattere jolly "*" per eseguire query su tutte le funzionalità dell'API.

Funzionalità supportate

L'API attualmente supporta le seguenti funzionalità:

Capacità Argomenti da Enabled
Disponibilità dell'archivio BLOB "blobstore", "*"
Letture Datastore "datastore_v3", "*"
Scritture datastore "datastore_v3", "write"
Disponibilità del servizio di posta "mail", "*"
Disponibilità del servizio Memcache "memcache", "*"
Disponibilità del servizio Task Queue "taskqueue", "*"
Disponibilità del servizio di recupero URL "urlfetch", "*"