REST Resource: projects.locations.reportConfigs.reportDetails

리소스: ReportDetail

ReportDetail 객체를 설명하는 메시지 ReportDetail는 보고서 구성에 대해 생성된 인벤토리 보고서의 메타데이터를 나타냅니다.

JSON 표현 
{
  "name": string,
  "snapshotTime": string,
  "reportPathPrefix": string,
  "shardsCount": string,
  "status": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "targetDatetime": {
    object (DateTime)
  },
  "reportMetrics": {
    object (Metrics)
  }
}
필드
name

string

리소스 이름입니다. 형식은 projects/{projectNumber}/locations/{location}/reportConfigs/{report-config-id}/reportDetails/{report-detail-id}입니다.
snapshotTime

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"입니다.
reportPathPrefix

string

각 보고서 샤드의 객체 이름의 접두사입니다. 여기에는 extension 및 shard_id를 제외한 전체 접두사가 있습니다. 예를 들어 destinationPath이 {report-config-id}/dt={datetime}이면 샤드 객체 이름은 gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_5.csv이고 reportPathPrefix 필드의 값은 gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_입니다.
shardsCount

string (int64 format)

인벤토리 보고서에 대해 생성된 총 샤드입니다.
status

object (Status)

인벤토리 보고서의 상태입니다.
labels

map (key: string, value: string)

키-값 쌍인 라벨입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
targetDatetime

object (DateTime)

인벤토리 보고서 생성 날짜 및 시간입니다. 이 입력란은 자동으로 채워집니다. targetDatetime의 시간 부분은 항상 0입니다.
reportMetrics

object (Metrics)

인벤토리 보고서의 측정항목입니다.

DateTime

상용시(또는 간혹 물리적 시간)를 나타냅니다.

이 유형은 다음 몇 가지 가능한 방법 중 하나로 상용시를 나타낼 수 있습니다.

  • utcOffset이 설정되고 timeZone이 설정되지 않은 경우: UTC 기준으로 특정 오프셋이 있는 캘린더 일자의 상용시입니다.
  • timeZone이 설정되고 utcOffset이 설정되지 않은 경우: 특정 시간대의 캘린더 일자 상용시입니다.
  • timeZone 또는 utcOffset이 모두 설정되지 않은 경우: 현지 시간으로 캘린더 일자의 상용시입니다.

날짜는 그레고리력을 기준으로 합니다.

연도, 월, 일이 0이면 DateTime에 각각 특정 연도, 월, 일이 없는 것으로 간주됩니다.

이 유형은 모든 날짜 및 시간 필드가 설정되었고 time_offset 중 하나가 설정된 경우 실제 시간을 나타내는 데 사용될 수도 있습니다. 실제 시간으로 대신 Timestamp 메시지를 사용하는 것이 좋습니다. 사용 사례에서 사용자의 시간대를 저장하려는 경우 다른 필드에서 저장할 수 있습니다.

이 유형은 일부 애플리케이션에 필요한 것보다 더 유연합니다. 애플리케이션의 제한사항을 문서화하고 검증하세요.

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
필드
year

integer

선택사항입니다. 연도. 1~9999 사이의 값이어야 합니다. 단, 연도 없이 날짜/시간을 지정할 경우 0입니다.
month

integer

선택사항입니다. 월. 1~12 사이의 값이어야 합니다. 단, 월 없이 날짜/시간을 지정할 경우 0입니다.
day

integer

선택사항입니다. 일. 1~31 사이의 값이어야 하며 유효한 연도와 월이어야 합니다. 정해진 날 없이 날짜/시간을 지정할 경우 0입니다.
hours

integer

선택사항입니다. 24시간 형식의 시간입니다. 0~23 사이의 값이어야 하며 기본값은 0(자정)입니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
minutes

integer

선택사항입니다. 특정 시간의 분입니다. 0에서 59 사이의 값이어야 하며 기본값은 0입니다.
seconds

integer

선택사항입니다. 특정 분의 초입니다. 일반적으로 0에서 59 사이의 값이어야 하며 기본값은 0입니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos

integer

선택사항입니다. 나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 하며 기본값은 0입니다.
통합 필드 time_offset. 선택사항입니다. UTC 오프셋 또는 DateTime의 시간대를 지정합니다. 이후에 시간대 데이터가 변경될 수 있으므로(예: 국가에서 DST 시작일/종료일을 수정하고 영향을 받는 범위의 향후 DateTime이 이미 저장된 경우) 이 점을 고려하여 신중하게 선택하세요. 생략하면 DateTime이 현지 시간으로 간주됩니다. time_offset은 다음 중 하나여야 합니다.
utcOffset

string (Duration format)

UTC 오프셋입니다. -18시간에서 +18시간 사이의 정수 초여야 합니다. 예를 들어 UTC 오프셋 -4:00은 {초: -14400}으로 표현됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
timeZone

object (TimeZone)

시간대입니다.

TimeZone

IANA 시간대 데이터베이스에서 가져온 시간대를 나타냅니다.

JSON 표현 
{
  "id": string,
  "version": string
}
필드
id

string

IANA 시간대 데이터베이스의 시간대입니다. 예: 'America/New_York'
version

string

선택사항입니다. IANA 시간대 데이터베이스의 버전 번호입니다. 예를 들면 '2019a'입니다.

측정항목

생성된 보고서와 연결된 측정항목입니다.

JSON 표현 
{
  "processedRecordsCount": string
}
필드
processedRecordsCount

string (int64 format)

인벤토리 보고서에 포함된 Cloud Storage 객체 수입니다.

메서드

get

 특정 위치의 특정 프로젝트에 있는 기존 인벤토리 보고서를 가져옵니다.

list

 특정 위치의 특정 프로젝트에 있는 인벤토리 보고서를 나열합니다.