Mengupgrade App Engine Admin API ke Rilis Terbaru

Gunakan halaman ini untuk mengupgrade aplikasi Anda agar dapat menggunakan Admin API versi v1. API versi v1beta4 dan v1beta5 tidak lagi didukung dan dijadwalkan untuk dinonaktifkan pada 14 Januari 2019.

Mengupgrade aplikasi ke versi terbaru

Untuk mengupgrade ke Admin API versi terbaru, Anda harus membuat beberapa perubahan pada kode aplikasi.

Versi v1 API memiliki beberapa perubahan yang dapat menyebabkan gangguan karena resource yang tidak digunakan lagi atau diganti namanya. Perubahan pada versi v1 memengaruhi kolom dan metode di semua resource dalam API, termasuk:

Gunakan daftar berikut untuk memahami kolom dan metode mana yang tidak digunakan lagi atau diganti namanya dalam API versi v1.

Untuk library klien, daftar berikut tidak secara khusus menguraikan perubahan untuk library mana pun. Namun, Anda harus menggunakan daftar ini untuk menentukan tempat perubahan pada aplikasi Anda yang diperlukan.

Aplikasi

Untuk resource Applications, Anda harus melakukan perubahan berikut:

Untuk REST API:
- Sekarang Anda harus menggunakan parameter updateMask dengan metode apps.patch, misalnya:
  
  mask → updateMask
- Parameter ensureResourcesExist telah dihapus dari metode apps.get. Dalam v1, Anda dapat menggunakan metode apps.repair.
Untuk RPC API:
- Sekarang Anda harus menggunakan kolom location_id dengan resource google.appengine.v1.Application, misalnya:
  
  location → location_id
- Sekarang Anda harus menggunakan kolom update_mask dengan resource google.appengine.v1.UpdateApplicationRequest, misalnya:
  
  mask → update_mask
- Kolom ensure_resources_exist telah dihapus dari resource google.appengine.v1.GetApplicationRequest. Sebagai gantinya, Anda dapat menggunakan metode RepairApplication.

Instance

Untuk resource Instances, Anda harus melakukan perubahan berikut:

Untuk REST API:
- Sekarang Anda harus menggunakan kolom startTime dan vmDebugEnabled dengan resource apps.services.versions.instances, misalnya:
  
  startTimestamp → startTime
  
  vmUnlocked → vmDebugEnabled
- Sekarang Anda harus menggunakan kolom parent dengan resource apps.services.versions.instances, misalnya:
  
  name → parent
- Khusus untuk v1beta4: Semua referensi ke modules sekarang menjadi services. Di v1, kini Anda harus menggunakan resource services, misalnya: apps.services.versions.instances
  
  apps.modules.versions.instances → apps.services.versions.instances
  
  Lihat bagian Layanan di bawah untuk informasi selengkapnya.
Untuk RPC API:
- Sekarang Anda harus menggunakan kolom start_time dan vm_debug_enabled dengan resource google.appengine.v1.Instance, misalnya:
  
  start_timestamp → start_time
  
  vm_unlocked → vm_debug_enabled
- Sekarang Anda harus menggunakan kolom parent dengan resource google.appengine.v1.ListInstancesRequest, misalnya:
  
  name → parent
- Khusus untuk v1beta4: Semua referensi ke module telah diganti dengan resource service.
  
  Lihat bagian Layanan di bawah untuk informasi selengkapnya.

Layanan

Untuk resource Services, Anda harus melakukan perubahan berikut:

Untuk REST API:
- Sekarang Anda harus menggunakan kolom parent dengan resource apps.services, misalnya:
  
  name → parent
- Sekarang Anda harus menggunakan parameter updateMask dengan metode apps.services.patch, misalnya:
  
  mask → updateMask
- Khusus untuk v1beta4: Semua referensi ke modules sekarang menjadi services. Di v1, kini Anda harus menggunakan resource services, misalnya:
  
  apps.modules.delete → apps.services.delete
  
  apps.modules.get → apps.services.get
  
  apps.modules.list → apps.services.list
  
  apps.modules.patch → apps.services.patch
Untuk RPC API:
- Sekarang Anda harus menggunakan kolom parent dengan resource google.appengine.v1.ListServicesRequest, misalnya:
  
  name → parent
- Sekarang Anda harus menggunakan kolom updateMask dengan resource google.appengine.v1.UpdateServicesRequest, misalnya:
  
  mask → update_mask
- Khusus untuk v1beta4: Semua referensi ke modules sekarang menjadi services. Di v1, Anda kini harus menggunakan antarmuka Services, misalnya:
  
  DeleteModule → DeleteService
  
  GetModule → GetService
  
  ListModules → ListServices
  
  UpdateModule → UpdateServices

Versi

Untuk resource Versions, Anda harus melakukan perubahan berikut:

Untuk REST API:
- Sekarang Anda harus menggunakan kolom parent dengan resource apps.services.versions, misalnya:
  
  name → parent
- Sekarang Anda harus menggunakan parameter updateMask dengan metode apps.services.versions.patch, misalnya:
  
  mask → updateMask
- Khusus untuk v1beta4: Semua referensi ke modules sekarang menjadi services. Di v1, kini Anda harus menggunakan resource services, misalnya:
  
  apps.modules.versions → apps.services.versions
Untuk RPC API:
- Anda sekarang harus menggunakan kolom created_by dan created_time dengan antarmuka google.appengine.v1.Version, misalnya:
  
  deployer → created_by
  
  created_by → create_time
- Sekarang Anda harus menggunakan kolom parent dengan resource google.appengine.v1.CreateVersionRequest dan google.appengine.v1.ListVersionsRequest, misalnya:
  
  name → parent
- Sekarang Anda harus menggunakan kolom updateMask dengan resource google.appengine.v1.UpdateVersionRequest, misalnya:
  
  mask → update_mask

Deployment

Kolom berikut telah dihapus:

Untuk REST API:

Kolom sourceReferences tidak digunakan lagi dan dihapus dari resource apps.services.versions.
Untuk RPC API:

Kolom source_references tidak digunakan lagi dan dihapus dari resource google.appengine.v1.Deployment.

DiskUtilization

Kolom berikut telah berubah:

Untuk REST API:

Sekarang Anda harus menggunakan kolom targetWriteBytesPerSecond, targetWriteOpsPerSecond, targetReadBytesPerSecond, dan targetReadOpsPerSecond dengan resource apps.services.versions, misalnya:

targetWriteBytesPerSec → targetWriteBytesPerSecond

targetWriteOpsPerSec → targetWriteOpsPerSecond

targetReadBytesPerSec → targetReadBytesPerSecond

targetReadOpsPerSec → targetReadOpsPerSecond
Untuk RPC API:

Anda sekarang harus menggunakan atributtarget_write_bytes_per_second, target_write_ops_per_second, target_read_bytes_per_second, dan kolom target_read_ops_per_second dengan resource google.appengine.v1.DiskUtilization, misalnya:

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

Kolom berikut telah berubah:

Untuk REST API:

Sekarang Anda harus menggunakan kolom targetSentBytesPerSecond, targetSentPacketsPerSecond, targetReceivedBytesPerSecond, dan kolom targetReceivedPacketsPerSecond dengan resource apps.services.versions, misalnya:

targetSentBytesPerSec → targetSentBytesPerSecond

targetSentPacketsPerSec → targetSentPacketsPerSecond

targetReceivedBytesPerSec → targetReceivedBytesPerSecond

targetReceivedPacketsPerSec → targetReceivedPacketsPerSecond
Untuk RPC API:

Anda sekarang harus menggunakan atributtarget_sent_bytes_per_second, target_sent_packets_per_second, target_received_bytes_per_second, dan kolom target_received_packets_per_second dengan resource google.appengine.v1.NetworkUtilization, misalnya:

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

Kolom berikut telah berubah:

Sekarang Anda harus menggunakan kolom method dengan resource google.appengine.v1.OperationMetadataV1, misalnya:

operation_type → method
Sekarang Anda harus menggunakan kolom OperationMetadataV1 dengan resource google.appengine.v1.OperationMetadataV1:
- Untuk v1beta4, ganti OperationMetadata, misalnya:
  
  OperationMetadata → OperationMetadataV1
- Untuk v1beta5, ganti OperationMetadataV1Beta5, misalnya:
  
  OperationMetadataV1Beta5 → OperationMetadataV1

RequestUtilization

Kolom berikut telah berubah:

Untuk REST API:

Sekarang Anda harus menggunakan kolom targetRequestCountPerSecond dengan resource apps.services.versions, misalnya:

targetRequestCountPerSec → targetRequestCountPerSecond
Untuk RPC API:

Sekarang Anda harus menggunakan kolom target_request_count_per_second dengan resource google.appengine.v1.RequestUtilization, misalnya:

target_request_count_per_sec → target_request_count_per_second

UrlDispatchRule

Anda sekarang harus menggunakan atribut service dengan resource REST API apps dan resource RPC google.appengine.v1.UrlDispatchRule , misalnya:

UrlDispatchRule.module → UrlDispatchRule.service