Method: projects.locations.configurations.aggregateUsage

구성의 인스턴스별 사용량을 집계합니다.

HTTP 요청

GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:aggregateUsage

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

경로 매개변수

매개변수
name

string

필수 입력란입니다. AggregateUsageRequest의 상위 값

쿼리 매개변수

파라미터
pageSize

integer

선택사항. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
pageToken

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
filter

string

선택사항. 결과 필터링
orderBy

string

선택사항. 결과 정렬 방법에 대한 힌트
startTime

string (Timestamp format)

필수 입력란입니다. 라이선스는 월별로 구매하므로 사용량 추적에는 월의 시작 시간이 필요합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
endTime

string (Timestamp format)

필수 입력란입니다. 사용 추적은 항상 한 달 동안 진행됩니다. 이 매개변수는 월의 종료 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

요청 본문

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

응답 본문

사용량 집계에 대한 응답 메시지

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

JSON 표현 
{
  "usages": [
    {
      object (Usage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
필드
usages[]

object (Usage)

구성별 사용량의 집계된 기록
nextPageToken

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
unreachable[]

string

도달할 수 없는 위치입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • licensemanager.configurations.aggregateUsage

자세한 내용은 IAM 문서를 참조하세요.

사용

VM에 액세스한 사용자의 총수를 설명하는 메시지입니다.

JSON 표현 
{
  "limaInstance": string,
  "users": integer
}
필드
limaInstance

string

LiMa 인스턴스 리소스 이름(예: projects/{project}/locations/{location}/instances/{instance})
users

integer

VM에 액세스하는 순 사용자 수입니다.