google-cloud-resource_manager-v3 0.4.0 → 0.5.1

data/lib/google/cloud/resourcemanager/v3/tag_holds_services_pb.rb

@@ -0,0 +1,54 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/resourcemanager/v3/tag_holds.proto for package 'Google.Cloud.ResourceManager.V3'
+# Original file comments:
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'grpc'
+require 'google/cloud/resourcemanager/v3/tag_holds_pb'
+
+module Google
+  module Cloud
+    module ResourceManager
+      module V3
+        module TagHolds
+          # Allow users to create and manage TagHolds for TagValues. TagHolds represent
+          # the use of a Tag Value that is not captured by TagBindings but
+          # should still block TagValue deletion (such as a reference in a policy
+          # condition). This service provides isolated failure domains by cloud location
+          # so that TagHolds can be managed in the same location as their usage.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.resourcemanager.v3.TagHolds'
+
+            # Creates a TagHold. Returns ALREADY_EXISTS if a TagHold with the same
+            # resource and origin exists under the same TagValue.
+            rpc :CreateTagHold, ::Google::Cloud::ResourceManager::V3::CreateTagHoldRequest, ::Google::Longrunning::Operation
+            # Deletes a TagHold.
+            rpc :DeleteTagHold, ::Google::Cloud::ResourceManager::V3::DeleteTagHoldRequest, ::Google::Longrunning::Operation
+            # Lists TagHolds under a TagValue.
+            rpc :ListTagHolds, ::Google::Cloud::ResourceManager::V3::ListTagHoldsRequest, ::Google::Cloud::ResourceManager::V3::ListTagHoldsResponse
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/resourcemanager/v3/tag_keys_pb.rb

@@ -24,6 +24,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :create_time, :message, 6, "google.protobuf.Timestamp"
       optional :update_time, :message, 7, "google.protobuf.Timestamp"
       optional :etag, :string, 8
+      optional :purpose, :enum, 11, "google.cloud.resourcemanager.v3.Purpose"
+      map :purpose_data, :string, :string, 12
     end
     add_message "google.cloud.resourcemanager.v3.ListTagKeysRequest" do
       optional :parent, :string, 1
@@ -37,6 +39,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.resourcemanager.v3.GetTagKeyRequest" do
       optional :name, :string, 1
     end
+    add_message "google.cloud.resourcemanager.v3.GetNamespacedTagKeyRequest" do
+      optional :name, :string, 1
+    end
     add_message "google.cloud.resourcemanager.v3.CreateTagKeyRequest" do
       optional :tag_key, :message, 1, "google.cloud.resourcemanager.v3.TagKey"
       optional :validate_only, :bool, 2
@@ -57,6 +62,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.resourcemanager.v3.DeleteTagKeyMetadata" do
     end
+    add_enum "google.cloud.resourcemanager.v3.Purpose" do
+      value :PURPOSE_UNSPECIFIED, 0
+      value :GCE_FIREWALL, 1
+    end
   end
 end
 
@@ -68,12 +77,14 @@ module Google
         ListTagKeysRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.ListTagKeysRequest").msgclass
         ListTagKeysResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.ListTagKeysResponse").msgclass
         GetTagKeyRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.GetTagKeyRequest").msgclass
+        GetNamespacedTagKeyRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.GetNamespacedTagKeyRequest").msgclass
         CreateTagKeyRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.CreateTagKeyRequest").msgclass
         CreateTagKeyMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.CreateTagKeyMetadata").msgclass
         UpdateTagKeyRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.UpdateTagKeyRequest").msgclass
         UpdateTagKeyMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.UpdateTagKeyMetadata").msgclass
         DeleteTagKeyRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.DeleteTagKeyRequest").msgclass
         DeleteTagKeyMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.DeleteTagKeyMetadata").msgclass
+        Purpose = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.Purpose").enummodule
       end
     end
   end

data/lib/google/cloud/resourcemanager/v3/tag_keys_services_pb.rb

@@ -38,10 +38,14 @@ module Google
             # Retrieves a TagKey. This method will return `PERMISSION_DENIED` if the
             # key does not exist or the user does not have permission to view it.
             rpc :GetTagKey, ::Google::Cloud::ResourceManager::V3::GetTagKeyRequest, ::Google::Cloud::ResourceManager::V3::TagKey
+            # Retrieves a TagKey by its namespaced name.
+            # This method will return `PERMISSION_DENIED` if the key does not exist
+            # or the user does not have permission to view it.
+            rpc :GetNamespacedTagKey, ::Google::Cloud::ResourceManager::V3::GetNamespacedTagKeyRequest, ::Google::Cloud::ResourceManager::V3::TagKey
             # Creates a new TagKey. If another request with the same parameters is
             # sent while the original request is in process, the second request
-            # will receive an error. A maximum of 300 TagKeys can exist under a parent at
-            # any given time.
+            # will receive an error. A maximum of 1000 TagKeys can exist under a parent
+            # at any given time.
             rpc :CreateTagKey, ::Google::Cloud::ResourceManager::V3::CreateTagKeyRequest, ::Google::Longrunning::Operation
             # Updates the attributes of the TagKey resource.
             rpc :UpdateTagKey, ::Google::Cloud::ResourceManager::V3::UpdateTagKeyRequest, ::Google::Longrunning::Operation

data/lib/google/cloud/resourcemanager/v3/tag_values_pb.rb

@@ -37,6 +37,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.resourcemanager.v3.GetTagValueRequest" do
       optional :name, :string, 1
     end
+    add_message "google.cloud.resourcemanager.v3.GetNamespacedTagValueRequest" do
+      optional :name, :string, 1
+    end
     add_message "google.cloud.resourcemanager.v3.CreateTagValueRequest" do
       optional :tag_value, :message, 1, "google.cloud.resourcemanager.v3.TagValue"
       optional :validate_only, :bool, 2
@@ -68,6 +71,7 @@ module Google
         ListTagValuesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.ListTagValuesRequest").msgclass
         ListTagValuesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.ListTagValuesResponse").msgclass
         GetTagValueRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.GetTagValueRequest").msgclass
+        GetNamespacedTagValueRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.GetNamespacedTagValueRequest").msgclass
         CreateTagValueRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.CreateTagValueRequest").msgclass
         CreateTagValueMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.CreateTagValueMetadata").msgclass
         UpdateTagValueRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.resourcemanager.v3.UpdateTagValueRequest").msgclass

data/lib/google/cloud/resourcemanager/v3/tag_values_services_pb.rb

@@ -35,13 +35,16 @@ module Google
 
             # Lists all TagValues for a specific TagKey.
             rpc :ListTagValues, ::Google::Cloud::ResourceManager::V3::ListTagValuesRequest, ::Google::Cloud::ResourceManager::V3::ListTagValuesResponse
-            # Retrieves TagValue. If the TagValue or namespaced name does not exist, or
-            # if the user does not have permission to view it, this method will return
-            # `PERMISSION_DENIED`.
+            # Retrieves a TagValue. This method will return `PERMISSION_DENIED` if the
+            # value does not exist or the user does not have permission to view it.
             rpc :GetTagValue, ::Google::Cloud::ResourceManager::V3::GetTagValueRequest, ::Google::Cloud::ResourceManager::V3::TagValue
+            # Retrieves a TagValue by its namespaced name.
+            # This method will return `PERMISSION_DENIED` if the value does not exist
+            # or the user does not have permission to view it.
+            rpc :GetNamespacedTagValue, ::Google::Cloud::ResourceManager::V3::GetNamespacedTagValueRequest, ::Google::Cloud::ResourceManager::V3::TagValue
             # Creates a TagValue as a child of the specified TagKey. If a another
             # request with the same parameters is sent while the original request is in
-            # process the second request will receive an error. A maximum of 300
+            # process the second request will receive an error. A maximum of 1000
             # TagValues can exist under a TagKey at any given time.
             rpc :CreateTagValue, ::Google::Cloud::ResourceManager::V3::CreateTagValueRequest, ::Google::Longrunning::Operation
             # Updates the attributes of the TagValue resource.

data/proto_docs/google/api/client.rb

@@ -35,7 +35,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
     #     long-running operation pattern.
     # @!attribute [rw] new_issue_uri
     #   @return [::String]
-    #     Link to a place that API users can report issues.  Example:
+    #     Link to a *public* URI where users can report issues.  Example:
     #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
     # @!attribute [rw] documentation_uri
     #   @return [::String]
@@ -111,6 +113,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from original service names to renamed versions.
+    #     This is used when the default generated types
+    #     would cause a naming conflict. (Neither name is
+    #     fully-qualified.)
+    #     Example: Subscriber to SubscriberServiceApi.
+    # @!attribute [rw] renamed_resources
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from full resource types to the effective short name
+    #     for the resource. This is used when otherwise resource
+    #     named from different services would cause naming collisions.
+    #     Example entry:
+    #     "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
+    # @!attribute [rw] ignored_resources
+    #   @return [::Array<::String>]
+    #     List of full resource types to ignore during generation.
+    #     This is typically used for API-specific Location resources,
+    #     which should be handled by the generator as if they were actually
+    #     the common Location resources.
+    #     Example entry: "documentai.googleapis.com/Location"
+    # @!attribute [rw] forced_namespace_aliases
+    #   @return [::Array<::String>]
+    #     Namespaces which must be aliased in snippets due to
+    #     a known (but non-generator-predictable) naming collision
+    # @!attribute [rw] handwritten_signatures
+    #   @return [::Array<::String>]
+    #     Method signatures (in the form "service.method(signature)")
+    #     which are provided separately, so shouldn't be generated.
+    #     Snippets *calling* these methods are still generated, however.
     class DotnetSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedResourcesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
 
       # Street View Org.
       STREET_VIEW = 4
+
+      # Shopping Org.
+      SHOPPING = 5
+
+      # Geo Org.
+      GEO = 6
+
+      # Generative AI - https://developers.generativeai.google
+      GENERATIVE_AI = 7
     end
 
     # To where should client libraries be published?

data/proto_docs/google/cloud/resourcemanager/v3/folders.rb

@@ -58,9 +58,9 @@ module Google
         #     Output only. Timestamp when the folder was requested to be deleted.
         # @!attribute [r] etag
         #   @return [::String]
-        #     Output only. A checksum computed by the server based on the current value of the folder
-        #     resource. This may be sent on update and delete requests to ensure the
-        #     client has an up-to-date value before proceeding.
+        #     Output only. A checksum computed by the server based on the current value
+        #     of the folder resource. This may be sent on update and delete requests to
+        #     ensure the client has an up-to-date value before proceeding.
         class Folder
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -91,15 +91,20 @@ module Google
         # The ListFolders request message.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the organization or folder whose folders are
-        #     being listed.
-        #     Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
+        #     Required. The name of the parent resource whose folders are being listed.
+        #     Only children of this parent resource are listed; descendants are not
+        #     listed.
+        #
+        #     If the parent is a folder, use the value `folders/{folder_id}`. If the
+        #     parent is an organization, use the value `organizations/{org_id}`.
+        #
         #     Access to this method is controlled by checking the
         #     `resourcemanager.folders.list` permission on the `parent`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. The maximum number of folders to return in the response.
-        #     If unspecified, server picks an appropriate default.
+        #     Optional. The maximum number of folders to return in the response. The
+        #     server can return fewer folders than requested. If unspecified, server
+        #     picks an appropriate default.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A pagination token returned from a previous call to `ListFolders`
@@ -131,12 +136,13 @@ module Google
         # The request message for searching folders.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. The maximum number of folders to return in the response.
-        #     If unspecified, server picks an appropriate default.
+        #     Optional. The maximum number of folders to return in the response. The
+        #     server can return fewer folders than requested. If unspecified, server
+        #     picks an appropriate default.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A pagination token returned from a previous call to `SearchFolders`
-        #     that indicates from where search should continue.
+        #     Optional. A pagination token returned from a previous call to
+        #     `SearchFolders` that indicates from where search should continue.
         # @!attribute [rw] query
         #   @return [::String]
         #     Optional. Search criteria used to select the folders to return.
@@ -192,8 +198,8 @@ module Google
         # The CreateFolder request message.
         # @!attribute [rw] folder
         #   @return [::Google::Cloud::ResourceManager::V3::Folder]
-        #     Required. The folder being created, only the display name and parent will be
-        #     consulted. All other fields will be ignored.
+        #     Required. The folder being created, only the display name and parent will
+        #     be consulted. All other fields will be ignored.
         class CreateFolderRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -222,8 +228,8 @@ module Google
         # change the `parent` field.
         # @!attribute [rw] folder
         #   @return [::Google::Cloud::ResourceManager::V3::Folder]
-        #     Required. The new definition of the Folder. It must include the `name` field, which
-        #     cannot be changed.
+        #     Required. The new definition of the Folder. It must include the `name`
+        #     field, which cannot be changed.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Required. Fields to be updated.
@@ -247,9 +253,9 @@ module Google
         #     Must be of the form folders/\\{folder_id}
         # @!attribute [rw] destination_parent
         #   @return [::String]
-        #     Required. The resource name of the folder or organization which should be the
-        #     folder's new parent.
-        #     Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
+        #     Required. The resource name of the folder or organization which should be
+        #     the folder's new parent. Must be of the form `folders/{folder_id}` or
+        #     `organizations/{org_id}`.
         class MoveFolderRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/resourcemanager/v3/organizations.rb

@@ -51,9 +51,9 @@ module Google
         #     Output only. Timestamp when the Organization was requested for deletion.
         # @!attribute [r] etag
         #   @return [::String]
-        #     Output only. A checksum computed by the server based on the current value of the
-        #     Organization resource. This may be sent on update and delete requests to
-        #     ensure the client has an up-to-date value before proceeding.
+        #     Output only. A checksum computed by the server based on the current value
+        #     of the Organization resource. This may be sent on update and delete
+        #     requests to ensure the client has an up-to-date value before proceeding.
         class Organization
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -75,9 +75,9 @@ module Google
         # required. `organization_id` is no longer accepted.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The resource name of the Organization to fetch. This is the organization's
-        #     relative path in the API, formatted as "organizations/[organizationId]".
-        #     For example, "organizations/1234".
+        #     Required. The resource name of the Organization to fetch. This is the
+        #     organization's relative path in the API, formatted as
+        #     "organizations/[organizationId]". For example, "organizations/1234".
         class GetOrganizationRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -87,15 +87,17 @@ module Google
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. The maximum number of organizations to return in the response.
-        #     If unspecified, server picks an appropriate default.
+        #     The server can return fewer organizations than requested. If unspecified,
+        #     server picks an appropriate default.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A pagination token returned from a previous call to `SearchOrganizations`
-        #     that indicates from where listing should continue.
+        #     Optional. A pagination token returned from a previous call to
+        #     `SearchOrganizations` that indicates from where listing should continue.
         # @!attribute [rw] query
         #   @return [::String]
-        #     Optional. An optional query string used to filter the Organizations to return in
-        #     the response. Query rules are case-insensitive.
+        #     Optional. An optional query string used to filter the Organizations to
+        #     return in the response. Query rules are case-insensitive.
+        #
         #
         #     ```
         #     | Field            | Description                                |

data/proto_docs/google/cloud/resourcemanager/v3/projects.rb

@@ -26,8 +26,8 @@ module Google
         # Google Cloud Platform resources.
         # @!attribute [r] name
         #   @return [::String]
-        #     Output only. The unique resource name of the project. It is an int64 generated number
-        #     prefixed by "projects/".
+        #     Output only. The unique resource name of the project. It is an int64
+        #     generated number prefixed by "projects/".
         #
         #     Example: `projects/415104041262`
         # @!attribute [rw] parent
@@ -64,9 +64,9 @@ module Google
         #     Output only. The time at which this resource was requested for deletion.
         # @!attribute [r] etag
         #   @return [::String]
-        #     Output only. A checksum computed by the server based on the current value of the Project
-        #     resource. This may be sent on update and delete requests to ensure the
-        #     client has an up-to-date value before proceeding.
+        #     Output only. A checksum computed by the server based on the current value
+        #     of the Project resource. This may be sent on update and delete requests to
+        #     ensure the client has an up-to-date value before proceeding.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. The labels associated with this project.
@@ -77,7 +77,7 @@ module Google
         #     Label values must be between 0 and 63 characters long and must conform
         #     to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
         #
-        #     No more than 256 labels can be associated with a given resource.
+        #     No more than 64 labels can be associated with a given resource.
         #
         #     Clients should store labels in a representation such as JSON that does not
         #     depend on specific characters being disallowed.
@@ -131,15 +131,17 @@ module Google
         # method.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the parent resource to list projects under.
+        #     Required. The name of the parent resource whose projects are being listed.
+        #     Only children of this parent resource are listed; descendants are not
+        #     listed.
         #
-        #     For example, setting this field to 'folders/1234' would list all projects
-        #     directly under that folder.
+        #     If the parent is a folder, use the value `folders/{folder_id}`. If the
+        #     parent is an organization, use the value `organizations/{org_id}`.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A pagination token returned from a previous call to [ListProjects]
-        #     [google.cloud.resourcemanager.v3.Projects.ListProjects]
-        #     that indicates from where listing should continue.
+        #     Optional. A pagination token returned from a previous call to
+        #     [ListProjects] [google.cloud.resourcemanager.v3.Projects.ListProjects] that
+        #     indicates from where listing should continue.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. The maximum number of projects to return in the response.
@@ -147,8 +149,8 @@ module Google
         #     If unspecified, server picks an appropriate default.
         # @!attribute [rw] show_deleted
         #   @return [::Boolean]
-        #     Optional. Indicate that projects in the `DELETE_REQUESTED` state should also be
-        #     returned. Normally only `ACTIVE` projects are returned.
+        #     Optional. Indicate that projects in the `DELETE_REQUESTED` state should
+        #     also be returned. Normally only `ACTIVE` projects are returned.
         class ListProjectsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -192,48 +194,42 @@ module Google
         #   @return [::String]
         #     Optional. A query string for searching for projects that the caller has
         #     `resourcemanager.projects.get` permission to. If multiple fields are
-        #     included in the query, the it will return results that match any of the
+        #     included in the query, then it will return results that match any of the
         #     fields. Some eligible fields are:
         #
-        #     ```
-        #     | Field                   | Description                                  |
-        #     |-------------------------|----------------------------------------------|
-        #     | displayName, name       | Filters by displayName.                      |
-        #     | parent                  | Project's parent. (for example: folders/123,
-        #     organizations/*) Prefer parent field over parent.type and parent.id. |
-        #     | parent.type             | Parent's type: `folder` or `organization`.   |
-        #     | parent.id               | Parent's id number (for example: 123)        |
-        #     | id, projectId           | Filters by projectId.                        |
-        #     | state, lifecycleState   | Filters by state.                            |
-        #     | labels                  | Filters by label name or value.              |
-        #     | labels.<key> (where *key* is the name of a label) | Filters by label
-        #     name. |
-        #     ```
+        #     - **`displayName`, `name`**: Filters by displayName.
+        #     - **`parent`**: Project's parent (for example: `folders/123`,
+        #     `organizations/*`). Prefer `parent` field over `parent.type` and
+        #     `parent.id`.
+        #     - **`parent.type`**: Parent's type: `folder` or `organization`.
+        #     - **`parent.id`**: Parent's id number (for example: `123`).
+        #     - **`id`, `projectId`**: Filters by projectId.
+        #     - **`state`, `lifecycleState`**: Filters by state.
+        #     - **`labels`**: Filters by label name or value.
+        #     - **`labels.<key>` (where `<key>` is the name of a label)**: Filters by label
+        #     name.
         #
         #     Search expressions are case insensitive.
         #
         #     Some examples queries:
         #
-        #     ```
-        #     | Query            | Description                                         |
-        #     |------------------|-----------------------------------------------------|
-        #     | name:how*        | The project's name starts with "how".               |
-        #     | name:Howl        | The project's name is `Howl` or `howl`.             |
-        #     | name:HOWL        | Equivalent to above.                                |
-        #     | NAME:howl        | Equivalent to above.                                |
-        #     | labels.color:*   | The project has the label `color`.                  |
-        #     | labels.color:red | The project's label `color` has the value `red`.    |
-        #     | labels.color:red&nbsp;labels.size:big | The project's label `color` has
-        #     the value `red` and its label `size` has the value `big`.                |
-        #     ```
+        #
+        #     - **`name:how*`**: The project's name starts with "how".
+        #     - **`name:Howl`**: The project's name is `Howl` or `howl`.
+        #     - **`name:HOWL`**: Equivalent to above.
+        #     - **`NAME:howl`**: Equivalent to above.
+        #     - **`labels.color:*`**: The project has the label `color`.
+        #     - **`labels.color:red`**:  The project's label `color` has the value `red`.
+        #     - **`labels.color:red labels.size:big`**: The project's label `color` has
+        #     the value `red` or its label `size` has the value `big`.
         #
         #     If no query is specified, the call will return projects for which the user
         #     has the `resourcemanager.projects.get` permission.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A pagination token returned from a previous call to [ListProjects]
-        #     [google.cloud.resourcemanager.v3.Projects.ListProjects]
-        #     that indicates from where listing should continue.
+        #     Optional. A pagination token returned from a previous call to
+        #     [ListProjects] [google.cloud.resourcemanager.v3.Projects.ListProjects] that
+        #     indicates from where listing should continue.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. The maximum number of projects to return in the response.
@@ -285,7 +281,7 @@ module Google
         #
         #     If the `parent` field is set, the `resourcemanager.projects.create`
         #     permission is checked on the parent resource. If no parent is set and
-        #     the authorization credentials belong to an Organziation, the parent
+        #     the authorization credentials belong to an Organization, the parent
         #     will be set to that Organization.
         class CreateProjectRequest
           include ::Google::Protobuf::MessageExts