feat: add a new searchable field kmsKeys (#665)

- [ ] Regenerate this pull request now.

fix: deprecate searchable field kmsKey

PiperOrigin-RevId: 479103182

Source-Link: https://github.com/googleapis/googleapis/commit/7b5a467b978ff2dde6cd34717ebad5728d05f2bb

Source-Link: https://github.com/googleapis/googleapis-gen/commit/417aefa0fb633d0f171a607779e9f0e19c8b8b7f
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNDE3YWVmYTBmYjYzM2QwZjE3MWE2MDc3NzllOWYwZTE5YzhiOGI3ZiJ9

asset/snippets/generated/v1/asset_service.analyze_iam_policy.js

@@ -49,8 +49,7 @@ function main(analysisQuery) {
    */
   // const savedAnalysisQuery = 'abc123'
   /**
-   *  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
    *  execution of your query hasn't finished in the specified

asset/snippets/generated/v1/asset_service.analyze_iam_policy_longrunning.js

@@ -49,8 +49,7 @@ function main(analysisQuery, outputConfig) {
    */
   // const savedAnalysisQuery = 'abc123'
   /**
-   *  Required. Output configuration indicating where the results will be output
-   *  to.
+   *  Required. Output configuration indicating where the results will be output to.
    */
   // const outputConfig = {}
 

asset/snippets/generated/v1/asset_service.create_feed.js

@@ -42,8 +42,9 @@ function main(parent, feedId, feed) {
    */
   // const feedId = 'abc123'
   /**
-   *  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
    */

asset/snippets/generated/v1/asset_service.create_saved_query.js

@@ -29,22 +29,22 @@ function main(parent, savedQuery, savedQueryId) {
    * TODO(developer): Uncomment these variables before running the sample.
    */
   /**
-   *  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").
    */
   // const parent = 'abc123'
   /**
-   *  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.
    */
   // const savedQuery = {}
   /**
-   *  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]-/.
    *  Notice that this field is required in the saved query creation, and the

asset/snippets/generated/v1/asset_service.delete_saved_query.js

@@ -29,8 +29,7 @@ function main(name) {
    * TODO(developer): Uncomment these variables before running the sample.
    */
   /**
-   *  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
    *  * organizations/organization_number/savedQueries/saved_query_id

asset/snippets/generated/v1/asset_service.export_assets.js

@@ -66,8 +66,7 @@ function main(parent, outputConfig) {
    */
   // const contentType = {}
   /**
-   *  Required. Output configuration indicating where the results will be output
-   *  to.
+   *  Required. Output configuration indicating where the results will be output to.
    */
   // const outputConfig = {}
   /**

asset/snippets/generated/v1/asset_service.list_assets.js

@@ -29,11 +29,11 @@ function main(parent) {
    * TODO(developer): Uncomment these variables before running the sample.
    */
   /**
-   *  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").
    */
   // const parent = 'abc123'
   /**

asset/snippets/generated/v1/asset_service.list_saved_queries.js

@@ -29,8 +29,8 @@ function main(parent) {
    * TODO(developer): Uncomment these variables before running the sample.
    */
   /**
-   *  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").
    */
   // const parent = 'abc123'
@@ -44,9 +44,8 @@ function main(parent) {
    */
   // const filter = 'abc123'
   /**
-   *  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.
    */
   // const pageSize = 1234

asset/snippets/generated/v1/asset_service.query_assets.js

@@ -42,13 +42,13 @@ function main(parent) {
    */
   // const statement = 'abc123'
   /**
-   *  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.
    */
   // const jobReference = 'abc123'
   /**
-   *  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.
    *  The field will be ignored when output_config  is specified.
@@ -60,11 +60,10 @@ function main(parent) {
    */
   // const pageToken = 'abc123'
   /**
-   *  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)
    *  The call is not guaranteed to wait for the specified timeout; it typically
@@ -74,14 +73,13 @@ function main(parent) {
    */
   // const timeout = {}
   /**
-   *  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.
    */
   // const readTimeWindow = {}
   /**
-   *  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.
    */
   // const readTime = {}
   /**

asset/snippets/generated/v1/asset_service.search_all_iam_policies.js

@@ -29,9 +29,9 @@ function main(scope) {
    * TODO(developer): Uncomment these variables before running the sample.
    */
   /**
-   *  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.
    *  The allowed values are:
@@ -85,24 +85,22 @@ function main(scope) {
    */
   // const query = 'abc123'
   /**
-   *  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.
    */
   // const pageSize = 1234
   /**
-   *  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.
    */
   // const pageToken = 'abc123'
   /**
-   *  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:
    *  * "compute.googleapis.com.*" snapshots IAM policies attached to asset type
@@ -117,9 +115,9 @@ function main(scope) {
    */
   // const assetTypes = 'abc123'
   /**
-   *  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

asset/snippets/generated/v1/asset_service.search_all_resources.js

@@ -29,9 +29,8 @@ function main(scope) {
    * TODO(developer): Uncomment these variables before running the sample.
    */
   /**
-   *  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.
    *  The allowed values are:
@@ -61,7 +60,11 @@ function main(scope) {
    *    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
@@ -91,8 +94,8 @@ function main(scope) {
    */
   // const query = 'abc123'
   /**
-   *  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:
    *  * "compute.googleapis.com.*" snapshots resources whose asset type starts
@@ -105,24 +108,23 @@ function main(scope) {
    */
   // const assetTypes = 'abc123'
   /**
-   *  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.
    */
   // const pageSize = 1234
   /**
-   *  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.
    */
   // const pageToken = 'abc123'
   /**
-   *  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:
    *    * name
@@ -131,22 +133,21 @@ function main(scope) {
    *    * 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.
    */
   // const orderBy = 'abc123'
   /**
-   *  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):
    *    * name
@@ -160,7 +161,9 @@ function main(scope) {
    *    * tagValueIds
    *    * labels
    *    * networkTags
-   *    * kmsKey
+   *    * kmsKey (This field is deprecated. Please use the `kmsKeys` field to
+   *      retrieve KMS key information.)
+   *    * kmsKeys
    *    * createTime
    *    * updateTime
    *    * state

asset/snippets/generated/v1/asset_service.update_feed.js

@@ -29,8 +29,8 @@ function main(feed, updateMask) {
    * TODO(developer): Uncomment these variables before running the sample.
    */
   /**
-   *  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.