ID de la région
Le REGION_ID est un code abrégé que Google attribue en fonction de la région que vous sélectionnez lors de la création de votre application. Le code ne correspond pas à un pays ou une province, même si certains ID de région peuvent ressembler aux codes de pays et de province couramment utilisés. Pour les applications créées après février 2020, REGION_ID.r est inclus dans les URL App Engine. Pour les applications existantes créées avant cette date, l'ID de région est facultatif dans l'URL.
En savoir plus sur les ID de région
Cette page explique comment envoyer des requêtes HTTP(S) depuis votre application App Engine à l'aide du service de récupération d'URL pour les environnements d'exécution de deuxième génération.
Avant de suivre les instructions de cette page, nous vous recommandons d'utiliser des solutions idiomatiques de langage pour émettre des requêtes HTTP(S) avant d'utiliser le service de récupération d'URL. Le principal cas d'utilisation de la récupération d'URL est lorsque vous souhaitez envoyer des requêtes HTTP(S) à une autre application App Engine et revendiquer l'identité de votre application sur cette requête.
Pour en savoir plus sur les limites de taille des requêtes et les en-têtes envoyés dans une requête de récupération d'URL, consultez Requêtes sortantes.
Émettre une requête HTTP
Pour émettre des requêtes HTTP(S) sortantes à l'aide du service de récupération d'URL, déclarez les bibliothèques URL Fetch.
Le langage PHP fournit plusieurs fonctions permettant de générer des requêtes HTTP à distance. Celles-ci sont mises en œuvre de différentes manières dans App Engine et sont soumises à divers quotas et coûts.
Consultez le guide Accéder aux anciens services groupés pour PHP pour obtenir des instructions sur l'utilisation des gestionnaires de flux.
Définir un délai avant expiration de la requête
Utilisez l'option timeout dans le contexte HTTP pour modifier le délai.
Désactiver les redirections
Si vous utilisez la récupération d'URL, le service de récupération d'URL sous-jacent suit jusqu'à cinq redirections par défaut. Ces redirections peuvent transférer des informations sensibles, telles que des en-têtes d'autorisation, vers la destination de redirection. Si votre application ne nécessite pas de redirections HTTP, il est recommandé de les désactiver.
Pour indiquer au service de récupération d'URL de ne pas suivre les redirections, l'application doit définir le paramètre follow_location dans les options de contexte HTTP sur false.
Émettre une requête HTTPS
Par défaut, le service de récupération d'URL sous-jacent valide le certificat de l'hôte qu'il contacte et refuse les requêtes si le certificat n'est pas conforme. Vous n'avez pas besoin de sécuriser explicitement votre demande.
Désactiver la validation du certificat de l'hôte
Par défaut, la mise en œuvre App Engine du wrapper HTTPS tente de valider le certificat de l'hôte et rejette les requêtes pour lesquelles le certificat ne correspond pas. Pour désactiver ce comportement, définissez la valeur de verify_peer sur false dans les options de contexte SSL/TLS.
Envoyer une requête à une autre application App Engine
Lorsque vous utilisez URL Fetch pour envoyer une requête à une autre application App Engine, votre application peut affirmer son identité en ajoutant l'en-tête X-Appengine-Inbound-Appid à la requête.
Si vous indiquez au service de récupération d'URL de ne pas suivre les redirections, App Engine ajoutera automatiquement cet en-tête aux requêtes. Consultez Désactiver les redirections pour des conseils sur la désactivation des redirections.
Étapes suivantes
Pour en savoir plus sur le service URL Fetch, y compris sur les en-têtes envoyés dans une requête URL Fetch, consultez la page Requêtes sortantes.