Method: projects.profiles.create

profiles.create는 온라인 모드에서 새 프로필 리소스를 만듭니다.

이 API는 직접 사용하지 않는 것이 좋습니다. 대신 프로필 수집에 지원되는 프로파일러 에이전트를 사용하세요.

서버는 배포마다 일정한 속도로 새 프로필이 생성되게 하므로 다음 프로필 세션을 사용할 수 있을 때까지 생성 요청이 일정 시간 동안 중단될 수 있습니다.

최대 1분 내에 만들 수 없는 경우 ABORTED 오류와 함께 요청이 실패할 수 있으며, 응답에 다시 프로필 생성을 시도하기 전에 클라이언트가 가져야 하는 백오프 기간이 표시됩니다. 백오프 기간은 응답 상태의 google.rpc.RetryInfo 확장 프로그램으로 반환됩니다. gRPC 클라이언트에서는 확장 프로그램이 'google.rpc.retryinfo-bin'이라는 후행 메타데이터 항목에서 바이너리 직렬화된 proto로 반환됩니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

프로필을 만들 상위 프로젝트입니다. projects/{project} 형식이 사용됩니다.

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

  • cloudprofiler.profiles.create

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "deployment": {
    object (Deployment)
  },
  "profileType": [
    enum (ProfileType)
  ]
}
필드
deployment

object (Deployment)

배포 세부정보

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

  • cloudprofiler.profiles.create
profileType[]

enum (ProfileType)

에이전트가 제공할 수 있는 하나 이상의 프로필 유형입니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Profile의 인스턴스가 포함됩니다.

승인 범위

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

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

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