Upgrade dell'API App Engine Admin all'ultima release

Utilizza questa pagina per eseguire l'upgrade delle tue app alla versione v1 dell'API Admin. Le versioni v1beta4 e v1beta5 dell'API non sono più supportate e la loro disattivazione è prevista per il 14 gennaio 2019.

Upgrade delle app alla versione più recente

Per eseguire l'upgrade alla versione più recente dell'API Admin, devi apportare alcune modifiche al codice dell'app.

La versione v1 dell'API presenta alcune modifiche che provocano errori dovuti a risorse deprecate o rinominate. Le modifiche alla versione v1 influiscono sui campi e sui metodi di tutte le risorse dell'API, tra cui:

Utilizza i seguenti elenchi per capire quali campi e metodi sono stati deprecati o rinominati nella versione v1 dell'API.

Per le librerie client, i seguenti elenchi non descrivono in modo specifico le modifiche apportate alle librerie. Tuttavia, dovresti utilizzare questi elenchi per determinare dove sono necessarie modifiche alla tua app.

Applicazioni

Per Applications risorse, devi apportare le seguenti modifiche:

Per l'API REST:
- Ora devi utilizzare il parametro updateMask con il metodo apps.patch, ad esempio:
  
  mask → updateMask
- Il parametro ensureResourcesExist è stato rimosso dal metodo apps.get. In v1, puoi utilizzare invece il metodo apps.repair.
Per l'API RPC:
- Ora devi utilizzare il campo location_id con la risorsa google.appengine.v1.Application, ad esempio:
  
  location → location_id
- Ora devi utilizzare il campo update_mask con la risorsa google.appengine.v1.UpdateApplicationRequest, ad esempio:
  
  mask → update_mask
- Il campo ensure_resources_exist è stato rimosso dalla risorsa google.appengine.v1.GetApplicationRequest. In alternativa, puoi utilizzare il metodo RepairApplication.

Istanze

Per Instances risorse, devi apportare le seguenti modifiche:

Per l'API REST:
- Ora devi utilizzare i campi startTime e vmDebugEnabled con la risorsa apps.services.versions.instances, ad esempio:
  
  startTimestamp → startTime
  
  vmUnlocked → vmDebugEnabled
- Ora devi utilizzare il campo parent con la risorsa apps.services.versions.instances, ad esempio:
  
  name → parent
- Solo per v1beta4: tutti i riferimenti a modules ora sono services. In v1, ora devi utilizzare la risorsa services, ad esempio: apps.services.versions.instances
  
  apps.modules.versions.instances → apps.services.versions.instances
  
  Per saperne di più, consulta la sezione Servizi di seguito.
Per l'API RPC:
- Ora devi utilizzare i campi start_time e vm_debug_enabled con la risorsa google.appengine.v1.Instance, ad esempio:
  
  start_timestamp → start_time
  
  vm_unlocked → vm_debug_enabled
- Ora devi utilizzare il campo parent con la risorsa google.appengine.v1.ListInstancesRequest, ad esempio:
  
  name → parent
- Solo per v1beta4: tutti i riferimenti a module sono stati sostituiti con la risorsa service.
  
  Per saperne di più, consulta la sezione Servizi di seguito.

Servizi

Per Services risorse, devi apportare le seguenti modifiche:

Per l'API REST:
- Ora devi utilizzare il campo parent con la risorsa apps.services, ad esempio:
  
  name → parent
- Ora devi utilizzare il parametro updateMask con il metodo apps.services.patch, ad esempio:
  
  mask → updateMask
- Solo per v1beta4: tutti i riferimenti a modules ora sono services. In v1, ora devi utilizzare la risorsa services, ad esempio:
  
  apps.modules.delete → apps.services.delete
  
  apps.modules.get → apps.services.get
  
  apps.modules.list → apps.services.list
  
  apps.modules.patch → apps.services.patch
Per l'API RPC:
- Ora devi utilizzare il campo parent con la risorsa google.appengine.v1.ListServicesRequest, ad esempio:
  
  name → parent
- Ora devi utilizzare il campo updateMask con la risorsa google.appengine.v1.UpdateServicesRequest, ad esempio:
  
  mask → update_mask
- Solo per v1beta4: tutti i riferimenti a modules ora sono services. In v1, ora devi utilizzare l'interfaccia Services, ad esempio:
  
  DeleteModule → DeleteService
  
  GetModule → GetService
  
  ListModules → ListServices
  
  UpdateModule → UpdateServices

Versioni

Per Versions risorse, devi apportare le seguenti modifiche:

Per l'API REST:
- Ora devi utilizzare il campo parent con la risorsa apps.services.versions, ad esempio:
  
  name → parent
- Ora devi utilizzare il parametro updateMask con il metodo apps.services.versions.patch, ad esempio:
  
  mask → updateMask
- Solo per v1beta4: tutti i riferimenti a modules ora sono services. In v1, ora devi utilizzare la risorsa services, ad esempio:
  
  apps.modules.versions → apps.services.versions
Per l'API RPC:
- Ora devi utilizzare i campi created_by e created_time con l'interfaccia google.appengine.v1.Version, ad esempio:
  
  deployer → created_by
  
  created_by → create_time
- Ora devi utilizzare il campo parent con le risorse google.appengine.v1.CreateVersionRequest e google.appengine.v1.ListVersionsRequest, ad esempio:
  
  name → parent
- Ora devi utilizzare il campo updateMask con la risorsa google.appengine.v1.UpdateVersionRequest, ad esempio:
  
  mask → update_mask

Deployment

Sono stati rimossi i seguenti campi:

Per l'API REST:

Il campo sourceReferences è stato deprecato e rimosso dalla risorsa apps.services.versions.
Per l'API RPC:

Il campo source_references è stato deprecato e rimosso dalla risorsa google.appengine.v1.Deployment.

DiskUtilization

I seguenti campi sono stati modificati:

Per l'API REST:

Ora devi utilizzare i campi targetWriteBytesPerSecond, targetWriteOpsPerSecond, targetReadBytesPerSecond e targetReadOpsPerSecond con le risorse apps.services.versions, ad esempio:

targetWriteBytesPerSec → targetWriteBytesPerSecond

targetWriteOpsPerSec → targetWriteOpsPerSecond

targetReadBytesPerSec → targetReadBytesPerSecond

targetReadOpsPerSec → targetReadOpsPerSecond
Per l'API RPC:

Ora devi utilizzare i campi target_write_bytes_per_second, target_write_ops_per_second, target_read_bytes_per_second e target_read_ops_per_second con la risorsa google.appengine.v1.DiskUtilization, ad esempio:

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

I seguenti campi sono stati modificati:

Per l'API REST:

Ora devi utilizzare i campi targetSentBytesPerSecond, targetSentPacketsPerSecond, targetReceivedBytesPerSecond e targetReceivedPacketsPerSecond con la risorsa apps.services.versions, ad esempio:

targetSentBytesPerSec → targetSentBytesPerSecond

targetSentPacketsPerSec → targetSentPacketsPerSecond

targetReceivedBytesPerSec → targetReceivedBytesPerSecond

targetReceivedPacketsPerSec → targetReceivedPacketsPerSecond
Per l'API RPC:

Ora devi utilizzare i campi target_sent_bytes_per_second, target_sent_packets_per_second, target_received_bytes_per_second e target_received_packets_per_second con la risorsa google.appengine.v1.NetworkUtilization, ad esempio:

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

I seguenti campi sono stati modificati:

Ora devi utilizzare il campo method con la risorsa google.appengine.v1.OperationMetadataV1, ad esempio:

operation_type → method
Ora devi utilizzare il campo OperationMetadataV1 con la risorsa google.appengine.v1.OperationMetadataV1:
- Per v1beta4, sostituisci OperationMetadata, ad esempio:
  
  OperationMetadata → OperationMetadataV1
- Per v1beta5, sostituisci OperationMetadataV1Beta5, ad esempio:
  
  OperationMetadataV1Beta5 → OperationMetadataV1

RequestUtilization

I seguenti campi sono stati modificati:

Per l'API REST:

Ora devi utilizzare il campo targetRequestCountPerSecond con la risorsa apps.services.versions, ad esempio:

targetRequestCountPerSec → targetRequestCountPerSecond
Per l'API RPC:

Ora devi utilizzare il campo target_request_count_per_second con la risorsa google.appengine.v1.RequestUtilization, ad esempio:

target_request_count_per_sec → target_request_count_per_second

UrlDispatchRule

Ora devi utilizzare il campo service con la risorsa API REST apps e la risorsa RPC google.appengine.v1.UrlDispatchRule, ad esempio:

UrlDispatchRule.module → UrlDispatchRule.service