특정 프로젝트의 기록을 나열합니다.
내역은 수정 시간을 기준으로 내림차순으로 정렬됩니다. HistoryId 키는 수정 시간이 동일한 기록을 정렬하는 데 사용됩니다.
다음 표준 오류 코드 중 하나를 반환할 수 있습니다.
- PERMISSION_DENIED - 사용자에게 프로젝트를 읽을 수 있는 권한이 없는 경우
- INVALID_ARGUMENT - 요청의 형식이 잘못된 경우
- NOT_FOUND - 기록이 존재하지 않는 경우
HTTP 요청
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
projectId | 프로젝트 ID. 필수의. |
쿼리 매개변수
매개변수 | |
---|---|
pageToken | 다음 항목에서 쿼리를 재개하기 위한 연속 토큰입니다. 선택 과목. |
pageSize | 가져올 기록의 최대 수입니다. 기본값: 20. 필드가 설정되지 않았거나 값이 0인 경우 서버는 이 기본값을 사용합니다. 100보다 큰 값은 100으로 처리됩니다. 선택 과목. |
filterByName | 설정된 경우, 주어진 이름의 기록만 반환합니다. 선택 과목. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
HistoryService.List에 대한 응답 메시지
성공하면 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"histories": [
{
object ( |
필드 | |
---|---|
histories[] | 역사. |
nextPageToken | 다음 항목에서 쿼리를 재개하기 위한 연속 토큰입니다. 가져올 기록이 더 있는 경우에만 설정됩니다. 토큰은 첫 번째 목록 요청 시점부터 최대 1시간 동안 유효합니다. 예를 들어 오후 1시에 목록 요청을 하고 10분 후에 첫 번째 요청의 토큰을 사용하는 경우 두 번째 응답의 토큰은 50분 동안만 유효합니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
-
https://www.googleapis.com/auth/cloud-platform
자세한 내용은 인증 개요를 참조하세요.