Google Genomics è diventato Cloud Life Sciences. Questa pagina spiega come eseguire la migrazione dalla versione v2alpha1 di Google Genomics alla versione v2beta di Cloud Life Sciences.
Cloud Life Sciences come servizio regionalizzato
Google Genomics era un servizio globale che non poteva essere eseguito da località Google Cloud specifiche. API Cloud Life Sciences è un servizio regionalizzato che ti consente di allinearti alle esigenze di località per i tuoi dati. Quando selezioni la località in cui viene eseguita l'API Cloud Life Sciences, in cui vengono archiviati i metadati per l'operazione che esegui.
Per informazioni su come effettuare richieste all'API Cloud Life Sciences e per specificare una località, consulta l'articolo sui percorsi REST e RPC.
Percorsi REST e RPC
Sono state apportate le seguenti modifiche ai percorsi REST e RPC dell'API Cloud Life Sciences:
- Tutti i percorsi ora utilizzano
lifesciences.googleapis.com
anzichégenomics.googleapis.com
. - Per tutti i percorsi ora è necessario specificare una località Google Cloud, ad esempio
us-central1
, quando chiami l'API Cloud Life Sciences.
Ad esempio:
v2alpha1 Google Genomics:
GET https://genomics.googleapis.com/v2alpha1/projects/PROJECT_ID/operations/OPERATION_ID
API Cloud Life Sciences v2beta:
GET https://lifesciences.googleapis.com/v2beta/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
Le richieste batch devono essere effettuate agli endpoint a livello di regione:
POST https://LOCATION-lifesciences.googleapis.com/batch
Modifiche a Google Cloud CLI
I comandi gcloud CLI di Cloud Life Sciences ora utilizzano
gcloud beta lifesciences
anziché gcloud alpha genomics
. Ad esempio:
v2alpha1 Google Genomics:
gcloud alpha genomics operations describe OPERATION_ID
API Cloud Life Sciences v2beta:
gcloud beta lifesciences operations describe OPERATION_ID
I flag --cpu
e --memory
sono stati rimossi. Utilizza invece
--machine-type
flag. Quando scegli un tipo di macchina,
puoi specificare la quantità di memoria e il numero di core della CPU.
Modifiche IAM
Cloud Life Sciences utilizza i seguenti
I ruoli e le autorizzazioni di Identity and Access Management (IAM) nella
lifesciences
anziché lo spazio dei nomi genomics
utilizzato da Cloud
Genomics v2alpha1. Oltre alla modifica dello spazio dei nomi, il ruolo
roles/lifesciences.workflowsRunner
ha sostituito roles/genomics.pipelinesRunner
,
e l'autorizzazione lifesciences.workflows.run
è stata sostituita
genomics.pipelines.run
.
v2alpha1 Google Genomics:
Ruolo | Autorizzazioni |
---|---|
roles/genomics.admin |
|
roles/genomics.editor |
|
roles/genomics.viewer |
|
Ruolo Pipelines | Autorizzazione |
---|---|
roles/genomics.pipelinesRunner |
|
API Cloud Life Sciences v2beta:
Ruolo | Autorizzazioni |
---|---|
roles/lifesciences.admin |
|
roles/lifesciences.editor |
|
roles/lifesciences.viewer |
|
Ruolo Workflows | Autorizzazione |
---|---|
roles/lifesciences.workflowsRunner |
|
Esegui la migrazione di richieste e risposte
Il processo di migrazione delle richieste Google Genomics v2alpha1 Le richieste v2beta dell'API Cloud Life Sciences consistono principalmente nella sostituzione del campo nomi e la modifica delle strutture dei campi all'interno di richieste e risposte.
Ognuna delle sezioni seguenti contiene informazioni su un'API Cloud Life Sciences ed eventuali differenze tra l'oggetto Google Genomics v2alpha1 e API Cloud Life Sciences v2beta.
Action
Il campo name
è stato modificato in containerName
:
Google Genomics v2alpha1 | Cloud Life Sciences v2beta |
---|---|
|
|
In precedenza, il campo flags
era un'enumerazione che consente di specificare i valori in un Flag
. Questi valori sono ora campi nell'oggetto Action
. Le seguenti
esempio mostra come eseguire la migrazione della richiesta quando si imposta il ignoreExitStatus
Segnala in Action
:
Google Genomics v2alpha1 | Cloud Life Sciences v2beta |
---|---|
|
|
Event
I dettagli degli eventi leggibili dalle macchine ora vengono memorizzati come tipo di messaggio specifico
all'interno di un messaggio oneof
anziché in un messaggio digitato in protobuf.Any
. La
i tipi di messaggi sottostanti non sono cambiati.
L'esempio seguente mostra come eseguire la migrazione della richiesta quando
configurando una DelayedEvent
:
Google Genomics v2alpha1 | Cloud Life Sciences v2beta |
---|---|
|
|
Network
Il campo name
è stato modificato in network
:
Google Genomics v2alpha1 | Cloud Life Sciences v2beta |
---|---|
|
|
Resources
L'oggetto Resources
non utilizza più un campo projectId
. l'operazione
rileva invece l'ID progetto Google Cloud dall'URL della richiesta.
Google Genomics v2alpha1 | Cloud Life Sciences v2beta |
---|---|
|
|
operations.get
e operations.list
risposte
Nella versione v2alpha1, la projects.locations.operations.get
e projects.locations.operations.list
hanno restituito una risposta contenente un ID progetto Google Cloud
nei nomi delle operazioni. Nella versione v2beta,
il nome dell'operazione nella risposta contiene un numero di progetto Google Cloud anziché un ID progetto.
Consulta Creare e gestire progetti
per informazioni sulle differenze tra un ID progetto e un numero di progetto.
Google Genomics v2alpha1 | Cloud Life Sciences v2beta |
---|---|
|
|
Quando invii una richiesta all'API Cloud Life Sciences, puoi utilizzare l'ID progetto o il numero del progetto. Tuttavia, la risposta contiene sempre del progetto.