将 App Engine Admin API 升级到最新版本

使用此页面升级您的应用，以使用 Admin API 的 v1 版本。API 的 v1beta4 和 v1beta5 版本不再受支持，计划于 2019 年 1 月 14 日关停。

将应用升级到最新版本

如需升级到最新的 Admin API 版本，您必须对应用的代码进行某些更改。

由于已弃用或重命名的资源，API 的 v1 版本发生了一些重大更改。v1 版本的更改会影响 API 中所有资源的字段和方法，包括：

您可以通过以下列表了解 API 的 v1 版本中已弃用或重命名的字段和方法。

对于客户端库，以下列表没有具体概述任何库的更改。但您应该使用这些列表来确定需要对应用进行哪些更改。

应用

对于 Applications 资源，您必须进行如下更改：

对于 REST API：
- 现在必须将 updateMask 参数用于 apps.patch 方法，例如：
  
  mask → updateMask
- ensureResourcesExist 参数已从 apps.get 方法中移除。在 v1 中，您可以改用 apps.repair 方法。
对于 RPC API：
- 现在必须将 location_id 字段用于 google.appengine.v1.Application 资源，例如：
  
  location → location_id
- 现在必须将 update_mask 字段用于 google.appengine.v1.UpdateApplicationRequest 资源，例如：
  
  mask → update_mask
- ensure_resources_exist 字段已从 google.appengine.v1.GetApplicationRequest 资源中移除。您可以改为使用 RepairApplication 方法。

实例

对于 Instances 资源，您必须进行如下更改：

对于 REST API：
- 现在必须将 startTime 和 vmDebugEnabled 字段用于 apps.services.versions.instances 资源，例如：
  
  startTimestamp → startTime
  
  vmUnlocked → vmDebugEnabled
- 现在必须将 parent 字段用于 apps.services.versions.instances 资源，例如：
  
  name → parent
- 仅针对 v1beta4：所有对 modules 的引用都已替换为 services。在 v1 中，现在必须使用 services 资源，例如：apps.services.versions.instances
  
  apps.modules.versions.instances → apps.services.versions.instances
  
  请参阅下面的服务部分了解详情。
对于 RPC API：
- 现在必须将 start_time 和 vm_debug_enabled 字段用于 google.appengine.v1.Instance 资源，例如：
  
  start_timestamp → start_time
  
  vm_unlocked → vm_debug_enabled
- 现在必须将 parent 字段用于 google.appengine.v1.ListInstancesRequest 资源，例如：
  
  name → parent
- 仅针对 v1beta4：所有对 module 的引用都已替换为 service 资源。
  
  请参阅下面的服务部分了解详情。

服务

对于 Services 资源，您必须进行如下更改：

对于 REST API：
- 现在必须将 parent 字段用于 apps.services 资源，例如：
  
  name → parent
- 现在必须将 updateMask 参数用于 apps.services.patch 方法，例如：
  
  mask → updateMask
- 仅针对 v1beta4：所有对 modules 的引用都已替换为 services。在 v1 中，现在必须使用 services 资源，例如：
  
  apps.modules.delete → apps.services.delete
  
  apps.modules.get → apps.services.get
  
  apps.modules.list → apps.services.list
  
  apps.modules.patch → apps.services.patch
对于 RPC API：
- 现在必须将 parent 字段用于 google.appengine.v1.ListServicesRequest 资源，例如：
  
  name → parent
- 现在必须将 updateMask 字段用于 google.appengine.v1.UpdateServicesRequest 资源，例如：
  
  mask → update_mask
- 仅针对 v1beta4：所有对 modules 的引用都已替换为 services。在 v1 中，现在必须使用 Services 接口，例如：
  
  DeleteModule → DeleteService
  
  GetModule → GetService
  
  ListModules → ListServices
  
  UpdateModule → UpdateServices

版本

对于 Versions 资源，您必须进行如下更改：

对于 REST API：
- 现在必须将 parent 字段用于 apps.services.versions 资源，例如：
  
  name → parent
- 现在必须将 updateMask 参数用于 apps.services.versions.patch 方法，例如：
  
  mask → updateMask
- 仅针对 v1beta4：所有对 modules 的引用都已替换为 services。在 v1 中，现在必须使用 services 资源，例如：
  
  apps.modules.versions → apps.services.versions
对于 RPC API：
- 现在必须将 created_by 和 created_time 字段用于 google.appengine.v1.Version 接口，例如：
  
  deployer → created_by
  
  created_by → create_time
- 现在必须将 parent 字段用于 google.appengine.v1.CreateVersionRequest 和 google.appengine.v1.ListVersionsRequest 资源，例如：
  
  name → parent
- 现在必须将 updateMask 字段用于 google.appengine.v1.UpdateVersionRequest 资源，例如：
  
  mask → update_mask

部署

已移除以下字段：

对于 REST API：

sourceReferences 字段已被弃用，并从 apps.services.versions 资源中移除。
对于 RPC API：

source_references 字段已被弃用，并从 google.appengine.v1.Deployment 资源中移除。

DiskUtilization

已更改以下字段：

对于 REST API：

现在必须将 targetWriteBytesPerSecond、targetWriteOpsPerSecond、targetReadBytesPerSecond、targetReadOpsPerSecond 字段用于 apps.services.versions 资源，例如：

targetWriteBytesPerSec → targetWriteBytesPerSecond

targetWriteOpsPerSec → targetWriteOpsPerSecond

targetReadBytesPerSec → targetReadBytesPerSecond

targetReadOpsPerSec → targetReadOpsPerSecond
对于 RPC API：

现在必须将 target_write_bytes_per_second、target_write_ops_per_second、target_read_bytes_per_second、target_read_ops_per_second 字段用于 google.appengine.v1.DiskUtilization 资源，例如：

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

已更改以下字段：

对于 REST API：

现在必须将 targetSentBytesPerSecond、targetSentPacketsPerSecond、targetReceivedBytesPerSecond、targetReceivedPacketsPerSecond 字段用于 apps.services.versions 资源，例如：

targetSentBytesPerSec → targetSentBytesPerSecond

targetSentPacketsPerSec → targetSentPacketsPerSecond

targetReceivedBytesPerSec → targetReceivedBytesPerSecond

targetReceivedPacketsPerSec → targetReceivedPacketsPerSecond
对于 RPC API：

现在必须将 target_sent_bytes_per_second、target_sent_packets_per_second、target_received_bytes_per_second、target_received_packets_per_second 字段用于 google.appengine.v1.NetworkUtilization 资源，例如：

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

以下字段已更改：

现在必须将 method 字段用于 google.appengine.v1.OperationMetadataV1 资源，例如：

operation_type → method
现在必须将 OperationMetadataV1 字段用于 google.appengine.v1.OperationMetadataV1 资源：
- 对于 v1beta4，请替换 OperationMetadata，例如：
  
  OperationMetadata → OperationMetadataV1
- 对于 v1beta5，请替换 OperationMetadataV1Beta5，例如：
  
  OperationMetadataV1Beta5 → OperationMetadataV1

RequestUtilization

以下字段已更改：

对于 REST API：

现在必须将 targetRequestCountPerSecond 字段用于 apps.services.versions 资源，例如：

targetRequestCountPerSec → targetRequestCountPerSecond
对于 RPC API：

现在必须将 target_request_count_per_second 字段用于 google.appengine.v1.RequestUtilization 资源，例如：

target_request_count_per_sec → target_request_count_per_second

UrlDispatchRule

现在必须将 service 字段用于 apps REST API 资源和 google.appengine.v1.UrlDispatchRule RPC 资源，例如：

UrlDispatchRule.module → UrlDispatchRule.service