Applicazione di filtri per la creazione di un elenco

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

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 diverse (!=) per un determinato valore.
  • done: restituisce tutte le operazioni con lo stato "done": true. Puoi anche specificare operazioni ancora in corso (non "done").

    Query:

    • ?filter="done=true"
    • ?filter="done!=true"
  • worksOn - restituisce tutte le operazioni che funzionano su una risorsa (set di dati o modello). Puoi anche specificare operazioni diverse 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 per operazioni completate (con stato "done": true).

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

  • project-id: il tuo Google Cloud Platform Cloud 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:

curl

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

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 seguente risposta proviene da un progetto con più operazioni AutoML, filtrate in base alle operazioni completate (?filter="done=true").

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 di destinazione.

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 Google Cloud Platform Cloud 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:

curl

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

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 seguente risposta proviene da un progetto con più tipi di set di dati AutoML filtrati in base ai set di dati AutoML Translation (?filter="translationDatasetMetadata:*").

Risposta:

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 di destinazione.
  • datasetId - restituisce tutti i modelli creati 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 Google Cloud Platform Cloud 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:

curl

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

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 seguente risposta proviene da un progetto con più tipi di modelli AutoML filtrati in base ai modelli AutoML Natural Language (?filter="textClassificationModelMetadata:*").

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 elencati utilizzando i seguenti parametri:

Filtri

  • annotationSpecId - restituisce tutte le valutazioni del modello con un ID uguale al valore fornito. Puoi anche specificare le valutazioni del modello diverse (!=) rispetto 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 del modello elencate specificando annotationSpecId.

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

  • project-id: il tuo Google Cloud Platform Cloud ID.
  • model-id: l'ID del modello per il quale vuoi ricevere le valutazioni.
  • annotation-spec-id: l'ID della specifica di annotazione a cui si applica la valutazione del modello. L'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:

curl

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

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 seguente risposta proviene da un progetto con più tipi di modelli AutoML, filtrati in base alle valutazioni del modello di un singolo modello (?filter="annotationSpecId=1231173747155664896").

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"