google-cloud-iap-v1 0.1.2 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 10730453daa40c5ab47cdbcea2f97b6c9ab7844215aba6a42eedee4bb7d75435
4
- data.tar.gz: 45037db6b7a9d5ab4f384611c9cf8cc709f38f74aaa63d567cc08beac30fc7ac
3
+ metadata.gz: 4d0e2c3423feead8e29e5b6528c55edbbdf659c4c10919f6aafb0797ed31484a
4
+ data.tar.gz: 3499c5349aa082a92568e12607764fb8ffd8de52db2060233c14f8be8e295a6c
5
5
  SHA512:
6
- metadata.gz: 52eae47b41afdb9d1e942ba3991c01b9c91953fc27b5f7021f0644b3806064c87f75195550273bdd333493692ce38bd176f4477be090049dd96d3db412bd70b6
7
- data.tar.gz: ab8e2b430ff04624c589c2bd2b62beccdbca8db007123346a985a55b6f2cede4404b17bda0e23c94d9fcbffcd30af7dc1aee28486e9fc041ceb21bce4af2e621
6
+ metadata.gz: 9c9e63413d86964952f6ca3d0119d06b8f0c0f8863394366a518b5b4b91e25ca94f26fc1deb459b3f8c2398e68758a6975174fa5d86359a4fb6640c87c660960
7
+ data.tar.gz: 8746f1f52c6beca3e631ad05f5bad0d0ae261c1b94d4cdb11e20ee4a200b6bb026748845ccf28995fd9d760885691e6e97d3dc96bea7561d7ac07327a57e278e
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Identity-Aware Proxy V1 API
2
+ --title="Identity-Aware Proxy V1 API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
data/README.md CHANGED
@@ -37,7 +37,7 @@ request = ::Google::Iam::V1::SetIamPolicyRequest.new # (request fields as keywor
37
37
  response = client.set_iam_policy request
38
38
  ```
39
39
 
40
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-iap-v1/latest)
40
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-iap-v1/latest)
41
41
  for class and method documentation.
42
42
 
43
43
  See also the [Product Documentation](https://cloud.google.com/iap/)
@@ -69,6 +69,11 @@ module GRPC
69
69
  end
70
70
  ```
71
71
 
72
+
73
+ ## Google Cloud Samples
74
+
75
+ To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
+
72
77
  ## Supported Ruby Versions
73
78
 
74
79
  This library is supported on Ruby 2.5+.
@@ -30,6 +30,8 @@ module Google
30
30
  # APIs for Identity-Aware Proxy Admin configurations.
31
31
  #
32
32
  class Client
33
+ include Paths
34
+
33
35
  # @private
34
36
  attr_reader :identity_aware_proxy_admin_service_stub
35
37
 
@@ -160,7 +162,7 @@ module Google
160
162
  # @param options [::Gapic::CallOptions, ::Hash]
161
163
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
162
164
  #
163
- # @overload set_iam_policy(resource: nil, policy: nil)
165
+ # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
164
166
  # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
165
167
  # least one keyword argument is required. To specify no parameters, or to keep all
166
168
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -173,6 +175,12 @@ module Google
173
175
  # the policy is limited to a few 10s of KB. An empty policy is a
174
176
  # valid policy but certain Cloud Platform services (such as Projects)
175
177
  # might reject them.
178
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
179
+ # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
180
+ # the fields in the mask will be modified. If no mask is provided, the
181
+ # following default mask is used:
182
+ #
183
+ # `paths: "bindings, etag"`
176
184
  #
177
185
  # @yield [response, operation] Access the result along with the RPC operation
178
186
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -264,7 +272,7 @@ module Google
264
272
  # See the operation documentation for the appropriate value for this field.
265
273
  # @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
266
274
  # OPTIONAL: A `GetPolicyOptions` object for specifying options to
267
- # `GetIamPolicy`. This field is only used by Cloud IAM.
275
+ # `GetIamPolicy`.
268
276
  #
269
277
  # @yield [response, operation] Access the result along with the RPC operation
270
278
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -603,6 +611,473 @@ module Google
603
611
  raise ::Google::Cloud::Error.from_error(e)
604
612
  end
605
613
 
614
+ ##
615
+ # Lists the existing TunnelDestGroups. To group across all locations, use a
616
+ # `-` as the location ID. For example:
617
+ # `/v1/projects/123/iap_tunnel/locations/-/destGroups`
618
+ #
619
+ # @overload list_tunnel_dest_groups(request, options = nil)
620
+ # Pass arguments to `list_tunnel_dest_groups` via a request object, either of type
621
+ # {::Google::Cloud::Iap::V1::ListTunnelDestGroupsRequest} or an equivalent Hash.
622
+ #
623
+ # @param request [::Google::Cloud::Iap::V1::ListTunnelDestGroupsRequest, ::Hash]
624
+ # A request object representing the call parameters. Required. To specify no
625
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
626
+ # @param options [::Gapic::CallOptions, ::Hash]
627
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
628
+ #
629
+ # @overload list_tunnel_dest_groups(parent: nil, page_size: nil, page_token: nil)
630
+ # Pass arguments to `list_tunnel_dest_groups` via keyword arguments. Note that at
631
+ # least one keyword argument is required. To specify no parameters, or to keep all
632
+ # the default parameter values, pass an empty Hash as a request object (see above).
633
+ #
634
+ # @param parent [::String]
635
+ # Required. Google Cloud Project ID and location.
636
+ # In the following format:
637
+ # `projects/{project_number/id}/iap_tunnel/locations/{location}`.
638
+ # A `-` can be used for the location to group across all locations.
639
+ # @param page_size [::Integer]
640
+ # The maximum number of groups to return. The service might return fewer than
641
+ # this value.
642
+ # If unspecified, at most 100 groups are returned.
643
+ # The maximum value is 1000; values above 1000 are coerced to 1000.
644
+ # @param page_token [::String]
645
+ # A page token, received from a previous `ListTunnelDestGroups`
646
+ # call. Provide this to retrieve the subsequent page.
647
+ #
648
+ # When paginating, all other parameters provided to
649
+ # `ListTunnelDestGroups` must match the call that provided the page
650
+ # token.
651
+ #
652
+ # @yield [response, operation] Access the result along with the RPC operation
653
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Iap::V1::TunnelDestGroup>]
654
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
655
+ #
656
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Iap::V1::TunnelDestGroup>]
657
+ #
658
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
659
+ #
660
+ # @example Basic example
661
+ # require "google/cloud/iap/v1"
662
+ #
663
+ # # Create a client object. The client can be reused for multiple calls.
664
+ # client = Google::Cloud::Iap::V1::IdentityAwareProxyAdminService::Client.new
665
+ #
666
+ # # Create a request. To set request fields, pass in keyword arguments.
667
+ # request = Google::Cloud::Iap::V1::ListTunnelDestGroupsRequest.new
668
+ #
669
+ # # Call the list_tunnel_dest_groups method.
670
+ # result = client.list_tunnel_dest_groups request
671
+ #
672
+ # # The returned object is of type Gapic::PagedEnumerable. You can
673
+ # # iterate over all elements by calling #each, and the enumerable
674
+ # # will lazily make API calls to fetch subsequent pages. Other
675
+ # # methods are also available for managing paging directly.
676
+ # result.each do |response|
677
+ # # Each element is of type ::Google::Cloud::Iap::V1::TunnelDestGroup.
678
+ # p response
679
+ # end
680
+ #
681
+ def list_tunnel_dest_groups request, options = nil
682
+ raise ::ArgumentError, "request must be provided" if request.nil?
683
+
684
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Iap::V1::ListTunnelDestGroupsRequest
685
+
686
+ # Converts hash and nil to an options object
687
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
688
+
689
+ # Customize the options with defaults
690
+ metadata = @config.rpcs.list_tunnel_dest_groups.metadata.to_h
691
+
692
+ # Set x-goog-api-client and x-goog-user-project headers
693
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
694
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
695
+ gapic_version: ::Google::Cloud::Iap::V1::VERSION
696
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
697
+
698
+ header_params = {}
699
+ if request.parent
700
+ header_params["parent"] = request.parent
701
+ end
702
+
703
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
704
+ metadata[:"x-goog-request-params"] ||= request_params_header
705
+
706
+ options.apply_defaults timeout: @config.rpcs.list_tunnel_dest_groups.timeout,
707
+ metadata: metadata,
708
+ retry_policy: @config.rpcs.list_tunnel_dest_groups.retry_policy
709
+
710
+ options.apply_defaults timeout: @config.timeout,
711
+ metadata: @config.metadata,
712
+ retry_policy: @config.retry_policy
713
+
714
+ @identity_aware_proxy_admin_service_stub.call_rpc :list_tunnel_dest_groups, request, options: options do |response, operation|
715
+ response = ::Gapic::PagedEnumerable.new @identity_aware_proxy_admin_service_stub, :list_tunnel_dest_groups, request, response, operation, options
716
+ yield response, operation if block_given?
717
+ return response
718
+ end
719
+ rescue ::GRPC::BadStatus => e
720
+ raise ::Google::Cloud::Error.from_error(e)
721
+ end
722
+
723
+ ##
724
+ # Creates a new TunnelDestGroup.
725
+ #
726
+ # @overload create_tunnel_dest_group(request, options = nil)
727
+ # Pass arguments to `create_tunnel_dest_group` via a request object, either of type
728
+ # {::Google::Cloud::Iap::V1::CreateTunnelDestGroupRequest} or an equivalent Hash.
729
+ #
730
+ # @param request [::Google::Cloud::Iap::V1::CreateTunnelDestGroupRequest, ::Hash]
731
+ # A request object representing the call parameters. Required. To specify no
732
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
733
+ # @param options [::Gapic::CallOptions, ::Hash]
734
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
735
+ #
736
+ # @overload create_tunnel_dest_group(parent: nil, tunnel_dest_group: nil, tunnel_dest_group_id: nil)
737
+ # Pass arguments to `create_tunnel_dest_group` via keyword arguments. Note that at
738
+ # least one keyword argument is required. To specify no parameters, or to keep all
739
+ # the default parameter values, pass an empty Hash as a request object (see above).
740
+ #
741
+ # @param parent [::String]
742
+ # Required. Google Cloud Project ID and location.
743
+ # In the following format:
744
+ # `projects/{project_number/id}/iap_tunnel/locations/{location}`.
745
+ # @param tunnel_dest_group [::Google::Cloud::Iap::V1::TunnelDestGroup, ::Hash]
746
+ # Required. The TunnelDestGroup to create.
747
+ # @param tunnel_dest_group_id [::String]
748
+ # Required. The ID to use for the TunnelDestGroup, which becomes the final component of
749
+ # the resource name.
750
+ #
751
+ # This value must be 4-63 characters, and valid characters
752
+ # are `[a-z][0-9]-`.
753
+ #
754
+ # @yield [response, operation] Access the result along with the RPC operation
755
+ # @yieldparam response [::Google::Cloud::Iap::V1::TunnelDestGroup]
756
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
757
+ #
758
+ # @return [::Google::Cloud::Iap::V1::TunnelDestGroup]
759
+ #
760
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
761
+ #
762
+ # @example Basic example
763
+ # require "google/cloud/iap/v1"
764
+ #
765
+ # # Create a client object. The client can be reused for multiple calls.
766
+ # client = Google::Cloud::Iap::V1::IdentityAwareProxyAdminService::Client.new
767
+ #
768
+ # # Create a request. To set request fields, pass in keyword arguments.
769
+ # request = Google::Cloud::Iap::V1::CreateTunnelDestGroupRequest.new
770
+ #
771
+ # # Call the create_tunnel_dest_group method.
772
+ # result = client.create_tunnel_dest_group request
773
+ #
774
+ # # The returned object is of type Google::Cloud::Iap::V1::TunnelDestGroup.
775
+ # p result
776
+ #
777
+ def create_tunnel_dest_group request, options = nil
778
+ raise ::ArgumentError, "request must be provided" if request.nil?
779
+
780
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Iap::V1::CreateTunnelDestGroupRequest
781
+
782
+ # Converts hash and nil to an options object
783
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
784
+
785
+ # Customize the options with defaults
786
+ metadata = @config.rpcs.create_tunnel_dest_group.metadata.to_h
787
+
788
+ # Set x-goog-api-client and x-goog-user-project headers
789
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
790
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
791
+ gapic_version: ::Google::Cloud::Iap::V1::VERSION
792
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
793
+
794
+ header_params = {}
795
+ if request.parent
796
+ header_params["parent"] = request.parent
797
+ end
798
+
799
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
800
+ metadata[:"x-goog-request-params"] ||= request_params_header
801
+
802
+ options.apply_defaults timeout: @config.rpcs.create_tunnel_dest_group.timeout,
803
+ metadata: metadata,
804
+ retry_policy: @config.rpcs.create_tunnel_dest_group.retry_policy
805
+
806
+ options.apply_defaults timeout: @config.timeout,
807
+ metadata: @config.metadata,
808
+ retry_policy: @config.retry_policy
809
+
810
+ @identity_aware_proxy_admin_service_stub.call_rpc :create_tunnel_dest_group, request, options: options do |response, operation|
811
+ yield response, operation if block_given?
812
+ return response
813
+ end
814
+ rescue ::GRPC::BadStatus => e
815
+ raise ::Google::Cloud::Error.from_error(e)
816
+ end
817
+
818
+ ##
819
+ # Retrieves an existing TunnelDestGroup.
820
+ #
821
+ # @overload get_tunnel_dest_group(request, options = nil)
822
+ # Pass arguments to `get_tunnel_dest_group` via a request object, either of type
823
+ # {::Google::Cloud::Iap::V1::GetTunnelDestGroupRequest} or an equivalent Hash.
824
+ #
825
+ # @param request [::Google::Cloud::Iap::V1::GetTunnelDestGroupRequest, ::Hash]
826
+ # A request object representing the call parameters. Required. To specify no
827
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
828
+ # @param options [::Gapic::CallOptions, ::Hash]
829
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
830
+ #
831
+ # @overload get_tunnel_dest_group(name: nil)
832
+ # Pass arguments to `get_tunnel_dest_group` via keyword arguments. Note that at
833
+ # least one keyword argument is required. To specify no parameters, or to keep all
834
+ # the default parameter values, pass an empty Hash as a request object (see above).
835
+ #
836
+ # @param name [::String]
837
+ # Required. Name of the TunnelDestGroup to be fetched.
838
+ # In the following format:
839
+ # `projects/{project_number/id}/iap_tunnel/locations/{location}/destGroups/{dest_group}`.
840
+ #
841
+ # @yield [response, operation] Access the result along with the RPC operation
842
+ # @yieldparam response [::Google::Cloud::Iap::V1::TunnelDestGroup]
843
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
844
+ #
845
+ # @return [::Google::Cloud::Iap::V1::TunnelDestGroup]
846
+ #
847
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
848
+ #
849
+ # @example Basic example
850
+ # require "google/cloud/iap/v1"
851
+ #
852
+ # # Create a client object. The client can be reused for multiple calls.
853
+ # client = Google::Cloud::Iap::V1::IdentityAwareProxyAdminService::Client.new
854
+ #
855
+ # # Create a request. To set request fields, pass in keyword arguments.
856
+ # request = Google::Cloud::Iap::V1::GetTunnelDestGroupRequest.new
857
+ #
858
+ # # Call the get_tunnel_dest_group method.
859
+ # result = client.get_tunnel_dest_group request
860
+ #
861
+ # # The returned object is of type Google::Cloud::Iap::V1::TunnelDestGroup.
862
+ # p result
863
+ #
864
+ def get_tunnel_dest_group request, options = nil
865
+ raise ::ArgumentError, "request must be provided" if request.nil?
866
+
867
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Iap::V1::GetTunnelDestGroupRequest
868
+
869
+ # Converts hash and nil to an options object
870
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
871
+
872
+ # Customize the options with defaults
873
+ metadata = @config.rpcs.get_tunnel_dest_group.metadata.to_h
874
+
875
+ # Set x-goog-api-client and x-goog-user-project headers
876
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
877
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
878
+ gapic_version: ::Google::Cloud::Iap::V1::VERSION
879
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
880
+
881
+ header_params = {}
882
+ if request.name
883
+ header_params["name"] = request.name
884
+ end
885
+
886
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
887
+ metadata[:"x-goog-request-params"] ||= request_params_header
888
+
889
+ options.apply_defaults timeout: @config.rpcs.get_tunnel_dest_group.timeout,
890
+ metadata: metadata,
891
+ retry_policy: @config.rpcs.get_tunnel_dest_group.retry_policy
892
+
893
+ options.apply_defaults timeout: @config.timeout,
894
+ metadata: @config.metadata,
895
+ retry_policy: @config.retry_policy
896
+
897
+ @identity_aware_proxy_admin_service_stub.call_rpc :get_tunnel_dest_group, request, options: options do |response, operation|
898
+ yield response, operation if block_given?
899
+ return response
900
+ end
901
+ rescue ::GRPC::BadStatus => e
902
+ raise ::Google::Cloud::Error.from_error(e)
903
+ end
904
+
905
+ ##
906
+ # Deletes a TunnelDestGroup.
907
+ #
908
+ # @overload delete_tunnel_dest_group(request, options = nil)
909
+ # Pass arguments to `delete_tunnel_dest_group` via a request object, either of type
910
+ # {::Google::Cloud::Iap::V1::DeleteTunnelDestGroupRequest} or an equivalent Hash.
911
+ #
912
+ # @param request [::Google::Cloud::Iap::V1::DeleteTunnelDestGroupRequest, ::Hash]
913
+ # A request object representing the call parameters. Required. To specify no
914
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
915
+ # @param options [::Gapic::CallOptions, ::Hash]
916
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
917
+ #
918
+ # @overload delete_tunnel_dest_group(name: nil)
919
+ # Pass arguments to `delete_tunnel_dest_group` via keyword arguments. Note that at
920
+ # least one keyword argument is required. To specify no parameters, or to keep all
921
+ # the default parameter values, pass an empty Hash as a request object (see above).
922
+ #
923
+ # @param name [::String]
924
+ # Required. Name of the TunnelDestGroup to delete.
925
+ # In the following format:
926
+ # `projects/{project_number/id}/iap_tunnel/locations/{location}/destGroups/{dest_group}`.
927
+ #
928
+ # @yield [response, operation] Access the result along with the RPC operation
929
+ # @yieldparam response [::Google::Protobuf::Empty]
930
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
931
+ #
932
+ # @return [::Google::Protobuf::Empty]
933
+ #
934
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
935
+ #
936
+ # @example Basic example
937
+ # require "google/cloud/iap/v1"
938
+ #
939
+ # # Create a client object. The client can be reused for multiple calls.
940
+ # client = Google::Cloud::Iap::V1::IdentityAwareProxyAdminService::Client.new
941
+ #
942
+ # # Create a request. To set request fields, pass in keyword arguments.
943
+ # request = Google::Cloud::Iap::V1::DeleteTunnelDestGroupRequest.new
944
+ #
945
+ # # Call the delete_tunnel_dest_group method.
946
+ # result = client.delete_tunnel_dest_group request
947
+ #
948
+ # # The returned object is of type Google::Protobuf::Empty.
949
+ # p result
950
+ #
951
+ def delete_tunnel_dest_group request, options = nil
952
+ raise ::ArgumentError, "request must be provided" if request.nil?
953
+
954
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Iap::V1::DeleteTunnelDestGroupRequest
955
+
956
+ # Converts hash and nil to an options object
957
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
958
+
959
+ # Customize the options with defaults
960
+ metadata = @config.rpcs.delete_tunnel_dest_group.metadata.to_h
961
+
962
+ # Set x-goog-api-client and x-goog-user-project headers
963
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
964
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
965
+ gapic_version: ::Google::Cloud::Iap::V1::VERSION
966
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
967
+
968
+ header_params = {}
969
+ if request.name
970
+ header_params["name"] = request.name
971
+ end
972
+
973
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
974
+ metadata[:"x-goog-request-params"] ||= request_params_header
975
+
976
+ options.apply_defaults timeout: @config.rpcs.delete_tunnel_dest_group.timeout,
977
+ metadata: metadata,
978
+ retry_policy: @config.rpcs.delete_tunnel_dest_group.retry_policy
979
+
980
+ options.apply_defaults timeout: @config.timeout,
981
+ metadata: @config.metadata,
982
+ retry_policy: @config.retry_policy
983
+
984
+ @identity_aware_proxy_admin_service_stub.call_rpc :delete_tunnel_dest_group, request, options: options do |response, operation|
985
+ yield response, operation if block_given?
986
+ return response
987
+ end
988
+ rescue ::GRPC::BadStatus => e
989
+ raise ::Google::Cloud::Error.from_error(e)
990
+ end
991
+
992
+ ##
993
+ # Updates a TunnelDestGroup.
994
+ #
995
+ # @overload update_tunnel_dest_group(request, options = nil)
996
+ # Pass arguments to `update_tunnel_dest_group` via a request object, either of type
997
+ # {::Google::Cloud::Iap::V1::UpdateTunnelDestGroupRequest} or an equivalent Hash.
998
+ #
999
+ # @param request [::Google::Cloud::Iap::V1::UpdateTunnelDestGroupRequest, ::Hash]
1000
+ # A request object representing the call parameters. Required. To specify no
1001
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1002
+ # @param options [::Gapic::CallOptions, ::Hash]
1003
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1004
+ #
1005
+ # @overload update_tunnel_dest_group(tunnel_dest_group: nil, update_mask: nil)
1006
+ # Pass arguments to `update_tunnel_dest_group` via keyword arguments. Note that at
1007
+ # least one keyword argument is required. To specify no parameters, or to keep all
1008
+ # the default parameter values, pass an empty Hash as a request object (see above).
1009
+ #
1010
+ # @param tunnel_dest_group [::Google::Cloud::Iap::V1::TunnelDestGroup, ::Hash]
1011
+ # Required. The new values for the TunnelDestGroup.
1012
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1013
+ # A field mask that specifies which IAP settings to update.
1014
+ # If omitted, then all of the settings are updated. See
1015
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
1016
+ #
1017
+ # @yield [response, operation] Access the result along with the RPC operation
1018
+ # @yieldparam response [::Google::Cloud::Iap::V1::TunnelDestGroup]
1019
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1020
+ #
1021
+ # @return [::Google::Cloud::Iap::V1::TunnelDestGroup]
1022
+ #
1023
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1024
+ #
1025
+ # @example Basic example
1026
+ # require "google/cloud/iap/v1"
1027
+ #
1028
+ # # Create a client object. The client can be reused for multiple calls.
1029
+ # client = Google::Cloud::Iap::V1::IdentityAwareProxyAdminService::Client.new
1030
+ #
1031
+ # # Create a request. To set request fields, pass in keyword arguments.
1032
+ # request = Google::Cloud::Iap::V1::UpdateTunnelDestGroupRequest.new
1033
+ #
1034
+ # # Call the update_tunnel_dest_group method.
1035
+ # result = client.update_tunnel_dest_group request
1036
+ #
1037
+ # # The returned object is of type Google::Cloud::Iap::V1::TunnelDestGroup.
1038
+ # p result
1039
+ #
1040
+ def update_tunnel_dest_group request, options = nil
1041
+ raise ::ArgumentError, "request must be provided" if request.nil?
1042
+
1043
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Iap::V1::UpdateTunnelDestGroupRequest
1044
+
1045
+ # Converts hash and nil to an options object
1046
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1047
+
1048
+ # Customize the options with defaults
1049
+ metadata = @config.rpcs.update_tunnel_dest_group.metadata.to_h
1050
+
1051
+ # Set x-goog-api-client and x-goog-user-project headers
1052
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1053
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1054
+ gapic_version: ::Google::Cloud::Iap::V1::VERSION
1055
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1056
+
1057
+ header_params = {}
1058
+ if request.tunnel_dest_group&.name
1059
+ header_params["tunnel_dest_group.name"] = request.tunnel_dest_group.name
1060
+ end
1061
+
1062
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1063
+ metadata[:"x-goog-request-params"] ||= request_params_header
1064
+
1065
+ options.apply_defaults timeout: @config.rpcs.update_tunnel_dest_group.timeout,
1066
+ metadata: metadata,
1067
+ retry_policy: @config.rpcs.update_tunnel_dest_group.retry_policy
1068
+
1069
+ options.apply_defaults timeout: @config.timeout,
1070
+ metadata: @config.metadata,
1071
+ retry_policy: @config.retry_policy
1072
+
1073
+ @identity_aware_proxy_admin_service_stub.call_rpc :update_tunnel_dest_group, request, options: options do |response, operation|
1074
+ yield response, operation if block_given?
1075
+ return response
1076
+ end
1077
+ rescue ::GRPC::BadStatus => e
1078
+ raise ::Google::Cloud::Error.from_error(e)
1079
+ end
1080
+
606
1081
  ##
607
1082
  # Configuration class for the IdentityAwareProxyAdminService API.
608
1083
  #
@@ -763,6 +1238,31 @@ module Google
763
1238
  # @return [::Gapic::Config::Method]
764
1239
  #
765
1240
  attr_reader :update_iap_settings
1241
+ ##
1242
+ # RPC-specific configuration for `list_tunnel_dest_groups`
1243
+ # @return [::Gapic::Config::Method]
1244
+ #
1245
+ attr_reader :list_tunnel_dest_groups
1246
+ ##
1247
+ # RPC-specific configuration for `create_tunnel_dest_group`
1248
+ # @return [::Gapic::Config::Method]
1249
+ #
1250
+ attr_reader :create_tunnel_dest_group
1251
+ ##
1252
+ # RPC-specific configuration for `get_tunnel_dest_group`
1253
+ # @return [::Gapic::Config::Method]
1254
+ #
1255
+ attr_reader :get_tunnel_dest_group
1256
+ ##
1257
+ # RPC-specific configuration for `delete_tunnel_dest_group`
1258
+ # @return [::Gapic::Config::Method]
1259
+ #
1260
+ attr_reader :delete_tunnel_dest_group
1261
+ ##
1262
+ # RPC-specific configuration for `update_tunnel_dest_group`
1263
+ # @return [::Gapic::Config::Method]
1264
+ #
1265
+ attr_reader :update_tunnel_dest_group
766
1266
 
767
1267
  # @private
768
1268
  def initialize parent_rpcs = nil
@@ -776,6 +1276,16 @@ module Google
776
1276
  @get_iap_settings = ::Gapic::Config::Method.new get_iap_settings_config
777
1277
  update_iap_settings_config = parent_rpcs.update_iap_settings if parent_rpcs.respond_to? :update_iap_settings
778
1278
  @update_iap_settings = ::Gapic::Config::Method.new update_iap_settings_config
1279
+ list_tunnel_dest_groups_config = parent_rpcs.list_tunnel_dest_groups if parent_rpcs.respond_to? :list_tunnel_dest_groups
1280
+ @list_tunnel_dest_groups = ::Gapic::Config::Method.new list_tunnel_dest_groups_config
1281
+ create_tunnel_dest_group_config = parent_rpcs.create_tunnel_dest_group if parent_rpcs.respond_to? :create_tunnel_dest_group
1282
+ @create_tunnel_dest_group = ::Gapic::Config::Method.new create_tunnel_dest_group_config
1283
+ get_tunnel_dest_group_config = parent_rpcs.get_tunnel_dest_group if parent_rpcs.respond_to? :get_tunnel_dest_group
1284
+ @get_tunnel_dest_group = ::Gapic::Config::Method.new get_tunnel_dest_group_config
1285
+ delete_tunnel_dest_group_config = parent_rpcs.delete_tunnel_dest_group if parent_rpcs.respond_to? :delete_tunnel_dest_group
1286
+ @delete_tunnel_dest_group = ::Gapic::Config::Method.new delete_tunnel_dest_group_config
1287
+ update_tunnel_dest_group_config = parent_rpcs.update_tunnel_dest_group if parent_rpcs.respond_to? :update_tunnel_dest_group
1288
+ @update_tunnel_dest_group = ::Gapic::Config::Method.new update_tunnel_dest_group_config
779
1289
 
780
1290
  yield self if block_given?
781
1291
  end