리소스, 평가 또는 작업을 나열할 때 필터링을 사용하여 더 구체적인 결과를 반환할 수 있습니다.
작업
다음 매개변수를 사용하여 나열된 작업을 필터링할 수 있습니다.
필터
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"
- dataset -
추가 쿼리 매개변수
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 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
다음 명령어를 실행합니다.
$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
요청이 성공하면 서버가 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 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
다음 명령어를 실행합니다.
$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
요청이 성공하면 서버가 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 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
다음 명령어를 실행합니다.
$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
요청이 성공하면 서버가 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 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
다음 명령어를 실행합니다.
$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
요청이 성공하면 서버가 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"