google-cloud-vm_migration-v1 2.2.0 → 2.4.0

data/lib/google/iam/v1/iam_policy/rest/service_stub.rb

@@ -0,0 +1,265 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/iam/v1/iam_policy_pb"
+
+module Google
+  module Iam
+    module V1
+      module IAMPolicy
+        module Rest
+          ##
+          # REST service stub for the IAMPolicy service.
+          # Service stub contains baseline method implementations
+          # including transcoding, making the REST call, and deserialing the response.
+          #
+          class ServiceStub
+            # @private
+            def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
+              # These require statements are intentionally placed here to initialize
+              # the REST modules only when it's required.
+              require "gapic/rest"
+
+              @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
+                                                           endpoint_template: endpoint_template,
+                                                           universe_domain: universe_domain,
+                                                           credentials: credentials,
+                                                           numeric_enums: true,
+                                                           service_name: self.class,
+                                                           raise_faraday_errors: false,
+                                                           logger: logger
+            end
+
+            ##
+            # The effective universe domain
+            #
+            # @return [String]
+            #
+            def universe_domain
+              @client_stub.universe_domain
+            end
+
+            ##
+            # The effective endpoint
+            #
+            # @return [String]
+            #
+            def endpoint
+              @client_stub.endpoint
+            end
+
+            ##
+            # The logger used for request/response debug logging.
+            #
+            # @return [Logger]
+            #
+            def logger stub: false
+              stub ? @client_stub.stub_logger : @client_stub.logger
+            end
+
+            ##
+            # Baseline implementation for the set_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::SetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V1::Policy]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V1::Policy]
+            #   A result object deserialized from the server's reply
+            def set_iam_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_set_iam_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split "=", 2 }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri: uri,
+                body: body || "",
+                params: query_string_params,
+                method_name: "set_iam_policy",
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
+              catch :response do
+                yield result, operation if block_given?
+                result
+              end
+            end
+
+            ##
+            # Baseline implementation for the get_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::GetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V1::Policy]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V1::Policy]
+            #   A result object deserialized from the server's reply
+            def get_iam_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_get_iam_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split "=", 2 }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri: uri,
+                body: body || "",
+                params: query_string_params,
+                method_name: "get_iam_policy",
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
+              catch :response do
+                yield result, operation if block_given?
+                result
+              end
+            end
+
+            ##
+            # Baseline implementation for the test_iam_permissions REST call
+            #
+            # @param request_pb [::Google::Iam::V1::TestIamPermissionsRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V1::TestIamPermissionsResponse]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V1::TestIamPermissionsResponse]
+            #   A result object deserialized from the server's reply
+            def test_iam_permissions request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_test_iam_permissions_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split "=", 2 }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri: uri,
+                body: body || "",
+                params: query_string_params,
+                method_name: "test_iam_permissions",
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V1::TestIamPermissionsResponse.decode_json response.body, ignore_unknown_fields: true
+              catch :response do
+                yield result, operation if block_given?
+                result
+              end
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the set_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::SetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_set_iam_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :post,
+                                                        uri_template: "/v1/{resource}:setIamPolicy",
+                                                        body: "*",
+                                                        matches: [
+                                                          ["resource", %r{^.*$}, true]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the get_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::GetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_get_iam_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :post,
+                                                        uri_template: "/v1/{resource}:getIamPolicy",
+                                                        body: "*",
+                                                        matches: [
+                                                          ["resource", %r{^.*$}, true]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the test_iam_permissions REST call
+            #
+            # @param request_pb [::Google::Iam::V1::TestIamPermissionsRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_test_iam_permissions_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :post,
+                                                        uri_template: "/v1/{resource}:testIamPermissions",
+                                                        body: "*",
+                                                        matches: [
+                                                          ["resource", %r{^.*$}, true]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/iam/v1/iam_policy/rest.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/vm_migration/v1/version"
+require "google/iam/v1/bindings_override"
+
+require "google/iam/v1/iam_policy/credentials"
+require "google/iam/v1/iam_policy/rest/client"
+
+module Google
+  module Iam
+    module V1
+      ##
+      # API Overview
+      #
+      # Manages Identity and Access Management (IAM) policies.
+      #
+      # Any implementation of an API that offers access control features
+      # implements the google.iam.v1.IAMPolicy interface.
+      #
+      # ## Data model
+      #
+      # Access control is applied when a principal (user or service account), takes
+      # some action on a resource exposed by a service. Resources, identified by
+      # URI-like names, are the unit of access control specification. Service
+      # implementations can choose the granularity of access control and the
+      # supported permissions for their resources.
+      # For example one database service may allow access control to be
+      # specified only at the Table level, whereas another might allow access control
+      # to also be specified at the Column level.
+      #
+      # ## Policy Structure
+      #
+      # See google.iam.v1.Policy
+      #
+      # This is intentionally not a CRUD style API because access control policies
+      # are created and deleted implicitly with the resources to which they are
+      # attached.
+      #
+      # To load this service and instantiate a REST client:
+      #
+      #     require "google/iam/v1/iam_policy/rest"
+      #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+      #
+      module IAMPolicy
+        # Client for the REST transport
+        module Rest
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/iam/v1/iam_policy/rest/helpers" if ::File.file? helper_path

data/lib/google/iam/v1/iam_policy.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/vm_migration/v1/version"
+
+require "google/iam/v1/iam_policy/credentials"
+require "google/iam/v1/iam_policy/client"
+require "google/iam/v1/iam_policy/rest"
+
+module Google
+  module Iam
+    module V1
+      ##
+      # API Overview
+      #
+      # Manages Identity and Access Management (IAM) policies.
+      #
+      # Any implementation of an API that offers access control features
+      # implements the google.iam.v1.IAMPolicy interface.
+      #
+      # ## Data model
+      #
+      # Access control is applied when a principal (user or service account), takes
+      # some action on a resource exposed by a service. Resources, identified by
+      # URI-like names, are the unit of access control specification. Service
+      # implementations can choose the granularity of access control and the
+      # supported permissions for their resources.
+      # For example one database service may allow access control to be
+      # specified only at the Table level, whereas another might allow access control
+      # to also be specified at the Column level.
+      #
+      # ## Policy Structure
+      #
+      # See google.iam.v1.Policy
+      #
+      # This is intentionally not a CRUD style API because access control policies
+      # are created and deleted implicitly with the resources to which they are
+      # attached.
+      #
+      # @example Load this service and instantiate a gRPC client
+      #
+      #     require "google/iam/v1/iam_policy"
+      #     client = ::Google::Iam::V1::IAMPolicy::Client.new
+      #
+      # @example Load this service and instantiate a REST client
+      #
+      #     require "google/iam/v1/iam_policy/rest"
+      #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+      #
+      module IAMPolicy
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "iam_policy", "helpers.rb"
+require "google/iam/v1/iam_policy/helpers" if ::File.file? helper_path

data/lib/google/iam/v1/rest.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/iam/v1/iam_policy/rest"
+require "google/iam/v1/bindings_override"
+require "google/cloud/vm_migration/v1/version"
+
+module Google
+  module Iam
+    ##
+    # To load just the REST part of this package, including all its services, and instantiate a REST client:
+    #
+    # @example
+    #
+    #     require "google/iam/v1/rest"
+    #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+    #
+    module V1
+    end
+  end
+end

data/lib/google/iam/v1.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/iam/v1/iam_policy"
+require "google/cloud/vm_migration/v1/version"
+
+module Google
+  module Iam
+    ##
+    # API client module.
+    #
+    # @example Load this package, including all its services, and instantiate a gRPC client
+    #
+    #     require "google/iam/v1"
+    #     client = ::Google::Iam::V1::IAMPolicy::Client.new
+    #
+    # @example Load this package, including all its services, and instantiate a REST client
+    #
+    #     require "google/iam/v1"
+    #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+    #
+    module V1
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "v1", "_helpers.rb"
+require "google/iam/v1/_helpers" if ::File.file? helper_path

data/lib/google-cloud-vm_migration-v1.rb

@@ -19,3 +19,4 @@
 # This gem does not autoload during Bundler.require. To load this gem,
 # issue explicit require statements for the packages desired, e.g.:
 # require "google/cloud/vm_migration/v1"
+# require "google/iam/v1"

data/proto_docs/google/api/field_info.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # Rich semantic information of an API field beyond basic typing.
+    # @!attribute [rw] format
+    #   @return [::Google::Api::FieldInfo::Format]
+    #     The standard format of a field value. This does not explicitly configure
+    #     any API consumer, just documents the API's format for the field it is
+    #     applied to.
+    # @!attribute [rw] referenced_types
+    #   @return [::Array<::Google::Api::TypeReference>]
+    #     The type(s) that the annotated, generic field may represent.
+    #
+    #     Currently, this must only be used on fields of type `google.protobuf.Any`.
+    #     Supporting other generic types may be considered in the future.
+    class FieldInfo
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # The standard format of a field value. The supported formats are all backed
+      # by either an RFC defined by the IETF or a Google-defined AIP.
+      module Format
+        # Default, unspecified value.
+        FORMAT_UNSPECIFIED = 0
+
+        # Universally Unique Identifier, version 4, value as defined by
+        # https://datatracker.ietf.org/doc/html/rfc4122. The value may be
+        # normalized to entirely lowercase letters. For example, the value
+        # `F47AC10B-58CC-0372-8567-0E02B2C3D479` would be normalized to
+        # `f47ac10b-58cc-0372-8567-0e02b2c3d479`.
+        UUID4 = 1
+
+        # Internet Protocol v4 value as defined by [RFC
+        # 791](https://datatracker.ietf.org/doc/html/rfc791). The value may be
+        # condensed, with leading zeros in each octet stripped. For example,
+        # `001.022.233.040` would be condensed to `1.22.233.40`.
+        IPV4 = 2
+
+        # Internet Protocol v6 value as defined by [RFC
+        # 2460](https://datatracker.ietf.org/doc/html/rfc2460). The value may be
+        # normalized to entirely lowercase letters with zeros compressed, following
+        # [RFC 5952](https://datatracker.ietf.org/doc/html/rfc5952). For example,
+        # the value `2001:0DB8:0::0` would be normalized to `2001:db8::`.
+        IPV6 = 3
+
+        # An IP address in either v4 or v6 format as described by the individual
+        # values defined herein. See the comments on the IPV4 and IPV6 types for
+        # allowed normalizations of each.
+        IPV4_OR_IPV6 = 4
+      end
+    end
+
+    # A reference to a message type, for use in {::Google::Api::FieldInfo FieldInfo}.
+    # @!attribute [rw] type_name
+    #   @return [::String]
+    #     The name of the type that the annotated, generic field may represent.
+    #     If the type is in the same protobuf package, the value can be the simple
+    #     message name e.g., `"MyMessage"`. Otherwise, the value must be the
+    #     fully-qualified message name e.g., `"google.library.v1.Book"`.
+    #
+    #     If the type(s) are unknown to the service (e.g. the field accepts generic
+    #     user input), use the wildcard `"*"` to denote this behavior.
+    #
+    #     See [AIP-202](https://google.aip.dev/202#type-references) for more details.
+    class TypeReference
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end