Guide de migration de l'API Cloud Functions
L'API Cloud Functions v1beta2 est obsolète. Pour éviter toute interruption de service potentielle, utilisez plutôt l'API Cloud Functions v1. Cette page fournit des instructions pour la migration de l'API Cloud Functions v1beta2 vers l'API Cloud Functions v1.
CLI gcloud
Les clients qui utilisent Google Cloud CLI doivent effectuer la mise à niveau vers la version la plus récente de gcloud
en exécutant la commande suivante dans un terminal :
gcloud components update
Pour plus de détails, consultez la documentation de référence sur la mise à jour des composants gcloud.
CLI Firebase
Les clients qui utilisent la CLI Firebase doivent effectuer la mise à niveau vers sa version la plus récente. Pour plus de détails, consultez la documentation de référence associée à la CLI Firebase.
API
Les clients qui utilisent l'API directement à l'aide des bibliothèques clientes de l'API Google doivent utiliser les bibliothèques basées sur l'API Cloud Functions v1 :
Bibliothèque cliente de l'API Google Cloud Functions pour Java
Bibliothèque cliente de l'API Google Cloud Functions pour Python
Bibliothèque cliente de l'API Google Cloud Functions pour C#
Bibliothèque cliente de l'API Google Cloud Functions pour Ruby
Les différences entre l'API v1 et l'API v1beta2 sont minimes. Toutes les différences sont énumérées ci-dessous.
Deux nouveaux champs ont été ajoutés à l'API v1. Ces champs ne sont pas présents dans l'API v1beta2.
Champ de l'API v1 | Description |
---|---|
CloudFunction.description |
Permet de définir une description conviviale de la fonction Cloud Functions. |
CloudFunction.source_repository.deployed_url |
Permet d'afficher l'URL d'un dépôt source à partir du moment du déploiement. Fait référence à un ID de révision spécifique, même si le déploiement a eu lieu à partir d'une branche ou d'un tag. |
Quatre champs ont un nom différent dans l'API v1.
Champ de l'API v1beta2 | Champ de l'API v1 |
---|---|
CloudFunction.source_repository_url |
CloudFunction.source_repository.url |
CloudFunction.service_account |
CloudFunction.service_account_email |
ListFunctions.location |
ListFunctions.parent |
EventTrigger.retry_policy |
EventTrigger.failure_policy |
CloudFunction.last_operation
a été supprimé. Nous vous recommandons d'utiliser le service Operations
pour rechercher la dernière opération effectuée sur une fonction donnée.
La sémantique de mise à jour d'une fonction a été modifiée, passant de PUT
à PATCH
. La requête de mise à jour (UpdateFunctionRequest
) emploie deux paramètres : une fonction Cloud Functions et un masque de mise à jour.
Alors que l'API v1beta2 prend le nom de la fonction comme entrée, l'API v1 prend celui d'une instance CloudFunction
. Le masque de mise à jour contient la liste de tous les champs à mettre à jour. Le nom de la fonction est extrait de l'instance CloudFunction
et n'a plus besoin d'être explicitement fourni.
Vous pouvez essayer la nouvelle API en utilisant l'explorateur d'API.