나열 시 필터링

리소스, 평가 또는 작업을 나열할 때 필터링을 사용하여 더 구체적인 결과를 반환할 수 있습니다.

작업

다음 매개변수를 사용하여 나열된 작업을 필터링할 수 있습니다.

필터

  • operation_id - 제공된 값과 동일한 ID가 있는 모든 작업을 반환합니다. 특정 값과 같지 않은(!=) 작업을 지정할 수도 있습니다.
  • done - "done": true 상태인 모든 작업을 반환합니다. 진행 중인 작업("done"이 아닌 작업)을 지정할 수도 있습니다.

    쿼리:

    • ?filter="done=true"
    • ?filter="done!=true"
  • worksOn - 리소스(데이터세트 또는 모델)에서 작동하는 모든 작업을 반환합니다. 특정 값과 같지 않은(!=) 작업을 지정할 수도 있습니다.

    쿼리:

    • dataset - ?filter="worksOn=projects/project-id/locations/us-central1/datasets/dataset-id"
    • model - ?filter="worksOn=projects/project-id/locations/us-central1/models/model-id"

추가 쿼리 매개변수

  • pageSize - 반환되는 결과를 설정된 페이지 수로 제한합니다. 지정하지 않으면 서버는 기본 크기를 선택합니다.
  • pageToken - 결과의 다음 페이지를 검색하는 토큰입니다. 설정된 pageSize가 있고 결과가 해당 페이지에 맞는 크기보다 초기 쿼리도 nextPageToken을 반환합니다. 그런 다음 이 토큰은 pageToken으로 전달되어 후속 결과를 가져올 수 있습니다.

다음 명령줄 코드 샘플은 완료된 작업(상태: "done": true)별로 나열된 작업을 필터링하는 방법을 보여줍니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: Google Cloud Platform 프로젝트 ID

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

요청이 성공하면 서버가 200 OK HTTP 상태 코드와 응답을 JSON 형식으로 반환합니다.

다음 응답은 여러 AutoML 작업이 포함된 프로젝트의 응답으로, 완료된 작업(?filter="done=true")으로 필터링되었습니다.

추가 쿼리 매개변수

다른 매개변수(pageSize, pageToken)로 쿼리하려면 매개변수를 URL에 추가합니다.

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

매개변수를 앰퍼샌드(&)로 연결할 수도 있습니다.

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

데이터세트

다음 매개변수를 사용하여 나열된 데이터세트를 필터링할 수 있습니다.

필터

  • dataset_metadata - 대상 메타데이터 유형이 있는 모든 데이터세트를 반환합니다.

추가 쿼리 매개변수

  • pageSize - 반환되는 결과를 설정된 페이지 수로 제한합니다. 지정하지 않으면 서버는 기본 크기를 선택합니다.
  • pageToken - 결과의 다음 페이지를 검색하는 토큰입니다. 설정된 pageSize가 있고 결과가 해당 페이지에 맞는 크기보다 초기 쿼리도 nextPageToken을 반환합니다. 그런 다음 이 토큰은 pageToken으로 전달되어 후속 결과를 가져올 수 있습니다.

다음 명령줄 코드 샘플은 dataset_metadata를 지정하여 나열된 데이터세트를 필터링하는 방법을 보여줍니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: Google Cloud Platform 프로젝트 ID
  • dataset-metadata-value: 필터링할 dataset_metadata의 유형입니다. 이러한 값은 AutoML 문제 유형에 따라 다릅니다.

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

요청이 성공하면 서버가 200 OK HTTP 상태 코드와 응답을 JSON 형식으로 반환합니다.

다음 응답은 여러 AutoML 데이터세트 유형이 있는 프로젝트의 응답으로, AutoML Translation 데이터세트(?filter="translationDatasetMetadata:*")로 필터링되었습니다.

응답:

추가 쿼리 매개변수

다른 매개변수(pageSize, pageToken)로 쿼리하려면 매개변수를 URL에 추가합니다.

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

매개변수를 앰퍼샌드(&)로 연결할 수도 있습니다.

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

모델

다음 매개변수를 사용하여 나열된 모델을 필터링할 수 있습니다.

필터

  • model_metadata - 대상 메타데이터 유형이 있는 모든 모델을 반환합니다.
  • datasetId - 특정 데이터세트에서 생성된 모든 모델을 반환합니다.

추가 쿼리 매개변수

  • pageSize - 반환되는 결과를 설정된 페이지 수로 제한합니다. 지정하지 않으면 서버는 기본 크기를 선택합니다.
  • pageToken - 결과의 다음 페이지를 검색하는 토큰입니다. 설정된 pageSize가 있고 결과가 해당 페이지에 맞는 크기보다 초기 쿼리도 nextPageToken을 반환합니다. 그런 다음 이 토큰은 pageToken으로 전달되어 후속 결과를 가져올 수 있습니다.

다음 명령줄 코드 샘플은 model_metadata를 지정하여 나열된 모델을 필터링하는 방법을 보여줍니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: Google Cloud Platform 프로젝트 ID
  • model-metadata-value: 필터링한 model_metadata의 유형입니다. 이러한 값은 AutoML 문제 유형에 따라 다릅니다.

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

요청이 성공하면 서버가 200 OK HTTP 상태 코드와 응답을 JSON 형식으로 반환합니다.

다음 응답은 여러 AutoML 모델 유형이 있는 프로젝트의 응답으로, AutoML Natural Language 모델(?filter="textClassificationModelMetadata:*")로 필터링되었습니다.

추가 쿼리 매개변수

다른 매개변수(pageSize, pageToken)로 쿼리하려면 매개변수를 URL에 추가합니다.

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

매개변수를 앰퍼샌드(&)로 연결할 수도 있습니다.

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

modelEvaulations

다음 매개변수를 사용하여 나열된 모델 평가를 필터링할 수 있습니다.

필터

  • annotationSpecId - ID가 제공된 값과 동일한 모든 모델 평가를 반환합니다. 특정 값과 같지 않은(!=) 모델 평가를 지정할 수도 있습니다.

추가 쿼리 매개변수

  • pageSize - 반환되는 결과를 설정된 페이지 수로 제한합니다. 지정하지 않으면 서버는 기본 크기를 선택합니다.
  • pageToken - 결과의 다음 페이지를 검색하는 토큰입니다. 설정된 pageSize가 있고 결과가 해당 페이지에 맞는 크기보다 초기 쿼리도 nextPageToken을 반환합니다. 그런 다음 이 토큰은 pageToken으로 전달되어 후속 결과를 가져올 수 있습니다.

다음 명령줄 코드 샘플은 annotationSpecId를 지정하여 나열된 모델을 필터링하는 방법을 보여줍니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: Google Cloud Platform 프로젝트 ID
  • model-id: 평가하려는 모델의 ID입니다.
  • annotation-spec-id: 모델 평가가 적용되는 주석 사양의 ID입니다. 전체 모델 평가의 경우 ID는 비어 있습니다.

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

요청이 성공하면 서버가 200 OK HTTP 상태 코드와 응답을 JSON 형식으로 반환합니다.

다음 응답은 여러 AutoML 모델 유형이 있는 프로젝트의 응답으로, 단일 모델의 모델 평가(?filter="annotationSpecId=1231173747155664896")로 필터링되었습니다.

추가 쿼리 매개변수

다른 매개변수(pageSize, pageToken)로 쿼리하려면 매개변수를 URL에 추가합니다.

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

매개변수를 앰퍼샌드(&)로 연결할 수도 있습니다.

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"