Filtra cuando se muestre la lista

Puedes usar filtros para mostrar resultados más específicos cuando enumeres recursos, operaciones o evaluaciones.

Operaciones

Puedes filtrar las operaciones que se enumeran mediante los siguientes parámetros:

Filtros

  • operation_id: Muestra todas las operaciones con un ID igual al valor proporcionado. También puedes especificar operaciones no iguales (!=) a un valor determinado.
  • done: Muestra todas las operaciones con un estado de "done": true. También puedes especificar operaciones que aún están en curso (no “"done"”).

    Consultas:

    • ?filter="done=true"
    • ?filter="done!=true"
  • worksOn: Muestra todas las operaciones que funcionan en un recurso (un conjunto de datos o un modelo). También puedes especificar operaciones no iguales (!=) a un valor determinado.

    Consultas:

    • Conjunto de datos: ?filter="worksOn=projects/project-id/locations/us-central1/datasets/dataset-id"
    • Modelo: ?filter="worksOn=projects/project-id/locations/us-central1/models/model-id"

Parámetros de búsqueda adicionales

  • pageSize: Limita los resultados que se muestran a una cantidad determinada de líneas. Si no se especifica, el servidor elegirá un tamaño predeterminado.
  • pageToken: Un token para recuperar la siguiente página de resultados. Una consulta inicial con un conjunto pageSize y resultados mayores que los que quepan en ese tamaño de página también mostrarán un nextPageToken. Este token se puede pasar a pageToken para obtener resultados posteriores.

En la siguiente muestra de código de línea de comandos, se muestra cómo filtrar las operaciones enumeradas por operaciones completadas (que tienen un estado de "done": true).

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los reemplazos a continuación:

  • project-id: Tu proyecto de Google Cloud Platform. ID

Método de HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente comando:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

Si la solicitud se completa de forma correcta, el servidor muestra un código de estado HTTP 200 OK y la respuesta en formato JSON.

La siguiente respuesta es de un proyecto con varias operaciones de AutoML, filtradas por operaciones que se completaron (?filter="done=true").

Parámetros de consulta adicionales

Para realizar consultas con otros parámetros (pageSize, pageToken), agrega el parámetro a la URL:

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

También puedes concatenar parámetros con un signo et (&):

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

Conjuntos de datos

Puedes filtrar los conjuntos de datos que se enumeran mediante los siguientes parámetros:

Filtros

  • dataset_metadata: Muestra todos los conjuntos de datos con el tipo de metadatos de destino.

Parámetros de búsqueda adicionales

  • pageSize: Limita los resultados que se muestran a una cantidad determinada de líneas. Si no se especifica, el servidor elegirá un tamaño predeterminado.
  • pageToken: Un token para recuperar la siguiente página de resultados. Una consulta inicial con un conjunto pageSize y resultados mayores que los que quepan en ese tamaño de página también mostrarán un nextPageToken. Este token se puede pasar a pageToken para obtener resultados posteriores.

En la siguiente muestra de código de línea de comandos, se señala cómo filtrar los conjuntos de datos enumerados mediante la especificación de dataset_metadata.

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los reemplazos a continuación:

  • project-id: Tu proyecto de Google Cloud Platform ID
  • dataset-metadata-value: El tipo de dataset_metadata que quieres filtrar. Estos valores dependen del tipo de problema de AutoML

Método de HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente comando:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

Si la solicitud se completa de forma correcta, el servidor muestra un código de estado HTTP 200 OK y la respuesta en formato JSON.

La siguiente respuesta es de un proyecto con varios tipos de conjuntos de datos de AutoML, filtrados por conjuntos de datos de AutoML Translation (?filter="translationDatasetMetadata:*").

Respuesta:

Parámetros de consulta adicionales

Para realizar consultas con otros parámetros (pageSize, pageToken), agrega el parámetro a la URL:

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

También puedes concatenar parámetros con un signo et (&):

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

Modelos

Puedes filtrar los modelos que se enumeran mediante los siguientes parámetros:

Filtros

  • model_metadata: Muestra todos los modelos con el tipo de metadatos de destino.
  • datasetId: Muestra todos los modelos creados a partir de un conjunto de datos específico.

Parámetros de búsqueda adicionales

  • pageSize: Limita los resultados que se muestran a una cantidad determinada de líneas. Si no se especifica, el servidor elegirá un tamaño predeterminado.
  • pageToken: Un token para recuperar la siguiente página de resultados. Una consulta inicial con un conjunto pageSize y resultados mayores que los que quepan en ese tamaño de página también mostrarán un nextPageToken. Este token se puede pasar a pageToken para obtener resultados posteriores.

En la siguiente muestra de código de línea de comandos, se señala cómo filtrar los modelos enumerados mediante la especificación de model_metadata.

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los reemplazos a continuación:

  • project-id: Tu proyecto de Google Cloud Platform ID
  • model-metadata-value: El tipo de model_metadata que quieres filtrar. Estos valores dependen del tipo de problema de AutoML

Método de HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente comando:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

Si la solicitud se completa de forma correcta, el servidor muestra un código de estado HTTP 200 OK y la respuesta en formato JSON.

La siguiente respuesta es de un proyecto con varios tipos de modelos de AutoML, filtrados por modelos de AutoML Natural Language (?filter="textClassificationModelMetadata:*").

Parámetros de consulta adicionales

Para realizar consultas con otros parámetros (pageSize, pageToken), agrega el parámetro a la URL:

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

También puedes concatenar parámetros con un signo et (&):

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

modelEvaulations

Puedes filtrar las evaluaciones de modelos enumeradas mediante los siguientes parámetros:

Filtros

  • annotationSpecId: Muestra todas las evaluaciones de modelo con un ID igual al valor proporcionado. También puedes especificar que las evacuaciones del modelo no sean iguales (!=) a un valor determinado.

Parámetros de búsqueda adicionales

  • pageSize: Limita los resultados que se muestran a una cantidad determinada de líneas. Si no se especifica, el servidor elegirá un tamaño predeterminado.
  • pageToken: Un token para recuperar la siguiente página de resultados. Una consulta inicial con un conjunto pageSize y resultados mayores que los que quepan en ese tamaño de página también mostrarán un nextPageToken. Este token se puede pasar a pageToken para obtener resultados posteriores.

En la siguiente muestra de código de línea de comandos, se muestra cómo filtrar las evaluaciones de modelos enumeradas mediante la especificación de annotationSpecId.

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los reemplazos a continuación:

  • project-id: Tu proyecto de Google Cloud Platform ID
  • model-id: El ID del modelo del que deseas obtener las evaluaciones
  • annotation-spec-id: El ID de la especificación de anotación a la que se aplica la evaluación del modelo. El ID está vacío para la evaluación general del modelo

Método de HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente comando:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

Si la solicitud se completa de forma correcta, el servidor muestra un código de estado HTTP 200 OK y la respuesta en formato JSON.

La siguiente respuesta es de un proyecto con varios tipos de modelos de AutoML, filtrados por las evaluaciones de modelo de un solo modelo (?filter="annotationSpecId=1231173747155664896").

Parámetros de consulta adicionales

Para realizar consultas con otros parámetros (pageSize, pageToken), agrega el parámetro a la URL:

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

También puedes concatenar parámetros con un signo et (&):

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"