google-cloud-data_fusion-v1 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 266e99fe7c123372e581ae2cc4ddaeaf959c97c24c99716dfb71605154a4e3cf
-  data.tar.gz: 137db50e77763b3a41a05dee06ba7e01ba26698f7fe919bacfd66a657f47584e
+  metadata.gz: 6b39e3729168eb47590a09681cb2cebcbb0a6cf1632ad65b2c0850348cbcd810
+  data.tar.gz: 5baad0357cd449c69145c9640b062f8f5b0aae994d40bbd17a314f9dd13eb49b
 SHA512:
-  metadata.gz: 664010810c927571665928fdf16900acbcaf2fdd54a575ac75f0d8ff248a8a3c7dc1fbb61dcc6ec65fd744083bc2ddfca770d7c7d186732c82b47579bd6a10ba
-  data.tar.gz: f1a7245f8f86900b2eb6d324e4b7748f7d67e10455e4c2cca0bfb8296d689ecbb387a0b36a880a1d5d23c8724c0f75bdfc36b5bec5afbce1db30f1717fc13a86
+  metadata.gz: f6dad801c74307ac4fb305191d75674ce067cc0b17655cc891921a1cc2d2d95940db2e0457cabba258e00460bf5047a8fa59527e7e777e3cc811ad6ed7b347ef
+  data.tar.gz: 353e4d7e4246d76a69bbc1d73e86cd694952613e9b428959d9a455c4efbbd08c94d0555122a100f940da5ec81aa5a2e2d7147150626e6ffc710cc85136c7e7b1

data/lib/google/cloud/data_fusion/v1/data_fusion/client.rb

@@ -181,8 +181,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project and location for which to retrieve instance
-            #     information in the format projects/\\{project}/locations/\\{location}.
+            #     Required. The project and location for which to retrieve instance information
+            #     in the format projects/\\{project}/locations/\\{location}.
             #   @param page_size [::Integer]
             #     The maximum number of items to return.
             #   @param page_token [::String]
@@ -283,7 +283,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     The project and location for which to retrieve instance information
+            #     Required. The project and location for which to retrieve instance information
             #     in the format projects/\\{project}/locations/\\{location}. If the location is
             #     specified as '-' (wildcard), then all regions available to the project
             #     are queried, and the results are aggregated.
@@ -387,7 +387,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     The instance resource name in the format
+            #     Required. The instance resource name in the format
             #     projects/\\{project}/locations/\\{location}/instances/\\{instance}.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -473,10 +473,10 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     The instance's project and location in the format
+            #     Required. The instance's project and location in the format
             #     projects/\\{project}/locations/\\{location}.
             #   @param instance_id [::String]
-            #     The name of the instance to create.
+            #     Required. The name of the instance to create.
             #   @param instance [::Google::Cloud::DataFusion::V1::Instance, ::Hash]
             #     An instance resource.
             #
@@ -571,7 +571,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     The instance resource name in the format
+            #     Required. The instance resource name in the format
             #     projects/\\{project}/locations/\\{location}/instances/\\{instance}
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -665,7 +665,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param instance [::Google::Cloud::DataFusion::V1::Instance, ::Hash]
-            #     The instance resource that replaces the resource on the server. Currently,
+            #     Required. The instance resource that replaces the resource on the server. Currently,
             #     Data Fusion only allows replacing labels, options, and stack driver
             #     settings. All other fields will be ignored.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
@@ -768,7 +768,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Name of the Data Fusion instance which need to be restarted in the form of
+            #     Required. Name of the Data Fusion instance which need to be restarted in the form of
             #     projects/\\{project}/locations/\\{location}/instances/\\{instance}
             #
             # @yield [response, operation] Access the result along with the RPC operation

data/lib/google/cloud/data_fusion/v1/data_fusion/paths.rb

@@ -24,6 +24,27 @@ module Google
         module DataFusion
           # Path helper methods for the DataFusion API.
           module Paths
+            ##
+            # Create a fully-qualified CryptoKey resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param key_ring [String]
+            # @param crypto_key [String]
+            #
+            # @return [::String]
+            def crypto_key_path project:, location:, key_ring:, crypto_key:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "key_ring cannot contain /" if key_ring.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/keyRings/#{key_ring}/cryptoKeys/#{crypto_key}"
+            end
+
             ##
             # Create a fully-qualified Instance resource string.
             #
@@ -43,6 +64,23 @@ module Google
               "projects/#{project}/locations/#{location}/instances/#{instance}"
             end
 
+            ##
+            # Create a fully-qualified Location resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}`
+            #
+            # @param project [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def location_path project:, location:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}"
+            end
+
             extend self
           end
         end

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module DataFusion
       module V1
-        VERSION = "0.1.3"
+        VERSION = "0.1.4"
       end
     end
   end

data/lib/google/cloud/datafusion/v1/datafusion_pb.rb

@@ -20,6 +20,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :version_number, :string, 1
       optional :default_version, :bool, 2
       repeated :available_features, :string, 3
+      optional :type, :enum, 4, "google.cloud.datafusion.v1.Version.Type"
+    end
+    add_enum "google.cloud.datafusion.v1.Version.Type" do
+      value :TYPE_UNSPECIFIED, 0
+      value :TYPE_PREVIEW, 1
+      value :TYPE_GENERAL_AVAILABILITY, 2
     end
     add_message "google.cloud.datafusion.v1.Accelerator" do
       optional :accelerator_type, :enum, 1, "google.cloud.datafusion.v1.Accelerator.AcceleratorType"
@@ -68,6 +74,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :dataproc_service_account, :string, 25
       optional :enable_rbac, :bool, 27
       optional :crypto_key_config, :message, 28, "google.cloud.datafusion.v1.CryptoKeyConfig"
+      repeated :disabled_reason, :enum, 29, "google.cloud.datafusion.v1.Instance.DisabledReason"
     end
     add_enum "google.cloud.datafusion.v1.Instance.Type" do
       value :TYPE_UNSPECIFIED, 0
@@ -86,6 +93,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :UPDATING, 7
       value :AUTO_UPDATING, 8
       value :AUTO_UPGRADING, 9
+      value :DISABLED, 10
+    end
+    add_enum "google.cloud.datafusion.v1.Instance.DisabledReason" do
+      value :DISABLED_REASON_UNSPECIFIED, 0
+      value :KMS_KEY_ISSUE, 1
     end
     add_message "google.cloud.datafusion.v1.ListInstancesRequest" do
       optional :parent, :string, 1
@@ -146,6 +158,7 @@ module Google
       module V1
         NetworkConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.NetworkConfig").msgclass
         Version = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Version").msgclass
+        Version::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Version.Type").enummodule
         Accelerator = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Accelerator").msgclass
         Accelerator::AcceleratorType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Accelerator.AcceleratorType").enummodule
         Accelerator::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Accelerator.State").enummodule
@@ -153,6 +166,7 @@ module Google
         Instance = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Instance").msgclass
         Instance::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Instance.Type").enummodule
         Instance::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Instance.State").enummodule
+        Instance::DisabledReason = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.Instance.DisabledReason").enummodule
         ListInstancesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.ListInstancesRequest").msgclass
         ListInstancesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.ListInstancesResponse").msgclass
         ListAvailableVersionsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datafusion.v1.ListAvailableVersionsRequest").msgclass

data/proto_docs/google/cloud/datafusion/v1/datafusion.rb

@@ -54,9 +54,24 @@ module Google
         # @!attribute [rw] available_features
         #   @return [::Array<::String>]
         #     Represents a list of available feature names for a given version.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::DataFusion::V1::Version::Type]
+        #     Type represents the release availability of the version
         class Version
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Each type represents the release availability of a CDF version
+          module Type
+            # Version does not have availability yet
+            TYPE_UNSPECIFIED = 0
+
+            # Version is under development and not considered stable
+            TYPE_PREVIEW = 1
+
+            # Version is available for public use
+            TYPE_GENERAL_AVAILABILITY = 2
+          end
         end
 
         # Identifies Data Fusion accelerators for an instance.
@@ -178,8 +193,7 @@ module Google
         #     Current version of the Data Fusion. Only specifiable in Update.
         # @!attribute [r] service_account
         #   @return [::String]
-        #     Output only. Deprecated. Use tenant_project_id instead to extract the
-        #     tenant project ID.
+        #     Output only. Deprecated. Use tenant_project_id instead to extract the tenant project ID.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     Display name for an instance.
@@ -192,8 +206,7 @@ module Google
         #     Output only. Endpoint on which the REST APIs is accessible.
         # @!attribute [r] gcs_bucket
         #   @return [::String]
-        #     Output only. Cloud Storage bucket generated by Data Fusion in the customer
-        #     project.
+        #     Output only. Cloud Storage bucket generated by Data Fusion in the customer project.
         # @!attribute [rw] accelerators
         #   @return [::Array<::Google::Cloud::DataFusion::V1::Accelerator>]
         #     List of accelerators enabled for this CDF instance.
@@ -217,6 +230,9 @@ module Google
         #   @return [::Google::Cloud::DataFusion::V1::CryptoKeyConfig]
         #     The crypto key configuration. This field is used by the Customer-Managed
         #     Encryption Keys (CMEK) feature.
+        # @!attribute [r] disabled_reason
+        #   @return [::Array<::Google::Cloud::DataFusion::V1::Instance::DisabledReason>]
+        #     Output only. If the instance state is DISABLED, the reason for disabling the instance.
         class Instance
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -295,13 +311,25 @@ module Google
 
             # Instance is being auto-upgraded
             AUTO_UPGRADING = 9
+
+            # Instance is disabled
+            DISABLED = 10
+          end
+
+          # The reason for disabling the instance if the state is DISABLED.
+          module DisabledReason
+            # This is an unknown reason for disabling.
+            DISABLED_REASON_UNSPECIFIED = 0
+
+            # The KMS key used by the instance is either revoked or denied access to
+            KMS_KEY_ISSUE = 1
           end
         end
 
         # Request message for listing Data Fusion instances.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     The project and location for which to retrieve instance information
+        #     Required. The project and location for which to retrieve instance information
         #     in the format projects/\\{project}/locations/\\{location}. If the location is
         #     specified as '-' (wildcard), then all regions available to the project
         #     are queried, and the results are aggregated.
@@ -342,8 +370,8 @@ module Google
         # Request message for the list available versions request.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The project and location for which to retrieve instance
-        #     information in the format projects/\\{project}/locations/\\{location}.
+        #     Required. The project and location for which to retrieve instance information
+        #     in the format projects/\\{project}/locations/\\{location}.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     The maximum number of items to return.
@@ -377,7 +405,7 @@ module Google
         # Request message for getting details about a Data Fusion instance.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The instance resource name in the format
+        #     Required. The instance resource name in the format
         #     projects/\\{project}/locations/\\{location}/instances/\\{instance}.
         class GetInstanceRequest
           include ::Google::Protobuf::MessageExts
@@ -387,11 +415,11 @@ module Google
         # Request message for creating a Data Fusion instance.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     The instance's project and location in the format
+        #     Required. The instance's project and location in the format
         #     projects/\\{project}/locations/\\{location}.
         # @!attribute [rw] instance_id
         #   @return [::String]
-        #     The name of the instance to create.
+        #     Required. The name of the instance to create.
         # @!attribute [rw] instance
         #   @return [::Google::Cloud::DataFusion::V1::Instance]
         #     An instance resource.
@@ -403,16 +431,19 @@ module Google
         # Request message for deleting a Data Fusion instance.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The instance resource name in the format
+        #     Required. The instance resource name in the format
         #     projects/\\{project}/locations/\\{location}/instances/\\{instance}
         class DeleteInstanceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for updating a Data Fusion instance.
+        # Data Fusion allows updating the labels, options, and stack driver settings.
+        # This is also used for CDF version upgrade.
         # @!attribute [rw] instance
         #   @return [::Google::Cloud::DataFusion::V1::Instance]
-        #     The instance resource that replaces the resource on the server. Currently,
+        #     Required. The instance resource that replaces the resource on the server. Currently,
         #     Data Fusion only allows replacing labels, options, and stack driver
         #     settings. All other fields will be ignored.
         # @!attribute [rw] update_mask
@@ -431,7 +462,7 @@ module Google
         # Request message for restarting a Data Fusion instance.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Name of the Data Fusion instance which need to be restarted in the form of
+        #     Required. Name of the Data Fusion instance which need to be restarted in the form of
         #     projects/\\{project}/locations/\\{location}/instances/\\{instance}
         class RestartInstanceRequest
           include ::Google::Protobuf::MessageExts
@@ -458,9 +489,8 @@ module Google
         #   @return [::Boolean]
         #     Identifies whether the user has requested cancellation
         #     of the operation. Operations that have successfully been cancelled
-        #     have [Operation.error][] value with a
-        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
-        #     `Code.CANCELLED`.
+        #     have [Operation.error][] value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
+        #     corresponding to `Code.CANCELLED`.
         # @!attribute [rw] api_version
         #   @return [::String]
         #     API version used to start the operation.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-data_fusion-v1
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -209,7 +209,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Data Fusion V1 API