Mettre à niveau l'API Admin de Google App Engine vers la dernière version

À partir de cette page, vous pouvez mettre à jour vos applications afin d'utiliser la version v1 de l'API Admin. Les versions v1beta4 et v1beta5 de l'API ne sont plus compatibles et ont été supprimées le 14 janvier 2019.

Mettre à niveau vos applications vers la dernière version

Pour passer à la dernière version de l'API Admin, vous devez apporter des modifications au code de votre application.

La version v1 de l'API comporte quelques modifications importantes, dues à des ressources obsolètes ou qui ont été renommées. Les modifications apportées à la version v1 affectent les champs et les méthodes de toutes les ressources de l'API, y compris :

Servez-vous des listes suivantes pour identifier les champs et les méthodes obsolètes ou renommés dans la version v1 de l'API.

Les listes suivantes ne décrivent pas spécifiquement les modifications apportées aux bibliothèques clientes. Toutefois, ces listes vous permettent de déterminer où sont requises les modifications de votre application.

Applications

Pour les ressources Applications, vous devez apporter les modifications suivantes :

Instances

Pour les ressources Instances, vous devez apporter les modifications suivantes :

  • Pour l'API REST :

    • Vous devez maintenant utiliser les champs startTime et vmDebugEnabled avec la ressource apps.services.versions.instances. Par exemple :

      startTimestamp → startTime

      vmUnlocked → vmDebugEnabled

    • Vous devez maintenant utiliser le champ parent avec la ressource apps.services.versions.instances. Par exemple :

      name → parent

    • Pour la version v1beta4 uniquement : toutes les références aux modules sont désormais des services. Avec la version v1, vous devez maintenant utiliser la ressource services. Par exemple : apps.services.versions.instances

      apps.modules.versions.instances → apps.services.versions.instances

      Pour en savoir plus, reportez-vous à la section Services ci-dessous.

  • Pour l'API RPC :

    • Vous devez maintenant utiliser les champs start_time et vm_debug_enabled avec la ressource google.appengine.v1.Instance. Par exemple :

      start_timestamp → start_time

      vm_unlocked → vm_debug_enabled

    • Vous devez maintenant utiliser le champ parent avec la ressource google.appengine.v1.ListInstancesRequest. Par exemple :

      name → parent

    • Pour la version v1beta4 uniquement : toutes les références au module ont été remplacées par la ressource service.

      Pour en savoir plus, reportez-vous à la section Services ci-dessous.

Services

Pour les ressources Services, vous devez apporter les modifications suivantes :

  • Pour l'API REST :

    • Vous devez maintenant utiliser le champ parent avec la ressource apps.services. Par exemple :

      name → parent

    • Vous devez maintenant utiliser le paramètre updateMask avec la méthode apps.services.patch. Par exemple :

      mask → updateMask

    • Pour la version v1beta4 uniquement : toutes les références aux modules sont désormais des services. Avec la version v1, vous devez maintenant utiliser la ressource services. Par exemple :

      apps.modules.delete → apps.services.delete

      apps.modules.get → apps.services.get

      apps.modules.list → apps.services.list

      apps.modules.patch → apps.services.patch

  • Pour l'API RPC :

    • Vous devez maintenant utiliser le champ parent avec la ressource google.appengine.v1.ListServicesRequest. Par exemple :

      name → parent

    • Vous devez maintenant utiliser le champ updateMask avec la ressource google.appengine.v1.UpdateServicesRequest. Par exemple :

      mask → update_mask

    • Pour la version v1beta4 uniquement : toutes les références aux modules sont désormais des services. Avec la version v1, vous devez maintenant utiliser l'interface Services. Par exemple :

      DeleteModule → DeleteService

      GetModule → GetService

      ListModules → ListServices

      UpdateModule → UpdateServices

Versions

Pour les ressources Versions, vous devez apporter les modifications suivantes :

Déploiement

Les champs suivants ont été supprimés :

DiskUtilization

Les champs suivants ont été modifiés :

  • Pour l'API REST :

    Vous devez maintenant utiliser les champs targetWriteBytesPerSecond, targetWriteOpsPerSecond, targetReadBytesPerSecond et targetReadOpsPerSecond avec les ressources apps.services.versions. Par exemple :

    targetWriteBytesPerSec → targetWriteBytesPerSecond

    targetWriteOpsPerSec → targetWriteOpsPerSecond

    targetReadBytesPerSec → targetReadBytesPerSecond

    targetReadOpsPerSec → targetReadOpsPerSecond

  • Pour l'API RPC :

    Vous devez maintenant utiliser les champs target_write_bytes_per_second, target_write_ops_per_second, target_read_bytes_per_second et target_read_ops_per_second avec la ressource google.appengine.v1.DiskUtilization. Par exemple :

    target_write_bytes_per_sec → target_write_bytes_per_second

    target_write_ops_per_sec → target_write_ops_per_second

    target_read_bytes_per_sec → target_read_bytes_per_second

    target_read_ops_per_sec → target_read_ops_per_second

NetworkUtilization

Les champs suivants ont été modifiés :

  • Pour l'API REST :

    Vous devez maintenant utiliser les champs targetSentBytesPerSecond, targetSentPacketsPerSecond, targetReceivedBytesPerSecond et targetReceivedPacketsPerSecond avec la ressource apps.services.versions. Par exemple :

    targetSentBytesPerSec → targetSentBytesPerSecond

    targetSentPacketsPerSec → targetSentPacketsPerSecond

    targetReceivedBytesPerSec → targetReceivedBytesPerSecond

    targetReceivedPacketsPerSec → targetReceivedPacketsPerSecond

  • Pour l'API RPC :

    Vous devez maintenant utiliser les champs target_sent_bytes_per_second, target_sent_packets_per_second, target_received_bytes_per_second et target_received_packets_per_second avec la ressource google.appengine.v1.NetworkUtilization. Par exemple :

    target_sent_bytes_per_sec → target_sent_bytes_per_second

    target_sent_packets_per_sec → target_sent_packets_per_second

    target_received_bytes_per_sec → target_received_bytes_per_second

    target_received_packets_per_sec → target_received_packets_per_second

OperationMetadataV1

Les champs suivants ont été modifiés :

  • Vous devez maintenant utiliser le champ method avec la ressource google.appengine.v1.OperationMetadataV1. Par exemple :

    operation_type → method

  • Vous devez maintenant utiliser le champ OperationMetadataV1 avec la ressource google.appengine.v1.OperationMetadataV1 :

    • Pour la version v1beta4, remplacez OperationMetadata. Par exemple :

      OperationMetadata → OperationMetadataV1

    • Pour la version v1beta5, remplacez OperationMetadataV1Beta5. Par exemple :

      OperationMetadataV1Beta5 → OperationMetadataV1

RequestUtilization

Les champs suivants ont été supprimés :

  • Pour l'API REST :

    Vous devez maintenant utiliser le champ target_request_count_per_second avec la ressource apps.services.versions. Par exemple :

    targetRequestCountPerSec → targetRequestCountPerSecond

  • Pour l'API RPC :

    Vous devez maintenant utiliser le champ target_request_count_per_second avec la ressource google.appengine.v1.RequestUtilization. Par exemple :

    target_request_count_per_sec → target_request_count_per_second

UrlDispatchRule

Vous devez maintenant utiliser le champ service avec la ressource de l'API REST apps et la ressource RPC google.appengine.v1.UrlDispatchRule. Par exemple :

UrlDispatchRule.module → UrlDispatchRule.service

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

API App Engine Admin