REST Resource: projects.locations.reportConfigs

Ressource: ReportConfig

Nachricht, die das ReportConfig-Objekt beschreibt. ReportConfig ist die Konfiguration, mit der Inventarberichte generiert werden. Informationen zum Festlegen verschiedener Felder finden Sie unter Inventarberichtskonfiguration erstellen.

JSON-Darstellung
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "frequencyOptions": {
    object (FrequencyOptions)
  },
  "labels": {
    string: string,
    ...
  },
  "displayName": string,

  // Union field report_format can be only one of the following:
  "csvOptions": {
    object (CSVOptions)
  },
  "parquetOptions": {
    object (ParquetOptions)
  }
  // End of list of possible types for union field report_format.

  // Union field report_kind can be only one of the following:
  "objectMetadataReportOptions": {
    object (ObjectMetadataReportOptions)
  }
  // End of list of possible types for union field report_kind.
}
Felder
name

string

Kennung. Name der Ressource.

Format: projects/{projectId}/locations/{location}/reportConfigs/{report-config-id}.

createTime

string (Timestamp format)

Nur Ausgabe. Die UTC-Zeit, zu der die Konfiguration für den Inventarbericht erstellt wurde. Dieser Wert wird automatisch ausgefüllt.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Nur Ausgabe. Die UTC-Zeit, zu der die Inventarberichtskonfiguration aktualisiert wurde. Dieser Wert wird automatisch ausgefüllt.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

frequencyOptions

object (FrequencyOptions)

Die Häufigkeit der Generierung von Inventarberichten.

labels

map (key: string, value: string)

Labels als Schlüssel/Wert-Paare

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

displayName

string

Vom Nutzer angegebener Anzeigename, der leer sein kann und auf 256 Zeichen begrenzt ist. Er kann bearbeitet werden.

Union-Feld report_format. Format, in dem der Inventarbericht generiert wird. Für report_format ist nur einer der folgenden Werte zulässig:
csvOptions

object (CSVOptions)

Optionen für Berichte im CSV-Format.

parquetOptions

object (ParquetOptions)

Optionen für Berichte im Parquet-Format.

Union-Feld report_kind. Konfigurationsoptionen für den Inhalt von Inventarberichten. Für report_kind ist nur einer der folgenden Werte zulässig:
objectMetadataReportOptions

object (ObjectMetadataReportOptions)

Optionen zum Einbeziehen von Objektmetadaten in einen Inventarbericht.

FrequencyOptions

FrequencyOptions-Ressource

Häufigkeitskonfiguration für die Generierung von Inventarberichten.

JSON-Darstellung
{
  "frequency": enum (Frequency),
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Felder
frequency

enum (Frequency)

Häufigkeit der Generierung von Inventarberichten.

startDate

object (Date)

Das UTC-Datum, ab dem Inventarberichte erstellt werden sollen. Beispiel:{"day": 15, "month": 8, "year": 2022}.

endDate

object (Date)

Das UTC-Datum, an dem die Erstellung von Inventarberichten beendet werden soll. Beispiel:{"day": 15, "month": 8, "year": 2022}.

Häufigkeit

Die Häufigkeit, mit der die Inventarberichte generiert werden. Mögliche Werte sind FREQUENCY_UNSPECIFIED, DAILY und WEEKLY.

Enums
FREQUENCY_UNSPECIFIED Nicht angegeben.
DAILY Der Inventarbericht wird täglich generiert.
WEEKLY Der Inventarbericht wird wöchentlich erstellt.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes bedeuten:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
  • Einen Monat und Tag mit dem Wert „0“ für das Jahr (z. B. ein Jahrestag).
  • Ein Jahr für sich, mit dem Wert „0“ für Monat und Tag.
  • Ein Jahr und ein Monat mit dem Wert „0“ für den Tag (z. B. das Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Das Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird.

month

integer

Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.

day

integer

Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist.

CSVOptions

Optionen zum Konfigurieren von Inventarberichten im CSV-Format.

JSON-Darstellung
{
  "recordSeparator": string,
  "delimiter": string,
  "headerRequired": boolean
}
Felder
recordSeparator

string

Trennzeichen für Einträge in CSV-Dateien.

delimiter

string

Trennzeichen in CSV

headerRequired

boolean

Wenn festgelegt, enthält der CSV-Bericht eine Kopfzeile.

ParquetOptions

Dieser Typ hat keine Felder.

Optionen zum Konfigurieren von Inventarberichten im Parquet-Format.

ObjectMetadataReportOptions

Optionen zum Einbeziehen von Metadaten in einen Inventarbericht.

JSON-Darstellung
{
  "metadataFields": [
    string
  ],

  // Union field filter can be only one of the following:
  "storageFilters": {
    object (CloudStorageFilters)
  }
  // End of list of possible types for union field filter.

  // Union field destination_options can be only one of the following:
  "storageDestinationOptions": {
    object (CloudStorageDestinationOptions)
  }
  // End of list of possible types for union field destination_options.
}
Felder
metadataFields[]

string

Die Metadatenfelder, die in einem Inventarbericht enthalten sind.

Union-Feld filter. Hiermit werden Buckets gefiltert, um Inventarberichte für Cloud Storage zu generieren. Für filter ist nur einer der folgenden Werte zulässig:
storageFilters

object (CloudStorageFilters)

Hiermit werden Buckets gefiltert, um Inventarberichte für Cloud Storage zu generieren.

Union-Feld destination_options. Optionen zum Speichern von Berichten in Cloud Storage Für destination_options ist nur einer der folgenden Werte zulässig:
storageDestinationOptions

object (CloudStorageDestinationOptions)

Optionen zum Speichern von Berichten in Cloud Storage

CloudStorageFilters

Hiermit werden Buckets gefiltert, um Inventarberichte für Cloud Storage zu generieren.

JSON-Darstellung
{
  "bucket": string
}
Felder
bucket

string

Optional. Bucket, für den der Inventarbericht generiert wird.

CloudStorageDestinationOptions

Optionen zum Speichern von Inventarberichten in Cloud Storage

JSON-Darstellung
{
  "bucket": string,
  "destinationPath": string
}
Felder
bucket

string

Optional. Der Ziel-Bucket für die Inventarberichte.

destinationPath

string

Der Zielpfad innerhalb des Buckets, in dem die Inventarberichte gespeichert werden.

Methoden

create

Erstellt eine neue Inventarberichtskonfiguration in einem bestimmten Projekt für einen bestimmten Standort.

delete

Löscht eine vorhandene Inventarberichtskonfiguration in einem bestimmten Projekt für einen bestimmten Standort.

get

Ruft die Inventarberichtskonfiguration in einem bestimmten Projekt für einen bestimmten Standort ab.

list

Listet die Inventarberichtskonfigurationen in einem bestimmten Projekt für einen bestimmten Standort auf.

patch

Aktualisiert eine vorhandene Inventarberichtskonfiguration in einem bestimmten Projekt für einen bestimmten Standort.