google-cloud-asset-v1 0.27.0 → 0.28.1

data/proto_docs/google/cloud/asset/v1/assets.rb

@@ -125,15 +125,15 @@ module Google
         #     set on a given resource.
         # @!attribute [rw] access_policy
         #   @return [::Google::Identity::AccessContextManager::V1::AccessPolicy]
-        #     Please also refer to the [access policy user
+        #     Also refer to the [access policy user
         #     guide](https://cloud.google.com/access-context-manager/docs/overview#access-policies).
         # @!attribute [rw] access_level
         #   @return [::Google::Identity::AccessContextManager::V1::AccessLevel]
-        #     Please also refer to the [access level user
+        #     Also refer to the [access level user
         #     guide](https://cloud.google.com/access-context-manager/docs/overview#access-levels).
         # @!attribute [rw] service_perimeter
         #   @return [::Google::Identity::AccessContextManager::V1::ServicePerimeter]
-        #     Please also refer to the [service perimeter user
+        #     Also refer to the [service perimeter user
         #     guide](https://cloud.google.com/vpc-service-controls/docs/overview).
         # @!attribute [rw] os_inventory
         #   @return [::Google::Cloud::OsConfig::V1::Inventory]
@@ -203,8 +203,6 @@ module Google
         #     hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy).
         #     Example:
         #     `//cloudresourcemanager.googleapis.com/projects/my_project_123`
-        #
-        #     For third-party assets, this field may be set differently.
         # @!attribute [rw] data
         #   @return [::Google::Protobuf::Struct]
         #     The content of the resource, in which some sensitive fields are removed
@@ -296,8 +294,48 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The key and value for a
+        # [tag](https://cloud.google.com/resource-manager/docs/tags/tags-overview),
+        # @!attribute [rw] tag_key
+        #   @return [::String]
+        #     TagKey namespaced name, in the format of \\{ORG_ID}/\\{TAG_KEY_SHORT_NAME}.
+        # @!attribute [rw] tag_value
+        #   @return [::String]
+        #     TagValue namespaced name, in the format of
+        #     \\{ORG_ID}/\\{TAG_KEY_SHORT_NAME}/\\{TAG_VALUE_SHORT_NAME}.
+        # @!attribute [rw] tag_value_id
+        #   @return [::String]
+        #     TagValue ID, in the format of tagValues/\\{TAG_VALUE_ID}.
+        class Tag
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The effective tags and the ancestor resources from which they were inherited.
+        # @!attribute [rw] attached_resource
+        #   @return [::String]
+        #     The [full resource
+        #     name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
+        #     of the ancestor from which an [effective_tag][] is inherited, according to
+        #     [tag
+        #     inheritance](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).
+        # @!attribute [rw] effective_tags
+        #   @return [::Array<::Google::Cloud::Asset::V1::Tag>]
+        #     The effective tags inherited from the
+        #     {::Google::Cloud::Asset::V1::EffectiveTagDetails#attached_resource attached_resource}.
+        #     Note that tags with the same key but different values may attach to
+        #     resources at a different hierarchy levels. The lower hierarchy tag value
+        #     will overwrite the higher hierarchy tag value of the same tag key. In this
+        #     case, the tag value at the higher hierarchy level will be removed. For more
+        #     information, see [tag
+        #     inheritance](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).
+        class EffectiveTagDetails
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A result of Resource Search, containing information of a cloud resource.
-        # Next ID: 32
+        # Next ID: 34
         # @!attribute [rw] name
         #   @return [::String]
         #     The full resource name of this resource. Example:
@@ -415,8 +453,8 @@ module Google
         #     [CryptoKeyVersion](https://cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings.cryptoKeys.cryptoKeyVersions)
         #     name.
         #
-        #     This field only presents for the purpose of backward compatibility. Please
-        #     use the `kms_keys` field to retrieve Cloud KMS key information. This field
+        #     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](https://cloud.google.com/asset-inventory/docs/legacy-field-names#resource_types_with_the_to_be_deprecated_kmskey_field)
@@ -496,7 +534,7 @@ module Google
         #     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](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types)
+        #     attributes](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
         #     to see which fields are included.
         #
         #     You can search values of these fields through free text search. However,
@@ -546,6 +584,9 @@ module Google
         #     types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#supported_relationship_types).
         # @!attribute [rw] tag_keys
         #   @return [::Array<::String>]
+        #     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`:
         #
@@ -558,6 +599,9 @@ module Google
         #         - `env`
         # @!attribute [rw] tag_values
         #   @return [::Array<::String>]
+        #     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`:
@@ -572,15 +616,53 @@ module Google
         #         - `prod`
         # @!attribute [rw] tag_value_ids
         #   @return [::Array<::String>]
+        #     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:"456"`
         #         - `tagValueIds="tagValues/456"`
         #
         #     * Use a free text query. Example:
         #         - `456`
+        # @!attribute [rw] tags
+        #   @return [::Array<::Google::Cloud::Asset::V1::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"`
+        #         - `tagValues:"env"`
+        #         - `tagValues:"env/prod"`
+        #         - `tagValues:"123456789/env/prod*"`
+        #         - `tagValues="123456789/env/prod"`
+        #         - `tagValueIds="tagValues/456"`
+        #
+        #     * Use a free text query. Example:
+        #         - `env/prod`
+        # @!attribute [rw] effective_tags
+        #   @return [::Array<::Google::Cloud::Asset::V1::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](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).
+        #
+        #     To search against the `effective_tags`:
+        #
+        #     * Use a field query. Example:
+        #         - `effectiveTagKeys:"123456789/env*"`
+        #         - `effectiveTagKeys="123456789/env"`
+        #         - `effectiveTagKeys:"env"`
+        #         - `effectiveTagValues:"env"`
+        #         - `effectiveTagValues:"env/prod"`
+        #         - `effectiveTagValues:"123456789/env/prod*"`
+        #         - `effectiveTagValues="123456789/env/prod"`
+        #         - `effectiveTagValueIds="tagValues/456"`
         # @!attribute [rw] parent_asset_type
         #   @return [::String]
         #     The type of this resource's immediate parent, if there is one.
@@ -591,6 +673,17 @@ module Google
         #     `parentAssetType:"cloudresourcemanager.googleapis.com/Project"`
         #     * Use a free text query. Example:
         #     `cloudresourcemanager.googleapis.com/Project`
+        # @!attribute [rw] scc_security_marks
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     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:*`
         class ResourceSearchResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -612,6 +705,15 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class SccSecurityMarksEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # Resource representation as defined by the corresponding service providing the
@@ -637,7 +739,7 @@ module Google
         #
         #     You can find the resource definition for each supported resource type in
         #     this table:
-        #     `https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types`
+        #     `https://cloud.google.com/asset-inventory/docs/supported-asset-types`
         class VersionedResource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -653,7 +755,7 @@ module Google
         #
         #     You can find the supported attached asset types of each resource in this
         #     table:
-        #     `https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types`
+        #     `https://cloud.google.com/asset-inventory/docs/supported-asset-types`
         # @!attribute [rw] versioned_resources
         #   @return [::Array<::Google::Cloud::Asset::V1::VersionedResource>]
         #     Versioned resource representations of this attached resource. This is
@@ -905,17 +1007,17 @@ module Google
           # An identity under analysis.
           # @!attribute [rw] name
           #   @return [::String]
-          #     The identity name in any form of members appear in
+          #     The identity of members, formatted as appear in an
           #     [IAM policy
-          #     binding](https://cloud.google.com/iam/reference/rest/v1/Binding), such
-          #     as:
+          #     binding](https://cloud.google.com/iam/reference/rest/v1/Binding). For
+          #     example, they might be formatted like the following:
+          #
           #     - user:foo@google.com
           #     - group:group1@google.com
           #     - serviceAccount:s1@prj1.iam.gserviceaccount.com
           #     - projectOwner:some_project_id
           #     - domain:google.com
           #     - allUsers
-          #     - etc.
           # @!attribute [rw] analysis_state
           #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisState]
           #     The analysis state of this identity.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.28.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-12 00:00:00.000000000 Z
+date: 2024-01-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -285,7 +285,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: The Cloud Asset API manages the history and inventory of Google Cloud resources.