REST Resource: projects.locations.reportConfigs.reportDetails

Recurso: ReportDetail

Mensaje que describe el objeto ReportDetail. ReportDetail representa los metadatos del informe de inventario generado para una configuración de informe.

Representación JSON
{
  "name": string,
  "snapshotTime": string,
  "reportPathPrefix": string,
  "shardsCount": string,
  "status": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "targetDatetime": {
    object (DateTime)
  },
  "reportMetrics": {
    object (Metrics)
  }
}
Campos
name

string

Es el nombre del recurso. Formato: projects/{projectNumber}/locations/{location}/reportConfigs/{report-config-id}/reportDetails/{report-detail-id}.

snapshotTime

string (Timestamp format)

La hora de la instantánea. Se hace referencia a todos los datos del informe de inventario en este momento.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

reportPathPrefix

string

Es el prefijo del nombre del objeto del fragmento de cada informe. Tiene el prefijo completo, excepto extension y shard_id. Por ejemplo, si destinationPath es {report-config-id}/dt={datetime}, el nombre del objeto de fragmento es gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_5.csv y el valor del campo reportPathPrefix es gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_.

shardsCount

string (int64 format)

Es la cantidad total de fragmentos generados para el informe de inventario.

status

object (Status)

Es el estado del informe de inventario.

labels

map (key: string, value: string)

Etiquetas como pares clave-valor

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

targetDatetime

object (DateTime)

Es la fecha y hora de generación del informe de inventario. Este campo se completa automáticamente. La parte de hora de targetDatetime siempre es 0.

reportMetrics

object (Metrics)

Métricas del informe de inventario

DateTime

Representa la hora civil (o, en ocasiones, la hora física).

Este tipo puede representar una hora civil de una de las siguientes maneras:

  • Cuando utcOffset está establecido y timeZone no está establecido: una hora civil en un día calendario con un desplazamiento particular de UTC.
  • Cuando se establece timeZone y no se establece utcOffset: una hora civil en un día calendario en una zona horaria en particular.
  • Cuando no se establecen timeZone ni utcOffset, se muestra una hora civil en un día calendario en hora local.

La fecha está relacionada con el calendario gregoriano proléptico.

Si el año, el mes o el día son 0, se considera que la fecha y hora no tiene un año, un mes o un día específicos, respectivamente.

Este tipo también se puede usar para representar una hora física si se configuran todos los campos de fecha y hora, y se establece cualquiera de los casos de time_offset oneof. En su lugar, considera usar el mensaje Timestamp para la hora física. Si tu caso de uso también desea almacenar la zona horaria del usuario, puedes hacerlo en otro campo.

Este tipo es más flexible que el que pueden desear algunas aplicaciones. Asegúrate de documentar y validar las limitaciones de tu aplicación.

Representación 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. Año de la fecha. Debe ser entre 1 y 9999, o bien 0 si se especifica una fecha y hora sin año.

month

integer

Opcional. Mes del año. Debe ser del 1 al 12 o 0 si se especifica una fecha y hora sin un mes.

day

integer

Opcional. Día del mes. Debe ser entre 1 y 31, y ser válido para el año y el mes, o bien debe ser 0 si se especifica una fecha y hora sin un día.

hours

integer

Opcional. Horas del día en formato de 24 horas. Debe ser de 0 a 23, el valor predeterminado es 0 (medianoche). Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.

minutes

integer

Opcional. Minutos de horas del día. Debe ser un valor entre 0 y 59. El valor predeterminado es 0.

seconds

integer

Opcional. Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59, el valor predeterminado es 0. Una API puede permitir el valor 60 si permite segundos bisiestos.

nanos

integer

Opcional. Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999. El valor predeterminado es 0.

Campo de unión time_offset. Opcional. Especifica el desplazamiento en UTC o la zona horaria de DateTime. Elige cuidadosamente entre ellos, teniendo en cuenta que los datos de zona horaria pueden cambiar en el futuro (por ejemplo, un país modifica las fechas de inicio y finalización del horario de verano, y las DateTime futuras en el rango afectado ya se habían almacenado). Si se omite, se considera que la fecha y hora están en la hora local. time_offset puede ser solo uno de los siguientes:
utcOffset

string (Duration format)

Compensación de UTC. Debe ser un número entero de segundos, entre -18 horas y +18 horas. Por ejemplo, un desfase de UTC de -4:00 se representaría como { seconds: -14400 }.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

timeZone

object (TimeZone)

Zona horaria

TimeZone

Representa una zona horaria de la base de datos de zonas horarias de IANA.

Representación JSON
{
  "id": string,
  "version": string
}
Campos
id

string

Es la zona horaria de la base de datos de zonas horarias de IANA. Por ejemplo, "America/New_York".

version

string

Opcional. Número de versión de la base de datos de zonas horarias de IANA. Por ejemplo, "2019a".

Métricas

Métricas asociadas con el informe generado.

Representación JSON
{
  "processedRecordsCount": string
}
Campos
processedRecordsCount

string (int64 format)

Es el recuento de objetos de Cloud Storage que forman parte del informe de inventario.

Métodos

get

Obtén un informe de inventario existente en un proyecto determinado para una ubicación determinada.

list

Muestra una lista de los informes de inventario de un proyecto y una ubicación determinados.