Module types (1.2.0)

API documentation for asset_v1.types module.

Classes

AccessLevel

API documentation for asset_v1.types.AccessLevel class.

AccessPolicy

API documentation for asset_v1.types.AccessPolicy class.

Any

API documentation for asset_v1.types.Any class.

Asset

An asset in Google Cloud. An asset can be any resource in the Google Cloud resource hierarchy <https://cloud.google.com/resource- manager/docs/cloud-platform-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 <https://cloud.google.com/asset- inventory/docs/supported-asset-types> for more information.

The full name of the asset. Example: //compute.googleapis.co m/projects/my_project_123/zones/zone1/instances/instance1 See Resource names <https://cloud.google.com/apis/design/reso urce_names#full_resource_name>__ for more information.

A representation of the resource.

A representation of an organization policy <https://cloud.google.com/resource-manager/docs/organization- policy/overview#organization_policy>__. There can be more than one organization policy with different constraints set on a given resource.

Please also refer to the access policy user guide <https://cloud.google.com/access-context- manager/docs/overview#access-policies>__.

Please also refer to the service perimeter user guide <https://cloud.google.com/vpc-service- controls/docs/overview>__.

AuditConfig

API documentation for asset_v1.types.AuditConfig class.

AuditConfigDelta

API documentation for asset_v1.types.AuditConfigDelta class.

AuditLogConfig

API documentation for asset_v1.types.AuditLogConfig class.

BasicLevel

API documentation for asset_v1.types.BasicLevel class.

BatchGetAssetsHistoryRequest

Batch get assets history request.

A list of the full names of the assets. See: https://cloud.google.com/asset-inventory/docs/resource-name- format Example: //compute.googleapis.com/projects/my_projec t_123/zones/zone1/instances/instance1. 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.

Optional. The time window for the asset history. Both start_time and end_time are optional and if set, it must be after the current time minus 35 days. 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.

BatchGetAssetsHistoryResponse

Batch get assets history response.

BigQueryDestination

A BigQuery destination for exporting assets to.

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.

Binding

API documentation for asset_v1.types.Binding class.

BindingDelta

API documentation for asset_v1.types.BindingDelta class.

CancelOperationRequest

API documentation for asset_v1.types.CancelOperationRequest class.

Condition

API documentation for asset_v1.types.Condition class.

CreateFeedRequest

Create asset feed request.

Required. This is the client-assigned asset feed identifier and it needs to be unique under a specific parent project/folder/organization.

CustomLevel

API documentation for asset_v1.types.CustomLevel class.

DeleteFeedRequest

DeleteOperationRequest

API documentation for asset_v1.types.DeleteOperationRequest class.

DevicePolicy

API documentation for asset_v1.types.DevicePolicy class.

Empty

API documentation for asset_v1.types.Empty class.

ExportAssetsRequest

Export asset request.

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 content type. If not specified, no content but the asset name will be returned.

ExportAssetsResponse

The export asset response. This message is returned by the [google.lon grunning.Operations.GetOperation][google.longrunning.Operations.GetOpe ration] method in the returned [google.longrunning.Operation.response] [google.longrunning.Operation.response] field.

Output configuration indicating where the results were output to.

Expr

API documentation for asset_v1.types.Expr class.

Feed

An asset feed used to export asset updates to a destinations. An asset feed filter controls what updates are exported. The asset feed must be created within a project, organization, or folder. Supported destinations are: Pub/Sub topics.

A list of the full names of the assets to receive updates. You must specify either or both of asset_names and asset_types. Only asset updates matching specified asset_names or asset_types are exported to the feed. Example: //compute.goo gleapis.com/projects/my_project_123/zones/zone1/instances/inst ance1. See Resource Names <https://cloud.google.com/apis/de sign/resource_names#full_resource_name>__ for more info.

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

A condition which determines whether an asset update should be published. If specified, an asset will be returned only when the expression evaluates to true. When set, expression field in the Expr must be a valid CEL expression on a TemporalAsset with name temporal_asset. Example: a Feed with expression (“temporal_asset.deleted == true”) will only publish Asset deletions. Other fields in Expr are optional.

FeedOutputConfig

Output configuration for asset feed destination.

Destination on Pub/Sub.

FieldMask

API documentation for asset_v1.types.FieldMask class.

GcsDestination

A Cloud Storage location.

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 <https://cloud.google.com/storage/docs/viewing-editing- metadata>__ for more information.

GetFeedRequest

Get asset feed request.

GetOperationRequest

API documentation for asset_v1.types.GetOperationRequest class.

IamPolicySearchResult

A result of IAM Policy search, containing information of an IAM policy.

The project that the associated GCP resource belongs to, in the form of projects/{PROJECT_NUMBER}. If an IAM policy is set on a resource (like VM instance, Cloud Storage bucket), the project field will indicate the project that contains the resource. If an IAM policy is set on a folder or orgnization, the project field will be empty. To search against the project: - specify the scope field as this project in your search request.

Explanation about the IAM policy search result. It contains additional information to explain why the search result matches the query.

ListFeedsRequest

List asset feeds request.

ListFeedsResponse

ListOperationsRequest

API documentation for asset_v1.types.ListOperationsRequest class.

ListOperationsResponse

API documentation for asset_v1.types.ListOperationsResponse class.

ListValue

API documentation for asset_v1.types.ListValue class.

Operation

API documentation for asset_v1.types.Operation class.

OperationInfo

API documentation for asset_v1.types.OperationInfo class.

OsConstraint

API documentation for asset_v1.types.OsConstraint class.

OutputConfig

Output configuration for export assets destination.

Destination on Cloud Storage.

Policy

API documentation for asset_v1.types.Policy class.

PolicyDelta

API documentation for asset_v1.types.PolicyDelta class.

PubsubDestination

A Pub/Sub destination.

Resource

A representation of a Google Cloud resource.

The URL of the discovery document containing the resource’s JSON schema. Example: https://www.googleapis.com/discovery/v 1/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.

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.

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

ResourceSearchResult

A result of Resource Search, containing information of a cloud resoure.

The type of this resource. Example: compute.googleapis.com/Disk. To search against the asset_type: - specify the asset_type field in your search request.

The display name of this resource. To search against the display_name: - use a field query. Example: displayName : "My Instance" - use a free text query. Example: "My Instance"

Location can be global, regional like us-east1, or zonal like us-west1-b. To search against the location: - use a field query. Example: location : "us-west*" - use a free text query. Example: "us-west*"

Network tags associated with this resource. Like labels, network tags are a type of annotations used to group GCP resources. See Labelling GCP resources <https://cloud.google.com/blog/products/gcp/labelling-and- grouping-your-google-cloud-platform-resources>__ for more information. To search against the network_tags: - use a field query. Example: networkTags : "internal" - use a free text query. Example: "internal"

SearchAllIamPoliciesRequest

Search all IAM policies request.

Optional. The query statement. An empty query can be specified to search all the IAM policies within the given scope. Examples: - policy : "amy@gmail.com" to find Cloud IAM policy bindings that specify user “amy@gmail.com”. - policy : "roles/compute.admin" to find Cloud IAM policy bindings that specify the Compute Admin role. - policy.role.permissions : "storage.buckets.update" to find Cloud IAM policy bindings that specify a role containing “storage.buckets.update” permission. - resource : "organizations/123" to find Cloud IAM policy bindings that are set on “organizations/123”. - (resource : ("organizations/123" OR "folders/1234") AND policy : "amy") to find Cloud IAM policy bindings that are set on “organizations/123” or “folders/1234”, and also specify user “amy”. See how to construct a query <https://cloud.google.com/asset-inventory/docs/searching-iam- policies#how_to_construct_a_query>__ for more details.

Optional. If present, retrieve the next batch of results from the preceding call to this method. page_token must be the value of next_page_token from the previous response. The values of all other method parameters must be identical to those in the previous call.

SearchAllIamPoliciesResponse

Search all IAM policies response.

Set if there are more results than those appearing in this response; to get the next set of results, call this method again, using this value as the page_token.

SearchAllResourcesRequest

Search all resources request.

Optional. The query statement. An empty query can be specified to search all the resources of certain asset_types within the given scope. Examples: - name : "Important" to find Cloud resources whose name contains “Important” as a word. - displayName : "Impor*" to find Cloud resources whose display name contains “Impor” as a word prefix. - description : "*por*" to find Cloud resources whose description contains “por” as a substring. - location : "us-west*" to find Cloud resources whose location is prefixed with “us-west”. - labels : "prod" to find Cloud resources whose labels contain “prod” as a key or value. - labels.env : "prod" to find Cloud resources which have a label “env” and its value is “prod”. - labels.env : * to find Cloud resources which have a label “env”. - "Important" to find Cloud resources which contain “Important” as a word in any of the searchable fields. - "Impor*" to find Cloud resources which contain “Impor” as a word prefix in any of the searchable fields. - "*por*" to find Cloud resources which contain “por” as a substring in any of the searchable fields. - ("Important" AND location : ("us-west1" OR "global")) to find Cloud resources which contain “Important” as a word in any of the searchable fields and are also located in the “us-west1” region or the “global” location. See how to construct a query <https://cloud.google.com/asset- inventory/docs/searching- resources#how_to_construct_a_query>__ for more details.

Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as next_page_token is returned.

Optional. A comma separated list of fields specifying the sorting order of the results. The default order is ascending. Add " DESC" after the field name to indicate descending order. Redundant space characters are ignored. Example: “location DESC, name”. See supported resource metadata fields <https://cloud.google.com/asset-inventory/docs/searching- resources#query_on_resource_metadata_fields>__ for more details.

SearchAllResourcesResponse

Search all resources response.

If there are more results than those appearing in this response, then next_page_token is included. To get the next set of results, call this method again using the value of next_page_token as page_token.

ServicePerimeter

API documentation for asset_v1.types.ServicePerimeter class.

ServicePerimeterConfig

API documentation for asset_v1.types.ServicePerimeterConfig class.

Status

API documentation for asset_v1.types.Status class.

Struct

API documentation for asset_v1.types.Struct class.

TemporalAsset

An asset in Google Cloud and its temporal metadata, including the time window when it was observed and its status during that window.

Whether the asset has been deleted or not.

State of prior_asset.

TimeWindow

A time window specified by its start_time and end_time.

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

Timestamp

API documentation for asset_v1.types.Timestamp class.

UpdateFeedRequest

Update asset feed request.

Required. Only updates the feed 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.

Value

API documentation for asset_v1.types.Value class.

WaitOperationRequest

API documentation for asset_v1.types.WaitOperationRequest class.