Google APIs updated at 2023-01-13 (#51)

Co-authored-by: GitHub Actions <>

gcloud-sdk/genproto/google.cloud.asset.v1p1beta1.rs

@@ -33,7 +33,8 @@ pub struct StandardResourceMetadata {
     /// "us-west1-b".
     #[prost(string, tag = "11")]
     pub location: ::prost::alloc::string::String,
-    /// Labels associated with this resource. See [Labelling and grouping GCP
+    /// Labels associated with this resource. See [Labelling and grouping Google
+    /// Cloud
     /// resources](<https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources>)
     /// for more information.
     #[prost(map = "string, string", tag = "12")]
@@ -42,36 +43,39 @@ pub struct StandardResourceMetadata {
         ::prost::alloc::string::String,
     >,
     /// Network tags associated with this resource. Like labels, network tags are a
-    /// type of annotations used to group GCP resources. See [Labelling GCP
+    /// type of annotations used to group Google Cloud resources. See [Labelling
+    /// Google Cloud
     /// resources](l<https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources>)
     /// for more information.
     #[prost(string, repeated, tag = "13")]
     pub network_tags: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
 }
-/// The result for a IAM Policy search.
+/// The result for an IAM policy search.
 #[allow(clippy::derive_partial_eq_without_eq)]
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct IamPolicySearchResult {
-    /// The [full resource
+    /// The
+    /// [full resource
     /// name](<https://cloud.google.com/apis/design/resource_names#full_resource_name>)
     /// of the resource associated with this IAM policy.
     #[prost(string, tag = "1")]
     pub resource: ::prost::alloc::string::String,
-    /// The project that the associated GCP resource belongs to, in the form of
-    /// `projects/{project_number}`. If an IAM policy is set on a resource (like VM
-    /// instance, Cloud Storage bucket), the project field will indicate the
-    /// project that contains the resource. If an IAM policy is set on a folder or
-    /// orgnization, the project field will be empty.
+    /// The project that the associated Google Cloud resource belongs to, in the
+    /// form of `projects/{project_number}`. If an IAM policy is set on a resource
+    /// -- such as a Compute Engine instance or a Cloud Storage bucket -- the
+    /// project field will indicate the project that contains the resource. If an
+    /// IAM policy is set on a folder or orgnization, the project field will be
+    /// empty.
     #[prost(string, tag = "3")]
     pub project: ::prost::alloc::string::String,
-    /// The IAM policy directly set on the given resource. Note that the original
+    /// The IAM policy attached to the specified resource. Note that the original
     /// IAM policy can contain multiple bindings. This only contains the bindings
-    /// that match the given query. For queries that don't contain a constrain on
+    /// that match the given query. For queries that don't contain a constraint on
     /// policies (e.g. an empty query), this contains all the bindings.
     #[prost(message, optional, tag = "4")]
     pub policy: ::core::option::Option<super::super::super::iam::v1::Policy>,
     /// Explanation about the IAM policy search result. It contains additional
-    /// information to explain why the search result matches the query.
+    /// information that explains why the search result matches the query.
     #[prost(message, optional, tag = "5")]
     pub explanation: ::core::option::Option<iam_policy_search_result::Explanation>,
 }
@@ -82,7 +86,7 @@ pub mod iam_policy_search_result {
     #[derive(Clone, PartialEq, ::prost::Message)]
     pub struct Explanation {
         /// The map from roles to their included permission matching the permission
-        /// query (e.g. containing `policy.role.permissions:`). A sample role string:
+        /// query (e.g. containing `policy.role.permissions:`). Example role string:
         /// "roles/compute.instanceAdmin". The roles can also be found in the
         /// returned `policy` bindings. Note that the map is populated only if
         /// requesting with a permission query.
@@ -93,49 +97,51 @@ pub mod iam_policy_search_result {
         >,
     }
 }
-/// IAM permissions
+/// IAM permissions.
 #[allow(clippy::derive_partial_eq_without_eq)]
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct Permissions {
-    /// A list of permissions. A sample permission string: "compute.disk.get".
+    /// A list of permissions. Example permission string: "compute.disk.get".
     #[prost(string, repeated, tag = "1")]
     pub permissions: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
 }
 /// Search all resources request.
 #[allow(clippy::derive_partial_eq_without_eq)]
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct SearchAllResourcesRequest {
-    /// Required. The relative name of an asset. The search is limited to the resources
-    /// within the `scope`. The allowed value must be:
+    /// Required. The relative name of an asset. The search is limited to the
+    /// resources within the `scope`. The allowed value must be:
+    ///
     /// * Organization number (such as "organizations/123")
-    /// * Folder number(such as "folders/1234")
+    /// * Folder number (such as "folders/1234")
     /// * Project number (such as "projects/12345")
-    /// * Project id (such as "projects/abc")
+    /// * Project ID (such as "projects/abc")
     #[prost(string, tag = "1")]
     pub scope: ::prost::alloc::string::String,
     /// Optional. The query statement.
     #[prost(string, tag = "2")]
     pub query: ::prost::alloc::string::String,
-    /// Optional. A list of asset types that this request searches for. If empty, it will
-    /// search all the supported asset types.
+    /// Optional. A list of asset types that this request searches for. If empty,
+    /// it will search all the supported asset types.
     #[prost(string, repeated, tag = "3")]
     pub asset_types: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
-    /// 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.
     #[prost(int32, tag = "4")]
     pub page_size: i32,
-    /// 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.
     #[prost(string, tag = "5")]
     pub page_token: ::prost::alloc::string::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. For
-    /// example, "  foo ,  bar  desc  ".
+    /// 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.
+    /// For example, `  location DESC ,  name  `.
     #[prost(string, tag = "10")]
     pub order_by: ::prost::alloc::string::String,
 }
@@ -156,39 +162,41 @@ pub struct SearchAllResourcesResponse {
 #[allow(clippy::derive_partial_eq_without_eq)]
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct SearchAllIamPoliciesRequest {
-    /// Required. The relative name of an asset. The search is limited to the resources
-    /// within the `scope`. The allowed value must be:
+    /// Required. The relative name of an asset. The search is limited to the
+    /// resources within the `scope`. The allowed value must be:
+    ///
     /// * Organization number (such as "organizations/123")
-    /// * Folder number(such as "folders/1234")
+    /// * Folder number (such as "folders/1234")
     /// * Project number (such as "projects/12345")
-    /// * Project id (such as "projects/abc")
+    /// * Project ID (such as "projects/abc")
     #[prost(string, tag = "1")]
     pub scope: ::prost::alloc::string::String,
-    /// Optional. The query statement.
-    /// Examples:
+    /// Optional. The query statement. Examples:
+    ///
     /// * "policy:[email protected]"
     /// * "policy:([email protected] viewer)"
     #[prost(string, tag = "2")]
     pub query: ::prost::alloc::string::String,
-    /// 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.
     #[prost(int32, tag = "3")]
     pub page_size: i32,
-    /// 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.
     #[prost(string, tag = "4")]
     pub page_token: ::prost::alloc::string::String,
 }
 /// Search all IAM policies response.
 #[allow(clippy::derive_partial_eq_without_eq)]
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct SearchAllIamPoliciesResponse {
-    /// A list of IamPolicy that match the search query. Related information such
-    /// as the associated resource is returned along with the policy.
+    /// A list of IAM policies that match the search query. Related information
+    /// such as the associated resource is returned along with the policy.
     #[prost(message, repeated, tag = "1")]
     pub results: ::prost::alloc::vec::Vec<IamPolicySearchResult>,
     /// Set if there are more results than those appearing in this response; to get
@@ -267,12 +275,12 @@ pub mod asset_service_client {
             self.inner = self.inner.accept_compressed(encoding);
             self
         }
-        /// Searches all the resources under a given accessible CRM scope
-        /// (project/folder/organization). This RPC gives callers
-        /// especially admins the ability to search all the resources under a scope,
-        /// even if they don't have .get permission of all the resources. Callers
-        /// should have cloud.assets.SearchAllResources permission on the requested
-        /// scope, otherwise it will be rejected.
+        /// Searches all the resources within a given accessible Resource Manager scope
+        /// (project/folder/organization). This RPC gives callers especially
+        /// administrators the ability to search all the resources within a scope, even
+        /// if they don't have `.get` permission of all the resources. Callers should
+        /// have `cloud.assets.SearchAllResources` permission on the requested scope,
+        /// otherwise the request will be rejected.
         pub async fn search_all_resources(
             &mut self,
             request: impl tonic::IntoRequest<super::SearchAllResourcesRequest>,
@@ -292,12 +300,12 @@ pub mod asset_service_client {
             );
             self.inner.unary(request.into_request(), path, codec).await
         }
-        /// Searches all the IAM policies under a given accessible CRM scope
-        /// (project/folder/organization). This RPC gives callers
-        /// especially admins the ability to search all the IAM policies under a scope,
-        /// even if they don't have .getIamPolicy permission of all the IAM policies.
-        /// Callers should have cloud.assets.SearchAllIamPolicies permission on the
-        /// requested scope, otherwise it will be rejected.
+        /// Searches all the IAM policies within a given accessible Resource Manager
+        /// scope (project/folder/organization). This RPC gives callers especially
+        /// administrators the ability to search all the IAM policies within a scope,
+        /// even if they don't have `.getIamPolicy` permission of all the IAM policies.
+        /// Callers should have `cloud.assets.SearchAllIamPolicies` permission on the
+        /// requested scope, otherwise the request will be rejected.
         pub async fn search_all_iam_policies(
             &mut self,
             request: impl tonic::IntoRequest<super::SearchAllIamPoliciesRequest>,