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"
- set di dati -
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 conpageSize
impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche unnextPageToken
. Questo token può quindi essere passato apageToken
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 conpageSize
impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche unnextPageToken
. Questo token può quindi essere passato apageToken
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 conpageSize
impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche unnextPageToken
. Questo token può quindi essere passato apageToken
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 conpageSize
impostato e risultati maggiori di quelli adatti a quella dimensione della pagina restituisce anche unnextPageToken
. Questo token può quindi essere passato apageToken
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"