google-cloud-asset-v1 0.21.1 → 0.22.0

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

@@ -71,8 +71,7 @@ module Google
         #     returned.
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::OutputConfig]
-        #     Required. Output configuration indicating where the results will be output
-        #     to.
+        #     Required. Output configuration indicating where the results will be output to.
         # @!attribute [rw] relationship_types
         #   @return [::Array<::String>]
         #     A list of relationship types to export, for example:
@@ -96,10 +95,8 @@ module Google
         end
 
         # The export asset response. This message is returned by the
-        # google.longrunning.Operations.GetOperation
-        # method in the returned
-        # {::Google::Longrunning::Operation#response google.longrunning.Operation.response}
-        # field.
+        # google.longrunning.Operations.GetOperation method in the returned
+        # {::Google::Longrunning::Operation#response google.longrunning.Operation.response} field.
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Time the snapshot was taken.
@@ -121,11 +118,11 @@ module Google
         # ListAssets request.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. Name of the organization, folder, or project the assets belong
-        #     to. Format: "organizations/[organization-number]" (such as
-        #     "organizations/123"), "projects/[project-id]" (such as
-        #     "projects/my-project-id"), "projects/[project-number]" (such as
-        #     "projects/12345"), or "folders/[folder-number]" (such as "folders/12345").
+        #     Required. Name of the organization, folder, or project the assets belong to. Format:
+        #     "organizations/[organization-number]" (such as "organizations/123"),
+        #     "projects/[project-id]" (such as "projects/my-project-id"),
+        #     "projects/[project-number]" (such as "projects/12345"), or
+        #     "folders/[folder-number]" (such as "folders/12345").
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Timestamp to take an asset snapshot. This can only be set to a timestamp
@@ -278,8 +275,9 @@ module Google
         #     be unique under a specific parent project/folder/organization.
         # @!attribute [rw] feed
         #   @return [::Google::Cloud::Asset::V1::Feed]
-        #     Required. The feed details. The field `name` must be empty and it will be
-        #     generated in the format of: projects/project_number/feeds/feed_id
+        #     Required. The feed details. The field `name` must be empty and it will be generated
+        #     in the format of:
+        #     projects/project_number/feeds/feed_id
         #     folders/folder_number/feeds/feed_id
         #     organizations/organization_number/feeds/feed_id
         class CreateFeedRequest
@@ -321,8 +319,8 @@ module Google
         # Update asset feed request.
         # @!attribute [rw] feed
         #   @return [::Google::Cloud::Asset::V1::Feed]
-        #     Required. The new values of feed details. It must match an existing feed
-        #     and the field `name` must be in the format of:
+        #     Required. The new values of feed details. It must match an existing feed and the
+        #     field `name` must be in the format of:
         #     projects/project_number/feeds/feed_id or
         #     folders/folder_number/feeds/feed_id or
         #     organizations/organization_number/feeds/feed_id.
@@ -613,9 +611,8 @@ module Google
         # Search all resources request.
         # @!attribute [rw] scope
         #   @return [::String]
-        #     Required. A scope can be a project, a folder, or an organization. The
-        #     search is limited to the resources within the `scope`. The caller must be
-        #     granted the
+        #     Required. A scope can be a project, a folder, or an organization. The search is
+        #     limited to the resources within the `scope`. The caller must be granted the
         #     [`cloudasset.assets.searchAllResources`](https://cloud.google.com/asset-inventory/docs/access-control#required_permissions)
         #     permission on the desired scope.
         #
@@ -648,7 +645,11 @@ module Google
         #       and its value is "prod".
         #     * `labels.env:*` to find Cloud resources that have a label "env".
         #     * `kmsKey:key` to find Cloud resources encrypted with a customer-managed
-        #       encryption key whose name contains the word "key".
+        #       encryption key whose name contains "key" as a word. This field is
+        #       deprecated. Please use the `kmsKeys` field to retrieve KMS key
+        #       information.
+        #     * `kmsKeys:key` to find Cloud resources encrypted with customer-managed
+        #       encryption keys whose name contains the word "key".
         #     * `relationships:instance-group-1` to find Cloud resources that have
         #       relationships with "instance-group-1" in the related resource name.
         #     * `relationships:INSTANCE_TO_INSTANCEGROUP` to find compute instances that
@@ -677,8 +678,8 @@ module Google
         #       location.
         # @!attribute [rw] asset_types
         #   @return [::Array<::String>]
-        #     Optional. A list of asset types that this request searches for. If empty,
-        #     it will search all the [searchable asset
+        #     Optional. A list of asset types that this request searches for. If empty, it will
+        #     search all the [searchable asset
         #     types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types).
         #
         #     Regular expressions are also supported. For example:
@@ -693,22 +694,21 @@ module Google
         #     supported asset type, an INVALID_ARGUMENT error will be returned.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     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. 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.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. If present, then 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.
+        #     Optional. If present, then 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.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     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.
+        #     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".
         #     Only singular primitive fields in the response are sortable:
         #
@@ -718,22 +718,21 @@ module Google
         #       * displayName
         #       * description
         #       * location
-        #       * kmsKey
         #       * createTime
         #       * updateTime
         #       * state
         #       * parentFullResourceName
         #       * parentAssetType
         #
-        #     All the other fields such as repeated fields (e.g., `networkTags`), map
-        #     fields (e.g., `labels`) and struct fields (e.g., `additionalAttributes`)
-        #     are not supported.
+        #     All the other fields such as repeated fields (e.g., `networkTags`,
+        #     `kmsKeys`), map fields (e.g., `labels`) and struct fields (e.g.,
+        #     `additionalAttributes`) are not supported.
         # @!attribute [rw] read_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     Optional. A comma-separated list of fields specifying which fields to be
-        #     returned in ResourceSearchResult. Only '*' or combination of top level
-        #     fields can be specified. Field names of both snake_case and camelCase are
-        #     supported. Examples: `"*"`, `"name,location"`, `"name,versionedResources"`.
+        #     Optional. A comma-separated list of fields specifying which fields to be returned in
+        #     ResourceSearchResult. Only '*' or combination of top level fields can be
+        #     specified. Field names of both snake_case and camelCase are supported.
+        #     Examples: `"*"`, `"name,location"`, `"name,versionedResources"`.
         #
         #     The read_mask paths must be valid field paths listed but not limited to
         #     (both snake_case and camelCase are supported):
@@ -749,7 +748,9 @@ module Google
         #       * tagValueIds
         #       * labels
         #       * networkTags
-        #       * kmsKey
+        #       * kmsKey (This field is deprecated. Please use the `kmsKeys` field to
+        #         retrieve KMS key information.)
+        #       * kmsKeys
         #       * createTime
         #       * updateTime
         #       * state
@@ -784,9 +785,9 @@ module Google
         # Search all IAM policies request.
         # @!attribute [rw] scope
         #   @return [::String]
-        #     Required. A scope can be a project, a folder, or an organization. The
-        #     search is limited to the IAM policies within the `scope`. The caller must
-        #     be granted the
+        #     Required. A scope can be a project, a folder, or an organization. The search is
+        #     limited to the IAM policies within the `scope`. The caller must be granted
+        #     the
         #     [`cloudasset.assets.searchAllIamPolicies`](https://cloud.google.com/asset-inventory/docs/access-control#required_permissions)
         #     permission on the desired scope.
         #
@@ -842,22 +843,20 @@ module Google
         #       principal type "user".
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     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. 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.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     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.
+        #     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.
         # @!attribute [rw] asset_types
         #   @return [::Array<::String>]
-        #     Optional. A list of asset types that the IAM policies are attached to. If
-        #     empty, it will search the IAM policies that are attached to all the
-        #     [searchable asset
+        #     Optional. A list of asset types that the IAM policies are attached to. If empty, it
+        #     will search the IAM policies that are attached to all the [searchable asset
         #     types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types).
         #
         #     Regular expressions are also supported. For example:
@@ -874,9 +873,9 @@ module Google
         #     supported asset type, an INVALID_ARGUMENT error will be returned.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     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.
+        #     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: "assetType DESC, resource".
         #     Only singular primitive fields in the response are sortable:
         #       * resource
@@ -907,8 +906,8 @@ module Google
         # IAM policy analysis query message.
         # @!attribute [rw] scope
         #   @return [::String]
-        #     Required. The relative name of the root asset. Only resources and IAM
-        #     policies within the scope will be analyzed.
+        #     Required. The relative name of the root asset. Only resources and IAM policies within
+        #     the scope will be analyzed.
         #
         #     This can only be an organization number (such as "organizations/123"), a
         #     folder number (such as "folders/123"), a project ID (such as
@@ -996,10 +995,9 @@ module Google
           #     Optional. If true, the identities section of the result will expand any
           #     Google groups appearing in an IAM policy binding.
           #
-          #     If
-          #     {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#identity_selector IamPolicyAnalysisQuery.identity_selector}
-          #     is specified, the identity in the result will be determined by the
-          #     selector, and this flag is not allowed to set.
+          #     If {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#identity_selector IamPolicyAnalysisQuery.identity_selector} is specified, the
+          #     identity in the result will be determined by the selector, and this flag
+          #     is not allowed to set.
           #
           #     If true, the default max expansion per group is 1000 for
           #     AssetService.AnalyzeIamPolicy][].
@@ -1010,31 +1008,28 @@ module Google
           #     Optional. If true, the access section of result will expand any roles
           #     appearing in IAM policy bindings to include their permissions.
           #
-          #     If
-          #     {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#access_selector IamPolicyAnalysisQuery.access_selector}
-          #     is specified, the access section of the result will be determined by the
-          #     selector, and this flag is not allowed to set.
+          #     If {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#access_selector IamPolicyAnalysisQuery.access_selector} is specified, the access
+          #     section of the result will be determined by the selector, and this flag
+          #     is not allowed to set.
           #
           #     Default is false.
           # @!attribute [rw] expand_resources
           #   @return [::Boolean]
-          #     Optional. If true and
-          #     {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#resource_selector IamPolicyAnalysisQuery.resource_selector}
-          #     is not specified, the resource section of the result will expand any
-          #     resource attached to an IAM policy to include resources lower in the
-          #     resource hierarchy.
+          #     Optional. If true and {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#resource_selector IamPolicyAnalysisQuery.resource_selector} is not
+          #     specified, the resource section of the result will expand any resource
+          #     attached to an IAM policy to include resources lower in the resource
+          #     hierarchy.
           #
           #     For example, if the request analyzes for which resources user A has
           #     permission P, and the results include an IAM policy with P on a GCP
           #     folder, the results will also include resources in that folder with
           #     permission P.
           #
-          #     If true and
-          #     {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#resource_selector IamPolicyAnalysisQuery.resource_selector}
-          #     is specified, the resource section of the result will expand the
-          #     specified resource to include resources lower in the resource hierarchy.
-          #     Only project or lower resources are supported. Folder and organization
-          #     resource cannot be used together with this option.
+          #     If true and {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#resource_selector IamPolicyAnalysisQuery.resource_selector} is specified,
+          #     the resource section of the result will expand the specified resource to
+          #     include resources lower in the resource hierarchy. Only project or
+          #     lower resources are supported. Folder and organization resource cannot be
+          #     used together with this option.
           #
           #     For example, if the request analyzes for which users have permission P on
           #     a GCP project with this option enabled, the results will include all
@@ -1047,21 +1042,21 @@ module Google
           #     Default is false.
           # @!attribute [rw] output_resource_edges
           #   @return [::Boolean]
-          #     Optional. If true, the result will output the relevant parent/child
-          #     relationships between resources. Default is false.
+          #     Optional. If true, the result will output the relevant parent/child relationships
+          #     between resources.
+          #     Default is false.
           # @!attribute [rw] output_group_edges
           #   @return [::Boolean]
-          #     Optional. If true, the result will output the relevant membership
-          #     relationships between groups and other groups, and between groups and
-          #     principals. Default is false.
+          #     Optional. If true, the result will output the relevant membership relationships
+          #     between groups and other groups, and between groups and principals.
+          #     Default is false.
           # @!attribute [rw] analyze_service_account_impersonation
           #   @return [::Boolean]
-          #     Optional. If true, the response will include access analysis from
-          #     identities to resources via service account impersonation. This is a very
-          #     expensive operation, because many derived queries will be executed. We
-          #     highly recommend you use
-          #     {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}
-          #     rpc instead.
+          #     Optional. If true, the response will include access analysis from identities to
+          #     resources via service account impersonation. This is a very expensive
+          #     operation, because many derived queries will be executed. We highly
+          #     recommend you use {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning} rpc
+          #     instead.
           #
           #     For example, if the request analyzes for which resources user A has
           #     permission P, and there's an IAM policy states user A has
@@ -1106,8 +1101,7 @@ module Google
           end
         end
 
-        # A request message for
-        # {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy}.
+        # A request message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy}.
         # @!attribute [rw] analysis_query
         #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery]
         #     Required. The request query.
@@ -1131,8 +1125,7 @@ module Google
         #     presence yet.
         # @!attribute [rw] execution_timeout
         #   @return [::Google::Protobuf::Duration]
-        #     Optional. Amount of time executable has to complete.  See JSON
-        #     representation of
+        #     Optional. Amount of time executable has to complete.  See JSON representation of
         #     [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json).
         #
         #     If this field is set with a value less than the RPC deadline, and the
@@ -1147,8 +1140,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # A response message for
-        # {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy}.
+        # A response message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy}.
         # @!attribute [rw] main_analysis
         #   @return [::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse::IamPolicyAnalysis]
         #     The main analysis that matches the original request.
@@ -1159,11 +1151,9 @@ module Google
         #     enabled.
         # @!attribute [rw] fully_explored
         #   @return [::Boolean]
-        #     Represents whether all entries in the
-        #     {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#main_analysis main_analysis}
-        #     and
-        #     {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#service_account_impersonation_analysis service_account_impersonation_analysis}
-        #     have been fully explored to answer the query in the request.
+        #     Represents whether all entries in the {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#main_analysis main_analysis} and
+        #     {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#service_account_impersonation_analysis service_account_impersonation_analysis} have been fully explored to
+        #     answer the query in the request.
         class AnalyzeIamPolicyResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1174,14 +1164,12 @@ module Google
           #     The analysis query.
           # @!attribute [rw] analysis_results
           #   @return [::Array<::Google::Cloud::Asset::V1::IamPolicyAnalysisResult>]
-          #     A list of
-          #     {::Google::Cloud::Asset::V1::IamPolicyAnalysisResult IamPolicyAnalysisResult}
-          #     that matches the analysis query, or empty if no result is found.
+          #     A list of {::Google::Cloud::Asset::V1::IamPolicyAnalysisResult IamPolicyAnalysisResult} that matches the analysis query, or
+          #     empty if no result is found.
           # @!attribute [rw] fully_explored
           #   @return [::Boolean]
-          #     Represents whether all entries in the
-          #     {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse::IamPolicyAnalysis#analysis_results analysis_results}
-          #     have been fully explored to answer the query.
+          #     Represents whether all entries in the {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse::IamPolicyAnalysis#analysis_results analysis_results} have been
+          #     fully explored to answer the query.
           # @!attribute [rw] non_critical_errors
           #   @return [::Array<::Google::Cloud::Asset::V1::IamPolicyAnalysisState>]
           #     A list of non-critical errors happened during the query handling.
@@ -1205,8 +1193,8 @@ module Google
           # A Cloud Storage location.
           # @!attribute [rw] uri
           #   @return [::String]
-          #     Required. 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
+          #     Required. 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.
@@ -1222,15 +1210,13 @@ module Google
           # A BigQuery destination.
           # @!attribute [rw] dataset
           #   @return [::String]
-          #     Required. The BigQuery dataset in format
-          #     "projects/projectId/datasets/datasetId", to which the analysis results
-          #     should be exported. If this dataset does not exist, the export call will
-          #     return an INVALID_ARGUMENT error.
+          #     Required. The BigQuery dataset in format "projects/projectId/datasets/datasetId",
+          #     to which the analysis results should be exported. If this dataset does
+          #     not exist, the export call will return an INVALID_ARGUMENT error.
           # @!attribute [rw] table_prefix
           #   @return [::String]
-          #     Required. The prefix of the BigQuery tables to which the analysis results
-          #     will be written. Tables will be created based on this table_prefix if not
-          #     exist:
+          #     Required. The prefix of the BigQuery tables to which the analysis results will be
+          #     written. Tables will be created based on this table_prefix if not exist:
           #     * <table_prefix>_analysis table will contain export operation's metadata.
           #     * <table_prefix>_analysis_result will contain all the
           #       {::Google::Cloud::Asset::V1::IamPolicyAnalysisResult IamPolicyAnalysisResult}.
@@ -1241,8 +1227,8 @@ module Google
           #     The partition key for BigQuery partitioned table.
           # @!attribute [rw] write_disposition
           #   @return [::String]
-          #     Optional. Specifies the action that occurs if the destination table or
-          #     partition already exists. The following values are supported:
+          #     Optional. Specifies the action that occurs if the destination table or partition
+          #     already exists. The following values are supported:
           #
           #     * WRITE_TRUNCATE: If the table or partition already exists, BigQuery
           #     overwrites the entire table or all the partitions data.
@@ -1275,8 +1261,7 @@ module Google
           end
         end
 
-        # A request message for
-        # {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}.
+        # A request message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}.
         # @!attribute [rw] analysis_query
         #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery]
         #     Required. The request query.
@@ -1300,15 +1285,13 @@ module Google
         #     presence yet.
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisOutputConfig]
-        #     Required. Output configuration indicating where the results will be output
-        #     to.
+        #     Required. Output configuration indicating where the results will be output to.
         class AnalyzeIamPolicyLongrunningRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # A response message for
-        # {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}.
+        # A response message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}.
         class AnalyzeIamPolicyLongrunningResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1337,8 +1320,7 @@ module Google
         #     Output only. The last update time of this saved query.
         # @!attribute [r] last_updater
         #   @return [::String]
-        #     Output only. The account's email address who has updated this saved query
-        #     most recently.
+        #     Output only. The account's email address who has updated this saved query most recently.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Labels applied on the resource.
@@ -1355,11 +1337,8 @@ module Google
           # @!attribute [rw] iam_policy_analysis_query
           #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery]
           #     An IAM Policy Analysis query, which could be used in
-          #     the
-          #     {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy}
-          #     rpc or the
-          #     {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}
-          #     rpc.
+          #     the {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy} rpc or
+          #     the {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning} rpc.
           class QueryContent
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1378,20 +1357,20 @@ module Google
         # Request to create a saved query.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the project/folder/organization where this
-        #     saved_query should be created in. It can only be an organization number
-        #     (such as "organizations/123"), a folder number (such as "folders/123"), a
-        #     project ID (such as "projects/my-project-id")", or a project number (such
-        #     as "projects/12345").
+        #     Required. The name of the project/folder/organization where this saved_query
+        #     should be created in. It can only be an organization number (such as
+        #     "organizations/123"), a folder number (such as "folders/123"), a project ID
+        #     (such as "projects/my-project-id")", or a project number (such as
+        #     "projects/12345").
         # @!attribute [rw] saved_query
         #   @return [::Google::Cloud::Asset::V1::SavedQuery]
-        #     Required. The saved_query details. The `name` field must be empty as it
-        #     will be generated based on the parent and saved_query_id.
+        #     Required. The saved_query details. The `name` field must be empty as it will be
+        #     generated based on the parent and saved_query_id.
         # @!attribute [rw] saved_query_id
         #   @return [::String]
-        #     Required. The ID to use for the saved query, which must be unique in the
-        #     specified parent. It will become the final component of the saved query's
-        #     resource name.
+        #     Required. The ID to use for the saved query, which must be unique in the specified
+        #     parent. It will become the final component of the saved query's resource
+        #     name.
         #
         #     This value should be 4-63 characters, and valid characters
         #     are /[a-z][0-9]-/.
@@ -1419,8 +1398,8 @@ module Google
         # Request to list saved queries.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The parent project/folder/organization whose savedQueries are to
-        #     be listed. It can only be using project/folder/organization number (such as
+        #     Required. The parent project/folder/organization whose savedQueries are to be
+        #     listed. It can only be using project/folder/organization number (such as
         #     "folders/12345")", or a project ID (such as "projects/my-project-id").
         # @!attribute [rw] filter
         #   @return [::String]
@@ -1433,9 +1412,8 @@ module Google
         #     See https://google.aip.dev/160 for more information on the grammar.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. The maximum number of saved queries to return per page. The
-        #     service may return fewer than this value. If unspecified, at most 50 will
-        #     be returned.
+        #     Optional. The maximum number of saved queries to return per page. The service may
+        #     return fewer than this value. If unspecified, at most 50 will be returned.
         #      The maximum value is 1000; values above 1000 will be coerced to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
@@ -1484,8 +1462,7 @@ module Google
         # Request to delete a saved query.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of the saved query to delete. It must be in the format
-        #     of:
+        #     Required. The name of the saved query to delete. It must be in the format of:
         #
         #     * projects/project_number/savedQueries/saved_query_id
         #     * folders/folder_number/savedQueries/saved_query_id
@@ -1594,13 +1571,12 @@ module Google
           # BigQuery destination.
           # @!attribute [rw] dataset
           #   @return [::String]
-          #     Required. The BigQuery dataset where the query results will be saved. It
-          #     has the format of "projects/\\{projectId}/datasets/\\{datasetId}".
+          #     Required. The BigQuery dataset where the query results will be saved. It has the
+          #     format of "projects/\\{projectId}/datasets/\\{datasetId}".
           # @!attribute [rw] table
           #   @return [::String]
-          #     Required. The BigQuery table where the query results will be saved. If
-          #     this table does not exist, a new table with the given name will be
-          #     created.
+          #     Required. The BigQuery table where the query results will be saved. If this table
+          #     does not exist, a new table with the given name will be created.
           # @!attribute [rw] write_disposition
           #   @return [::String]
           #     Specifies the action that occurs if the destination table or partition
@@ -1610,8 +1586,10 @@ module Google
           #     overwrites the entire table or all the partitions data.
           #     * WRITE_APPEND: If the table or partition already exists, BigQuery
           #     appends the data to the table or the latest partition.
-          #     * WRITE_EMPTY: If the table already exists and contains data, an error is
-          #     returned.
+          #     * WRITE_EMPTY: If the table already exists and contains data, a
+          #     'duplicate' error is returned in the job result.
+          #
+          #     The default value is WRITE_EMPTY.
           class BigQueryDestination
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1633,12 +1611,12 @@ module Google
         #     SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
         # @!attribute [rw] job_reference
         #   @return [::String]
-        #     Optional. Reference to the query job, which is from the
-        #     `QueryAssetsResponse` of previous `QueryAssets` call.
+        #     Optional. Reference to the query job, which is from the `QueryAssetsResponse` of
+        #     previous `QueryAssets` call.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. The maximum number of rows to return in the results. Responses
-        #     are limited to 10 MB and 1000 rows.
+        #     Optional. The maximum number of rows to return in the results. Responses are limited
+        #     to 10 MB and 1000 rows.
         #
         #     By default, the maximum row count is 1000. When the byte or row count limit
         #     is reached, the rest of the query results will be paginated.
@@ -1651,11 +1629,10 @@ module Google
         #     The field will be ignored when [output_config] is specified.
         # @!attribute [rw] timeout
         #   @return [::Google::Protobuf::Duration]
-        #     Optional. Specifies the maximum amount of time that the client is willing
-        #     to wait for the query to complete. By default, this limit is 5 min for the
-        #     first query, and 1 minute for the following queries. If the query is
-        #     complete, the `done` field in the `QueryAssetsResponse` is true, otherwise
-        #     false.
+        #     Optional. Specifies the maximum amount of time that the client is willing to wait
+        #     for the query to complete. By default, this limit is 5 min for the first
+        #     query, and 1 minute for the following queries. If the query is complete,
+        #     the `done` field in the `QueryAssetsResponse` is true, otherwise false.
         #
         #     Like BigQuery [jobs.query
         #     API](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#queryrequest)
@@ -1666,13 +1643,12 @@ module Google
         #     The field will be ignored when [output_config] is specified.
         # @!attribute [rw] read_time_window
         #   @return [::Google::Cloud::Asset::V1::TimeWindow]
-        #     Optional. [start_time] is required. [start_time] must be less than
-        #     [end_time] Defaults [end_time] to now if [start_time] is set and
-        #     [end_time] isn't. Maximum permitted time range is 7 days.
+        #     Optional. [start_time] is required. [start_time] must be less than [end_time]
+        #     Defaults [end_time] to now if [start_time] is set and [end_time] isn't.
+        #     Maximum permitted time range is 7 days.
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Optional. Queries cloud assets as they appeared at the specified point in
-        #     time.
+        #     Optional. Queries cloud assets as they appeared at the specified point in time.
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig]
         #     Optional. Destination where the query results will be saved.
@@ -1783,8 +1759,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # A request message for
-        # {::Google::Cloud::Asset::V1::AssetService::Client#batch_get_effective_iam_policies AssetService.BatchGetEffectiveIamPolicies}.
+        # A request message for {::Google::Cloud::Asset::V1::AssetService::Client#batch_get_effective_iam_policies AssetService.BatchGetEffectiveIamPolicies}.
         # @!attribute [rw] scope
         #   @return [::String]
         #     Required. Only IAM policies on or below the scope will be returned.
@@ -1810,16 +1785,14 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # A response message for
-        # {::Google::Cloud::Asset::V1::AssetService::Client#batch_get_effective_iam_policies AssetService.BatchGetEffectiveIamPolicies}.
+        # A response message for {::Google::Cloud::Asset::V1::AssetService::Client#batch_get_effective_iam_policies AssetService.BatchGetEffectiveIamPolicies}.
         # @!attribute [rw] policy_results
         #   @return [::Array<::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy>]
         #     The effective policies for a batch of resources. Note that the results
         #     order is the same as the order of
-        #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest#names BatchGetEffectiveIamPoliciesRequest.names}.
-        #     When a resource does not have any effective IAM policies, its corresponding
-        #     policy_result will contain empty
-        #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#policies EffectiveIamPolicy.policies}.
+        #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest#names BatchGetEffectiveIamPoliciesRequest.names}. When a resource does not
+        #     have any effective IAM policies, its corresponding policy_result will
+        #     contain empty {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#policies EffectiveIamPolicy.policies}.
         class BatchGetEffectiveIamPoliciesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1829,33 +1802,24 @@ module Google
           #   @return [::String]
           #     The [full_resource_name]
           #     (https://cloud.google.com/asset-inventory/docs/resource-name-format)
-          #     for which the
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#policies policies}
-          #     are computed. This is one of the
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest#names BatchGetEffectiveIamPoliciesRequest.names}
-          #     the caller provides in the request.
+          #     for which the {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#policies policies} are computed. This is one of the
+          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest#names BatchGetEffectiveIamPoliciesRequest.names} the caller provides in the
+          #     request.
           # @!attribute [rw] policies
           #   @return [::Array<::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo>]
-          #     The effective policies for the
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#full_resource_name full_resource_name}.
+          #     The effective policies for the {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#full_resource_name full_resource_name}.
           #
-          #     These policies include the policy set on the
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#full_resource_name full_resource_name}
-          #     and those set on its parents and ancestors up to the
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest#scope BatchGetEffectiveIamPoliciesRequest.scope}.
-          #     Note that these policies are not filtered according to the resource type
-          #     of the
+          #     These policies include the policy set on the {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#full_resource_name full_resource_name} and
+          #     those set on its parents and ancestors up to the
+          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest#scope BatchGetEffectiveIamPoliciesRequest.scope}. Note that these policies
+          #     are not filtered according to the resource type of the
           #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#full_resource_name full_resource_name}.
           #
           #     These policies are hierarchically ordered by
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource PolicyInfo.attached_resource}
-          #     starting from
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#full_resource_name full_resource_name}
+          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource PolicyInfo.attached_resource} starting from {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy#full_resource_name full_resource_name}
           #     itself to its parents and ancestors, such that policies[i]'s
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource PolicyInfo.attached_resource}
-          #     is the child of policies[i+1]'s
-          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource PolicyInfo.attached_resource},
-          #     if policies[i+1] exists.
+          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource PolicyInfo.attached_resource} is the child of policies[i+1]'s
+          #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource PolicyInfo.attached_resource}, if policies[i+1] exists.
           class EffectiveIamPolicy
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1863,13 +1827,10 @@ module Google
             # The IAM policy and its attached resource.
             # @!attribute [rw] attached_resource
             #   @return [::String]
-            #     The full resource name the
-            #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#policy policy}
-            #     is directly attached to.
+            #     The full resource name the {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#policy policy} is directly attached to.
             # @!attribute [rw] policy
             #   @return [::Google::Iam::V1::Policy]
-            #     The IAM policy that's directly attached to the
-            #     {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource attached_resource}.
+            #     The IAM policy that's directly attached to the {::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy::PolicyInfo#attached_resource attached_resource}.
             class PolicyInfo
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods