API Capabilities pour les anciens services groupés
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Avec l'API Capabilities, votre application peut détecter les pannes et les temps d'arrêt planifiés pour des fonctionnalités d'API spécifiques. Vous pouvez utiliser cette API pour réduire les temps d'arrêt de votre application en détectant le moment où une fonctionnalité n'est pas disponible et en la désactivant. .
Par exemple, si vous passez par l'API Images pour redimensionner des images, vous pouvez utiliser l'API Capabilities pour détecter à quel moment l'API Images n'est pas disponible et ignorer le redimensionnement :
Vous pouvez interroger séparément la disponibilité des opérations de lecture et d'écriture dans Datastore. L'exemple suivant montre comment procéder et comment envoyer un message aux utilisateurs lors des temps d'arrêt :
CapabilityStatusstatus=service.getStatus(Capability.DATASTORE_WRITE).getStatus();if(status==CapabilityStatus.DISABLED){// Datastore is in read-only mode.}
Utiliser l'API Capabilities dans Java 8
Chaque capacité est représentée sous la forme d'une constante statique dans la classe Capability, telle que Capability.DATASTORE_WRITE.
Chaque capacité est associée à un état que vous pouvez extraire de CapabilitiesService.getStatus(Capability).
Chaque état possède un statut, qui est une énumération reflétant la disponibilité d'une capacité : ENABLED ou DISABLED. Consultez ci-dessous la liste des services actuellement activés dans cette API.
Fonctionnalités proposées
L'API propose actuellement les fonctionnalités suivantes :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThe Capabilities API allows applications to detect outages and scheduled downtime for specific API capabilities, helping to minimize application downtime by bypassing unavailable services.\u003c/p\u003e\n"],["\u003cp\u003eThis API supports first-generation runtimes and can be utilized when upgrading to corresponding second-generation runtimes, with specific migration guidance provided for Java 11/17 runtimes.\u003c/p\u003e\n"],["\u003cp\u003eThe API returns an \u003ccode\u003eENABLED\u003c/code\u003e status for all services except "Datastore writes," which returns \u003ccode\u003eDISABLED\u003c/code\u003e when Datastore is in read-only mode.\u003c/p\u003e\n"],["\u003cp\u003eYou can query the availability of Datastore reads and writes separately, enabling you to handle read-only mode scenarios by displaying a custom message to users.\u003c/p\u003e\n"],["\u003cp\u003eThe API can verify the status of services like BLOBSTORE, Datastore, Images, Mail, Memcache, Task Queue, and URL Fetch, allowing for more fault-tolerant applications.\u003c/p\u003e\n"]]],[],null,["# Capabilities API for legacy bundled services\n\nWith the Capabilities API, your application can detect outages and scheduled\ndowntime for specific [API capabilities](#Supported_capabilities). You can use\nthis API to reduce downtime in your application by detecting when a capability\nis unavailable and then bypassing it. .\n| This API is supported for first-generation runtimes and can be used when [upgrading to corresponding second-generation runtimes](/appengine/docs/standard/\n| java-gen2\n|\n| /services/access). If you are updating to the App Engine Java 11/17 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/java-differences) to learn about your migration options for legacy bundled services.\n| Every status request to this API always returns `ENABLED` except\n| for the \"Datastore writes\" capability, which returns `DISABLED` if\n| Datastore is in read-only mode for your app.\n\nFor example, if you use the Images API to resize images, you can use the\nCapabilities API to detect when the Images API is unavailable and skip the\nresize: \n\n import com.google.appengine.api.capabilities.*;\n\n https://cloud.google.com/appengine/docs/standard/java-gen2/reference/services/bundled/latest/com.google.appengine.api.capabilities.CapabilitiesService.html service =\n https://cloud.google.com/appengine/docs/standard/java-gen2/reference/services/bundled/latest/com.google.appengine.api.capabilities.CapabilitiesServiceFactory.html.getCapabilitiesService();\n https://cloud.google.com/appengine/docs/standard/java-gen2/reference/services/bundled/latest/com.google.appengine.api.capabilities.CapabilityStatus.html status = service.https://cloud.google.com/appengine/docs/standard/java-gen2/reference/services/bundled/latest/com.google.appengine.api.capabilities.CapabilitiesService.html#com_google_appengine_api_capabilities_CapabilitiesService_getStatus_com_google_appengine_api_capabilities_Capability_(Capability.IMAGES).getStatus();\n\n if (status == https://cloud.google.com/appengine/docs/standard/java-gen2/reference/services/bundled/latest/com.google.appengine.api.capabilities.CapabilityStatus.html.DISABLED) {\n // Images API is not available.\n }\n\nYou can separately query for the availability of Datastore reads and writes. The\nfollowing sample shows how to detect the availability of Datastore writes and,\nduring downtime, provide a message to users: \n\n CapabilityStatus status =\n service.getStatus(Capability.DATASTORE_WRITE).getStatus();\n\n if (status == CapabilityStatus.DISABLED) {\n // Datastore is in read-only mode.\n }\n\nUsing the Capabilities API in Java 8\n------------------------------------\n\nEach Capability is represented as a static constant on the Capability class,\nsuch as\n[`Capability.DATASTORE_WRITE`](/appengine/docs/legacy/standard/java/javadoc/com/google/appengine/api/capabilities/Capability#DATASTORE_WRITE).\nEach Capability has a state, which you can retrieve from\n[`CapabilitiesService.getStatus(Capability)`](/appengine/docs/legacy/standard/java/javadoc/com/google/appengine/api/capabilities/CapabilitiesService#getStatus-com.google.appengine.api.capabilities.Capability-).\nEach state has a status, which is an enumeration reflecting a the availability\nof a capability: either `ENABLED` or `DISABLED`. See below for the\n[list of services](#Supported_capabilities) currently enabled in this API.\n\nSupported capabilities\n----------------------\n\nThe API currently supports the following capabilities:"]]
