Cloud Life Sciences v2beta로 마이그레이션

Cloud Genomics는 이제 Cloud Life Sciences입니다. 이 페이지에서는 v2alpha1 버전의 Cloud Genomics에서 v2beta 버전의 Cloud Life Sciences로 마이그레이션하는 방법을 설명합니다.

지역화된 서비스인 Cloud Life Sciences

Cloud Genomics는 특정 Google Cloud Platform 위치에서 실행할 수 없는 글로벌 서비스였습니다. Cloud Life Sciences API는 데이터의 지역적 요구에 맞게 지역화된 서비스입니다. Cloud Life Sciences API에 요청을 보내고 위치를 지정하는 방법에 대한 자세한 내용은 REST 및 RPC 경로를 참조하세요.

REST 및 RPC 경로

Cloud Life Sciences API에 대한 REST 및 RPC 경로가 다음과 같이 변경되었습니다.

  • 이제 모든 경로에서 genomics.googleapis.com 대신 lifesciences.googleapis.com을 사용합니다.
  • 이제 모든 경로에서 Cloud Life Sciences API를 호출할 때 us-central1과 같은 Google Cloud Platform 위치를 지정해야 합니다.

예:

v2alpha1 Cloud Genomics:

GET https://genomics.googleapis.com/v2alpha1/projects/PROJECT_ID/operations/OPERATION_ID

v2beta Cloud Life Sciences API:

GET https://lifesciences.googleapis.com/v2beta/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

gcloud 명령줄 도구 경로

이제 Cloud Life Sciences gcloud 도구 명령어에서 gcloud alpha genomics 대신 gcloud beta lifesciences를 사용합니다. 예:

v2alpha1 Cloud Genomics:

gcloud alpha genomics operations describe OPERATION_ID

v2beta1 Cloud Life Sciences API:

gcloud beta lifesciences operations describe OPERATION_ID

요청 마이그레이션

Google Genomics v2alpha1 요청을 Cloud Life Sciences API v2beta 요청으로 마이그레이션하는 과정은 주로 필드 이름 바꾸기와 요청 내의 필드 구조 변경으로 이루어집니다.

다음 각 섹션에는 Cloud Life Sciences API 객체에 대한 정보와 Google Genomics v2alpha1 객체 및 Cloud Life Sciences API v2beta 객체의 차이점이 포함되어 있습니다.

Action

name 필드가 containerName으로 변경되었습니다.

Google Genomics v2alpha1Cloud Life Sciences v2beta

{
  "name": string
  ...
}

{
  "containerName": string
  ...
}

이전에는 flags 필드가 Flag 객체의 값을 지정할 수 있는 enum이었습니다. 이제 이 값은 Action 객체의 필드입니다. 다음 샘플에서는 Action에서 ignoreExitStatus 플래그를 설정할 때 요청을 마이그레이션하는 방법을 보여줍니다.

Google Genomics v2alpha1Cloud Life Sciences v2beta

{
  ...
  "flags": [
    "ignoreExitStatus"
  ]
  ...
}

{
  ...
  "ignoreExitStatus": true
  ...
}

Event

머신에서 읽을 수 있는 이벤트 세부정보는 이제 oneof 내부에 특정 메시지 유형으로 저장되고 protobuf.Any 유형 메시지로 저장되지 않습니다. 기본 메시지 유형은 변경되지 않았습니다.

다음 샘플에서는 DelayedEvent를 구성할 때 요청을 마이그레이션하는 방법을 보여줍니다.

Google Genomics v2alpha1Cloud Life Sciences v2beta

{
  "timestamp": string,
  "description": string,
  "details": {
    "@type": string,
    field1: delayed
  }
}

{
  "timestamp": string,
  "description": string,
  "delayed": {
    "cause": string,
    "metrics": [
      string
    ]
  }
}

Network

name 필드가 network로 변경되었습니다.

Google Genomics v2alpha1Cloud Life Sciences v2beta

{
  "network": {
    "name": string
  }
}

{
  "network": {
    "network": string
  }
}

Resources

Resources 객체가 더 이상 projectId 필드를 사용하지 않습니다. 대신 해당 작업이 요청 URL에서 Google Cloud Platform 프로젝트 ID를 감지합니다.

Google Genomics v2alpha1Cloud Life Sciences v2beta

{
  "projectId": string,
  "regions": [
    string
  ],
  ...
}

{
  "regions": [
    string
  ],
  ...
  "defaultContainerRegistryUri": string
}