google-cloud-os_config-v1 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6b03ff236fbfb5835f57916a990a462bd860d433eafffcc8be9081a369b5947
-  data.tar.gz: 0151f856f131254682fac334325dc74eb64b1a4c0d9b1faff29b9895ea3153a3
+  metadata.gz: c3d96054fa59f63991987e87c9239c085d97a82f99a250b13d0b54519dec70df
+  data.tar.gz: 7fa7a1fa218f9d119ff651d11a0a02f79b270b7b608a668301185d49e7019c49
 SHA512:
-  metadata.gz: ef9e9f405b617ee99337f00dc2fd82d79cae7b8f64e64b60e4cc1080f89109e5702a61d6bc8096ea2e5b3ebe9ca04c731ec62bea146c7ea39186b03895068111
-  data.tar.gz: e5d4d3904564615614f5cb41c2d39c8f2e0d9a3846dd5953ae37ac432b32499bba4309cf5d9571d548c6c1351d32fcd8cc9bf6720ae6cbc3255566e56ecfc04c
+  metadata.gz: e4a07f3235e6c9af575d3b0fa106f1cb6f2d33e2c8893be52bfab240d94a8b0407c46e5a5155e733373fc13a8809e89c892e651b1d1826a4873cf3eb799b1923
+  data.tar.gz: 48b017fdfdf2ef8bdec089d32e53046d721ea16e5d36a44cf6d861321949e16742086a67a0705c66c695e8dcdfcc577b6ab74b1c7ffbbf78ff1e25211cc198b0

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title=Cloud OS Config V1 API
+--title="Cloud OS Config V1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/AUTHENTICATION.md

@@ -120,15 +120,6 @@ To configure your system for this, simply:
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
 *should* only be used during development.
 
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
 ## Creating a Service Account
 
 Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
 [Google Cloud Platform environments](#google-cloud-platform-environments), you
 need a Google Developers service account.
 
-1. Visit the [Google Developers Console][dev-console].
+1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
 2. Create a new project or click on an existing project.
-3. Activate the slide-out navigation tray and select **API Manager**. From
+3. Activate the menu in the upper left and select **APIs & Services**. From
    here, you will enable the APIs that your application requires.
 
-   ![Enable the APIs that your application requires][enable-apis]
-
    *Note: You may need to enable billing in order to use these services.*
 
 4. Select **Credentials** from the side navigation.
 
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
+   Find the "Create credentials" drop down near the top of the page, and select
+   "Service account" to be guided through downloading a new JSON key file.
 
    If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
+   new key file. Just select the account you wish to re-use, click the pencil
+   tool on the right side to edit the service account, select the **Keys** tab,
+   and then select **Add Key**.
 
    The key file you download will be used by this library to authenticate API
    requests and should be stored in a secure location.

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::OsConfig::V1::ExecutePatchJobRequest.new # (request f
 response = client.execute_patch_job request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-os_config-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-os_config-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/compute/docs/manage-os)

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

@@ -998,6 +998,268 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Update an OS Config patch deployment.
+            #
+            # @overload update_patch_deployment(request, options = nil)
+            #   Pass arguments to `update_patch_deployment` via a request object, either of type
+            #   {::Google::Cloud::OsConfig::V1::UpdatePatchDeploymentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::OsConfig::V1::UpdatePatchDeploymentRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload update_patch_deployment(patch_deployment: nil, update_mask: nil)
+            #   Pass arguments to `update_patch_deployment` 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).
+            #
+            #   @param patch_deployment [::Google::Cloud::OsConfig::V1::PatchDeployment, ::Hash]
+            #     Required. The patch deployment to Update.
+            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     Optional. Field mask that controls which fields of the patch deployment
+            #     should be updated.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::OsConfig::V1::PatchDeployment]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/os_config/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::OsConfig::V1::OsConfigService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::OsConfig::V1::UpdatePatchDeploymentRequest.new
+            #
+            #   # Call the update_patch_deployment method.
+            #   result = client.update_patch_deployment request
+            #
+            #   # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
+            #   p result
+            #
+            def update_patch_deployment request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OsConfig::V1::UpdatePatchDeploymentRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.update_patch_deployment.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::OsConfig::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.patch_deployment&.name
+                header_params["patch_deployment.name"] = request.patch_deployment.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.update_patch_deployment.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.update_patch_deployment.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @os_config_service_stub.call_rpc :update_patch_deployment, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Change state of patch deployment to "PAUSED".
+            # Patch deployment in paused state doesn't generate patch jobs.
+            #
+            # @overload pause_patch_deployment(request, options = nil)
+            #   Pass arguments to `pause_patch_deployment` via a request object, either of type
+            #   {::Google::Cloud::OsConfig::V1::PausePatchDeploymentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::OsConfig::V1::PausePatchDeploymentRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload pause_patch_deployment(name: nil)
+            #   Pass arguments to `pause_patch_deployment` 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).
+            #
+            #   @param name [::String]
+            #     Required. The resource name of the patch deployment in the form
+            #     `projects/*/patchDeployments/*`.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::OsConfig::V1::PatchDeployment]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/os_config/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::OsConfig::V1::OsConfigService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::OsConfig::V1::PausePatchDeploymentRequest.new
+            #
+            #   # Call the pause_patch_deployment method.
+            #   result = client.pause_patch_deployment request
+            #
+            #   # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
+            #   p result
+            #
+            def pause_patch_deployment request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OsConfig::V1::PausePatchDeploymentRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.pause_patch_deployment.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::OsConfig::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.pause_patch_deployment.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.pause_patch_deployment.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @os_config_service_stub.call_rpc :pause_patch_deployment, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Change state of patch deployment back to "ACTIVE".
+            # Patch deployment in active state continues to generate patch jobs.
+            #
+            # @overload resume_patch_deployment(request, options = nil)
+            #   Pass arguments to `resume_patch_deployment` via a request object, either of type
+            #   {::Google::Cloud::OsConfig::V1::ResumePatchDeploymentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::OsConfig::V1::ResumePatchDeploymentRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload resume_patch_deployment(name: nil)
+            #   Pass arguments to `resume_patch_deployment` 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).
+            #
+            #   @param name [::String]
+            #     Required. The resource name of the patch deployment in the form
+            #     `projects/*/patchDeployments/*`.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::OsConfig::V1::PatchDeployment]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/os_config/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::OsConfig::V1::OsConfigService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::OsConfig::V1::ResumePatchDeploymentRequest.new
+            #
+            #   # Call the resume_patch_deployment method.
+            #   result = client.resume_patch_deployment request
+            #
+            #   # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
+            #   p result
+            #
+            def resume_patch_deployment request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OsConfig::V1::ResumePatchDeploymentRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.resume_patch_deployment.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::OsConfig::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.resume_patch_deployment.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.resume_patch_deployment.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @os_config_service_stub.call_rpc :resume_patch_deployment, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the OsConfigService API.
             #
@@ -1178,6 +1440,21 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :delete_patch_deployment
+                ##
+                # RPC-specific configuration for `update_patch_deployment`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :update_patch_deployment
+                ##
+                # RPC-specific configuration for `pause_patch_deployment`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :pause_patch_deployment
+                ##
+                # RPC-specific configuration for `resume_patch_deployment`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :resume_patch_deployment
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -1199,6 +1476,12 @@ module Google
                   @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 = ::Gapic::Config::Method.new delete_patch_deployment_config
+                  update_patch_deployment_config = parent_rpcs.update_patch_deployment if parent_rpcs.respond_to? :update_patch_deployment
+                  @update_patch_deployment = ::Gapic::Config::Method.new update_patch_deployment_config
+                  pause_patch_deployment_config = parent_rpcs.pause_patch_deployment if parent_rpcs.respond_to? :pause_patch_deployment
+                  @pause_patch_deployment = ::Gapic::Config::Method.new pause_patch_deployment_config
+                  resume_patch_deployment_config = parent_rpcs.resume_patch_deployment if parent_rpcs.respond_to? :resume_patch_deployment
+                  @resume_patch_deployment = ::Gapic::Config::Method.new resume_patch_deployment_config
 
                   yield self if block_given?
                 end

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

@@ -143,6 +143,7 @@ module Google
 
               @operations_client = Operations.new do |config|
                 config.credentials = credentials
+                config.quota_project = @quota_project_id
                 config.endpoint = @config.endpoint
               end
 

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module OsConfig
       module V1
-        VERSION = "0.8.0"
+        VERSION = "0.10.0"
       end
     end
   end

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

@@ -26,6 +26,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/os_config/v1"
       #     client = ::Google::Cloud::OsConfig::V1::OsConfigService::Client.new
       #

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

@@ -1,12 +1,12 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/osconfig/v1/osconfig_service.proto
 
-require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/osconfig/v1/patch_deployments_pb'
 require 'google/cloud/osconfig/v1/patch_jobs_pb'
 require 'google/protobuf/empty_pb'
+require 'google/api/annotations_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

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

@@ -56,6 +56,14 @@ module Google
             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
+            # Update an OS Config patch deployment.
+            rpc :UpdatePatchDeployment, ::Google::Cloud::OsConfig::V1::UpdatePatchDeploymentRequest, ::Google::Cloud::OsConfig::V1::PatchDeployment
+            # Change state of patch deployment to "PAUSED".
+            # Patch deployment in paused state doesn't generate patch jobs.
+            rpc :PausePatchDeployment, ::Google::Cloud::OsConfig::V1::PausePatchDeploymentRequest, ::Google::Cloud::OsConfig::V1::PatchDeployment
+            # Change state of patch deployment back to "ACTIVE".
+            # Patch deployment in active state continues to generate patch jobs.
+            rpc :ResumePatchDeployment, ::Google::Cloud::OsConfig::V1::ResumePatchDeploymentRequest, ::Google::Cloud::OsConfig::V1::PatchDeployment
           end
 
           Stub = Service.rpc_stub_class

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

@@ -5,6 +5,7 @@ require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/osconfig/v1/patch_jobs_pb'
 require 'google/protobuf/duration_pb'
+require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/type/datetime_pb'
 require 'google/type/dayofweek_pb'
@@ -23,11 +24,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       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"
+      optional :state, :enum, 12, "google.cloud.osconfig.v1.PatchDeployment.State"
       oneof :schedule do
         optional :one_time_schedule, :message, 6, "google.cloud.osconfig.v1.OneTimeSchedule"
         optional :recurring_schedule, :message, 7, "google.cloud.osconfig.v1.RecurringSchedule"
       end
     end
+    add_enum "google.cloud.osconfig.v1.PatchDeployment.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :ACTIVE, 1
+      value :PAUSED, 2
+    end
     add_message "google.cloud.osconfig.v1.OneTimeSchedule" do
       optional :execute_time, :message, 1, "google.protobuf.Timestamp"
     end
@@ -62,6 +69,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.osconfig.v1.WeekDayOfMonth" do
       optional :week_ordinal, :int32, 1
       optional :day_of_week, :enum, 2, "google.type.DayOfWeek"
+      optional :day_offset, :int32, 3
     end
     add_message "google.cloud.osconfig.v1.CreatePatchDeploymentRequest" do
       optional :parent, :string, 1
@@ -83,6 +91,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.osconfig.v1.DeletePatchDeploymentRequest" do
       optional :name, :string, 1
     end
+    add_message "google.cloud.osconfig.v1.UpdatePatchDeploymentRequest" do
+      optional :patch_deployment, :message, 1, "google.cloud.osconfig.v1.PatchDeployment"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+    end
+    add_message "google.cloud.osconfig.v1.PausePatchDeploymentRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.osconfig.v1.ResumePatchDeploymentRequest" do
+      optional :name, :string, 1
+    end
   end
 end
 
@@ -91,6 +109,7 @@ module Google
     module OsConfig
       module V1
         PatchDeployment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.PatchDeployment").msgclass
+        PatchDeployment::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.PatchDeployment.State").enummodule
         OneTimeSchedule = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.OneTimeSchedule").msgclass
         RecurringSchedule = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.RecurringSchedule").msgclass
         RecurringSchedule::Frequency = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.RecurringSchedule.Frequency").enummodule
@@ -102,6 +121,9 @@ module Google
         ListPatchDeploymentsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.ListPatchDeploymentsRequest").msgclass
         ListPatchDeploymentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.ListPatchDeploymentsResponse").msgclass
         DeletePatchDeploymentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.DeletePatchDeploymentRequest").msgclass
+        UpdatePatchDeploymentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.UpdatePatchDeploymentRequest").msgclass
+        PausePatchDeploymentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.PausePatchDeploymentRequest").msgclass
+        ResumePatchDeploymentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.ResumePatchDeploymentRequest").msgclass
       end
     end
   end

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

@@ -103,6 +103,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :windows_update, :message, 7, "google.cloud.osconfig.v1.WindowsUpdateSettings"
       optional :pre_step, :message, 8, "google.cloud.osconfig.v1.ExecStep"
       optional :post_step, :message, 9, "google.cloud.osconfig.v1.ExecStep"
+      optional :mig_instances_allowed, :bool, 10
     end
     add_enum "google.cloud.osconfig.v1.PatchConfig.RebootConfig" do
       value :REBOOT_CONFIG_UNSPECIFIED, 0

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

@@ -19,6 +19,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :available_inventory_item_ids, :string, 3
       optional :create_time, :message, 4, "google.protobuf.Timestamp"
       optional :update_time, :message, 5, "google.protobuf.Timestamp"
+      repeated :items, :message, 6, "google.cloud.osconfig.v1.VulnerabilityReport.Vulnerability.Item"
     end
     add_message "google.cloud.osconfig.v1.VulnerabilityReport.Vulnerability.Details" do
       optional :cve, :string, 1
@@ -32,6 +33,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :url, :string, 1
       optional :source, :string, 2
     end
+    add_message "google.cloud.osconfig.v1.VulnerabilityReport.Vulnerability.Item" do
+      optional :installed_inventory_item_id, :string, 1
+      optional :available_inventory_item_id, :string, 2
+      optional :fixed_cpe_uri, :string, 3
+      optional :upstream_fix, :string, 4
+    end
     add_message "google.cloud.osconfig.v1.GetVulnerabilityReportRequest" do
       optional :name, :string, 1
     end
@@ -103,6 +110,7 @@ module Google
         VulnerabilityReport::Vulnerability = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.VulnerabilityReport.Vulnerability").msgclass
         VulnerabilityReport::Vulnerability::Details = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.VulnerabilityReport.Vulnerability.Details").msgclass
         VulnerabilityReport::Vulnerability::Details::Reference = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.VulnerabilityReport.Vulnerability.Details.Reference").msgclass
+        VulnerabilityReport::Vulnerability::Item = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.VulnerabilityReport.Vulnerability.Item").msgclass
         GetVulnerabilityReportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.GetVulnerabilityReportRequest").msgclass
         ListVulnerabilityReportsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.ListVulnerabilityReportsRequest").msgclass
         ListVulnerabilityReportsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.osconfig.v1.ListVulnerabilityReportsResponse").msgclass

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of

data/proto_docs/google/cloud/osconfig/v1/inventory.rb

@@ -287,12 +287,9 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Contains information about a Windows application as retrieved from the
-          # Windows Registry. For more information about these fields, see
-          #
-          # [Windows Installer Properties for the Uninstall
-          # Registry](https://docs.microsoft.com/en-us/windows/win32/msi/uninstall-registry-key){:
-          # class="external" }
+          # Contains information about a Windows application that is retrieved from the
+          # Windows Registry. For more information about these fields, see:
+          # https://docs.microsoft.com/en-us/windows/win32/msi/uninstall-registry-key
           # @!attribute [rw] display_name
           #   @return [::String]
           #     The name of the application or product.

data/proto_docs/google/cloud/osconfig/v1/os_policy.rb

@@ -473,7 +473,7 @@ module Google
 
                 # The interpreter to use.
                 module Interpreter
-                  # Defaults to NONE.
+                  # Invalid value, the request will return validation error.
                   INTERPRETER_UNSPECIFIED = 0
 
                   # If an interpreter is not specified, the

data/proto_docs/google/cloud/osconfig/v1/patch_deployments.rb

@@ -68,9 +68,25 @@ module Google
         # @!attribute [rw] rollout
         #   @return [::Google::Cloud::OsConfig::V1::PatchRollout]
         #     Optional. Rollout strategy of the patch job.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::OsConfig::V1::PatchDeployment::State]
+        #     Output only. Current state of the patch deployment.
         class PatchDeployment
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Represents state of patch peployment.
+          module State
+            # The default value. This value is used if the state is omitted.
+            STATE_UNSPECIFIED = 0
+
+            # Active value means that patch deployment generates Patch Jobs.
+            ACTIVE = 1
+
+            # Paused value means that patch deployment does not generate
+            # Patch jobs. Requires user action to move in and out from this state.
+            PAUSED = 2
+          end
         end
 
         # Sets the time for a one time patch deployment. Timestamp is in
@@ -123,16 +139,16 @@ module Google
             # Invalid. A frequency must be specified.
             FREQUENCY_UNSPECIFIED = 0
 
-            # Indicates that the frequency should be expressed in terms of
-            # weeks.
+            # Indicates that the frequency of recurrence should be expressed in terms
+            # of weeks.
             WEEKLY = 1
 
-            # Indicates that the frequency should be expressed in terms of
-            # months.
+            # Indicates that the frequency of recurrence should be expressed in terms
+            # of months.
             MONTHLY = 2
 
-            # Indicates that the frequency should be expressed in terms of
-            # days.
+            # Indicates that the frequency of recurrence should be expressed in terms
+            # of days.
             DAILY = 3
           end
         end
@@ -170,6 +186,15 @@ module Google
         # @!attribute [rw] day_of_week
         #   @return [::Google::Type::DayOfWeek]
         #     Required. A day of the week.
+        # @!attribute [rw] day_offset
+        #   @return [::Integer]
+        #     Optional. Represents the number of days before or after the given week day
+        #     of month that the patch deployment is scheduled for. For example if
+        #     `week_ordinal` and `day_of_week` values point to the second day of the
+        #     month and this `day_offset` value is set to `3`, the patch deployment takes
+        #     place three days after the second Tuesday of the month. If this value is
+        #     negative, for example -5, the patches are deployed five days before before
+        #     the second Tuesday of the month. Allowed values are in range [-30, 30].
         class WeekDayOfMonth
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -247,6 +272,39 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # A request message for updating a patch deployment.
+        # @!attribute [rw] patch_deployment
+        #   @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
+        #     Required. The patch deployment to Update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Field mask that controls which fields of the patch deployment
+        #     should be updated.
+        class UpdatePatchDeploymentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A request message for pausing a patch deployment.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the patch deployment in the form
+        #     `projects/*/patchDeployments/*`.
+        class PausePatchDeploymentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A request message for resuming a patch deployment.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the patch deployment in the form
+        #     `projects/*/patchDeployments/*`.
+        class ResumePatchDeploymentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/osconfig/v1/patch_jobs.rb

@@ -337,6 +337,9 @@ module Google
         # @!attribute [rw] post_step
         #   @return [::Google::Cloud::OsConfig::V1::ExecStep]
         #     The `ExecStep` to run after the patch update.
+        # @!attribute [rw] mig_instances_allowed
+        #   @return [::Boolean]
+        #     Allows the patch job to run on Managed instance groups (MIGs).
         class PatchConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/osconfig/v1/vulnerability.rb

@@ -69,6 +69,9 @@ module Google
           # @!attribute [rw] update_time
           #   @return [::Google::Protobuf::Timestamp]
           #     The timestamp for when the vulnerability was last modified.
+          # @!attribute [rw] items
+          #   @return [::Array<::Google::Cloud::OsConfig::V1::VulnerabilityReport::Vulnerability::Item>]
+          #     List of items affected by the vulnerability.
           class Vulnerability
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -112,6 +115,35 @@ module Google
                 extend ::Google::Protobuf::MessageExts::ClassMethods
               end
             end
+
+            # OS inventory item that is affected by a vulnerability or fixed as a
+            # result of a vulnerability.
+            # @!attribute [rw] installed_inventory_item_id
+            #   @return [::String]
+            #     Corresponds to the `INSTALLED_PACKAGE` inventory item on the VM.
+            #     This field displays the inventory items affected by this vulnerability.
+            #     If the vulnerability report was not updated after the VM inventory
+            #     update, these values might not display in VM inventory. For some
+            #     operating systems, this field might be empty.
+            # @!attribute [rw] available_inventory_item_id
+            #   @return [::String]
+            #     Corresponds to the `AVAILABLE_PACKAGE` inventory item on the VM.
+            #     If the vulnerability report was not updated after the VM inventory
+            #     update, these values might not display in VM inventory. If there is no
+            #     available fix, the field is empty. The `inventory_item` value specifies
+            #     the latest `SoftwarePackage` available to the VM that fixes the
+            #     vulnerability.
+            # @!attribute [rw] fixed_cpe_uri
+            #   @return [::String]
+            #     The recommended [CPE URI](https://cpe.mitre.org/specification/) update
+            #     that contains a fix for this vulnerability.
+            # @!attribute [rw] upstream_fix
+            #   @return [::String]
+            #     The upstream OS patch, packages or KB that fixes the vulnerability.
+            class Item
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
         end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-os_config-v1
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2022-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -235,7 +235,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud OS Config V1 API