Como fazer upgrade da API Admin do Google App Engine para a versão mais recente

Use esta página para fazer upgrade dos seus aplicativos e usar a versão v1 da API Admin. As versões v1beta4 e v1beta5 da API não serão mais compatíveis e serão encerradas em 14 de janeiro de 2019.

Aviso: as versões v1beta4 e v1beta5 estão obsoletas e não são mais compatíveis. Atualize para a versão mais recente da API Admin. As versões v1beta4 e v1beta5 serão desativadas.

Como fazer upgrade dos aplicativos para a versão mais recente

Para fazer upgrade para a versão mais recente da API Admin, é preciso fazer algumas alterações no código do aplicativo.

A versão v1 da API inclui algumas alterações importantes, como recursos obsoletos ou renomeados. As mudanças na versão v1 afetam os campos e métodos de todos os recursos na API, incluindo:

• API REST
• API RPC
• Bibliotecas cliente

Use as listas a seguir para entender quais campos e métodos foram suspensos ou renomeados na versão v1 da API.

As listas a seguir não especificam alterações para nenhuma das bibliotecas de cliente. No entanto, use essas listas para determinar onde há necessidade de alterações no aplicativo.

Observação: todas as mudanças listadas abaixo se aplicam às versões v1beta4 e v1beta5, a menos que especificado de outra forma.

Aplicativos

Nos recursos Applications, é necessário fazer as seguintes alterações:

• API REST:

  • Agora você precisa usar o parâmetro updateMask com o método apps.patch, por exemplo:

    mask → updateMask

  • O parâmetro ensureResourcesExist foi removido do método apps.get. Em v1, é possível usar o método apps.repair.

• API RPC:

  • Agora você precisa usar o campo location_id com o recurso google.appengine.v1.Application, por exemplo:

    location → location_id

  • Agora você precisa usar o campo update_mask com o recurso google.appengine.v1.UpdateApplicationRequest, por exemplo:

    mask → update_mask

  • O campo ensure_resources_exist foi removido do recurso google.appengine.v1.GetApplicationRequest. Em vez disso, use o método RepairApplication.

Instâncias

Nos recursos Instances, é necessário fazer as seguintes alterações:

• API REST:

  • Agora você precisa usar os campos startTime e vmDebugEnabled com o recurso apps.services.versions.instances, por exemplo:

    startTimestamp → startTime

    vmUnlocked → vmDebugEnabled

  • Agora você precisa usar o campo parent com o recurso apps.services.versions.instances, por exemplo:

    name → parent

  • Somente para v1beta4: todas as referências a modules agora são services. Em v1, agora você precisa usar o recurso services, por exemplo: apps.services.versions.instances

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

    Veja mais informações na seção Serviços abaixo.

• API RPC:

  • Agora você precisa usar os campos start_time e vm_debug_enabled com o recurso google.appengine.v1.Instance, por exemplo:

    start_timestamp → start_time

    vm_unlocked → vm_debug_enabled

  • Agora você precisa usar o campo parent com o recurso google.appengine.v1.ListInstancesRequest, por exemplo:

    name → parent

  • Somente para v1beta4: todas as referências a module foram substituídas pelo recurso service.

    Veja mais informações na seção Serviços abaixo.

Serviços

Nos recursos Services, é necessário fazer as seguintes alterações:

• API REST:

  • Agora você precisa usar o campo parent com o recurso apps.services, por exemplo:

    name → parent

  • Agora você precisa usar o parâmetro updateMask com o método apps.services.patch, por exemplo:

    mask → updateMask

  • Somente para v1beta4: todas as referências a modules agora são services. Em v1, agora você precisa usar o recurso services, por exemplo:

    apps.modules.delete → apps.services.delete

    apps.modules.get → apps.services.get

    apps.modules.list → apps.services.list

    apps.modules.patch → apps.services.patch

• API RPC:

  • Agora você precisa usar o campo parent com o recurso google.appengine.v1.ListServicesRequest, por exemplo:

    name → parent

  • Agora você precisa usar o campo updateMask com o recurso google.appengine.v1.UpdateServicesRequest, por exemplo:

    mask → update_mask

  • Somente para v1beta4: todas as referências a modules agora são services. Em v1, agora você precisa usar a interface Services, por exemplo:

    DeleteModule → DeleteService

    GetModule → GetService

    ListModules → ListServices

    UpdateModule → UpdateServices

Versões

Nos recursos Versions, é necessário fazer as seguintes alterações:

• API REST:

  • Agora você precisa usar o campo parent com o recurso apps.services.versions, por exemplo:

    name → parent

  • Agora você precisa usar o parâmetro updateMask com o método apps.services.versions.patch, por exemplo:

    mask → updateMask

  • Somente para v1beta4: todas as referências a modules agora são services. Em v1, agora você precisa usar o recurso services, por exemplo:

    apps.modules.versions → apps.services.versions

• API RPC:

  • Agora você precisa usar os campos created_by e created_time com a interface google.appengine.v1.Version, por exemplo:

    deployer → created_by

    created_by → create_time

  • Agora você precisa usar o campo parent com os recursos google.appengine.v1.CreateVersionRequest e google.appengine.v1.ListVersionsRequest para exemplo:

    name → parent

  • Agora você precisa usar o campo updateMask com o recurso google.appengine.v1.UpdateVersionRequest, por exemplo:

    mask → update_mask

Deployment

Os seguintes campos foram removidos:

• API REST:

  O uso do campo sourceReferences foi suspenso e removido do recurso apps.services.versions.

• API RPC:

  O uso do campo source_references foi suspenso e removido do recurso google.appengine.v1.Deployment.

DiskUtilization

Os seguintes campos foram alterados:

• API REST:

  Agora você precisa usar os campos targetWriteBytesPerSecond, targetWriteOpsPerSecond, targetReadBytesPerSecond e targetReadOpsPerSecond com os recursos apps.services.versions, por exemplo:

  targetWriteBytesPerSec → targetWriteBytesPerSecond

  targetWriteOpsPerSec → targetWriteOpsPerSecond

  targetReadBytesPerSec → targetReadBytesPerSecond

  targetReadOpsPerSec → targetReadOpsPerSecond

• API RPC:

  Agora você precisa usar os campos target_write_bytes_per_second, target_write_ops_per_second, target_read_bytes_per_second e target_read_ops_per_second com o recurso google.appengine.v1.DiskUtilization. Por exemplo:

  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

Os seguintes campos foram alterados:

• API REST:

  Agora você precisa usar os campos targetSentBytesPerSecond, targetSentPacketsPerSecond, targetReceivedBytesPerSecond e targetReceivedPacketsPerSecond com o recurso apps.services.versions. Por exemplo:

  targetSentBytesPerSec → targetSentBytesPerSecond

  targetSentPacketsPerSec → targetSentPacketsPerSecond

  targetReceivedBytesPerSec → targetReceivedBytesPerSecond

  targetReceivedPacketsPerSec → targetReceivedPacketsPerSecond

• API RPC:

  Agora você precisa usar os campos target_sent_bytes_per_second, target_sent_packets_per_second, target_received_bytes_per_second e target_received_packets_per_second com o recurso google.appengine.v1.NetworkUtilization, por exemplo:

  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

Os seguintes campos foram alterados:

• Agora você precisa usar o campo method com o recurso google.appengine.v1.OperationMetadataV1, por exemplo:

  operation_type → method

• Agora você precisa usar o campo OperationMetadataV1 com o recurso google.appengine.v1.OperationMetadataV1:

  • Para v1beta4, substitua OperationMetadata, por exemplo:

    OperationMetadata → OperationMetadataV1

  • Para v1beta5, substitua OperationMetadataV1Beta5, por exemplo:

    OperationMetadataV1Beta5 → OperationMetadataV1

RequestUtilization

Os seguintes campos foram alterados:

• API REST:

  Agora você precisa usar o campo targetRequestCountPerSecond com o recurso apps.services.versions, por exemplo:

  targetRequestCountPerSec → targetRequestCountPerSecond

• API RPC:

  Agora você precisa usar o campo target_request_count_per_second com o recurso google.appengine.v1.RequestUtilization, por exemplo:

  target_request_count_per_sec → target_request_count_per_second

UrlDispatchRule

Agora você precisa usar o campo service com o recurso da API REST apps e o recurso RPC google.appengine.v1.UrlDispatchRule, por exemplo:

UrlDispatchRule.module → UrlDispatchRule.service