google-cloud-os_config-v1 0.1.3 → 0.4.0

data/lib/google/cloud/os_config/v1.rb

@@ -33,3 +33,6 @@ module Google
     end
   end
 end
+
+helper_path = ::File.join __dir__, "v1", "_helpers.rb"
+require "google/cloud/os_config/v1/_helpers" if ::File.file? helper_path

data/lib/google/cloud/os_config/v1/os_config_service/client.rb

@@ -63,7 +63,7 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -71,9 +71,9 @@ module Google
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
                   initial_delay: 1.0,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14]
                 }
 
                 default_config
@@ -137,7 +137,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope: @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -168,7 +174,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload execute_patch_job(parent: nil, description: nil, instance_filter: nil, patch_config: nil, duration: nil, dry_run: nil, display_name: nil)
+            # @overload execute_patch_job(parent: nil, description: nil, instance_filter: nil, patch_config: nil, duration: nil, dry_run: nil, display_name: nil, rollout: nil)
             #   Pass arguments to `execute_patch_job` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -179,8 +185,8 @@ module Google
             #     Description of the patch job. Length of the description is limited
             #     to 1024 characters.
             #   @param instance_filter [::Google::Cloud::OsConfig::V1::PatchInstanceFilter, ::Hash]
-            #     Required. Instances to patch, either explicitly or filtered by some criteria such
-            #     as zone or labels.
+            #     Required. Instances to patch, either explicitly or filtered by some
+            #     criteria such as zone or labels.
             #   @param patch_config [::Google::Cloud::OsConfig::V1::PatchConfig, ::Hash]
             #     Patch configuration being applied. If omitted, instances are
             #     patched using the default configurations.
@@ -192,6 +198,8 @@ module Google
             #     will do nothing.
             #   @param display_name [::String]
             #     Display name for this patch job. This does not have to be unique.
+            #   @param rollout [::Google::Cloud::OsConfig::V1::PatchRollout, ::Hash]
+            #     Rollout strategy of the patch job.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::OsConfig::V1::PatchJob]
@@ -467,7 +475,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent for the instances are in the form of `projects/*/patchJobs/*`.
+            #     Required. The parent for the instances are in the form of
+            #     `projects/*/patchJobs/*`.
             #   @param page_size [::Integer]
             #     The maximum number of instance details records to return.  Default is 100.
             #   @param page_token [::String]
@@ -543,10 +552,11 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project to apply this patch deployment to in the form `projects/*`.
+            #     Required. The project to apply this patch deployment to in the form
+            #     `projects/*`.
             #   @param patch_deployment_id [::String]
-            #     Required. A name for the patch deployment in the project. When creating a name
-            #     the following rules apply:
+            #     Required. A name for the patch deployment in the project. When creating a
+            #     name the following rules apply:
             #     * Must contain only lowercase letters, numbers, and hyphens.
             #     * Must start with a letter.
             #     * Must be between 1-63 characters.
@@ -688,10 +698,12 @@ module Google
             #   @param parent [::String]
             #     Required. The resource name of the parent in the form `projects/*`.
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of patch deployments to return. Default is 100.
+            #     Optional. The maximum number of patch deployments to return. Default is
+            #     100.
             #   @param page_token [::String]
-            #     Optional. A pagination token returned from a previous call to ListPatchDeployments
-            #     that indicates where this listing should continue from.
+            #     Optional. A pagination token returned from a previous call to
+            #     ListPatchDeployments that indicates where this listing should continue
+            #     from.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OsConfig::V1::PatchDeployment>]
@@ -891,14 +903,14 @@ module Google
 
               config_attr :endpoint,      "osconfig.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -919,7 +931,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -931,7 +943,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -990,23 +1002,23 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  execute_patch_job_config = parent_rpcs&.execute_patch_job if parent_rpcs&.respond_to? :execute_patch_job
+                  execute_patch_job_config = parent_rpcs.execute_patch_job if parent_rpcs.respond_to? :execute_patch_job
                   @execute_patch_job = ::Gapic::Config::Method.new execute_patch_job_config
-                  get_patch_job_config = parent_rpcs&.get_patch_job if parent_rpcs&.respond_to? :get_patch_job
+                  get_patch_job_config = parent_rpcs.get_patch_job if parent_rpcs.respond_to? :get_patch_job
                   @get_patch_job = ::Gapic::Config::Method.new get_patch_job_config
-                  cancel_patch_job_config = parent_rpcs&.cancel_patch_job if parent_rpcs&.respond_to? :cancel_patch_job
+                  cancel_patch_job_config = parent_rpcs.cancel_patch_job if parent_rpcs.respond_to? :cancel_patch_job
                   @cancel_patch_job = ::Gapic::Config::Method.new cancel_patch_job_config
-                  list_patch_jobs_config = parent_rpcs&.list_patch_jobs if parent_rpcs&.respond_to? :list_patch_jobs
+                  list_patch_jobs_config = parent_rpcs.list_patch_jobs if parent_rpcs.respond_to? :list_patch_jobs
                   @list_patch_jobs = ::Gapic::Config::Method.new list_patch_jobs_config
-                  list_patch_job_instance_details_config = parent_rpcs&.list_patch_job_instance_details if parent_rpcs&.respond_to? :list_patch_job_instance_details
+                  list_patch_job_instance_details_config = parent_rpcs.list_patch_job_instance_details if parent_rpcs.respond_to? :list_patch_job_instance_details
                   @list_patch_job_instance_details = ::Gapic::Config::Method.new list_patch_job_instance_details_config
-                  create_patch_deployment_config = parent_rpcs&.create_patch_deployment if parent_rpcs&.respond_to? :create_patch_deployment
+                  create_patch_deployment_config = parent_rpcs.create_patch_deployment if parent_rpcs.respond_to? :create_patch_deployment
                   @create_patch_deployment = ::Gapic::Config::Method.new create_patch_deployment_config
-                  get_patch_deployment_config = parent_rpcs&.get_patch_deployment if parent_rpcs&.respond_to? :get_patch_deployment
+                  get_patch_deployment_config = parent_rpcs.get_patch_deployment if parent_rpcs.respond_to? :get_patch_deployment
                   @get_patch_deployment = ::Gapic::Config::Method.new get_patch_deployment_config
-                  list_patch_deployments_config = parent_rpcs&.list_patch_deployments if parent_rpcs&.respond_to? :list_patch_deployments
+                  list_patch_deployments_config = parent_rpcs.list_patch_deployments if parent_rpcs.respond_to? :list_patch_deployments
                   @list_patch_deployments = ::Gapic::Config::Method.new list_patch_deployments_config
-                  delete_patch_deployment_config = parent_rpcs&.delete_patch_deployment if parent_rpcs&.respond_to? :delete_patch_deployment
+                  delete_patch_deployment_config = parent_rpcs.delete_patch_deployment if parent_rpcs.respond_to? :delete_patch_deployment
                   @delete_patch_deployment = ::Gapic::Config::Method.new delete_patch_deployment_config
 
                   yield self if block_given?

data/lib/google/cloud/os_config/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module OsConfig
       module V1
-        VERSION = "0.1.3"
+        VERSION = "0.4.0"
       end
     end
   end

data/lib/google/cloud/osconfig/v1/inventory_pb.rb

@@ -0,0 +1,108 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/osconfig/v1/inventory.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/timestamp_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/osconfig/v1/inventory.proto", :syntax => :proto3) do
+    add_message "google.cloud.osconfig.v1.Inventory" do
+      optional :os_info, :message, 1, "google.cloud.osconfig.v1.Inventory.OsInfo"
+      map :items, :string, :message, 2, "google.cloud.osconfig.v1.Inventory.Item"
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.OsInfo" do
+      optional :hostname, :string, 9
+      optional :long_name, :string, 2
+      optional :short_name, :string, 3
+      optional :version, :string, 4
+      optional :architecture, :string, 5
+      optional :kernel_version, :string, 6
+      optional :kernel_release, :string, 7
+      optional :osconfig_agent_version, :string, 8
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.Item" do
+      optional :id, :string, 1
+      optional :origin_type, :enum, 2, "google.cloud.osconfig.v1.Inventory.Item.OriginType"
+      optional :create_time, :message, 8, "google.protobuf.Timestamp"
+      optional :update_time, :message, 9, "google.protobuf.Timestamp"
+      optional :type, :enum, 5, "google.cloud.osconfig.v1.Inventory.Item.Type"
+      oneof :details do
+        optional :installed_package, :message, 6, "google.cloud.osconfig.v1.Inventory.SoftwarePackage"
+        optional :available_package, :message, 7, "google.cloud.osconfig.v1.Inventory.SoftwarePackage"
+      end
+    end
+    add_enum "google.cloud.osconfig.v1.Inventory.Item.OriginType" do
+      value :ORIGIN_TYPE_UNSPECIFIED, 0
+      value :INVENTORY_REPORT, 1
+    end
+    add_enum "google.cloud.osconfig.v1.Inventory.Item.Type" do
+      value :TYPE_UNSPECIFIED, 0
+      value :INSTALLED_PACKAGE, 1
+      value :AVAILABLE_PACKAGE, 2
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.SoftwarePackage" do
+      oneof :details do
+        optional :yum_package, :message, 1, "google.cloud.osconfig.v1.Inventory.VersionedPackage"
+        optional :apt_package, :message, 2, "google.cloud.osconfig.v1.Inventory.VersionedPackage"
+        optional :zypper_package, :message, 3, "google.cloud.osconfig.v1.Inventory.VersionedPackage"
+        optional :googet_package, :message, 4, "google.cloud.osconfig.v1.Inventory.VersionedPackage"
+        optional :zypper_patch, :message, 5, "google.cloud.osconfig.v1.Inventory.ZypperPatch"
+        optional :wua_package, :message, 6, "google.cloud.osconfig.v1.Inventory.WindowsUpdatePackage"
+        optional :qfe_package, :message, 7, "google.cloud.osconfig.v1.Inventory.WindowsQuickFixEngineeringPackage"
+        optional :cos_package, :message, 8, "google.cloud.osconfig.v1.Inventory.VersionedPackage"
+      end
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.VersionedPackage" do
+      optional :package_name, :string, 4
+      optional :architecture, :string, 2
+      optional :version, :string, 3
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.WindowsUpdatePackage" do
+      optional :title, :string, 1
+      optional :description, :string, 2
+      repeated :categories, :message, 3, "google.cloud.osconfig.v1.Inventory.WindowsUpdatePackage.WindowsUpdateCategory"
+      repeated :kb_article_ids, :string, 4
+      optional :support_url, :string, 11
+      repeated :more_info_urls, :string, 5
+      optional :update_id, :string, 6
+      optional :revision_number, :int32, 7
+      optional :last_deployment_change_time, :message, 10, "google.protobuf.Timestamp"
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.WindowsUpdatePackage.WindowsUpdateCategory" do
+      optional :id, :string, 1
+      optional :name, :string, 2
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.ZypperPatch" do
+      optional :patch_name, :string, 5
+      optional :category, :string, 2
+      optional :severity, :string, 3
+      optional :summary, :string, 4
+    end
+    add_message "google.cloud.osconfig.v1.Inventory.WindowsQuickFixEngineeringPackage" do
+      optional :caption, :string, 1
+      optional :description, :string, 2
+      optional :hot_fix_id, :string, 3
+      optional :install_time, :message, 5, "google.protobuf.Timestamp"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module OsConfig
+      module V1
+        Inventory = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory").msgclass
+        Inventory::OsInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.OsInfo").msgclass
+        Inventory::Item = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.Item").msgclass
+        Inventory::Item::OriginType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.Item.OriginType").enummodule
+        Inventory::Item::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.Item.Type").enummodule
+        Inventory::SoftwarePackage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.SoftwarePackage").msgclass
+        Inventory::VersionedPackage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.VersionedPackage").msgclass
+        Inventory::WindowsUpdatePackage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.WindowsUpdatePackage").msgclass
+        Inventory::WindowsUpdatePackage::WindowsUpdateCategory = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.WindowsUpdatePackage.WindowsUpdateCategory").msgclass
+        Inventory::ZypperPatch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.ZypperPatch").msgclass
+        Inventory::WindowsQuickFixEngineeringPackage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.Inventory.WindowsQuickFixEngineeringPackage").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/osconfig/v1/osconfig_common_pb.rb

@@ -0,0 +1,25 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/osconfig/v1/osconfig_common.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/osconfig/v1/osconfig_common.proto", :syntax => :proto3) do
+    add_message "google.cloud.osconfig.v1.FixedOrPercent" do
+      oneof :mode do
+        optional :fixed, :int32, 1
+        optional :percent, :int32, 2
+      end
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module OsConfig
+      module V1
+        FixedOrPercent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.FixedOrPercent").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/osconfig/v1/osconfig_service_services_pb.rb

@@ -37,25 +37,25 @@ module Google
             self.service_name = 'google.cloud.osconfig.v1.OsConfigService'
 
             # Patch VM instances by creating and running a patch job.
-            rpc :ExecutePatchJob, Google::Cloud::OsConfig::V1::ExecutePatchJobRequest, Google::Cloud::OsConfig::V1::PatchJob
+            rpc :ExecutePatchJob, ::Google::Cloud::OsConfig::V1::ExecutePatchJobRequest, ::Google::Cloud::OsConfig::V1::PatchJob
             # Get the patch job. This can be used to track the progress of an
             # ongoing patch job or review the details of completed jobs.
-            rpc :GetPatchJob, Google::Cloud::OsConfig::V1::GetPatchJobRequest, Google::Cloud::OsConfig::V1::PatchJob
+            rpc :GetPatchJob, ::Google::Cloud::OsConfig::V1::GetPatchJobRequest, ::Google::Cloud::OsConfig::V1::PatchJob
             # Cancel a patch job. The patch job must be active. Canceled patch jobs
             # cannot be restarted.
-            rpc :CancelPatchJob, Google::Cloud::OsConfig::V1::CancelPatchJobRequest, Google::Cloud::OsConfig::V1::PatchJob
+            rpc :CancelPatchJob, ::Google::Cloud::OsConfig::V1::CancelPatchJobRequest, ::Google::Cloud::OsConfig::V1::PatchJob
             # Get a list of patch jobs.
-            rpc :ListPatchJobs, Google::Cloud::OsConfig::V1::ListPatchJobsRequest, Google::Cloud::OsConfig::V1::ListPatchJobsResponse
+            rpc :ListPatchJobs, ::Google::Cloud::OsConfig::V1::ListPatchJobsRequest, ::Google::Cloud::OsConfig::V1::ListPatchJobsResponse
             # Get a list of instance details for a given patch job.
-            rpc :ListPatchJobInstanceDetails, Google::Cloud::OsConfig::V1::ListPatchJobInstanceDetailsRequest, Google::Cloud::OsConfig::V1::ListPatchJobInstanceDetailsResponse
+            rpc :ListPatchJobInstanceDetails, ::Google::Cloud::OsConfig::V1::ListPatchJobInstanceDetailsRequest, ::Google::Cloud::OsConfig::V1::ListPatchJobInstanceDetailsResponse
             # Create an OS Config patch deployment.
-            rpc :CreatePatchDeployment, Google::Cloud::OsConfig::V1::CreatePatchDeploymentRequest, Google::Cloud::OsConfig::V1::PatchDeployment
+            rpc :CreatePatchDeployment, ::Google::Cloud::OsConfig::V1::CreatePatchDeploymentRequest, ::Google::Cloud::OsConfig::V1::PatchDeployment
             # Get an OS Config patch deployment.
-            rpc :GetPatchDeployment, Google::Cloud::OsConfig::V1::GetPatchDeploymentRequest, Google::Cloud::OsConfig::V1::PatchDeployment
+            rpc :GetPatchDeployment, ::Google::Cloud::OsConfig::V1::GetPatchDeploymentRequest, ::Google::Cloud::OsConfig::V1::PatchDeployment
             # Get a page of OS Config patch deployments.
-            rpc :ListPatchDeployments, Google::Cloud::OsConfig::V1::ListPatchDeploymentsRequest, Google::Cloud::OsConfig::V1::ListPatchDeploymentsResponse
+            rpc :ListPatchDeployments, ::Google::Cloud::OsConfig::V1::ListPatchDeploymentsRequest, ::Google::Cloud::OsConfig::V1::ListPatchDeploymentsResponse
             # Delete an OS Config patch deployment.
-            rpc :DeletePatchDeployment, Google::Cloud::OsConfig::V1::DeletePatchDeploymentRequest, Google::Protobuf::Empty
+            rpc :DeletePatchDeployment, ::Google::Cloud::OsConfig::V1::DeletePatchDeploymentRequest, ::Google::Protobuf::Empty
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/cloud/osconfig/v1/patch_deployments_pb.rb

@@ -22,6 +22,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :create_time, :message, 8, "google.protobuf.Timestamp"
       optional :update_time, :message, 9, "google.protobuf.Timestamp"
       optional :last_execute_time, :message, 10, "google.protobuf.Timestamp"
+      optional :rollout, :message, 11, "google.cloud.osconfig.v1.PatchRollout"
       oneof :schedule do
         optional :one_time_schedule, :message, 6, "google.cloud.osconfig.v1.OneTimeSchedule"
         optional :recurring_schedule, :message, 7, "google.cloud.osconfig.v1.RecurringSchedule"

data/lib/google/cloud/osconfig/v1/patch_jobs_pb.rb

@@ -5,6 +5,7 @@ require 'google/protobuf'
 
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/cloud/osconfig/v1/osconfig_common_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -17,6 +18,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :duration, :message, 5, "google.protobuf.Duration"
       optional :dry_run, :bool, 6
       optional :display_name, :string, 8
+      optional :rollout, :message, 9, "google.cloud.osconfig.v1.PatchRollout"
     end
     add_message "google.cloud.osconfig.v1.GetPatchJobRequest" do
       optional :name, :string, 1
@@ -63,6 +65,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :error_message, :string, 11
       optional :percent_complete, :double, 12
       optional :patch_deployment, :string, 15
+      optional :rollout, :message, 16, "google.cloud.osconfig.v1.PatchRollout"
     end
     add_message "google.cloud.osconfig.v1.PatchJob.InstanceDetailsSummary" do
       optional :pending_instance_count, :int64, 1
@@ -205,6 +208,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.osconfig.v1.PatchInstanceFilter.GroupLabel" do
       map :labels, :string, :string, 1
     end
+    add_message "google.cloud.osconfig.v1.PatchRollout" do
+      optional :mode, :enum, 1, "google.cloud.osconfig.v1.PatchRollout.Mode"
+      optional :disruption_budget, :message, 2, "google.cloud.osconfig.v1.FixedOrPercent"
+    end
+    add_enum "google.cloud.osconfig.v1.PatchRollout.Mode" do
+      value :MODE_UNSPECIFIED, 0
+      value :ZONE_BY_ZONE, 1
+      value :CONCURRENT_ZONES, 2
+    end
   end
 end
 
@@ -240,6 +252,8 @@ module Google
         GcsObject = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.GcsObject").msgclass
         PatchInstanceFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.PatchInstanceFilter").msgclass
         PatchInstanceFilter::GroupLabel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.PatchInstanceFilter.GroupLabel").msgclass
+        PatchRollout = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.PatchRollout").msgclass
+        PatchRollout::Mode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.PatchRollout.Mode").enummodule
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # This indicates that the field may be set once in a request to create a
       # resource, but may not be changed thereafter.
       IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
     end
   end
 end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # The ResourceDescriptor Yaml config will look like:
     #
-    #    resources:
-    #    - type: "pubsub.googleapis.com/Topic"
-    #      name_descriptor:
-    #        - pattern: "projects/\\{project}/topics/\\{topic}"
-    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #          parent_name_extractor: "projects/\\{project}"
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     The plural name used in the resource name, such as 'projects' for
-    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
-    #     field in k8s CRD spec
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods