REST Resource: projects.locations.reportConfigs.reportDetails

Recurso: ReportDetail

Mensagem que descreve o objeto ReportDetail. ReportDetail representa os metadados do relatório de inventário gerado para uma configuração de relatório.

Representação JSON
{
  "name": string,
  "snapshotTime": string,
  "reportPathPrefix": string,
  "shardsCount": string,
  "status": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "targetDatetime": {
    object (DateTime)
  },
  "reportMetrics": {
    object (Metrics)
  }
}
Campos
name

string

Nome do recurso. Formato: projects/{projectNumber}/locations/{location}/reportConfigs/{report-config-id}/reportDetails/{report-detail-id}.

snapshotTime

string (Timestamp format)

A hora do snapshot. Todos os dados do relatório de inventário são referenciados neste momento.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

reportPathPrefix

string

Prefixo do nome do objeto de cada fragmento do relatório. Ele tem o prefixo completo, exceto extension e shard_id. Por exemplo, se destinationPath for {report-config-id}/dt={datetime}, o nome do objeto de fragmento será gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_5.csv e o valor do campo reportPathPrefix será gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_.

shardsCount

string (int64 format)

Total de fragmentos gerados para o relatório de inventário.

status

object (Status)

Status do relatório de inventário.

labels

map (key: string, value: string)

Rótulos como pares de chave-valor

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

targetDatetime

object (DateTime)

A data e a hora da geração do relatório de inventário. Esse campo é preenchido automaticamente. A parte de tempo de targetDatetime é sempre 0.

reportMetrics

object (Metrics)

Métricas do relatório de inventário.

DateTime

Representa o horário civil (ou, às vezes, o horário físico).

Esse tipo pode representar um horário civil de uma das seguintes maneiras:

  • Quando utcOffset é definido e timeZone não é definido: um horário civil em um dia do calendário com um deslocamento específico do UTC.
  • Quando timeZone é definido e utcOffset não é definido: uma hora civil em um dia do calendário em um fuso horário específico.
  • Quando nem timeZone nem utcOffset estão definidos: uma hora civil em um dia do calendário no horário local.

A data é referente ao calendário gregoriano proléptico.

Se o ano, o mês ou o dia forem 0, o DateTime será considerado sem um ano, mês ou dia específico, respectivamente.

Esse tipo também pode ser usado para representar um horário físico se todos os campos de data e hora estiverem definidos e se um dos casos de time_offset estiver definido. Considere usar a mensagem Timestamp para o tempo físico. Se o caso de uso também quiser armazenar o fuso horário do usuário, isso pode ser feito em outro campo.

Esse tipo é mais flexível do que alguns aplicativos podem querer. Documente e valide as limitações do seu aplicativo.

Representação 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.
}
Campos
year

integer

Opcional. Ano da data. Precisa ser de 1 a 9999 ou 0 se especificar uma data/hora sem um ano.

month

integer

Opcional. Mês do ano. Precisa ser de 1 a 12 ou 0 se especificar uma data/hora sem um mês.

day

integer

Opcional. Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 se especificar uma data/hora sem dia.

hours

integer

Opcional. Horas do dia no formato de 24 horas. Precisa ser de 0 a 23, o padrão é 0 (meia-noite). Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.

minutes

integer

Opcional. Minutos da hora do dia. Precisa ser de 0 a 59, o padrão é 0.

seconds

integer

Opcional. Segundos do minutos do horário. Normalmente precisa ser de 0 a 59, padrão 0. Uma API pode permitir o valor 60 se permitir segundos bissextos.

nanos

integer

Opcional. Frações de segundos em nanossegundos. Precisa ser de 0 a 999.999.999. O padrão é 0.

Campo de união time_offset. Opcional. Especifica o deslocamento UTC ou o fuso horário do DateTime. Escolha com cuidado entre eles, considerando que os dados de fuso horário podem mudar no futuro (por exemplo, um país modifica as datas de início/término do horário de verão, e as datas e horários no período afetado já foram armazenadas). Se omitido, o DateTime será considerado no horário local. time_offset pode ser apenas de um dos tipos a seguir:
utcOffset

string (Duration format)

Deslocamento de UTC. Precisa ser um segundo inteiro, entre -18 horas e +18 horas. Por exemplo, um deslocamento UTC de -4:00 seria representado como { seconds: -14400 }.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

timeZone

object (TimeZone)

Fuso horário.

TimeZone

Representa um fuso horário do banco de dados IANA.

Representação JSON
{
  "id": string,
  "version": string
}
Campos
id

string

Fuso horário do banco de dados IANA. Por exemplo, "America/New_York".

version

string

Opcional. Número da versão do banco de dados de fuso horário IANA. Por exemplo, "2019a".

Métricas

Métricas associadas ao relatório gerado.

Representação JSON
{
  "processedRecordsCount": string
}
Campos
processedRecordsCount

string (int64 format)

Contagem de objetos do Cloud Storage que fazem parte do relatório de inventário.

Métodos

get

Consegue um relatório de inventário em um determinado projeto para um local.

list

Lista os relatórios de inventário em um determinado projeto para um local.