Enumeration

ContentType

constant   static

number

Asset content type.

Value

CONTENT_TYPE_UNSPECIFIED

Unspecified content type.

RESOURCE

Resource metadata.

IAM_POLICY

The actual IAM policy set on a resource.

Property

ContentType

constant   static

number

Asset content type.

Value

CONTENT_TYPE_UNSPECIFIED

Unspecified content type.

RESOURCE

Resource metadata.

IAM_POLICY

The actual IAM policy set on a resource.

Abstract types

Asset

static

Cloud asset. This includes all Google Cloud Platform resources, Cloud IAM policies, and other non-GCP assets.

Properties

Parameter

name

string

The full name of the asset. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See Resource Names for more information.

assetType

string

Type of the asset. Example: "google.compute.Disk".

resource

Object

Representation of the resource.

This object should have the same structure as Resource

iamPolicy

Object

Representation of the actual Cloud IAM policy set on a cloud resource. For each resource, there must be at most one Cloud IAM policy set on it.

This object should have the same structure as Policy

See also

google.cloud.asset.v1beta1.Asset definition in proto format

BatchGetAssetsHistoryRequest

static

Batch get assets history request.

Properties

Parameter

parent

string

Required. The relative name of the root asset. It 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").

assetNames

Array of string

A list of the full names of the assets. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See Resource Names for more info.

The request becomes a no-op if the asset name list is empty, and the max size of the asset name list is 100 in one request.

contentType

number

Required. The content type.

The number should be among the values of ContentType

readTimeWindow

Object

Optional. The time window for the asset history. Both start_time and end_time are optional and if set, it must be after 2018-10-02 UTC. If end_time is not set, it is default to current timestamp. If start_time is not set, the snapshot of the assets at end_time will be returned. The returned results contain all temporal assets whose time window overlap with read_time_window.

This object should have the same structure as TimeWindow

See also

google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest definition in proto format

BatchGetAssetsHistoryResponse

static

Batch get assets history response.

Property

Parameter

assets

Array of Object

A list of assets with valid time windows.

This object should have the same structure as TemporalAsset

See also

google.cloud.asset.v1beta1.BatchGetAssetsHistoryResponse definition in proto format

ExportAssetsRequest

static

Export asset request.

Properties

Parameter

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"), a project number (such as "projects/12345"), or a folder number (such as "folders/123").

readTime

Object

Timestamp to take an asset snapshot. This can only be set to a timestamp between 2018-10-02 UTC (inclusive) and the current time. 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.

This object should have the same structure as Timestamp

assetTypes

Array of string

A list of asset types of which to take a snapshot for. For example: "google.compute.Disk". If specified, only matching assets will be returned. See Introduction to Cloud Asset Inventory for all supported asset types.

contentType

number

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

The number should be among the values of ContentType

outputConfig

Object

Required. Output configuration indicating where the results will be output to. All results will be in newline delimited JSON format.

This object should have the same structure as OutputConfig

See also

google.cloud.asset.v1beta1.ExportAssetsRequest definition in proto format

ExportAssetsResponse

static

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

Properties

Parameter

readTime

Object

Time the snapshot was taken.

This object should have the same structure as Timestamp

outputConfig

Object

Output configuration indicating where the results were output to. All results are in JSON format.

This object should have the same structure as OutputConfig

See also

google.cloud.asset.v1beta1.ExportAssetsResponse definition in proto format

GcsDestination

static

A Cloud Storage location.

Property

Parameter

uri

string

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

See also

google.cloud.asset.v1beta1.GcsDestination definition in proto format

OutputConfig

static

Output configuration for export assets destination.

Property

Parameter

gcsDestination

Object

Destination on Cloud Storage.

This object should have the same structure as GcsDestination

See also

google.cloud.asset.v1beta1.OutputConfig definition in proto format

Resource

static

Representation of a cloud resource.

Properties

Parameter

version

string

The API version. Example: "v1".

discoveryDocumentUri

string

The URL of the discovery document containing the resource's JSON schema. For example: "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest". It will be left unspecified for resources without a discovery-based API, such as Cloud Bigtable.

discoveryName

string

The JSON schema name listed in the discovery document. Example: "Project". It will be left unspecified for resources (such as Cloud Bigtable) without a discovery-based API.

resourceUrl

string

The REST URL for accessing the resource. An HTTP GET operation using this URL returns the resource itself. Example: https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123. It will be left 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 GCP assets, it is the parent resource defined in the Cloud IAM policy hierarchy. For example: "//cloudresourcemanager.googleapis.com/projects/my_project_123".

For third-party assets, it is up to the users to define.

data

Object

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

This object should have the same structure as Struct

See also

google.cloud.asset.v1beta1.Resource definition in proto format

TemporalAsset

static

Temporal asset. In addition to the asset, the temporal asset includes the status of the asset and valid from and to time of it.

Properties

Parameter

window

Object

The time window when the asset data and state was observed.

This object should have the same structure as TimeWindow

deleted

boolean

If the asset is deleted or not.

asset

Object

Asset.

This object should have the same structure as Asset

See also

google.cloud.asset.v1beta1.TemporalAsset definition in proto format

TimeWindow

static

A time window of (start_time, end_time].

Properties

Parameter

startTime

Object

Start time of the time window (exclusive).

This object should have the same structure as Timestamp

endTime

Object

End time of the time window (inclusive). Current timestamp if not specified.

This object should have the same structure as Timestamp

See also

google.cloud.asset.v1beta1.TimeWindow definition in proto format