REST Resource: projects.locations.reportConfigs

资源：ReportConfig

描述 ReportConfig 对象的消息。ReportConfig 是用于生成资产清单报告的配置。如需了解如何设置各种字段，请参阅创建资产清单报告配置。

JSON 表示法 
{
  "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.
}
字段
name

string

标识符。资源名称。

格式：projects/{projectId}/locations/{location}/reportConfigs/{report-config-id}。
createTime

string (Timestamp format)

仅限输出。创建资产清单报告配置时的时间（世界协调时间 [UTC]）。系统会自动填充此字段。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。资产清单报告配置的更新时间（世界协调时间 [UTC]）。系统会自动填充此字段。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
frequencyOptions

object (FrequencyOptions)

生成资产清单报告的频率。
labels

map (key: string, value: string)

标签作为键值对

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
displayName

string

用户提供的显示名称，可以为空，长度不得超过 256 个字符，并且可以修改。
联合字段 report_format。生成资产清单报告的格式。report_format 只能是下列其中一项：
csvOptions

object (CSVOptions)

CSV 格式报告的选项。
parquetOptions

object (ParquetOptions)

Parquet 格式报告的选项。
联合字段 report_kind。资产清单报告内容的配置选项。report_kind 只能是下列其中一项：
objectMetadataReportOptions

object (ObjectMetadataReportOptions)

用于在资产清单报告中包含对象元数据的选项。

FrequencyOptions

FrequencyOptions 资源

生成资产清单报告的频率配置。

JSON 表示法 
{
  "frequency": enum (Frequency),
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
字段
frequency

enum (Frequency)

生成资产清单报告的频率。
startDate

object (Date)

开始生成资产清单报告的日期（世界协调时间 [UTC]）。例如 {"day": 15, "month": 8, "year": 2022}。
endDate

object (Date)

停止生成资产清单报告的日期（世界协调时间 [UTC]）。例如 {"day": 15, "month": 8, "year": 2022}。

频率

生成资产清单报告的频率。值包括 FREQUENCY_UNSPECIFIED、DAILY 或 WEEKLY。

枚举
FREQUENCY_UNSPECIFIED 未指定。
DAILY 资产清单报告每天生成一次。
WEEKLY 资产清单报告每周生成一次。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

CSVOptions

用于配置 CSV 格式的资产清单报告的选项。

JSON 表示法 
{
  "recordSeparator": string,
  "delimiter": string,
  "headerRequired": boolean
}
字段
recordSeparator

string

CSV 中的记录分隔符。
delimiter

string

CSV 中的分隔符。
headerRequired

boolean

如果设置，则在 CSV 报告中包含标题行。

ParquetOptions

此类型没有字段。

用于配置 Parquet 格式的资产清单报告的选项。

ObjectMetadataReportOptions

用于在资产清单报告中包含元数据的选项。

JSON 表示法 
{
  "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.
}
字段
metadataFields[]

string

资产清单报告中包含的元数据字段。
联合字段 filter。过滤存储桶以生成 Cloud Storage 的资产清单报告。filter 只能是下列其中一项：
storageFilters

object (CloudStorageFilters)

过滤存储桶以生成 Cloud Storage 的资产清单报告。
联合字段 destination_options。用于在 Cloud Storage 中存储报告的选项。destination_options 只能是下列其中一项：
storageDestinationOptions

object (CloudStorageDestinationOptions)

用于在 Cloud Storage 中存储报告的选项。

CloudStorageFilters

过滤存储桶以生成 Cloud Storage 的资产清单报告。

JSON 表示法 
{
  "bucket": string
}
字段
bucket

string

可选。生成其资产清单报告的存储桶。

CloudStorageDestinationOptions

用于在 Cloud Storage 中存储资产清单报告的选项。

JSON 表示法 
{
  "bucket": string,
  "destinationPath": string
}
字段
bucket

string

可选。资产清单报告的目标存储桶。
destinationPath

string

存储桶内用于存储资产清单报告的目标路径。

方法

create

 在给定项目的给定位置中创建新的资产清单报告配置。

delete

 在给定项目的给定位置中删除现有资产清单报告配置。

get

 在给定项目的给定位置中获取资产清单报告配置。

list

 在给定项目的给定位置中列出资产清单报告配置。

patch

 在给定项目的给定位置中更新现有资产清单报告配置。