Applicazione di filtri per la creazione di un elenco

Puoi utilizzare i filtri per restituire risultati più specifici quando elenchi risorse, valutazioni o operazioni.

Punto chiave: in generale, filtra aggiungendo la seguente sintassi all'URL della richiesta:

• ?filter="[filter_name=]filter-value": restituisce tutti gli oggetti JSON corrispondenti a filter-value.
• ?filter="": un filtro non impostato. Non viene restituita nessuna corrispondenza.
• ?filter="*": un filtro che corrisponde a tutti i valori possibili.

Suite operativa

Puoi filtrare le operazioni elencate utilizzando i seguenti parametri:

Filtri

• operation_id: restituisce tutte le operazioni con un ID uguale al valore fornito. Puoi anche specificare operazioni diverso (!=) per un determinato valore.
• done: restituisce tutte le operazioni con stato "done": true. Puoi anche specificare operazioni ancora in corso (non "done").

  Query:

  • ?filter="done=true"
  • ?filter="done!=true"
• worksOn: restituisce tutte le operazioni eseguite su una risorsa (set di dati o modello). Puoi anche specificare operazioni diversamente da (!=) a un determinato valore.

  Query:

  • set di dati - ?filter="worksOn=projects/project-id/locations/us-central1/datasets/dataset-id"
  • model - ?filter="worksOn=projects/project-id/locations/us-central1/models/model-id"

Parametri di ricerca aggiuntivi

• pageSize: limita i risultati restituiti a un determinato numero di righe. Se non specificato, il server sceglierà una dimensione predefinita.
• pageToken: un token per recuperare la pagina successiva di risultati. Una query iniziale con pageSize impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche un nextPageToken. Questo token può quindi essere passato a pageToken per ricevere risultati successivi.

Il seguente esempio di codice della riga di comando mostra come filtrare le operazioni elencate in base a quelle completate (avere uno stato "done": true).

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• project-id: il tuo progetto Google Cloud Platform ID.

Metodo HTTP e URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/operations?filter="done=true"

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciatura

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/operations?filter="done=true""

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/operations?filter="done=true"" | Select-Object -Expand Content

Se la richiesta ha esito positivo, il server restituisce un codice di stato HTTP 200 OK e la risposta in formato JSON.

La risposta seguente proviene da un progetto con più operazioni AutoML, filtrate in base alle operazioni completate (?filter="done=true").

Risposta

PREZZO IN CALO
          },
 {
 "code"
          },
 {
 "code"
          0.000.000 m Più documenti (riga 2552 e 3528) condividono gli stessi contenuti.
          },
 {
 " "code"
          }
 ],
 "createTime": "2019-12-11T22:22:40.789066Z"

Parametri di ricerca aggiuntivi

Per eseguire una query con altri parametri (pageSize, pageToken), aggiungi il parametro all'URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?pageSize=INT

Puoi anche concatenare i parametri con la e commerciale (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?filter="done=true&pageSize=INT&pageToken=next-page-token"

Set di dati

Puoi filtrare i set di dati elencati utilizzando i seguenti parametri:

Filtri

• dataset_metadata: restituisce tutti i set di dati con il tipo di metadati target.

  Valori disponibili

  • imageClassificationDatasetMetadata:* (AutoML Vision - Classificazione delle immagini)
  • imageObjectDetectionDatasetMetadata:* (AutoML Vision - Rilevamento di oggetti)
  • textClassificationDatasetMetadata:* (AutoML Natural Language - Classificazione)
  • textExtractionDatasetMetadata:* (AutoML Natural Language - Estrazione entità)
  • textSentimentDatasetMetadata:* (AutoML Natural Language - Analisi del sentiment)
  • translationDatasetMetadata:* (AutoML Translation)

Parametri di ricerca aggiuntivi

• pageSize: limita i risultati restituiti a un determinato numero di righe. Se non specificato, il server sceglierà una dimensione predefinita.
• pageToken: un token per recuperare la pagina successiva di risultati. Una query iniziale con pageSize impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche un nextPageToken. Questo token può quindi essere passato a pageToken per ricevere risultati successivi.

Il seguente esempio di codice della riga di comando mostra come filtrare i set di dati elencati specificando dataset_metadata.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• project-id: il tuo progetto Google Cloud Platform ID.
• dataset-metadata-value: il tipo di dataset_metadata che stai filtrando. Questi valori dipendono dal tipo di problema di AutoML.

Metodo HTTP e URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value"

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciatura

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value""

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value"" | Select-Object -Expand Content

Se la richiesta ha esito positivo, il server restituisce un codice di stato HTTP 200 OK e la risposta in formato JSON.

La risposta seguente proviene da un progetto con più tipi di set di dati AutoML, filtrati in base ai set di dati AutoML Translation (?filter="translationDatasetMetadata:*").

Risposta:

Risposta

PREZZO IN CALO

Parametri di ricerca aggiuntivi

Per eseguire una query con altri parametri (pageSize, pageToken), aggiungi il parametro all'URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?pageSize=INT

Puoi anche concatenare i parametri con la e commerciale (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value&pageSize=INT&pageToken=next-page-token"

Modelli

Puoi filtrare i modelli elencati utilizzando i seguenti parametri:

Filtri

• model_metadata: restituisce tutti i modelli con il tipo di metadati target.

  Valori disponibili

  • imageClassificationModelMetadata:* (AutoML Vision - Classificazione delle immagini)
  • imageObjectDetectionModelMetadata:* (AutoML Vision - Rilevamento di oggetti)
  • textClassificationModelMetadata:* (AutoML Natural Language - Classificazione)
  • textExtractionModelMetadata:* (AutoML Natural Language - Estrazione entità)
  • textSentimentModelMetadata:* (AutoML Natural Language - Analisi del sentiment)
  • translationModelMetadata:* (AutoML Translation)
• datasetId: restituisce tutti i modelli creati a partire da un set di dati specifico.

Parametri di ricerca aggiuntivi

• pageSize: limita i risultati restituiti a un determinato numero di righe. Se non specificato, il server sceglierà una dimensione predefinita.
• pageToken: un token per recuperare la pagina successiva di risultati. Una query iniziale con pageSize impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche un nextPageToken. Questo token può quindi essere passato a pageToken per ricevere risultati successivi.

Il seguente esempio di codice della riga di comando mostra come filtrare i modelli elencati specificando model_metadata.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• project-id: il tuo progetto Google Cloud Platform ID.
• model-metadata-value: il tipo di model_metadata che stai filtrando. Questi valori dipendono dal tipo di problema di AutoML.

Metodo HTTP e URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value"

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciatura

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value""

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value"" | Select-Object -Expand Content

Se la richiesta ha esito positivo, il server restituisce un codice di stato HTTP 200 OK e la risposta in formato JSON.

La risposta seguente proviene da un progetto con più tipi di modelli AutoML, filtrati in base ai modelli AutoML Natural Language (?filter="textClassificationModelMetadata:*").

Risposta

PREZZO IN CALO

Parametri di ricerca aggiuntivi

Per eseguire una query con altri parametri (pageSize, pageToken), aggiungi il parametro all'URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?pageSize=INT

Puoi anche concatenare i parametri con la e commerciale (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value&pageSize=INT&pageToken=next-page-token"

modelEvaulations

Puoi filtrare le valutazioni dei modelli elencate utilizzando i seguenti parametri:

Filtri

• annotationSpecId: restituisce tutte le valutazioni del modello con un ID uguale al valore fornito. Puoi anche specificare valutazioni del modello diverse da (!=) a un determinato valore.

Parametri di ricerca aggiuntivi

• pageSize: limita i risultati restituiti a un determinato numero di righe. Se non specificato, il server sceglierà una dimensione predefinita.
• pageToken: un token per recuperare la pagina successiva di risultati. Una query iniziale con pageSize impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche un nextPageToken. Questo token può quindi essere passato a pageToken per ricevere risultati successivi.

Il seguente esempio di codice della riga di comando mostra come filtrare le valutazioni dei modelli elencati specificando annotationSpecId.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• project-id: il tuo progetto Google Cloud Platform ID.
• model-id: l'ID del modello per il quale vuoi ricevere valutazioni.
• annotation-spec-id: l'ID della specifica dell'annotazione a cui si applica la valutazione del modello. Il campo ID è vuoto per la valutazione complessiva del modello.

Metodo HTTP e URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id"

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciatura

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id""

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id"" | Select-Object -Expand Content

Se la richiesta ha esito positivo, il server restituisce un codice di stato HTTP 200 OK e la risposta in formato JSON.

La risposta seguente proviene da un progetto con più tipi di modelli AutoML, filtrati in base alle valutazioni del modello da un singolo modello (?filter="annotationSpecId=1231173747155664896").

Risposta

PREZZO IN CALO

Parametri di ricerca aggiuntivi

Per eseguire una query con altri parametri (pageSize, pageToken), aggiungi il parametro all'URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?pageSize=INT

Puoi anche concatenare i parametri con la e commerciale (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id&pageSize=INT&pageToken=next-page-token"