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 a il valore fornito. Puoi anche specificare operazioni diverse (!=
) a 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 sei dei filtri. 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
per i 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 sei dei filtri. 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
per i 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 a il valore fornito. Puoi anche specificare le valutazioni del modello diverse (!=
) 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 per
che specifica 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 che il modello valuta a cui si applica. 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
per le valutazioni 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"