將 Google App Engine Admin API 升級至最新版本

如要使用 Admin API 的 v1 版本,請使用本頁面升級您的應用程式。系統不再支援 API 的 v1beta4v1beta5 版本,並排定於 2019 年 1 月 14 日進行關閉。

將應用程式升級至最新版本

如要要升級至最新版本的 Admin API,您必須對應用程式的程式碼進行一些變更。

由於資源已遭淘汰或重新命名,API 的 v1 版本會有幾項重大變更,且 v1 版本的變更會影響 API 中所有資源的欄位和方法,包括:

使用下列清單,瞭解 API v1 版本中已遭淘汰或重新命名的欄位和方法。

對於用戶端程式庫,下列清單並無具體概述任一程式庫的變更,但建議您利用這些清單來判斷應用程式需要的變更。

應用程式

您必須對 Applications 資源進行下列變更:

執行個體

您必須對 Instances 資源進行下列變更:

  • 針對 REST API:

    • 您現在必須將 startTimevmDebugEnabled 欄位與 apps.services.versions.instances 資源搭配使用,例如:

      startTimestampstartTime

      vmUnlockedvmDebugEnabled

    • 您現在必須將 parent 欄位與 apps.services.versions.instances 資源搭配使用,例如:

      nameparent

    • 僅適用於 v1beta4:所有對 modules 的參照目前都是 services。在 v1 中,您現在必須使用 services 資源,例如:apps.services.versions.instances

      apps.modules.versions.instancesapps.services.versions.instances

      詳情請參閱下方的服務一節。

  • 針對 RPC API:

    • 您現在必須將 start_timevm_debug_enabled 欄位與 google.appengine.v1.Instance 資源搭配使用,例如:

      start_timestampstart_time

      vm_unlockedvm_debug_enabled

    • 您現在必須將 parent 欄位與 google.appengine.v1.ListInstancesRequest 資源搭配使用,例如:

      nameparent

    • 僅適用於 v1beta4:所有對 module 的參照都已替換成 service 資源。

      詳情請參閱下方的服務一節。

服務

您必須對 Services 資源進行下列變更:

  • 針對 REST API:

    • 您現在必須將 parent 欄位與 apps.services 資源搭配使用,例如:

      nameparent

    • 您現在必須將 updateMask 參數與 apps.services.patch 方法搭配使用,例如:

      maskupdateMask

    • 僅適用於 v1beta4:所有對 modules 的參照目前都是 services。在 v1 中,您現在必須使用 services 資源,例如:

      apps.modules.deleteapps.services.delete

      apps.modules.getapps.services.get

      apps.modules.listapps.services.list

      apps.modules.patchapps.services.patch

  • 針對 RPC API:

    • 您現在必須將 parent 欄位與 google.appengine.v1.ListServicesRequest 資源搭配使用,例如:

      nameparent

    • 您現在必須將 updateMask 欄位與 google.appengine.v1.UpdateServicesRequest 資源搭配使用,例如:

      maskupdate_mask

    • 僅適用於 v1beta4:所有對 modules 的參照目前都是 services。在 v1 中,您現在必須使用 Services 介面,例如:

      DeleteModuleDeleteService

      GetModuleGetService

      ListModulesListServices

      UpdateModuleUpdateServices

版本

您必須對 Versions 資源進行下列變更:

部署

下列欄位已遭移除:

磁碟使用率

下列欄位已遭變更:

  • 針對 REST API:

    您現在必須將 targetWriteBytesPerSecondtargetWriteOpsPerSecondtargetReadBytesPerSecondtargetReadOpsPerSecond 欄位與 apps.services.versions 資源搭配使用,例如:

    targetWriteBytesPerSectargetWriteBytesPerSecond

    targetWriteOpsPerSectargetWriteOpsPerSecond

    targetReadBytesPerSectargetReadBytesPerSecond

    targetReadOpsPerSectargetReadOpsPerSecond

  • 針對 RPC API:

    您現在必須將 target_write_bytes_per_secondtarget_write_ops_per_secondtarget_read_bytes_per_secondtarget_read_ops_per_second 欄位與 google.appengine.v1.DiskUtilization 資源搭配使用,例如:

    target_write_bytes_per_sectarget_write_bytes_per_second

    target_write_ops_per_sectarget_write_ops_per_second

    target_read_bytes_per_sectarget_read_bytes_per_second

    target_read_ops_per_sectarget_read_ops_per_second

網路使用率

下列欄位已遭變更:

  • 針對 REST API:

    您現在必須將 targetSentBytesPerSecondtargetSentPacketsPerSecondtargetReceivedBytesPerSecondtargetReceivedPacketsPerSecondapps.services.versions 資源搭配使用,例如:

    targetSentBytesPerSectargetSentBytesPerSecond

    targetSentPacketsPerSectargetSentPacketsPerSecond

    targetReceivedBytesPerSectargetReceivedBytesPerSecond

    targetReceivedPacketsPerSectargetReceivedPacketsPerSecond

  • 針對 RPC API:

    您現在必須使用 target_sent_bytes_per_secondtarget_sent_packets_per_secondtarget_received_bytes_per_secondtarget_received_packets_per_second 欄位與 google.appengine.v1.NetworkUtilization 資源搭配使用,例如:

    target_sent_bytes_per_sectarget_sent_bytes_per_second

    target_sent_packets_per_sectarget_sent_packets_per_second

    target_received_bytes_per_sectarget_received_bytes_per_second

    target_received_packets_per_sectarget_received_packets_per_second

作業中繼資料 V1

下列欄位已遭變更:

  • 您現在必須將 method 欄位與 google.appengine.v1.OperationMetadataV1 資源搭配使用,例如:

    operation_typemethod

  • 您現在必須將 OperationMetadataV1 欄位與 google.appengine.v1.OperationMetadataV1 資源搭配使用:

    • 針對 v1beta4,請替換 OperationMetadata,例如:

      OperationMetadataOperationMetadataV1

    • 針對 v1beta5,請替換 OperationMetadataV1Beta5,例如:

      OperationMetadataV1Beta5OperationMetadataV1

要求使用率

下列欄位已遭移除:

  • 針對 REST API:

    您現在必須將 target_request_count_per_second 欄位與 apps.services.versions 資源搭配使用,例如:

    targetRequestCountPerSectargetRequestCountPerSecond

  • 針對 RPC API:

    您現在必須將 target_request_count_per_second 欄位與 google.appengine.v1.RequestUtilization 資源搭配使用,例如:

    target_request_count_per_sectarget_request_count_per_second

網址分派規則

您現在必須將 service 欄位與 apps REST API 資源和 google.appengine.v1.UrlDispatchRule 遠端程序呼叫 (RPC) 資源搭配使用,例如:

UrlDispatchRule.moduleUrlDispatchRule.service

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
App Engine Admin API