App Engine Admin API를 최신 출시 버전으로 업그레이드

v1 버전의 Admin API를 사용하도록 앱을 업그레이드하려면 이 페이지를 참조하세요. v1beta4 및 v1beta5 버전의 API는 더 이상 지원되지 않으며 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