Package google.cloud.asset.v1p7beta1

Index

AssetService

Asset service definition.

CreateExportSetting

rpc CreateExportSetting(CreateExportSettingRequest) returns (ExportSetting)

Creates an export setting.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

DeleteExportSetting

rpc DeleteExportSetting(DeleteExportSettingRequest) returns (Empty)

Deletes an export setting.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ExportAssetUpdates

rpc ExportAssetUpdates(ExportAssetUpdatesRequest) returns (Operation)

Exports asset updates within a time window to a given Cloud Storage location/BigQuery table. For Cloud Storage location destinations, the output format is newline-delimited JSON. Each line represents a google.cloud.asset.v1p7beta1.Asset in the JSON format; for BigQuery table destinations, the output table stores the fields in asset proto as columns. This API implements the google.longrunning.Operation API , which allows you to keep track of the export. We recommend intervals of at least 2 seconds with exponential retry to poll the export operation result. For regular-size resource parent, the export operation usually finishes within 5 minutes.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ExportAssets

rpc ExportAssets(ExportAssetsRequest) returns (Operation)

Exports assets with time and resource types to a given Cloud Storage location/BigQuery table. For Cloud Storage location destinations, the output format is newline-delimited JSON. Each line represents a google.cloud.asset.v1p7beta1.Asset in the JSON format; for BigQuery table destinations, the output table stores the fields in asset proto as columns. This API implements the google.longrunning.Operation API , which allows you to keep track of the export. We recommend intervals of at least 2 seconds with exponential retry to poll the export operation result. For regular-size resource parent, the export operation usually finishes within 5 minutes.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

GetExportSetting

rpc GetExportSetting(GetExportSettingRequest) returns (ExportSetting)

Gets details about an export setting.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

GetInventorySettings

rpc GetInventorySettings(GetInventorySettingsRequest) returns (InventorySettings)

Gets details about an inventory setting.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ListAssetUpdates

rpc ListAssetUpdates(ListAssetUpdatesRequest) returns (ListAssetUpdatesResponse)

Lists asset updates within a time window and returns paged results in response.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ListExportSettings

rpc ListExportSettings(ListExportSettingsRequest) returns (ListExportSettingsResponse)

Lists all export settings under a [InventorySettings].

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

UpdateExportSetting

rpc UpdateExportSetting(UpdateExportSettingRequest) returns (ExportSetting)

Updates an export setting.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Asset

An asset in Google Cloud. An asset can be any resource in the Google Cloud resource hierarchy, a resource outside the Google Cloud resource hierarchy (such as Google Kubernetes Engine clusters and objects), or a policy (e.g. Cloud IAM policy). See Supported asset types for more information.

Fields
update_time

Timestamp

The last update timestamp of an asset. update_time is updated when create/update/delete operation is performed.

name

string

The full name of the asset. Example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1

See Resource names for more information.

asset_type

string

The type of the asset. Example: compute.googleapis.com/Disk

See Supported asset types for more information.

deleted

bool

Whether the asset has been deleted or not.

resource

Resource

A representation of the resource.

iam_policy

Policy

A representation of the Cloud IAM policy set on a Google Cloud resource. There can be a maximum of one Cloud IAM policy set on any given resource. In addition, Cloud IAM policies inherit their granted access scope from any policies set on parent resources in the resource hierarchy. Therefore, the effectively policy is the union of both the policy set on this resource and each policy set on all of the resource's ancestry resource levels in the hierarchy. See this topic for more information.

org_policy[]

Policy

A representation of an organization policy. There can be more than one organization policy with different constraints set on a given resource.

ancestors[]

string

The ancestry path of an asset in Google Cloud resource hierarchy, represented as a list of relative resource names. An ancestry path starts with the closest ancestor in the hierarchy and ends at root. If the asset is a project, folder, or organization, the ancestry path starts from the asset itself.

Example: ["projects/123456789", "folders/5432", "organizations/1234"]

Union field access_context_policy. A representation of an access policy. access_context_policy can be only one of the following:
access_policy

AccessPolicy

Please also refer to the access policy user guide.

access_level

AccessLevel

Please also refer to the access level user guide.

service_perimeter

ServicePerimeter

Please also refer to the service perimeter user guide.

BigQueryDestination

A BigQuery destination for exporting assets to.

Fields
dataset

string

Required. The BigQuery dataset in format "projects/projectId/datasets/datasetId", to which the snapshot result should be exported. If this dataset does not exist, the export call returns an INVALID_ARGUMENT error.

table

string

Required. The BigQuery table to which the snapshot result should be written. If this table does not exist, a new table with the given name will be created.

In the case of scheduled export, the real destination is [table] appended with a suffix indicating the point-in-time of the snapshot. For example, suppose field [table] is "mytable". When [separate_tables_per_asset_type] and is FALSE, the destination will be "mytable_snapshot_20201122060000", and when [separate_tables_per_asset_type] and is TRUE and the [asset_types] contains "storage.googleapis.com/Bucket", the destination will be "mytable_snapshot_20201122060000_storage_googleapis_com_Bucket"

force

bool

If the destination table already exists and this flag is TRUE, the table will be overwritten by the contents of assets snapshot. If the flag is FALSE or unset and the destination table already exists, the export call returns an INVALID_ARGUMEMT error.

partition_spec

PartitionSpec

[partition_spec] determines whether to export to partitioned table(s) and how to partition the data.

If [partition_spec] is unset or [partition_spec.partition_key] is unset or PARTITION_KEY_UNSPECIFIED, the snapshot results will be exported to non-partitioned table(s). [force] will decide whether to overwrite existing table(s).

If [partition_spec] is specified. First, the snapshot results will be written to partitioned table(s) with two additional timestamp columns, readTime and requestTime, one of which will be the partition key. Secondly, in the case when any destination table already exists, it will first try to update existing table's schema as necessary by appending additional columns. Then, if [force] is TRUE, the corresponding partition will be overwritten by the snapshot results (data in different partitions will remain intact); if [force] is unset or FALSE, it will append the data. An error will be returned if the schema update or data appension fails.

separate_tables_per_asset_type

bool

If this flag is TRUE, the snapshot results will be written to one or multiple tables, each of which contains results of one asset type. The [force] and [partition_spec] fields will apply to each of them.

Field [table] will be concatenated with "_" and the asset type names (see https://cloud.google.com/asset-inventory/docs/supported-asset-types for supported asset types) to construct per-asset-type table names, in which all non-alphanumeric characters like "." and "/" will be substituted by "_". Example: if field [table] is "mytable" and snapshot results contain "storage.googleapis.com/Bucket" assets, the corresponding table name will be "mytable_storage_googleapis_com_Bucket". If any of these tables does not exist, a new table with the concatenated name will be created.

When [content_type] in the ExportAssetsRequest is RESOURCE, the schema of each table will include RECORD-type columns mapped to the nested fields in the Asset.resource.data field of that asset type (up to the 15 nested level BigQuery supports (https://cloud.google.com/bigquery/docs/nested-repeated#limitations)). The fields in >15 nested levels will be stored in JSON format string as a child column of its parent RECORD column.

If error occurs when exporting to any table, the whole export call will return an error but the export results that already succeed will persist. Example: if exporting to table_type_A succeeds when exporting to table_type_B fails during one export call, the results in table_type_A will persist and there will not be partial results persisting in a table.

BigQuerySetting

Setting for scheduled export to BigQuery.

Fields
destination

BigQueryDestination

Required. Destination on BigQuery. The output table stores the fields in asset proto as columns in BigQuery.

snapshot_schedule

ScheduleConfig

Schedule for scheduled export of asset snapshot.

ContentType

Asset content type.

Enums
CONTENT_TYPE_UNSPECIFIED Unspecified content type.
RESOURCE Resource metadata.
IAM_POLICY The actual IAM policy set on a resource.
ORG_POLICY The Cloud Organization Policy set on an asset.
ACCESS_POLICY The Cloud Access context manager Policy set on an asset.

CreateExportSettingRequest

Fields
parent

string

Required. Name of the inventory settings where this export setting should be created in.

The format will be: projects/{PROJECT_NUMBER}/inventorySettings folders/{FOLDER_NUMBER}/inventorySettings organizations/{ORGANIZATION_NUMBER}/inventorySettings

Currently a maximum of 100 export setting can be created under each [InventorySettings].

export_setting_id

string

Required. This is the client-assigned export setting identifier encoded in UTF-8 and it needs to be unique under a specific [InventorySettings].

export_setting

ExportSetting

Required. The export setting details. The field name must be empty and it will be generated in the format of: projects/{PROJECT_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} folders/{FOLDER_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} organizations/{ORGANIZATION_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID}

DeleteExportSettingRequest

Fields
name

string

Required. The name of the export setting and it must be in the format of: projects/{PROJECT_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} folders/{FOLDER_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} organizations/{ORGANIZATION_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID}

ExportAssetUpdatesRequest

Export asset updates request.

Fields
parent

string

Required. The relative name of the root asset. This can only be an organization number (such as "organizations/123"), a project ID (such as "projects/my-project-id"), or a project number (such as "projects/12345"), or a folder number (such as "folders/123").

Authorization requires one or more of the following IAM permissions on the specified resource parent:

  • cloudasset.assets.exportResource
  • cloudasset.assets.exportIamPolicy
update_time_window

UpdateTimeWindow

The time window configuration for the asset updates. Both start_time and end_time must be within 35 days from now. end_time is optional and not set, it is default to current timestamp. The returned results contain all assets created, updated or deleted within update_time_window.time_window.

asset_types[]

string

A list of asset types to export the updates for. For example: "compute.googleapis.com/Disk".

Regular expressions are also supported. For example:

  • "compute.googleapis.com.*" snapshots resources whose asset type starts with "compute.googleapis.com".
  • ".*Instance" snapshots resources whose asset type ends with "Instance".
  • ".*Instance.*" snapshots resources whose asset type contains "Instance".

See RE2 for all supported regular expression syntax. If the regular expression does not match any supported asset type, an INVALID_ARGUMENT error will be returned.

If specified, only matching assets will be returned. See Introduction to Cloud Asset Inventory for all supported asset types.

At most one of asset_types and asset_names should be specified. If neither is specified, all assets under the parent will be returned.

asset_names[]

string

A list of the full names of the assets to export the updates for. See: https://cloud.google.com/asset-inventory/docs/resource-name-format Example:

//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1.

If specified, only assets in the list will be returned.

At most one of asset_types and asset_names should be specified. If neither is specified, all assets under the parent will be returned.

content_type

ContentType

Asset content type. If not specified, no content but the asset name will be returned.

output_config

OutputConfig

Required. Output configuration indicating where the results will be output to.

ExportAssetsRequest

Export asset request.

Fields
parent

string

Required. The relative name of the root asset. This can only be an organization number (such as "organizations/123"), a project ID (such as "projects/my-project-id"), or a project number (such as "projects/12345"), or a folder number (such as "folders/123").

Authorization requires one or more of the following IAM permissions on the specified resource parent:

  • cloudasset.assets.exportResource
  • cloudasset.assets.exportIamPolicy
read_time

Timestamp

Timestamp to take an asset snapshot. This can only be set to a timestamp between the current time and the current time minus 35 days (inclusive). If not specified, the current time will be used. Due to delays in resource data collection and indexing, there is a volatile window during which running the same query may get different results.

asset_types[]

string

A list of asset types to take a snapshot for. For example: "compute.googleapis.com/Disk".

Regular expressions are also supported. For example:

  • "compute.googleapis.com.*" snapshots resources whose asset type starts with "compute.googleapis.com".
  • ".*Instance" snapshots resources whose asset type ends with "Instance".
  • ".*Instance.*" snapshots resources whose asset type contains "Instance".

See RE2 for all supported regular expression syntax. If the regular expression does not match any supported asset type, an INVALID_ARGUMENT error will be returned.

If specified, only matching assets will be returned, otherwise, it will snapshot all asset types. See Introduction to Cloud Asset Inventory for all supported asset types.

content_type

ContentType

Asset content type. If not specified, no content but the asset name will be returned.

output_config

OutputConfig

Required. Output configuration indicating where the results will be output to.

ExportAssetsResponse

The export asset response. This message is returned by the google.longrunning.Operations.GetOperation method in the returned google.longrunning.Operation.response field.

Fields
read_time

Timestamp

Time the snapshot was taken.

output_config

OutputConfig

Output configuration indicating where the results were output to.

output_result

OutputResult

Output result indicating where the assets were exported to. For example, a set of actual Google Cloud Storage object uris where the assets are exported to. The uris can be different from what [output_config] has specified, as the service will split the output object into multiple ones once it exceeds a single Google Cloud Storage object limit.

ExportSetting

Settings that configure CAI to export assets on given schedules. An [InventorySettings] might have multiple [ExportSetting], each with a unique identifier.

Fields
name

string

The format will be: organizations/{ORGANIZATION_NUMBER}/inventorySettings/exportSettings/{exportSetting} or folders/{FOLDER_NUMBER}/inventorySettings/exportSettings/{exportSetting} or projects/{PROJECT_NUMBER}/inventorySettings/exportSettings/{exportSetting}

asset_types[]

string

Asset types of resources that will be exported on schedule. For example: "compute.googleapis.com/Disk".

Regular expressions are also supported. For example:

  • "compute.googleapis.com.*" snapshots resources whose asset type starts with "compute.googleapis.com".
  • ".*Instance" snapshots resources whose asset type ends with "Instance".
  • ".*Instance.*" snapshots resources whose asset type contains "Instance".

See RE2 for all supported regular expression syntax. If the regular expression does not match any supported asset type, an INVALID_ARGUMENT error will be returned.

If specified, only matching assets will be returned. See Introduction to Cloud Asset Inventory for all supported asset types.

content_type

ContentType

Required. Asset content type. Currently only RESOURCE, IAM_POLICY, ORG_POLICY, ACCESS_POLICY are supported.

gcs_setting

GcsSetting

Setting to configure scheduled export output to GCS. At least one of [gcs_setting] and [bigquery_setting] should be set.

bigquery_setting

BigQuerySetting

Setting to configure scheduled export output to BigQuery. At least one of [gcs_settings] and [bigquery_settings] should be set.

GcsDestination

A Cloud Storage location.

Fields
Union field object_uri. Required. object_uri can be only one of the following:
uri

string

The uri of the Cloud Storage object. It's the same uri that is used by gsutil. Example: "gs://bucket_name/object_name". See Viewing and Editing Object Metadata for more information.

In the case of scheduled export, a path indiciating when the export happens will be added in between the bucket_name and object_name. For example: the real destination for an scheduled snapshot is: gs://bucket_name/{YYYY}/{MM}/{DD}/snapshot/{HHMMSS}/file

uri_prefix

string

The uri prefix of all generated Cloud Storage objects. Example: "gs://bucket_name/object_name_prefix". Each object uri is in format: "gs://bucket_name/object_name_prefix/{ASSET_TYPE}/{SHARD_NUMBER} and only contains assets for that type. starts from 0. Example: "gs://bucket_name/object_name_prefix/compute.googleapis.com/Disk/0" is the first shard of output objects containing all compute.googleapis.com/Disk assets. An INVALID_ARGUMENT error will be returned if file with the same name "gs://bucket_name/object_name_prefix" already exists.

In the case of scheduled export, a path indiciating when the export happens will be appended. For example: the real destination for an scheduled snapshot is: gs://bucket_name/object_name_prefix/{YYYY}/{MM}/{DD}/snapshot/{HHMMSS}/{ASSET_TYPE}/{SHARD_NUMBER}

GcsOutputResult

A Cloud Storage output result.

Fields
uris[]

string

List of uris of the Cloud Storage objects. Example: "gs://bucket_name/object_name".

GcsSetting

Setting for scheduled export to GCS.

Fields
destination

GcsDestination

Required. Destination on Cloud Storage.

snapshot_schedule

ScheduleConfig

Schedule for scheduled export of asset snapshot.

GetExportSettingRequest

Fields
name

string

Required. The name of the [ExportSetting] and it must be in the format of: projects/{PROJECT_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} folders/{FOLDER_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} organizations/{ORGANIZATION_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID}

GetInventorySettingsRequest

Fields
name

string

Required. The name of the [InventorySettings] which has the format of: projects/{PROJECT_NUMBER}/inventorySettings folders/{FOLDER_NUMBER}/inventorySettings organizations/{ORGANIZATION_NUMBER}/inventorySettings

InventorySettings

Inventory Settings. There is only one inventory settings for a given organization, folder or project. Users can update inventory settings using specific API, but cannot create or delete.

Fields
name

string

Required. The format will be projects/{PROJECT_NUMBER}/inventorySettings or folders/{FOLDER_NUMBER}/inventorySettings or organizations/{ORGANIZATION_NUMBER}/inventorySettings

export_settings[]

string

Output only. A list of export settings.

ListAssetUpdatesRequest

ListAssets request.

Fields
parent

string

Required. Name of the organization or project the assets belong to. Format: "organizations/[organization-number]" (such as "organizations/123"), "projects/[project-number]" (such as "projects/my-project-id"), or "projects/[project-id]" (such as "projects/12345").

Authorization requires one or more of the following IAM permissions on the specified resource parent:

  • cloudasset.assets.listResource
  • cloudasset.assets.listIamPolicy
update_time_window

UpdateTimeWindow

The time window configuration for the asset updates. Both start_time and end_time must be within 35 days from now. end_time is optional and not set, it is default to current timestamp. The returned results contain all assets created, updated or deleted in update_time_window.time_window.

asset_types[]

string

A list of asset types to list the updates for. For example: "compute.googleapis.com/Disk".

Regular expression is also supported. For example:

  • "compute.googleapis.com.*" snapshots resources whose asset type starts with "compute.googleapis.com".
  • ".*Instance" snapshots resources whose asset type ends with "Instance".
  • ".*Instance.*" snapshots resources whose asset type contains "Instance".

See RE2 for all supported regular expression syntax. If the regular expression does not match any supported asset type, an INVALID_ARGUMENT error will be returned.

If specified, only matching assets will be returned.

At most one of asset_types and asset_names should be specified. If neither is specified, all assets under the parent will be returned.

asset_names[]

string

A list of the full names of the assets to list the updates for. See: https://cloud.google.com/asset-inventory/docs/resource-name-format Example:

//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1.

If specified, only assets in the list will be returned.

At most one of asset_types and asset_names should be specified. If neither is specified, all assets under the parent will be returned.

content_type

ContentType

Asset content type. If not specified, no content but the asset name will be returned.

page_size

int32

The maximum number of assets to be returned in a single response. Default is 100, minimum is 1, and maximum is 1000.

page_token

string

The next_page_token returned from the previous ListAssetsResponse, or unspecified for the first ListAssetsRequest. It is a continuation of a prior ListAssets call, and the API should return the next page of assets.

ListAssetUpdatesResponse

ListAssets response.

Fields
asset_updates[]

Asset

Asset updates in the time window.

update_time_window

UpdateTimeWindow

Time window configuration of the list request.

next_page_token

string

Token to retrieve the next page of results. Set to empty if there are no remaining results.

ListExportSettingsRequest

Fields
parent

string

Required. The parent [InventorySettings] whose export settings are to be listed.

page_size

int32

The maximum number of export settings to return. The service may return fewer than this value.

If unspecified, at most 100 export settings will be returned. The maximum value is 100, as currently only a maximum of 100 export settings can be created under each parent.

page_token

string

A page token, received from a previous ListExportSettings call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListExportSettings must match the call that provided the page token.

ListExportSettingsResponse

Fields
export_settings[]

ExportSetting

A list of export settings.

next_page_token

string

Token to retrieve the next page of results. Set to empty if there are no remaining results.

OutputConfig

Output configuration for export assets destination.

Fields
Union field destination. Asset export destination. destination can be only one of the following:
gcs_destination

GcsDestination

Destination on Cloud Storage.

bigquery_destination

BigQueryDestination

Destination on BigQuery. The output table stores the fields in asset proto as columns in BigQuery.

OutputResult

Output result of export assets.

Fields
gcs_result

GcsOutputResult

Export result on Cloud Storage.

PartitionSpec

Specifications of BigQuery partitioned table as export destination.

Fields
partition_key

PartitionKey

The partition key for BigQuery partitioned table.

PartitionKey

This enum is used to determine the partition key column when exporting assets to BigQuery partitioned table(s). Note that, if the partition key is a timestamp column, the actual partition is based on its date value (expressed in UTC. see details in https://cloud.google.com/bigquery/docs/partitioned-tables#date_timestamp_partitioned_tables).

Enums
PARTITION_KEY_UNSPECIFIED Unspecified partition key. If used, it means using non-partitioned table.
READ_TIME The time when the snapshot is taken. If specified as partition key, the result table(s) is partitoned by the additional timestamp column, readTime. If [read_time] in ExportAssetsRequest is specified, the readTime column's value will be the same as it. Otherwise, its value will be the current time that is used to take the snapshot.
REQUEST_TIME The time when the request is received and started to be processed. If specified as partition key, the result table(s) is partitoned by the requestTime column, an additional timestamp column representing when the request was received.

Resource

A representation of a Google Cloud resource.

Fields
version

string

The API version. Example: v1

discovery_document_uri

string

The URL of the discovery document containing the resource's JSON schema. Example: https://www.googleapis.com/discovery/v1/apis/compute/v1/rest

This value is unspecified for resources that do not have an API based on a discovery document, such as Cloud Bigtable.

discovery_name

string

The JSON schema name listed in the discovery document. Example: Project

This value is unspecified for resources that do not have an API based on a discovery document, such as Cloud Bigtable.

resource_url

string

The REST URL for accessing the resource. An HTTP GET request using this URL returns the resource itself. Example: https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123

This value is unspecified for resources without a REST API.

parent

string

The full name of the immediate parent of this resource. See Resource Names for more information.

For Google Cloud assets, this value is the parent resource defined in the Cloud IAM policy hierarchy. Example: //cloudresourcemanager.googleapis.com/projects/my_project_123

For third-party assets, this field may be set differently.

data

Struct

The content of the resource, in which some sensitive fields are removed and may not be present.

location

string

The location of the resource in Google Cloud, such as its zone and region. For more information, see https://cloud.google.com/about/locations/.

ScheduleConfig

Schedule for scheduled export. This is used to configure scheduled export for both GCS and BigQuery.

Fields
crontab

string

Required. Cron-tab formatted schedule by which the job will execute Format: minute, hour, day of month, month, day of week e.g. 0 0 * * WED = every Wednesday More examples: https://crontab.guru/examples.html

time_zone

string

Specifies the time zone to be used in interpreting [crontab]. The value of this field must be a time zone name from the tz database.

Note that some time zones include a provision for daylight savings time. The rules for daylight saving time are determined by the chosen tz. For UTC use the string "utc". If a time zone is not specified, the default will be in UTC (also known as GMT).

TimeWindow

A time window specified by its start_time and end_time.

Fields
start_time

Timestamp

Start time of the time window (exclusive).

end_time

Timestamp

End time of the time window (inclusive). If not specified, the current timestamp is used instead.

UpdateExportSettingRequest

Fields
export_setting

ExportSetting

Required. The new values of export settings details. It must match an existing export setting and the field name must be in the format of: projects/{PROJECT_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} folders/{FOLDER_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID} organizations/{ORGANIZATION_NUMBER}/inventorySettings/exportSettings/{EXPORT_SETTING_ID}

update_mask

FieldMask

Required. Only updates the export_setting fields indicated by this mask. The field mask must not be empty, and it must not contain fields that are immutable or only set by the server.

UpdateTimeWindow

Time window configuration for asset updates requests.

Fields
type

TimeType

The type of the time in time_window.

time_window

TimeWindow

The time window.

TimeType

The type of the time.

Enums
TIME_TYPE_UNSPECIFIED If not specified, UPDATE_TIME is used.
UPDATE_TIME Update time of the Asset. Assets updated in the window will be returned.
CAPTURE_TIME Capture time of the Asset update in Asset Inventory. Assets updates captured by Asset Inventory in the window will be returned. This definition should be used when full-fidelity data is required in requests with consecutive time windows.