Method: projects.profiles.list

지금까지 수집되고 호출자가 볼 수 있는 권한이 있는 프로필을 나열합니다.

HTTP 요청

GET https://cloudprofiler.googleapis.com/v2/{parent=projects/*}/profiles

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 프로필 컬렉션을 소유한 상위 항목입니다. 형식: projects/{user_project_id} projects/{project} 형식이 사용됩니다.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • cloudprofiler.profiles.list

쿼리 매개변수

매개변수
pageSize

integer

선택사항입니다. 반환할 최대 항목 수입니다. 기본 pageSize는 1000입니다. 최대 한도는 1,000입니다.

pageToken

string

선택사항입니다. 특정 페이지에서 페이지로 나누기를 계속하고 프로필을 가져오는 토큰입니다. 페이지를 매길 때 profiles.list에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

ListProfileResponse에는 사용자가 볼 수 있는 권한이 있는 프로젝트에서 배포에 대해 수집된 프로필 목록이 포함됩니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "profiles": [
    {
      object (Profile)
    }
  ],
  "nextPageToken": string,
  "skippedProfiles": integer
}
필드
profiles[]

object (Profile)

가져온 프로필 목록입니다.

nextPageToken

string

결과의 다음 페이지를 수신하는 토큰입니다. 가져올 프로필이 더 이상 없으면 이 필드가 비어 있을 수 있습니다.

skippedProfiles

integer

프로필을 가져올 수 없어 현재 페이지에서 건너뛴 프로필 수입니다. 일반적으로 0이어야 합니다. 0이 아닌 값은 일시적인 오류를 나타낼 수 있습니다. 이 경우 숫자가 사용 사례보다 지나치게 높으면 호출을 다시 시도할 수 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/monitoring.write
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.