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 instantâneo. Todos os dados do relatório de inventário são referenciados neste momento.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". 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. 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 é 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 é 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)

Estado do relatório de inventário.
labels

map (key: string, value: string)

Etiquetas como pares de chave-valor

Um objeto que contém 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. Este campo é preenchido automaticamente. A parte da hora de targetDatetime é sempre 0.
reportMetrics

object (Metrics)

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

DateTime

Representa a hora civil (ou, ocasionalmente, a hora física).

Este tipo pode representar uma hora civil de uma das seguintes formas possíveis:

  • Quando utcOffset está definido e timeZone não está definido: uma hora civil num dia do calendário com uma determinada diferença para UTC.
  • Quando timeZone está definido e utcOffset não está definido: uma hora civil num dia do calendário num fuso horário específico.
  • Quando não é definido nem timeZone nem utcOffset: uma hora civil num dia do calendário na hora local.

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

Se o ano, o mês ou o dia for 0, considera-se que o DateTime não tem um ano, um mês ou um dia específico, respetivamente.

Este tipo também pode ser usado para representar uma hora física se todos os campos de data e hora estiverem definidos e qualquer um dos casos de time_offset estiver definido. Em alternativa, considere usar a mensagem Timestamp para a hora física. Se o seu exemplo de utilização também quiser armazenar o fuso horário do utilizador, isso pode ser feito noutro campo.

Este tipo é mais flexível do que algumas aplicações podem querer. Certifique-se de que documenta e valida as limitações da sua aplicação.

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. Tem de ser de 1 a 9999 ou 0 se especificar uma data/hora sem um ano.
month

integer

Opcional. Mês do ano. Tem de estar compreendido entre 1 e 12 ou ser 0 se especificar uma data/hora sem um mês.
day

integer

Opcional. Dia do mês. Tem de estar compreendido entre 1 e 31 e ser válido para o ano e o mês, ou 0 se especificar uma data/hora sem um dia.
hours

integer

Opcional. Horas do dia no formato de 24 horas. Deve estar entre 0 e 23, sendo a predefinição 0 (meia-noite). Uma API pode optar por permitir o valor "24:00:00" para cenários como a hora de encerramento da empresa.
minutes

integer

Opcional. Minutos da hora do dia. Tem de ser um valor entre 0 e 59. A predefinição é 0.
seconds

integer

Opcional. Segundos dos minutos da hora. Normalmente, tem de estar entre 0 e 59. A predefinição é 0. Uma API pode permitir o valor 60 se permitir segundos intercalares.
nanos

integer

Opcional. Frações de segundos em nanosegundos. Tem de estar entre 0 e 999 999 999. A predefinição é 0.
Campo de união time_offset. Opcional. Especifica a diferença horária entre UTC e o fuso horário do DateTime. Escolha cuidadosamente entre eles, tendo em conta que os dados de fuso horário podem mudar no futuro (por exemplo, um país modifica as datas de início/fim da hora de verão e as datas/horas futuras no intervalo afetado já tinham sido armazenadas). Se for omitido, o DateTime é considerado na hora local. time_offset só pode ser uma das seguintes opções:
utcOffset

string (Duration format)

Diferença face ao UTC. Tem de ser segundos inteiros, entre -18 horas e +18 horas. Por exemplo, um desvio de UTC de -4:00 seria representado como { seconds: -14400 }.

Uma duração em segundos com até nove dígitos fracionários, que termina com "s". Exemplo: "3.5s".
timeZone

object (TimeZone)

Fuso horário.

Fuso horário

Representa um fuso horário da base de dados de fusos horários da IANA.

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

string

Fuso horário da base de dados de fusos horários da IANA. Por exemplo, "America/New_York".
version

string

Opcional. Número da versão da base de dados de fusos horários da IANA. Por exemplo, "2019a".

Métrica

Métricas associadas ao relatório gerado.

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

string (int64 format)

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

Métodos

get

 Obtém um relatório de inventário existente num determinado projeto para uma determinada localização.

list

 Apresenta os relatórios de inventário num determinado projeto para uma determinada localização.