Class ResourceSearchResult (3.9.0)

Version 3.9.0

• 3.27.1 (latest)
• 3.27.0
• 3.26.4
• 3.25.1
• 3.24.3
• 3.23.0
• 3.22.0
• 3.21.0
• 3.20.1
• 3.19.1
• 3.18.1
• 3.17.1
• 3.16.0
• 3.15.0
• 3.14.2
• 3.13.1
• 3.12.0
• 3.11.0
• 3.10.0
• 3.9.1
• 3.8.1
• 3.7.1
• 3.6.1
• 3.5.0
• 3.4.0
• 3.3.0
• 3.2.1
• 3.1.0
• 2.2.2
• 2.1.0
• 2.0.0
• 1.3.2
• 1.2.0
• 1.1.0
• 1.0.0
• 0.10.0
• 0.9.0
• 0.8.0
• 0.7.0
• 0.6.0
• 0.5.0
• 0.4.1
• 0.3.0

ResourceSearchResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

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

Attributes

Name	Description
name	str The full resource name of this resource. Example: ``//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1``. See `Cloud Asset Inventory Resource Name Format
asset_type	str 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.
project	str The project that this resource belongs to, in the form of projects/{PROJECT_NUMBER}. This field is available when the resource belongs to a project. To search against ``project``: - use a field query. Example: ``project:12345`` - use a free text query. Example: ``12345`` - specify the ``scope`` field as this project in your search request.
folders	Sequence[str] The folder(s) that this resource belongs to, in the form of folders/{FOLDER_NUMBER}. This field is available when the resource belongs to one or more folders. To search against ``folders``: - use a field query. Example: ``folders:(123 OR 456)`` - use a free text query. Example: ``123`` - specify the ``scope`` field as this folder in your search request.
organization	str The organization that this resource belongs to, in the form of organizations/{ORGANIZATION_NUMBER}. This field is available when the resource belongs to an organization. To search against ``organization``: - use a field query. Example: ``organization:123`` - use a free text query. Example: ``123`` - specify the ``scope`` field as this organization in your search request.
display_name	str The display name of this resource. This field is available only when the resource's Protobuf contains it. To search against the ``display_name``: - use a field query. Example: ``displayName:"My Instance"`` - use a free text query. Example: ``"My Instance"``
description	str One or more paragraphs of text description of this resource. Maximum length could be up to 1M bytes. This field is available only when the resource's Protobuf contains it. To search against the ``description``: - use a field query. Example: ``description:"important instance"`` - use a free text query. Example: ``"important instance"``
location	str Location can be ``global``, regional like ``us-east1``, or zonal like ``us-west1-b``. This field is available only when the resource's Protobuf contains it. To search against the ``location``: - use a field query. Example: ``location:us-west*`` - use a free text query. Example: ``us-west*``
labels	Mapping[str, str] Labels associated with this resource. See `Labelling and grouping GCP resources
network_tags	Sequence[str] Network tags associated with this resource. Like labels, network tags are a type of annotations used to group GCP resources. See `Labelling GCP resources
kms_key	str The Cloud KMS `CryptoKey
create_time	google.protobuf.timestamp_pb2.Timestamp The create timestamp of this resource, at which the resource was created. The granularity is in seconds. Timestamp.nanos will always be 0. This field is available only when the resource's Protobuf contains it. To search against ``create_time``: - use a field query. - value in seconds since unix epoch. Example: ``createTime > 1609459200`` - value in date string. Example: ``createTime > 2021-01-01`` - value in date-time string (must be quoted). Example: ``createTime > "2021-01-01T00:00:00"``
update_time	google.protobuf.timestamp_pb2.Timestamp The last update timestamp of this resource, at which the resource was last modified or deleted. The granularity is in seconds. Timestamp.nanos will always be 0. This field is available only when the resource's Protobuf contains it. To search against ``update_time``: - use a field query. - value in seconds since unix epoch. Example: ``updateTime < 1609459200``="" -="" value="" in="" date="" string.="" example:="" ``updatetime="">< 2021-01-01``="" -="" value="" in="" date-time="" string="" (must="" be="" quoted).="" example:="" ``updatetime="">< "2021-01-01t00:00:00"``="">
state	str The state of this resource. Different resources types have different state definitions that are mapped from various fields of different resource types. This field is available only when the resource's Protobuf contains it. Example: If the resource is an instance provided by Compute Engine, its state will include PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. See ``status`` definition in `API Reference
additional_attributes	google.protobuf.struct_pb2.Struct The additional searchable attributes of this resource. The attributes may vary from one resource type to another. Examples: ``projectId`` for Project, ``dnsName`` for DNS ManagedZone. This field contains a subset of the resource metadata fields that are returned by the List or Get APIs provided by the corresponding GCP service (e.g., Compute Engine). see `API references and supported searchable attributes
parent_full_resource_name	str The full resource name of this resource's parent, if it has one. To search against the ``parent_full_resource_name``: - use a field query. Example: ``parentFullResourceName:"project-name"`` - use a free text query. Example: ``project-name``
versioned_resources	Sequence[google.cloud.asset_v1.types.VersionedResource] Versioned resource representations of this resource. This is repeated because there could be multiple versions of resource representations during version migration. This ``versioned_resources`` field is not searchable. Some attributes of the resource representations are exposed in ``additional_attributes`` field, so as to allow users to search on them.
attached_resources	Sequence[google.cloud.asset_v1.types.AttachedResource] Attached resources of this resource. For example, an OSConfig Inventory is an attached resource of a Compute Instance. This field is repeated because a resource could have multiple attached resources. This ``attached_resources`` field is not searchable. Some attributes of the attached resources are exposed in ``additional_attributes`` field, so as to allow users to search on them.
relationships	Mapping[str, google.cloud.asset_v1.types.RelatedResources] A map of related resources of this resource, keyed by the relationship type. A relationship type is in the format of {SourceType}*{ACTION}*\ {DestType}. Example: ``DISK_TO_INSTANCE``, ``DISK_TO_NETWORK``, ``INSTANCE_TO_INSTANCEGROUP``. See `supported relationship types
tag_keys	Sequence[str] TagKey namespaced names, in the format of {ORG_ID}/{TAG_KEY_SHORT_NAME}. To search against the ``tagKeys``: - use a field query. Example: - ``tagKeys:"123456789/env*"`` - ``tagKeys="123456789/env"`` - ``tagKeys:"env"`` - use a free text query. Example: - ``env``
tag_values	Sequence[str] TagValue namespaced names, in the format of {ORG_ID}/{TAG_KEY_SHORT_NAME}/{TAG_VALUE_SHORT_NAME}. To search against the ``tagValues``: - use a field query. Example: - ``tagValues:"env"`` - ``tagValues:"env/prod"`` - ``tagValues:"123456789/env/prod*"`` - ``tagValues="123456789/env/prod"`` - use a free text query. Example: - ``prod``
tag_value_ids	Sequence[str] TagValue IDs, in the format of tagValues/{TAG_VALUE_ID}. To search against the ``tagValueIds``: - use a field query. Example: - ``tagValueIds:"456"`` - ``tagValueIds="tagValues/456"`` - use a free text query. Example: - ``456``
parent_asset_type	str The type of this resource's immediate parent, if there is one. To search against the ``parent_asset_type``: - use a field query. Example: ``parentAssetType:"cloudresourcemanager.googleapis.com/Project"`` - use a free text query. Example: ``cloudresourcemanager.googleapis.com/Project``

Inheritance

builtins.object > proto.message.Message > ResourceSearchResult

Classes

LabelsEntry

LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters

Name	Description
kwargs	dict Keys and values corresponding to the fields of the message.
mapping	Union[dict, `.Message`] A dictionary or message to be used to determine the values for this message.
ignore_unknown_fields	Optional(bool) If True, do not raise errors for unknown fields. Only applied if mapping is a mapping type or there are keyword parameters.

RelationshipsEntry

RelationshipsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters

Name	Description
kwargs	dict Keys and values corresponding to the fields of the message.
mapping	Union[dict, `.Message`] A dictionary or message to be used to determine the values for this message.
ignore_unknown_fields	Optional(bool) If True, do not raise errors for unknown fields. Only applied if mapping is a mapping type or there are keyword parameters.