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 |
MutableSequence[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 |
MutableMapping[str, str]
User labels associated with this resource. See `Labelling and grouping Google Cloud resources |
network_tags |
MutableSequence[str]
Network tags associated with this resource. Like labels, network tags are a type of annotations used to group Google Cloud resources. See `Labelling Google Cloud resources |
kms_key |
str
The Cloud KMS CryptoKey __
name or
CryptoKeyVersion __
name.
This field only presents for the purpose of backward
compatibility. Use the kms_keys field to retrieve Cloud
KMS key information. This field is available only when the
resource's Protobuf contains it and will only be populated
for `these resource
types |
kms_keys |
MutableSequence[str]
The Cloud KMS CryptoKey __
names or
CryptoKeyVersion __
names. This field is available only when the resource's
Protobuf contains it.
To search against the kms_keys :
- Use a field query. Example: kmsKeys:key
- Use a free text query. Example: key
|
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 <>
- value in date string. Example:
updateTime <>
- value in date-time string (must be quoted). Example:
updateTime <>
|
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 Google Cloud 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 |
MutableSequence[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 |
MutableSequence[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 |
MutableMapping[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 |
MutableSequence[str]
This field is only present for the purpose of backward compatibility. Use the tags field instead.
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 |
MutableSequence[str]
This field is only present for the purpose of backward compatibility. Use the tags field instead.
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 |
MutableSequence[str]
This field is only present for the purpose of backward compatibility. Use the tags field instead.
TagValue IDs, in the format of tagValues/{TAG_VALUE_ID}. To
search against the tagValueIds :
- Use a field query. Example:
- tagValueIds="tagValues/456"
- Use a free text query. Example:
- 456
|
tags |
MutableSequence[google.cloud.asset_v1.types.Tag]
The tags directly attached to this resource. To search against the tags :
- Use a field query. Example:
- tagKeys:"123456789/env*"
- tagKeys="123456789/env"
- tagKeys:"env"
- tagKeyIds="tagKeys/123"
- tagValues:"env"
- tagValues:"env/prod"
- tagValues:"123456789/env/prod*"
- tagValues="123456789/env/prod"
- tagValueIds="tagValues/456"
- Use a free text query. Example:
- env/prod
|
effective_tags |
MutableSequence[google.cloud.asset_v1.types.EffectiveTagDetails]
The effective tags on this resource. All of the tags that are both attached to and inherited by a resource are collectively called the effective tags. For more information, see `tag inheritance |
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
|
scc_security_marks |
MutableMapping[str, str]
The actual content of Security Command Center security marks associated with the asset. To search against SCC SecurityMarks field: - Use a field query: - query by a given key value pair. Example: sccSecurityMarks.foo=bar
- query by a given key's existence. Example:
sccSecurityMarks.foo:*
|
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,
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 |
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,
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 |
SccSecurityMarksEntry
SccSecurityMarksEntry(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,
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 |