Filtra cuando se muestre la lista

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

Punto clave: Por lo general, debes agregar la siguiente sintaxis a la URL de la solicitud para filtrar:

• ?filter="[filter_name=]filter-value": Muestra todos los objetos JSON que coinciden con filter-value.
• ?filter="": Anula un filtro. No se muestran coincidencias.
• ?filter="*": Un filtro que coincide con todos los valores posibles.

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"
  • model: ?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 indica 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 a continuación, realiza los siguientes reemplazos:

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

Método 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

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

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 las operaciones que se completaron (?filter="done=true").

Respuesta

{
"operations": [
{
"name": "projects/project-id/locations/us-central1/operations/VCN1765936620487311360",
"metadata": {
"@type": "type.googleapis.com/google.cloud.automl.v1.OperationMetadata",
"createTime": "2019-12-12T19:50:54.701276Z",
"updateTime": "2019-12-12T21:44:41.398588Z",
"createModelDetails": {}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.automl.v1.Model",
"name": "projects/project-id/locations/us-central1/models/VCN3089482538515693568"
}
},
{
"name": "projects/project-id/locations/us-central1/operations/ICN4019988233986244608",
"metadata": {
"@type": "type.googleapis.com/google.cloud.automl.v1.OperationMetadata",
"partialFailures": [
{
"code": 3,
"message": "Error: gs://storage-bucket/csv/all_data.csv line 2269: The label is already a ground truth."
          }, {"code": 3, "message": "Error: Single label example 6192816919589105442 can have at most one approved positive annotation."
          }, {"code": 3, "message": "Error: gs://storage-bucket/csv/all_data.csv line 2267: The label is already a ground truth."
          }
],
"createTime": "2019-12-12T20:24:26.992578Z",
"updateTime": "2019-12-12T20:40:39.672070Z",
"importDataDetails": {}
},
"done": true,
"response": {
"@type":
"type.googleapis.com/google.protobuf.Empty"
}
},
{
"name": "projects/project-id/locations/us-central1/operations/TBL1400159888251813888",
"metadata": {
"@type": "type.googleapis.com/google.cloud.automl.v1.OperationMetadata",
"createTime": "2019-12-11T23:08:07.315450Z",
"updateTime": "2019-12-12T00:48:44.703974Z",
"createModelDetails": {}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.automl.v1.Model",
"name": "projects/project-id/locations/us-central1/models/TBL5737009781177057280"
}
},
{
"name": "projects/project-id/locations/us-central1/operations/TBL7492967234130673664",
"metadata": {
"@type": "type.googleapis.com/google.cloud.automl.v1.OperationMetadata",
"createTime": "2019-12-11T23:07:36.217459Z",
"updateTime": "2019-12-11T23:08:17.727121Z",
"createModelDetails": {}
},
"done": true,
"error": {
"code": 1,
"message": "CANCELLED"
}
},
{
"name": "projects/project-id/locations/us-central1/operations/TBL6841634138022215680",
"metadata": {
"@type": "type.googleapis.com/google.cloud.automl.v1.OperationMetadata",
"createTime": "2019-12-11T23:02:56.089038Z",
"updateTime": "2019-12-11T23:02:59.300928Z",
"deleteDetails": {}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.protobuf.Empty"
}
},
{
"name": "projects/project-id/locations/us-central1/operations/TBL8322192515520266240",
"metadata": {
"@type": "type.googleapis.com/google.cloud.automl.v1.OperationMetadata",
"createTime": "2019-12-11T22:57:14.840747Z",
"updateTime": "2019-12-11T22:59:00.764354Z",
"importDataDetails": {}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.protobuf.Empty"
}
},
{
"name": "projects/project-id/locations/us-central1/operations/TCN7841151780321755136",
"metadata": {
"@type": "type.googleapis.com/google.cloud.automl.v1.OperationMetadata",
"partialFailures": [
{
  "code": 3,
  "message": "Error: DUPLICATE_CONTENT: Duplicated content detected. Multiple documents (line 2552 and line 3528) share the same content."
          }, {"code": 3, "message": "Error: gs://automl-docs-filtering-vcm/happiness.csv line 3527: The label is already a ground truth."
          }], "createTime": "2019-12-11T22:22:40.789066Z", "updateTime": "2019-12-11T22:36:40.388359Z", "importDataDetails": {}}, "done": true, "response": {"@type": "type.googleapis.com/google.protobuf.Empty"}}]}

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.

  Valores disponibles

  • imageClassificationDatasetMetadata:* (AutoML Vision: clasificación de imágenes)
  • imageObjectDetectionDatasetMetadata:* (AutoML Vision: detección de objetos)
  • textClassificationDatasetMetadata:* (AutoML Natural Language: clasificación)
  • textExtractionDatasetMetadata:* (AutoML Natural Language: extracción de entidades)
  • textSentimentDatasetMetadata:* (AutoML Natural Language: análisis de opiniones)
  • translationDatasetMetadata:* (AutoML Translation)

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 indica cómo filtrar los conjuntos de datos enumerados mediante la especificación de dataset_metadata.

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

• 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 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

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

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:

Respuesta

Nota:

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.

  Valores disponibles

  • imageClassificationModelMetadata:* (AutoML Vision: clasificación de imágenes)
  • imageObjectDetectionModelMetadata:* (AutoML Vision: detección de objetos)
  • textClassificationModelMetadata:* (AutoML Natural Language: clasificación)
  • textExtractionModelMetadata:* (AutoML Natural Language: extracción de entidades)
  • textSentimentModelMetadata:* (AutoML Natural Language: análisis de opiniones)
  • translationModelMetadata:* (AutoML Translation)
• 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 muestra cómo filtrar los modelos enumerados mediante la especificación de model_metadata.

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

• 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 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

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

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:*").

Respuesta

Nota:

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 indica cómo filtrar las evaluaciones de modelos enumeradas mediante la especificación de annotationSpecId.

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

• 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 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

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

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 evaluaciones de modelo de un solo modelo (?filter="annotationSpecId=1231173747155664896").

Respuesta

Nota:

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"