google-cloud-network_security-v1 0.a → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +12 -0
  3. data/AUTHENTICATION.md +122 -0
  4. data/README.md +154 -8
  5. data/lib/google/cloud/network_security/v1/address_group_service/client.rb +1457 -0
  6. data/lib/google/cloud/network_security/v1/address_group_service/credentials.rb +47 -0
  7. data/lib/google/cloud/network_security/v1/address_group_service/operations.rb +843 -0
  8. data/lib/google/cloud/network_security/v1/address_group_service/paths.rb +110 -0
  9. data/lib/google/cloud/network_security/v1/address_group_service.rb +52 -0
  10. data/lib/google/cloud/network_security/v1/dns_threat_detector_service/client.rb +900 -0
  11. data/lib/google/cloud/network_security/v1/dns_threat_detector_service/credentials.rb +47 -0
  12. data/lib/google/cloud/network_security/v1/dns_threat_detector_service/paths.rb +86 -0
  13. data/lib/google/cloud/network_security/v1/dns_threat_detector_service.rb +49 -0
  14. data/lib/google/cloud/network_security/v1/firewall_activation/client.rb +2098 -0
  15. data/lib/google/cloud/network_security/v1/firewall_activation/credentials.rb +47 -0
  16. data/lib/google/cloud/network_security/v1/firewall_activation/operations.rb +843 -0
  17. data/lib/google/cloud/network_security/v1/firewall_activation/paths.rb +165 -0
  18. data/lib/google/cloud/network_security/v1/firewall_activation.rb +50 -0
  19. data/lib/google/cloud/network_security/v1/intercept/client.rb +2599 -0
  20. data/lib/google/cloud/network_security/v1/intercept/credentials.rb +47 -0
  21. data/lib/google/cloud/network_security/v1/intercept/operations.rb +843 -0
  22. data/lib/google/cloud/network_security/v1/intercept/paths.rb +160 -0
  23. data/lib/google/cloud/network_security/v1/intercept.rb +51 -0
  24. data/lib/google/cloud/network_security/v1/mirroring/client.rb +2598 -0
  25. data/lib/google/cloud/network_security/v1/mirroring/credentials.rb +47 -0
  26. data/lib/google/cloud/network_security/v1/mirroring/operations.rb +843 -0
  27. data/lib/google/cloud/network_security/v1/mirroring/paths.rb +160 -0
  28. data/lib/google/cloud/network_security/v1/mirroring.rb +50 -0
  29. data/lib/google/cloud/network_security/v1/network_security/client.rb +5161 -0
  30. data/lib/google/cloud/network_security/v1/network_security/credentials.rb +47 -0
  31. data/lib/google/cloud/network_security/v1/network_security/operations.rb +843 -0
  32. data/lib/google/cloud/network_security/v1/network_security/paths.rb +280 -0
  33. data/lib/google/cloud/network_security/v1/network_security.rb +52 -0
  34. data/lib/google/cloud/network_security/v1/organization_address_group_service/client.rb +1457 -0
  35. data/lib/google/cloud/network_security/v1/organization_address_group_service/credentials.rb +47 -0
  36. data/lib/google/cloud/network_security/v1/organization_address_group_service/operations.rb +843 -0
  37. data/lib/google/cloud/network_security/v1/organization_address_group_service/paths.rb +110 -0
  38. data/lib/google/cloud/network_security/v1/organization_address_group_service.rb +52 -0
  39. data/lib/google/cloud/network_security/v1/organization_security_profile_group_service/client.rb +1471 -0
  40. data/lib/google/cloud/network_security/v1/organization_security_profile_group_service/credentials.rb +47 -0
  41. data/lib/google/cloud/network_security/v1/organization_security_profile_group_service/operations.rb +843 -0
  42. data/lib/google/cloud/network_security/v1/organization_security_profile_group_service/paths.rb +191 -0
  43. data/lib/google/cloud/network_security/v1/organization_security_profile_group_service.rb +50 -0
  44. data/lib/google/cloud/network_security/v1/security_profile_group_service/client.rb +1472 -0
  45. data/lib/google/cloud/network_security/v1/security_profile_group_service/credentials.rb +47 -0
  46. data/lib/google/cloud/network_security/v1/security_profile_group_service/operations.rb +843 -0
  47. data/lib/google/cloud/network_security/v1/security_profile_group_service/paths.rb +191 -0
  48. data/lib/google/cloud/network_security/v1/security_profile_group_service.rb +51 -0
  49. data/lib/google/cloud/network_security/v1/sse_realm_service/client.rb +1316 -0
  50. data/lib/google/cloud/network_security/v1/sse_realm_service/credentials.rb +47 -0
  51. data/lib/google/cloud/network_security/v1/sse_realm_service/operations.rb +843 -0
  52. data/lib/google/cloud/network_security/v1/sse_realm_service/paths.rb +88 -0
  53. data/lib/google/cloud/network_security/v1/sse_realm_service.rb +50 -0
  54. data/lib/google/cloud/network_security/v1/version.rb +7 -2
  55. data/lib/google/cloud/network_security/v1.rb +49 -0
  56. data/lib/google/cloud/networksecurity/v1/address_group_pb.rb +46 -0
  57. data/lib/google/cloud/networksecurity/v1/address_group_services_pb.rb +97 -0
  58. data/lib/google/cloud/networksecurity/v1/authorization_policy_pb.rb +37 -0
  59. data/lib/google/cloud/networksecurity/v1/authz_policy_pb.rb +56 -0
  60. data/lib/google/cloud/networksecurity/v1/backend_authentication_config_pb.rb +33 -0
  61. data/lib/google/cloud/networksecurity/v1/client_tls_policy_pb.rb +33 -0
  62. data/lib/google/cloud/networksecurity/v1/common_pb.rb +24 -0
  63. data/lib/google/cloud/networksecurity/v1/dns_threat_detector_pb.rb +36 -0
  64. data/lib/google/cloud/networksecurity/v1/dns_threat_detector_services_pb.rb +53 -0
  65. data/lib/google/cloud/networksecurity/v1/firewall_activation_pb.rb +48 -0
  66. data/lib/google/cloud/networksecurity/v1/firewall_activation_services_pb.rb +73 -0
  67. data/lib/google/cloud/networksecurity/v1/gateway_security_policy_pb.rb +32 -0
  68. data/lib/google/cloud/networksecurity/v1/gateway_security_policy_rule_pb.rb +33 -0
  69. data/lib/google/cloud/networksecurity/v1/intercept_pb.rb +71 -0
  70. data/lib/google/cloud/networksecurity/v1/intercept_services_pb.rb +104 -0
  71. data/lib/google/cloud/networksecurity/v1/mirroring_pb.rb +72 -0
  72. data/lib/google/cloud/networksecurity/v1/mirroring_services_pb.rb +103 -0
  73. data/lib/google/cloud/networksecurity/v1/network_security_pb.rb +35 -0
  74. data/lib/google/cloud/networksecurity/v1/network_security_services_pb.rb +138 -0
  75. data/lib/google/cloud/networksecurity/v1/security_profile_group_intercept_pb.rb +24 -0
  76. data/lib/google/cloud/networksecurity/v1/security_profile_group_mirroring_pb.rb +24 -0
  77. data/lib/google/cloud/networksecurity/v1/security_profile_group_pb.rb +31 -0
  78. data/lib/google/cloud/networksecurity/v1/security_profile_group_service_pb.rb +42 -0
  79. data/lib/google/cloud/networksecurity/v1/security_profile_group_service_services_pb.rb +98 -0
  80. data/lib/google/cloud/networksecurity/v1/security_profile_group_threatprevention_pb.rb +30 -0
  81. data/lib/google/cloud/networksecurity/v1/security_profile_group_urlfiltering_pb.rb +25 -0
  82. data/lib/google/cloud/networksecurity/v1/server_tls_policy_pb.rb +35 -0
  83. data/lib/google/cloud/networksecurity/v1/sse_realm_pb.rb +46 -0
  84. data/lib/google/cloud/networksecurity/v1/sse_realm_services_pb.rb +59 -0
  85. data/lib/google/cloud/networksecurity/v1/tls_inspection_policy_pb.rb +34 -0
  86. data/lib/google/cloud/networksecurity/v1/tls_pb.rb +26 -0
  87. data/lib/google/cloud/networksecurity/v1/url_list_pb.rb +32 -0
  88. data/lib/google-cloud-network_security-v1.rb +21 -0
  89. data/proto_docs/README.md +4 -0
  90. data/proto_docs/google/api/client.rb +593 -0
  91. data/proto_docs/google/api/field_behavior.rb +85 -0
  92. data/proto_docs/google/api/field_info.rb +88 -0
  93. data/proto_docs/google/api/launch_stage.rb +71 -0
  94. data/proto_docs/google/api/resource.rb +227 -0
  95. data/proto_docs/google/cloud/networksecurity/v1/address_group.rb +374 -0
  96. data/proto_docs/google/cloud/networksecurity/v1/authorization_policy.rb +263 -0
  97. data/proto_docs/google/cloud/networksecurity/v1/authz_policy.rb +735 -0
  98. data/proto_docs/google/cloud/networksecurity/v1/backend_authentication_config.rb +217 -0
  99. data/proto_docs/google/cloud/networksecurity/v1/client_tls_policy.rb +162 -0
  100. data/proto_docs/google/cloud/networksecurity/v1/common.rb +57 -0
  101. data/proto_docs/google/cloud/networksecurity/v1/dns_threat_detector.rb +159 -0
  102. data/proto_docs/google/cloud/networksecurity/v1/firewall_activation.rb +469 -0
  103. data/proto_docs/google/cloud/networksecurity/v1/gateway_security_policy.rb +144 -0
  104. data/proto_docs/google/cloud/networksecurity/v1/gateway_security_policy_rule.rb +178 -0
  105. data/proto_docs/google/cloud/networksecurity/v1/intercept.rb +960 -0
  106. data/proto_docs/google/cloud/networksecurity/v1/mirroring.rb +970 -0
  107. data/proto_docs/google/cloud/networksecurity/v1/security_profile_group.rb +166 -0
  108. data/proto_docs/google/cloud/networksecurity/v1/security_profile_group_intercept.rb +38 -0
  109. data/proto_docs/google/cloud/networksecurity/v1/security_profile_group_mirroring.rb +38 -0
  110. data/proto_docs/google/cloud/networksecurity/v1/security_profile_group_service.rb +211 -0
  111. data/proto_docs/google/cloud/networksecurity/v1/security_profile_group_threatprevention.rb +193 -0
  112. data/proto_docs/google/cloud/networksecurity/v1/security_profile_group_urlfiltering.rb +66 -0
  113. data/proto_docs/google/cloud/networksecurity/v1/server_tls_policy.rb +251 -0
  114. data/proto_docs/google/cloud/networksecurity/v1/sse_realm.rb +388 -0
  115. data/proto_docs/google/cloud/networksecurity/v1/tls.rb +90 -0
  116. data/proto_docs/google/cloud/networksecurity/v1/tls_inspection_policy.rb +239 -0
  117. data/proto_docs/google/cloud/networksecurity/v1/url_list.rb +144 -0
  118. data/proto_docs/google/longrunning/operations.rb +191 -0
  119. data/proto_docs/google/protobuf/any.rb +145 -0
  120. data/proto_docs/google/protobuf/duration.rb +98 -0
  121. data/proto_docs/google/protobuf/empty.rb +34 -0
  122. data/proto_docs/google/protobuf/field_mask.rb +229 -0
  123. data/proto_docs/google/protobuf/timestamp.rb +127 -0
  124. data/proto_docs/google/rpc/status.rb +48 -0
  125. data/proto_docs/google/type/expr.rb +75 -0
  126. metadata +186 -9
@@ -0,0 +1,2098 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/errors"
20
+ require "google/cloud/networksecurity/v1/firewall_activation_pb"
21
+ require "google/cloud/location"
22
+ require "google/iam/v1"
23
+
24
+ module Google
25
+ module Cloud
26
+ module NetworkSecurity
27
+ module V1
28
+ module FirewallActivation
29
+ ##
30
+ # Client for the FirewallActivation service.
31
+ #
32
+ # Service for managing Firewall Endpoints and Associations.
33
+ #
34
+ class Client
35
+ # @private
36
+ API_VERSION = ""
37
+
38
+ # @private
39
+ DEFAULT_ENDPOINT_TEMPLATE = "networksecurity.$UNIVERSE_DOMAIN$"
40
+
41
+ include Paths
42
+
43
+ # @private
44
+ attr_reader :firewall_activation_stub
45
+
46
+ ##
47
+ # Configure the FirewallActivation Client class.
48
+ #
49
+ # See {::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client::Configuration}
50
+ # for a description of the configuration fields.
51
+ #
52
+ # @example
53
+ #
54
+ # # Modify the configuration for all FirewallActivation clients
55
+ # ::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.configure do |config|
56
+ # config.timeout = 10.0
57
+ # end
58
+ #
59
+ # @yield [config] Configure the Client client.
60
+ # @yieldparam config [Client::Configuration]
61
+ #
62
+ # @return [Client::Configuration]
63
+ #
64
+ def self.configure
65
+ @configure ||= begin
66
+ namespace = ["Google", "Cloud", "NetworkSecurity", "V1"]
67
+ parent_config = while namespace.any?
68
+ parent_name = namespace.join "::"
69
+ parent_const = const_get parent_name
70
+ break parent_const.configure if parent_const.respond_to? :configure
71
+ namespace.pop
72
+ end
73
+ default_config = Client::Configuration.new parent_config
74
+
75
+ default_config
76
+ end
77
+ yield @configure if block_given?
78
+ @configure
79
+ end
80
+
81
+ ##
82
+ # Configure the FirewallActivation Client instance.
83
+ #
84
+ # The configuration is set to the derived mode, meaning that values can be changed,
85
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
86
+ # should be made on {Client.configure}.
87
+ #
88
+ # See {::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client::Configuration}
89
+ # for a description of the configuration fields.
90
+ #
91
+ # @yield [config] Configure the Client client.
92
+ # @yieldparam config [Client::Configuration]
93
+ #
94
+ # @return [Client::Configuration]
95
+ #
96
+ def configure
97
+ yield @config if block_given?
98
+ @config
99
+ end
100
+
101
+ ##
102
+ # The effective universe domain
103
+ #
104
+ # @return [String]
105
+ #
106
+ def universe_domain
107
+ @firewall_activation_stub.universe_domain
108
+ end
109
+
110
+ ##
111
+ # Create a new FirewallActivation client object.
112
+ #
113
+ # @example
114
+ #
115
+ # # Create a client using the default configuration
116
+ # client = ::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
117
+ #
118
+ # # Create a client using a custom configuration
119
+ # client = ::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new do |config|
120
+ # config.timeout = 10.0
121
+ # end
122
+ #
123
+ # @yield [config] Configure the FirewallActivation client.
124
+ # @yieldparam config [Client::Configuration]
125
+ #
126
+ def initialize
127
+ # These require statements are intentionally placed here to initialize
128
+ # the gRPC module only when it's required.
129
+ # See https://github.com/googleapis/toolkit/issues/446
130
+ require "gapic/grpc"
131
+ require "google/cloud/networksecurity/v1/firewall_activation_services_pb"
132
+
133
+ # Create the configuration object
134
+ @config = Configuration.new Client.configure
135
+
136
+ # Yield the configuration if needed
137
+ yield @config if block_given?
138
+
139
+ # Create credentials
140
+ credentials = @config.credentials
141
+ # Use self-signed JWT if the endpoint is unchanged from default,
142
+ # but only if the default endpoint does not have a region prefix.
143
+ enable_self_signed_jwt = @config.endpoint.nil? ||
144
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
145
+ !@config.endpoint.split(".").first.include?("-"))
146
+ credentials ||= Credentials.default scope: @config.scope,
147
+ enable_self_signed_jwt: enable_self_signed_jwt
148
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
149
+ credentials = Credentials.new credentials, scope: @config.scope
150
+ end
151
+ @quota_project_id = @config.quota_project
152
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
153
+
154
+ @operations_client = Operations.new do |config|
155
+ config.credentials = credentials
156
+ config.quota_project = @quota_project_id
157
+ config.endpoint = @config.endpoint
158
+ config.universe_domain = @config.universe_domain
159
+ end
160
+
161
+ @firewall_activation_stub = ::Gapic::ServiceStub.new(
162
+ ::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Stub,
163
+ credentials: credentials,
164
+ endpoint: @config.endpoint,
165
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
166
+ universe_domain: @config.universe_domain,
167
+ channel_args: @config.channel_args,
168
+ interceptors: @config.interceptors,
169
+ channel_pool_config: @config.channel_pool,
170
+ logger: @config.logger
171
+ )
172
+
173
+ @firewall_activation_stub.stub_logger&.info do |entry|
174
+ entry.set_system_name
175
+ entry.set_service
176
+ entry.message = "Created client for #{entry.service}"
177
+ entry.set_credentials_fields credentials
178
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
179
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
180
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
181
+ end
182
+
183
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
184
+ config.credentials = credentials
185
+ config.quota_project = @quota_project_id
186
+ config.endpoint = @firewall_activation_stub.endpoint
187
+ config.universe_domain = @firewall_activation_stub.universe_domain
188
+ config.logger = @firewall_activation_stub.logger if config.respond_to? :logger=
189
+ end
190
+
191
+ @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
192
+ config.credentials = credentials
193
+ config.quota_project = @quota_project_id
194
+ config.endpoint = @firewall_activation_stub.endpoint
195
+ config.universe_domain = @firewall_activation_stub.universe_domain
196
+ config.logger = @firewall_activation_stub.logger if config.respond_to? :logger=
197
+ end
198
+ end
199
+
200
+ ##
201
+ # Get the associated client for long-running operations.
202
+ #
203
+ # @return [::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Operations]
204
+ #
205
+ attr_reader :operations_client
206
+
207
+ ##
208
+ # Get the associated client for mix-in of the Locations.
209
+ #
210
+ # @return [Google::Cloud::Location::Locations::Client]
211
+ #
212
+ attr_reader :location_client
213
+
214
+ ##
215
+ # Get the associated client for mix-in of the IAMPolicy.
216
+ #
217
+ # @return [Google::Iam::V1::IAMPolicy::Client]
218
+ #
219
+ attr_reader :iam_policy_client
220
+
221
+ ##
222
+ # The logger used for request/response debug logging.
223
+ #
224
+ # @return [Logger]
225
+ #
226
+ def logger
227
+ @firewall_activation_stub.logger
228
+ end
229
+
230
+ # Service calls
231
+
232
+ ##
233
+ # Lists FirewallEndpoints in a given organization and location.
234
+ #
235
+ # @overload list_firewall_endpoints(request, options = nil)
236
+ # Pass arguments to `list_firewall_endpoints` via a request object, either of type
237
+ # {::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest} or an equivalent Hash.
238
+ #
239
+ # @param request [::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest, ::Hash]
240
+ # A request object representing the call parameters. Required. To specify no
241
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
242
+ # @param options [::Gapic::CallOptions, ::Hash]
243
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
244
+ #
245
+ # @overload list_firewall_endpoints(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
246
+ # Pass arguments to `list_firewall_endpoints` via keyword arguments. Note that at
247
+ # least one keyword argument is required. To specify no parameters, or to keep all
248
+ # the default parameter values, pass an empty Hash as a request object (see above).
249
+ #
250
+ # @param parent [::String]
251
+ # Required. Parent value for ListEndpointsRequest
252
+ # @param page_size [::Integer]
253
+ # Optional. Requested page size. Server may return fewer items than
254
+ # requested. If unspecified, server will pick an appropriate default.
255
+ # @param page_token [::String]
256
+ # A token identifying a page of results the server should return.
257
+ # @param filter [::String]
258
+ # Optional. Filtering results
259
+ # @param order_by [::String]
260
+ # Hint for how to order the results
261
+ #
262
+ # @yield [response, operation] Access the result along with the RPC operation
263
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint>]
264
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
265
+ #
266
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint>]
267
+ #
268
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
269
+ #
270
+ # @example Basic example
271
+ # require "google/cloud/network_security/v1"
272
+ #
273
+ # # Create a client object. The client can be reused for multiple calls.
274
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
275
+ #
276
+ # # Create a request. To set request fields, pass in keyword arguments.
277
+ # request = Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest.new
278
+ #
279
+ # # Call the list_firewall_endpoints method.
280
+ # result = client.list_firewall_endpoints request
281
+ #
282
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
283
+ # # over elements, and API calls will be issued to fetch pages as needed.
284
+ # result.each do |item|
285
+ # # Each element is of type ::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint.
286
+ # p item
287
+ # end
288
+ #
289
+ def list_firewall_endpoints request, options = nil
290
+ raise ::ArgumentError, "request must be provided" if request.nil?
291
+
292
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest
293
+
294
+ # Converts hash and nil to an options object
295
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
296
+
297
+ # Customize the options with defaults
298
+ metadata = @config.rpcs.list_firewall_endpoints.metadata.to_h
299
+
300
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
301
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
302
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
303
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
304
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
305
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
306
+
307
+ header_params = {}
308
+ if request.parent
309
+ header_params["parent"] = request.parent
310
+ end
311
+
312
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
313
+ metadata[:"x-goog-request-params"] ||= request_params_header
314
+
315
+ options.apply_defaults timeout: @config.rpcs.list_firewall_endpoints.timeout,
316
+ metadata: metadata,
317
+ retry_policy: @config.rpcs.list_firewall_endpoints.retry_policy
318
+
319
+ options.apply_defaults timeout: @config.timeout,
320
+ metadata: @config.metadata,
321
+ retry_policy: @config.retry_policy
322
+
323
+ @firewall_activation_stub.call_rpc :list_firewall_endpoints, request, options: options do |response, operation|
324
+ response = ::Gapic::PagedEnumerable.new @firewall_activation_stub, :list_firewall_endpoints, request, response, operation, options
325
+ yield response, operation if block_given?
326
+ throw :response, response
327
+ end
328
+ rescue ::GRPC::BadStatus => e
329
+ raise ::Google::Cloud::Error.from_error(e)
330
+ end
331
+
332
+ ##
333
+ # Lists FirewallEndpoints in a given project and location.
334
+ #
335
+ # @overload list_project_firewall_endpoints(request, options = nil)
336
+ # Pass arguments to `list_project_firewall_endpoints` via a request object, either of type
337
+ # {::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest} or an equivalent Hash.
338
+ #
339
+ # @param request [::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest, ::Hash]
340
+ # A request object representing the call parameters. Required. To specify no
341
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
342
+ # @param options [::Gapic::CallOptions, ::Hash]
343
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
344
+ #
345
+ # @overload list_project_firewall_endpoints(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
346
+ # Pass arguments to `list_project_firewall_endpoints` via keyword arguments. Note that at
347
+ # least one keyword argument is required. To specify no parameters, or to keep all
348
+ # the default parameter values, pass an empty Hash as a request object (see above).
349
+ #
350
+ # @param parent [::String]
351
+ # Required. Parent value for ListEndpointsRequest
352
+ # @param page_size [::Integer]
353
+ # Optional. Requested page size. Server may return fewer items than
354
+ # requested. If unspecified, server will pick an appropriate default.
355
+ # @param page_token [::String]
356
+ # A token identifying a page of results the server should return.
357
+ # @param filter [::String]
358
+ # Optional. Filtering results
359
+ # @param order_by [::String]
360
+ # Hint for how to order the results
361
+ #
362
+ # @yield [response, operation] Access the result along with the RPC operation
363
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint>]
364
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
365
+ #
366
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint>]
367
+ #
368
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
369
+ #
370
+ # @example Basic example
371
+ # require "google/cloud/network_security/v1"
372
+ #
373
+ # # Create a client object. The client can be reused for multiple calls.
374
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
375
+ #
376
+ # # Create a request. To set request fields, pass in keyword arguments.
377
+ # request = Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest.new
378
+ #
379
+ # # Call the list_project_firewall_endpoints method.
380
+ # result = client.list_project_firewall_endpoints request
381
+ #
382
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
383
+ # # over elements, and API calls will be issued to fetch pages as needed.
384
+ # result.each do |item|
385
+ # # Each element is of type ::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint.
386
+ # p item
387
+ # end
388
+ #
389
+ def list_project_firewall_endpoints request, options = nil
390
+ raise ::ArgumentError, "request must be provided" if request.nil?
391
+
392
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointsRequest
393
+
394
+ # Converts hash and nil to an options object
395
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
396
+
397
+ # Customize the options with defaults
398
+ metadata = @config.rpcs.list_project_firewall_endpoints.metadata.to_h
399
+
400
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
401
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
402
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
403
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
404
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
405
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
406
+
407
+ header_params = {}
408
+ if request.parent
409
+ header_params["parent"] = request.parent
410
+ end
411
+
412
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
413
+ metadata[:"x-goog-request-params"] ||= request_params_header
414
+
415
+ options.apply_defaults timeout: @config.rpcs.list_project_firewall_endpoints.timeout,
416
+ metadata: metadata,
417
+ retry_policy: @config.rpcs.list_project_firewall_endpoints.retry_policy
418
+
419
+ options.apply_defaults timeout: @config.timeout,
420
+ metadata: @config.metadata,
421
+ retry_policy: @config.retry_policy
422
+
423
+ @firewall_activation_stub.call_rpc :list_project_firewall_endpoints, request, options: options do |response, operation|
424
+ response = ::Gapic::PagedEnumerable.new @firewall_activation_stub, :list_project_firewall_endpoints, request, response, operation, options
425
+ yield response, operation if block_given?
426
+ throw :response, response
427
+ end
428
+ rescue ::GRPC::BadStatus => e
429
+ raise ::Google::Cloud::Error.from_error(e)
430
+ end
431
+
432
+ ##
433
+ # Gets details of a single org Endpoint.
434
+ #
435
+ # @overload get_firewall_endpoint(request, options = nil)
436
+ # Pass arguments to `get_firewall_endpoint` via a request object, either of type
437
+ # {::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest} or an equivalent Hash.
438
+ #
439
+ # @param request [::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest, ::Hash]
440
+ # A request object representing the call parameters. Required. To specify no
441
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
442
+ # @param options [::Gapic::CallOptions, ::Hash]
443
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
444
+ #
445
+ # @overload get_firewall_endpoint(name: nil)
446
+ # Pass arguments to `get_firewall_endpoint` via keyword arguments. Note that at
447
+ # least one keyword argument is required. To specify no parameters, or to keep all
448
+ # the default parameter values, pass an empty Hash as a request object (see above).
449
+ #
450
+ # @param name [::String]
451
+ # Required. Name of the resource
452
+ #
453
+ # @yield [response, operation] Access the result along with the RPC operation
454
+ # @yieldparam response [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint]
455
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
456
+ #
457
+ # @return [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint]
458
+ #
459
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
460
+ #
461
+ # @example Basic example
462
+ # require "google/cloud/network_security/v1"
463
+ #
464
+ # # Create a client object. The client can be reused for multiple calls.
465
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
466
+ #
467
+ # # Create a request. To set request fields, pass in keyword arguments.
468
+ # request = Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest.new
469
+ #
470
+ # # Call the get_firewall_endpoint method.
471
+ # result = client.get_firewall_endpoint request
472
+ #
473
+ # # The returned object is of type Google::Cloud::NetworkSecurity::V1::FirewallEndpoint.
474
+ # p result
475
+ #
476
+ def get_firewall_endpoint request, options = nil
477
+ raise ::ArgumentError, "request must be provided" if request.nil?
478
+
479
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest
480
+
481
+ # Converts hash and nil to an options object
482
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
483
+
484
+ # Customize the options with defaults
485
+ metadata = @config.rpcs.get_firewall_endpoint.metadata.to_h
486
+
487
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
488
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
489
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
490
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
491
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
492
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
493
+
494
+ header_params = {}
495
+ if request.name
496
+ header_params["name"] = request.name
497
+ end
498
+
499
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
500
+ metadata[:"x-goog-request-params"] ||= request_params_header
501
+
502
+ options.apply_defaults timeout: @config.rpcs.get_firewall_endpoint.timeout,
503
+ metadata: metadata,
504
+ retry_policy: @config.rpcs.get_firewall_endpoint.retry_policy
505
+
506
+ options.apply_defaults timeout: @config.timeout,
507
+ metadata: @config.metadata,
508
+ retry_policy: @config.retry_policy
509
+
510
+ @firewall_activation_stub.call_rpc :get_firewall_endpoint, request, options: options do |response, operation|
511
+ yield response, operation if block_given?
512
+ end
513
+ rescue ::GRPC::BadStatus => e
514
+ raise ::Google::Cloud::Error.from_error(e)
515
+ end
516
+
517
+ ##
518
+ # Gets details of a single project Endpoint.
519
+ #
520
+ # @overload get_project_firewall_endpoint(request, options = nil)
521
+ # Pass arguments to `get_project_firewall_endpoint` via a request object, either of type
522
+ # {::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest} or an equivalent Hash.
523
+ #
524
+ # @param request [::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest, ::Hash]
525
+ # A request object representing the call parameters. Required. To specify no
526
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
527
+ # @param options [::Gapic::CallOptions, ::Hash]
528
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
529
+ #
530
+ # @overload get_project_firewall_endpoint(name: nil)
531
+ # Pass arguments to `get_project_firewall_endpoint` via keyword arguments. Note that at
532
+ # least one keyword argument is required. To specify no parameters, or to keep all
533
+ # the default parameter values, pass an empty Hash as a request object (see above).
534
+ #
535
+ # @param name [::String]
536
+ # Required. Name of the resource
537
+ #
538
+ # @yield [response, operation] Access the result along with the RPC operation
539
+ # @yieldparam response [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint]
540
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
541
+ #
542
+ # @return [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint]
543
+ #
544
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
545
+ #
546
+ # @example Basic example
547
+ # require "google/cloud/network_security/v1"
548
+ #
549
+ # # Create a client object. The client can be reused for multiple calls.
550
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
551
+ #
552
+ # # Create a request. To set request fields, pass in keyword arguments.
553
+ # request = Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest.new
554
+ #
555
+ # # Call the get_project_firewall_endpoint method.
556
+ # result = client.get_project_firewall_endpoint request
557
+ #
558
+ # # The returned object is of type Google::Cloud::NetworkSecurity::V1::FirewallEndpoint.
559
+ # p result
560
+ #
561
+ def get_project_firewall_endpoint request, options = nil
562
+ raise ::ArgumentError, "request must be provided" if request.nil?
563
+
564
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointRequest
565
+
566
+ # Converts hash and nil to an options object
567
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
568
+
569
+ # Customize the options with defaults
570
+ metadata = @config.rpcs.get_project_firewall_endpoint.metadata.to_h
571
+
572
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
573
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
574
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
575
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
576
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
577
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
578
+
579
+ header_params = {}
580
+ if request.name
581
+ header_params["name"] = request.name
582
+ end
583
+
584
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
585
+ metadata[:"x-goog-request-params"] ||= request_params_header
586
+
587
+ options.apply_defaults timeout: @config.rpcs.get_project_firewall_endpoint.timeout,
588
+ metadata: metadata,
589
+ retry_policy: @config.rpcs.get_project_firewall_endpoint.retry_policy
590
+
591
+ options.apply_defaults timeout: @config.timeout,
592
+ metadata: @config.metadata,
593
+ retry_policy: @config.retry_policy
594
+
595
+ @firewall_activation_stub.call_rpc :get_project_firewall_endpoint, request, options: options do |response, operation|
596
+ yield response, operation if block_given?
597
+ end
598
+ rescue ::GRPC::BadStatus => e
599
+ raise ::Google::Cloud::Error.from_error(e)
600
+ end
601
+
602
+ ##
603
+ # Creates a new FirewallEndpoint in a given organization and location.
604
+ #
605
+ # @overload create_firewall_endpoint(request, options = nil)
606
+ # Pass arguments to `create_firewall_endpoint` via a request object, either of type
607
+ # {::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest} or an equivalent Hash.
608
+ #
609
+ # @param request [::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest, ::Hash]
610
+ # A request object representing the call parameters. Required. To specify no
611
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
612
+ # @param options [::Gapic::CallOptions, ::Hash]
613
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
614
+ #
615
+ # @overload create_firewall_endpoint(parent: nil, firewall_endpoint_id: nil, firewall_endpoint: nil, request_id: nil)
616
+ # Pass arguments to `create_firewall_endpoint` via keyword arguments. Note that at
617
+ # least one keyword argument is required. To specify no parameters, or to keep all
618
+ # the default parameter values, pass an empty Hash as a request object (see above).
619
+ #
620
+ # @param parent [::String]
621
+ # Required. Value for parent.
622
+ # @param firewall_endpoint_id [::String]
623
+ # Required. Id of the requesting object.
624
+ # If auto-generating Id server-side, remove this field and
625
+ # firewall_endpoint_id from the method_signature of Create RPC.
626
+ # @param firewall_endpoint [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint, ::Hash]
627
+ # Required. The resource being created
628
+ # @param request_id [::String]
629
+ # Optional. An optional request ID to identify requests. Specify a unique
630
+ # request ID so that if you must retry your request, the server will know to
631
+ # ignore the request if it has already been completed. The server will
632
+ # guarantee that for at least 60 minutes since the first request.
633
+ #
634
+ # For example, consider a situation where you make an initial request and
635
+ # the request times out. If you make the request again with the same request
636
+ # ID, the server can check if original operation with the same request ID
637
+ # was received, and if so, will ignore the second request. This prevents
638
+ # clients from accidentally creating duplicate commitments.
639
+ #
640
+ # The request ID must be a valid UUID with the exception that zero UUID is
641
+ # not supported (00000000-0000-0000-0000-000000000000).
642
+ #
643
+ # @yield [response, operation] Access the result along with the RPC operation
644
+ # @yieldparam response [::Gapic::Operation]
645
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
646
+ #
647
+ # @return [::Gapic::Operation]
648
+ #
649
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
650
+ #
651
+ # @example Basic example
652
+ # require "google/cloud/network_security/v1"
653
+ #
654
+ # # Create a client object. The client can be reused for multiple calls.
655
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
656
+ #
657
+ # # Create a request. To set request fields, pass in keyword arguments.
658
+ # request = Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest.new
659
+ #
660
+ # # Call the create_firewall_endpoint method.
661
+ # result = client.create_firewall_endpoint request
662
+ #
663
+ # # The returned object is of type Gapic::Operation. You can use it to
664
+ # # check the status of an operation, cancel it, or wait for results.
665
+ # # Here is how to wait for a response.
666
+ # result.wait_until_done! timeout: 60
667
+ # if result.response?
668
+ # p result.response
669
+ # else
670
+ # puts "No response received."
671
+ # end
672
+ #
673
+ def create_firewall_endpoint request, options = nil
674
+ raise ::ArgumentError, "request must be provided" if request.nil?
675
+
676
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest
677
+
678
+ # Converts hash and nil to an options object
679
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
680
+
681
+ # Customize the options with defaults
682
+ metadata = @config.rpcs.create_firewall_endpoint.metadata.to_h
683
+
684
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
685
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
686
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
687
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
688
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
689
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
690
+
691
+ header_params = {}
692
+ if request.parent
693
+ header_params["parent"] = request.parent
694
+ end
695
+
696
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
697
+ metadata[:"x-goog-request-params"] ||= request_params_header
698
+
699
+ options.apply_defaults timeout: @config.rpcs.create_firewall_endpoint.timeout,
700
+ metadata: metadata,
701
+ retry_policy: @config.rpcs.create_firewall_endpoint.retry_policy
702
+
703
+ options.apply_defaults timeout: @config.timeout,
704
+ metadata: @config.metadata,
705
+ retry_policy: @config.retry_policy
706
+
707
+ @firewall_activation_stub.call_rpc :create_firewall_endpoint, request, options: options do |response, operation|
708
+ response = ::Gapic::Operation.new response, @operations_client, options: options
709
+ yield response, operation if block_given?
710
+ throw :response, response
711
+ end
712
+ rescue ::GRPC::BadStatus => e
713
+ raise ::Google::Cloud::Error.from_error(e)
714
+ end
715
+
716
+ ##
717
+ # Creates a new FirewallEndpoint in a given project and location.
718
+ #
719
+ # @overload create_project_firewall_endpoint(request, options = nil)
720
+ # Pass arguments to `create_project_firewall_endpoint` via a request object, either of type
721
+ # {::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest} or an equivalent Hash.
722
+ #
723
+ # @param request [::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest, ::Hash]
724
+ # A request object representing the call parameters. Required. To specify no
725
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
726
+ # @param options [::Gapic::CallOptions, ::Hash]
727
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
728
+ #
729
+ # @overload create_project_firewall_endpoint(parent: nil, firewall_endpoint_id: nil, firewall_endpoint: nil, request_id: nil)
730
+ # Pass arguments to `create_project_firewall_endpoint` via keyword arguments. Note that at
731
+ # least one keyword argument is required. To specify no parameters, or to keep all
732
+ # the default parameter values, pass an empty Hash as a request object (see above).
733
+ #
734
+ # @param parent [::String]
735
+ # Required. Value for parent.
736
+ # @param firewall_endpoint_id [::String]
737
+ # Required. Id of the requesting object.
738
+ # If auto-generating Id server-side, remove this field and
739
+ # firewall_endpoint_id from the method_signature of Create RPC.
740
+ # @param firewall_endpoint [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint, ::Hash]
741
+ # Required. The resource being created
742
+ # @param request_id [::String]
743
+ # Optional. An optional request ID to identify requests. Specify a unique
744
+ # request ID so that if you must retry your request, the server will know to
745
+ # ignore the request if it has already been completed. The server will
746
+ # guarantee that for at least 60 minutes since the first request.
747
+ #
748
+ # For example, consider a situation where you make an initial request and
749
+ # the request times out. If you make the request again with the same request
750
+ # ID, the server can check if original operation with the same request ID
751
+ # was received, and if so, will ignore the second request. This prevents
752
+ # clients from accidentally creating duplicate commitments.
753
+ #
754
+ # The request ID must be a valid UUID with the exception that zero UUID is
755
+ # not supported (00000000-0000-0000-0000-000000000000).
756
+ #
757
+ # @yield [response, operation] Access the result along with the RPC operation
758
+ # @yieldparam response [::Gapic::Operation]
759
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
760
+ #
761
+ # @return [::Gapic::Operation]
762
+ #
763
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
764
+ #
765
+ # @example Basic example
766
+ # require "google/cloud/network_security/v1"
767
+ #
768
+ # # Create a client object. The client can be reused for multiple calls.
769
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
770
+ #
771
+ # # Create a request. To set request fields, pass in keyword arguments.
772
+ # request = Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest.new
773
+ #
774
+ # # Call the create_project_firewall_endpoint method.
775
+ # result = client.create_project_firewall_endpoint request
776
+ #
777
+ # # The returned object is of type Gapic::Operation. You can use it to
778
+ # # check the status of an operation, cancel it, or wait for results.
779
+ # # Here is how to wait for a response.
780
+ # result.wait_until_done! timeout: 60
781
+ # if result.response?
782
+ # p result.response
783
+ # else
784
+ # puts "No response received."
785
+ # end
786
+ #
787
+ def create_project_firewall_endpoint request, options = nil
788
+ raise ::ArgumentError, "request must be provided" if request.nil?
789
+
790
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointRequest
791
+
792
+ # Converts hash and nil to an options object
793
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
794
+
795
+ # Customize the options with defaults
796
+ metadata = @config.rpcs.create_project_firewall_endpoint.metadata.to_h
797
+
798
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
799
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
800
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
801
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
802
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
803
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
804
+
805
+ header_params = {}
806
+ if request.parent
807
+ header_params["parent"] = request.parent
808
+ end
809
+
810
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
811
+ metadata[:"x-goog-request-params"] ||= request_params_header
812
+
813
+ options.apply_defaults timeout: @config.rpcs.create_project_firewall_endpoint.timeout,
814
+ metadata: metadata,
815
+ retry_policy: @config.rpcs.create_project_firewall_endpoint.retry_policy
816
+
817
+ options.apply_defaults timeout: @config.timeout,
818
+ metadata: @config.metadata,
819
+ retry_policy: @config.retry_policy
820
+
821
+ @firewall_activation_stub.call_rpc :create_project_firewall_endpoint, request, options: options do |response, operation|
822
+ response = ::Gapic::Operation.new response, @operations_client, options: options
823
+ yield response, operation if block_given?
824
+ throw :response, response
825
+ end
826
+ rescue ::GRPC::BadStatus => e
827
+ raise ::Google::Cloud::Error.from_error(e)
828
+ end
829
+
830
+ ##
831
+ # Deletes a single org Endpoint.
832
+ #
833
+ # @overload delete_firewall_endpoint(request, options = nil)
834
+ # Pass arguments to `delete_firewall_endpoint` via a request object, either of type
835
+ # {::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest} or an equivalent Hash.
836
+ #
837
+ # @param request [::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest, ::Hash]
838
+ # A request object representing the call parameters. Required. To specify no
839
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
840
+ # @param options [::Gapic::CallOptions, ::Hash]
841
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
842
+ #
843
+ # @overload delete_firewall_endpoint(name: nil, request_id: nil)
844
+ # Pass arguments to `delete_firewall_endpoint` via keyword arguments. Note that at
845
+ # least one keyword argument is required. To specify no parameters, or to keep all
846
+ # the default parameter values, pass an empty Hash as a request object (see above).
847
+ #
848
+ # @param name [::String]
849
+ # Required. Name of the resource
850
+ # @param request_id [::String]
851
+ # Optional. An optional request ID to identify requests. Specify a unique
852
+ # request ID so that if you must retry your request, the server will know to
853
+ # ignore the request if it has already been completed. The server will
854
+ # guarantee that for at least 60 minutes after the first request.
855
+ #
856
+ # For example, consider a situation where you make an initial request and
857
+ # the request times out. If you make the request again with the same request
858
+ # ID, the server can check if original operation with the same request ID
859
+ # was received, and if so, will ignore the second request. This prevents
860
+ # clients from accidentally creating duplicate commitments.
861
+ #
862
+ # The request ID must be a valid UUID with the exception that zero UUID is
863
+ # not supported (00000000-0000-0000-0000-000000000000).
864
+ #
865
+ # @yield [response, operation] Access the result along with the RPC operation
866
+ # @yieldparam response [::Gapic::Operation]
867
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
868
+ #
869
+ # @return [::Gapic::Operation]
870
+ #
871
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
872
+ #
873
+ # @example Basic example
874
+ # require "google/cloud/network_security/v1"
875
+ #
876
+ # # Create a client object. The client can be reused for multiple calls.
877
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
878
+ #
879
+ # # Create a request. To set request fields, pass in keyword arguments.
880
+ # request = Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest.new
881
+ #
882
+ # # Call the delete_firewall_endpoint method.
883
+ # result = client.delete_firewall_endpoint request
884
+ #
885
+ # # The returned object is of type Gapic::Operation. You can use it to
886
+ # # check the status of an operation, cancel it, or wait for results.
887
+ # # Here is how to wait for a response.
888
+ # result.wait_until_done! timeout: 60
889
+ # if result.response?
890
+ # p result.response
891
+ # else
892
+ # puts "No response received."
893
+ # end
894
+ #
895
+ def delete_firewall_endpoint request, options = nil
896
+ raise ::ArgumentError, "request must be provided" if request.nil?
897
+
898
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest
899
+
900
+ # Converts hash and nil to an options object
901
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
902
+
903
+ # Customize the options with defaults
904
+ metadata = @config.rpcs.delete_firewall_endpoint.metadata.to_h
905
+
906
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
907
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
908
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
909
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
910
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
911
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
912
+
913
+ header_params = {}
914
+ if request.name
915
+ header_params["name"] = request.name
916
+ end
917
+
918
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
919
+ metadata[:"x-goog-request-params"] ||= request_params_header
920
+
921
+ options.apply_defaults timeout: @config.rpcs.delete_firewall_endpoint.timeout,
922
+ metadata: metadata,
923
+ retry_policy: @config.rpcs.delete_firewall_endpoint.retry_policy
924
+
925
+ options.apply_defaults timeout: @config.timeout,
926
+ metadata: @config.metadata,
927
+ retry_policy: @config.retry_policy
928
+
929
+ @firewall_activation_stub.call_rpc :delete_firewall_endpoint, request, options: options do |response, operation|
930
+ response = ::Gapic::Operation.new response, @operations_client, options: options
931
+ yield response, operation if block_given?
932
+ throw :response, response
933
+ end
934
+ rescue ::GRPC::BadStatus => e
935
+ raise ::Google::Cloud::Error.from_error(e)
936
+ end
937
+
938
+ ##
939
+ # Deletes a single project Endpoint.
940
+ #
941
+ # @overload delete_project_firewall_endpoint(request, options = nil)
942
+ # Pass arguments to `delete_project_firewall_endpoint` via a request object, either of type
943
+ # {::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest} or an equivalent Hash.
944
+ #
945
+ # @param request [::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest, ::Hash]
946
+ # A request object representing the call parameters. Required. To specify no
947
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
948
+ # @param options [::Gapic::CallOptions, ::Hash]
949
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
950
+ #
951
+ # @overload delete_project_firewall_endpoint(name: nil, request_id: nil)
952
+ # Pass arguments to `delete_project_firewall_endpoint` via keyword arguments. Note that at
953
+ # least one keyword argument is required. To specify no parameters, or to keep all
954
+ # the default parameter values, pass an empty Hash as a request object (see above).
955
+ #
956
+ # @param name [::String]
957
+ # Required. Name of the resource
958
+ # @param request_id [::String]
959
+ # Optional. An optional request ID to identify requests. Specify a unique
960
+ # request ID so that if you must retry your request, the server will know to
961
+ # ignore the request if it has already been completed. The server will
962
+ # guarantee that for at least 60 minutes after the first request.
963
+ #
964
+ # For example, consider a situation where you make an initial request and
965
+ # the request times out. If you make the request again with the same request
966
+ # ID, the server can check if original operation with the same request ID
967
+ # was received, and if so, will ignore the second request. This prevents
968
+ # clients from accidentally creating duplicate commitments.
969
+ #
970
+ # The request ID must be a valid UUID with the exception that zero UUID is
971
+ # not supported (00000000-0000-0000-0000-000000000000).
972
+ #
973
+ # @yield [response, operation] Access the result along with the RPC operation
974
+ # @yieldparam response [::Gapic::Operation]
975
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
976
+ #
977
+ # @return [::Gapic::Operation]
978
+ #
979
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
980
+ #
981
+ # @example Basic example
982
+ # require "google/cloud/network_security/v1"
983
+ #
984
+ # # Create a client object. The client can be reused for multiple calls.
985
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
986
+ #
987
+ # # Create a request. To set request fields, pass in keyword arguments.
988
+ # request = Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest.new
989
+ #
990
+ # # Call the delete_project_firewall_endpoint method.
991
+ # result = client.delete_project_firewall_endpoint request
992
+ #
993
+ # # The returned object is of type Gapic::Operation. You can use it to
994
+ # # check the status of an operation, cancel it, or wait for results.
995
+ # # Here is how to wait for a response.
996
+ # result.wait_until_done! timeout: 60
997
+ # if result.response?
998
+ # p result.response
999
+ # else
1000
+ # puts "No response received."
1001
+ # end
1002
+ #
1003
+ def delete_project_firewall_endpoint request, options = nil
1004
+ raise ::ArgumentError, "request must be provided" if request.nil?
1005
+
1006
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointRequest
1007
+
1008
+ # Converts hash and nil to an options object
1009
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1010
+
1011
+ # Customize the options with defaults
1012
+ metadata = @config.rpcs.delete_project_firewall_endpoint.metadata.to_h
1013
+
1014
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1015
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1016
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1017
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1018
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1019
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1020
+
1021
+ header_params = {}
1022
+ if request.name
1023
+ header_params["name"] = request.name
1024
+ end
1025
+
1026
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1027
+ metadata[:"x-goog-request-params"] ||= request_params_header
1028
+
1029
+ options.apply_defaults timeout: @config.rpcs.delete_project_firewall_endpoint.timeout,
1030
+ metadata: metadata,
1031
+ retry_policy: @config.rpcs.delete_project_firewall_endpoint.retry_policy
1032
+
1033
+ options.apply_defaults timeout: @config.timeout,
1034
+ metadata: @config.metadata,
1035
+ retry_policy: @config.retry_policy
1036
+
1037
+ @firewall_activation_stub.call_rpc :delete_project_firewall_endpoint, request, options: options do |response, operation|
1038
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1039
+ yield response, operation if block_given?
1040
+ throw :response, response
1041
+ end
1042
+ rescue ::GRPC::BadStatus => e
1043
+ raise ::Google::Cloud::Error.from_error(e)
1044
+ end
1045
+
1046
+ ##
1047
+ # Update a single org Endpoint.
1048
+ #
1049
+ # @overload update_firewall_endpoint(request, options = nil)
1050
+ # Pass arguments to `update_firewall_endpoint` via a request object, either of type
1051
+ # {::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest} or an equivalent Hash.
1052
+ #
1053
+ # @param request [::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest, ::Hash]
1054
+ # A request object representing the call parameters. Required. To specify no
1055
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1056
+ # @param options [::Gapic::CallOptions, ::Hash]
1057
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1058
+ #
1059
+ # @overload update_firewall_endpoint(update_mask: nil, firewall_endpoint: nil, request_id: nil)
1060
+ # Pass arguments to `update_firewall_endpoint` via keyword arguments. Note that at
1061
+ # least one keyword argument is required. To specify no parameters, or to keep all
1062
+ # the default parameter values, pass an empty Hash as a request object (see above).
1063
+ #
1064
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1065
+ # Required. Field mask is used to specify the fields to be overwritten in the
1066
+ # Endpoint resource by the update.
1067
+ # The fields specified in the update_mask are relative to the resource, not
1068
+ # the full request. A field will be overwritten if it is in the mask. If the
1069
+ # user does not provide a mask then all fields will be overwritten.
1070
+ # @param firewall_endpoint [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint, ::Hash]
1071
+ # Required. The resource being updated
1072
+ # @param request_id [::String]
1073
+ # Optional. An optional request ID to identify requests. Specify a unique
1074
+ # request ID so that if you must retry your request, the server will know to
1075
+ # ignore the request if it has already been completed. The server will
1076
+ # guarantee that for at least 60 minutes since the first request.
1077
+ #
1078
+ # For example, consider a situation where you make an initial request and
1079
+ # the request times out. If you make the request again with the same request
1080
+ # ID, the server can check if original operation with the same request ID
1081
+ # was received, and if so, will ignore the second request. This prevents
1082
+ # clients from accidentally creating duplicate commitments.
1083
+ #
1084
+ # The request ID must be a valid UUID with the exception that zero UUID is
1085
+ # not supported (00000000-0000-0000-0000-000000000000).
1086
+ #
1087
+ # @yield [response, operation] Access the result along with the RPC operation
1088
+ # @yieldparam response [::Gapic::Operation]
1089
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1090
+ #
1091
+ # @return [::Gapic::Operation]
1092
+ #
1093
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1094
+ #
1095
+ # @example Basic example
1096
+ # require "google/cloud/network_security/v1"
1097
+ #
1098
+ # # Create a client object. The client can be reused for multiple calls.
1099
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
1100
+ #
1101
+ # # Create a request. To set request fields, pass in keyword arguments.
1102
+ # request = Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest.new
1103
+ #
1104
+ # # Call the update_firewall_endpoint method.
1105
+ # result = client.update_firewall_endpoint request
1106
+ #
1107
+ # # The returned object is of type Gapic::Operation. You can use it to
1108
+ # # check the status of an operation, cancel it, or wait for results.
1109
+ # # Here is how to wait for a response.
1110
+ # result.wait_until_done! timeout: 60
1111
+ # if result.response?
1112
+ # p result.response
1113
+ # else
1114
+ # puts "No response received."
1115
+ # end
1116
+ #
1117
+ def update_firewall_endpoint request, options = nil
1118
+ raise ::ArgumentError, "request must be provided" if request.nil?
1119
+
1120
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest
1121
+
1122
+ # Converts hash and nil to an options object
1123
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1124
+
1125
+ # Customize the options with defaults
1126
+ metadata = @config.rpcs.update_firewall_endpoint.metadata.to_h
1127
+
1128
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1129
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1130
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1131
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1132
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1133
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1134
+
1135
+ header_params = {}
1136
+ if request.firewall_endpoint&.name
1137
+ header_params["firewall_endpoint.name"] = request.firewall_endpoint.name
1138
+ end
1139
+
1140
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1141
+ metadata[:"x-goog-request-params"] ||= request_params_header
1142
+
1143
+ options.apply_defaults timeout: @config.rpcs.update_firewall_endpoint.timeout,
1144
+ metadata: metadata,
1145
+ retry_policy: @config.rpcs.update_firewall_endpoint.retry_policy
1146
+
1147
+ options.apply_defaults timeout: @config.timeout,
1148
+ metadata: @config.metadata,
1149
+ retry_policy: @config.retry_policy
1150
+
1151
+ @firewall_activation_stub.call_rpc :update_firewall_endpoint, request, options: options do |response, operation|
1152
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1153
+ yield response, operation if block_given?
1154
+ throw :response, response
1155
+ end
1156
+ rescue ::GRPC::BadStatus => e
1157
+ raise ::Google::Cloud::Error.from_error(e)
1158
+ end
1159
+
1160
+ ##
1161
+ # Update a single project Endpoint.
1162
+ #
1163
+ # @overload update_project_firewall_endpoint(request, options = nil)
1164
+ # Pass arguments to `update_project_firewall_endpoint` via a request object, either of type
1165
+ # {::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest} or an equivalent Hash.
1166
+ #
1167
+ # @param request [::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest, ::Hash]
1168
+ # A request object representing the call parameters. Required. To specify no
1169
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1170
+ # @param options [::Gapic::CallOptions, ::Hash]
1171
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1172
+ #
1173
+ # @overload update_project_firewall_endpoint(update_mask: nil, firewall_endpoint: nil, request_id: nil)
1174
+ # Pass arguments to `update_project_firewall_endpoint` via keyword arguments. Note that at
1175
+ # least one keyword argument is required. To specify no parameters, or to keep all
1176
+ # the default parameter values, pass an empty Hash as a request object (see above).
1177
+ #
1178
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1179
+ # Required. Field mask is used to specify the fields to be overwritten in the
1180
+ # Endpoint resource by the update.
1181
+ # The fields specified in the update_mask are relative to the resource, not
1182
+ # the full request. A field will be overwritten if it is in the mask. If the
1183
+ # user does not provide a mask then all fields will be overwritten.
1184
+ # @param firewall_endpoint [::Google::Cloud::NetworkSecurity::V1::FirewallEndpoint, ::Hash]
1185
+ # Required. The resource being updated
1186
+ # @param request_id [::String]
1187
+ # Optional. An optional request ID to identify requests. Specify a unique
1188
+ # request ID so that if you must retry your request, the server will know to
1189
+ # ignore the request if it has already been completed. The server will
1190
+ # guarantee that for at least 60 minutes since the first request.
1191
+ #
1192
+ # For example, consider a situation where you make an initial request and
1193
+ # the request times out. If you make the request again with the same request
1194
+ # ID, the server can check if original operation with the same request ID
1195
+ # was received, and if so, will ignore the second request. This prevents
1196
+ # clients from accidentally creating duplicate commitments.
1197
+ #
1198
+ # The request ID must be a valid UUID with the exception that zero UUID is
1199
+ # not supported (00000000-0000-0000-0000-000000000000).
1200
+ #
1201
+ # @yield [response, operation] Access the result along with the RPC operation
1202
+ # @yieldparam response [::Gapic::Operation]
1203
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1204
+ #
1205
+ # @return [::Gapic::Operation]
1206
+ #
1207
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1208
+ #
1209
+ # @example Basic example
1210
+ # require "google/cloud/network_security/v1"
1211
+ #
1212
+ # # Create a client object. The client can be reused for multiple calls.
1213
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
1214
+ #
1215
+ # # Create a request. To set request fields, pass in keyword arguments.
1216
+ # request = Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest.new
1217
+ #
1218
+ # # Call the update_project_firewall_endpoint method.
1219
+ # result = client.update_project_firewall_endpoint request
1220
+ #
1221
+ # # The returned object is of type Gapic::Operation. You can use it to
1222
+ # # check the status of an operation, cancel it, or wait for results.
1223
+ # # Here is how to wait for a response.
1224
+ # result.wait_until_done! timeout: 60
1225
+ # if result.response?
1226
+ # p result.response
1227
+ # else
1228
+ # puts "No response received."
1229
+ # end
1230
+ #
1231
+ def update_project_firewall_endpoint request, options = nil
1232
+ raise ::ArgumentError, "request must be provided" if request.nil?
1233
+
1234
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointRequest
1235
+
1236
+ # Converts hash and nil to an options object
1237
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1238
+
1239
+ # Customize the options with defaults
1240
+ metadata = @config.rpcs.update_project_firewall_endpoint.metadata.to_h
1241
+
1242
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1243
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1244
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1245
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1246
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1247
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1248
+
1249
+ header_params = {}
1250
+ if request.firewall_endpoint&.name
1251
+ header_params["firewall_endpoint.name"] = request.firewall_endpoint.name
1252
+ end
1253
+
1254
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1255
+ metadata[:"x-goog-request-params"] ||= request_params_header
1256
+
1257
+ options.apply_defaults timeout: @config.rpcs.update_project_firewall_endpoint.timeout,
1258
+ metadata: metadata,
1259
+ retry_policy: @config.rpcs.update_project_firewall_endpoint.retry_policy
1260
+
1261
+ options.apply_defaults timeout: @config.timeout,
1262
+ metadata: @config.metadata,
1263
+ retry_policy: @config.retry_policy
1264
+
1265
+ @firewall_activation_stub.call_rpc :update_project_firewall_endpoint, request, options: options do |response, operation|
1266
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1267
+ yield response, operation if block_given?
1268
+ throw :response, response
1269
+ end
1270
+ rescue ::GRPC::BadStatus => e
1271
+ raise ::Google::Cloud::Error.from_error(e)
1272
+ end
1273
+
1274
+ ##
1275
+ # Lists Associations in a given project and location.
1276
+ #
1277
+ # @overload list_firewall_endpoint_associations(request, options = nil)
1278
+ # Pass arguments to `list_firewall_endpoint_associations` via a request object, either of type
1279
+ # {::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointAssociationsRequest} or an equivalent Hash.
1280
+ #
1281
+ # @param request [::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointAssociationsRequest, ::Hash]
1282
+ # A request object representing the call parameters. Required. To specify no
1283
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1284
+ # @param options [::Gapic::CallOptions, ::Hash]
1285
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1286
+ #
1287
+ # @overload list_firewall_endpoint_associations(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1288
+ # Pass arguments to `list_firewall_endpoint_associations` via keyword arguments. Note that at
1289
+ # least one keyword argument is required. To specify no parameters, or to keep all
1290
+ # the default parameter values, pass an empty Hash as a request object (see above).
1291
+ #
1292
+ # @param parent [::String]
1293
+ # Required. Parent value for ListAssociationsRequest
1294
+ # @param page_size [::Integer]
1295
+ # Optional. Requested page size. Server may return fewer items than
1296
+ # requested. If unspecified, server will pick an appropriate default.
1297
+ # @param page_token [::String]
1298
+ # A token identifying a page of results the server should return.
1299
+ # @param filter [::String]
1300
+ # Optional. Filtering results
1301
+ # @param order_by [::String]
1302
+ # Hint for how to order the results
1303
+ #
1304
+ # @yield [response, operation] Access the result along with the RPC operation
1305
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation>]
1306
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1307
+ #
1308
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation>]
1309
+ #
1310
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1311
+ #
1312
+ # @example Basic example
1313
+ # require "google/cloud/network_security/v1"
1314
+ #
1315
+ # # Create a client object. The client can be reused for multiple calls.
1316
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
1317
+ #
1318
+ # # Create a request. To set request fields, pass in keyword arguments.
1319
+ # request = Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointAssociationsRequest.new
1320
+ #
1321
+ # # Call the list_firewall_endpoint_associations method.
1322
+ # result = client.list_firewall_endpoint_associations request
1323
+ #
1324
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1325
+ # # over elements, and API calls will be issued to fetch pages as needed.
1326
+ # result.each do |item|
1327
+ # # Each element is of type ::Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation.
1328
+ # p item
1329
+ # end
1330
+ #
1331
+ def list_firewall_endpoint_associations request, options = nil
1332
+ raise ::ArgumentError, "request must be provided" if request.nil?
1333
+
1334
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::ListFirewallEndpointAssociationsRequest
1335
+
1336
+ # Converts hash and nil to an options object
1337
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1338
+
1339
+ # Customize the options with defaults
1340
+ metadata = @config.rpcs.list_firewall_endpoint_associations.metadata.to_h
1341
+
1342
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1343
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1344
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1345
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1346
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1347
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1348
+
1349
+ header_params = {}
1350
+ if request.parent
1351
+ header_params["parent"] = request.parent
1352
+ end
1353
+
1354
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1355
+ metadata[:"x-goog-request-params"] ||= request_params_header
1356
+
1357
+ options.apply_defaults timeout: @config.rpcs.list_firewall_endpoint_associations.timeout,
1358
+ metadata: metadata,
1359
+ retry_policy: @config.rpcs.list_firewall_endpoint_associations.retry_policy
1360
+
1361
+ options.apply_defaults timeout: @config.timeout,
1362
+ metadata: @config.metadata,
1363
+ retry_policy: @config.retry_policy
1364
+
1365
+ @firewall_activation_stub.call_rpc :list_firewall_endpoint_associations, request, options: options do |response, operation|
1366
+ response = ::Gapic::PagedEnumerable.new @firewall_activation_stub, :list_firewall_endpoint_associations, request, response, operation, options
1367
+ yield response, operation if block_given?
1368
+ throw :response, response
1369
+ end
1370
+ rescue ::GRPC::BadStatus => e
1371
+ raise ::Google::Cloud::Error.from_error(e)
1372
+ end
1373
+
1374
+ ##
1375
+ # Gets details of a single FirewallEndpointAssociation.
1376
+ #
1377
+ # @overload get_firewall_endpoint_association(request, options = nil)
1378
+ # Pass arguments to `get_firewall_endpoint_association` via a request object, either of type
1379
+ # {::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointAssociationRequest} or an equivalent Hash.
1380
+ #
1381
+ # @param request [::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointAssociationRequest, ::Hash]
1382
+ # A request object representing the call parameters. Required. To specify no
1383
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1384
+ # @param options [::Gapic::CallOptions, ::Hash]
1385
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1386
+ #
1387
+ # @overload get_firewall_endpoint_association(name: nil)
1388
+ # Pass arguments to `get_firewall_endpoint_association` via keyword arguments. Note that at
1389
+ # least one keyword argument is required. To specify no parameters, or to keep all
1390
+ # the default parameter values, pass an empty Hash as a request object (see above).
1391
+ #
1392
+ # @param name [::String]
1393
+ # Required. Name of the resource
1394
+ #
1395
+ # @yield [response, operation] Access the result along with the RPC operation
1396
+ # @yieldparam response [::Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation]
1397
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1398
+ #
1399
+ # @return [::Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation]
1400
+ #
1401
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1402
+ #
1403
+ # @example Basic example
1404
+ # require "google/cloud/network_security/v1"
1405
+ #
1406
+ # # Create a client object. The client can be reused for multiple calls.
1407
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
1408
+ #
1409
+ # # Create a request. To set request fields, pass in keyword arguments.
1410
+ # request = Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointAssociationRequest.new
1411
+ #
1412
+ # # Call the get_firewall_endpoint_association method.
1413
+ # result = client.get_firewall_endpoint_association request
1414
+ #
1415
+ # # The returned object is of type Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation.
1416
+ # p result
1417
+ #
1418
+ def get_firewall_endpoint_association request, options = nil
1419
+ raise ::ArgumentError, "request must be provided" if request.nil?
1420
+
1421
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::GetFirewallEndpointAssociationRequest
1422
+
1423
+ # Converts hash and nil to an options object
1424
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1425
+
1426
+ # Customize the options with defaults
1427
+ metadata = @config.rpcs.get_firewall_endpoint_association.metadata.to_h
1428
+
1429
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1430
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1431
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1432
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1433
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1434
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1435
+
1436
+ header_params = {}
1437
+ if request.name
1438
+ header_params["name"] = request.name
1439
+ end
1440
+
1441
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1442
+ metadata[:"x-goog-request-params"] ||= request_params_header
1443
+
1444
+ options.apply_defaults timeout: @config.rpcs.get_firewall_endpoint_association.timeout,
1445
+ metadata: metadata,
1446
+ retry_policy: @config.rpcs.get_firewall_endpoint_association.retry_policy
1447
+
1448
+ options.apply_defaults timeout: @config.timeout,
1449
+ metadata: @config.metadata,
1450
+ retry_policy: @config.retry_policy
1451
+
1452
+ @firewall_activation_stub.call_rpc :get_firewall_endpoint_association, request, options: options do |response, operation|
1453
+ yield response, operation if block_given?
1454
+ end
1455
+ rescue ::GRPC::BadStatus => e
1456
+ raise ::Google::Cloud::Error.from_error(e)
1457
+ end
1458
+
1459
+ ##
1460
+ # Creates a new FirewallEndpointAssociation in a given project and location.
1461
+ #
1462
+ # @overload create_firewall_endpoint_association(request, options = nil)
1463
+ # Pass arguments to `create_firewall_endpoint_association` via a request object, either of type
1464
+ # {::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointAssociationRequest} or an equivalent Hash.
1465
+ #
1466
+ # @param request [::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointAssociationRequest, ::Hash]
1467
+ # A request object representing the call parameters. Required. To specify no
1468
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1469
+ # @param options [::Gapic::CallOptions, ::Hash]
1470
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1471
+ #
1472
+ # @overload create_firewall_endpoint_association(parent: nil, firewall_endpoint_association_id: nil, firewall_endpoint_association: nil, request_id: nil)
1473
+ # Pass arguments to `create_firewall_endpoint_association` via keyword arguments. Note that at
1474
+ # least one keyword argument is required. To specify no parameters, or to keep all
1475
+ # the default parameter values, pass an empty Hash as a request object (see above).
1476
+ #
1477
+ # @param parent [::String]
1478
+ # Required. Value for parent.
1479
+ # @param firewall_endpoint_association_id [::String]
1480
+ # Optional. Id of the requesting object.
1481
+ # If auto-generating Id server-side, remove this field and
1482
+ # firewall_endpoint_association_id from the method_signature of Create RPC.
1483
+ # @param firewall_endpoint_association [::Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation, ::Hash]
1484
+ # Required. The resource being created
1485
+ # @param request_id [::String]
1486
+ # Optional. An optional request ID to identify requests. Specify a unique
1487
+ # request ID so that if you must retry your request, the server will know to
1488
+ # ignore the request if it has already been completed. The server will
1489
+ # guarantee that for at least 60 minutes since the first request.
1490
+ #
1491
+ # For example, consider a situation where you make an initial request and
1492
+ # the request times out. If you make the request again with the same request
1493
+ # ID, the server can check if original operation with the same request ID
1494
+ # was received, and if so, will ignore the second request. This prevents
1495
+ # clients from accidentally creating duplicate commitments.
1496
+ #
1497
+ # The request ID must be a valid UUID with the exception that zero UUID is
1498
+ # not supported (00000000-0000-0000-0000-000000000000).
1499
+ #
1500
+ # @yield [response, operation] Access the result along with the RPC operation
1501
+ # @yieldparam response [::Gapic::Operation]
1502
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1503
+ #
1504
+ # @return [::Gapic::Operation]
1505
+ #
1506
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1507
+ #
1508
+ # @example Basic example
1509
+ # require "google/cloud/network_security/v1"
1510
+ #
1511
+ # # Create a client object. The client can be reused for multiple calls.
1512
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
1513
+ #
1514
+ # # Create a request. To set request fields, pass in keyword arguments.
1515
+ # request = Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointAssociationRequest.new
1516
+ #
1517
+ # # Call the create_firewall_endpoint_association method.
1518
+ # result = client.create_firewall_endpoint_association request
1519
+ #
1520
+ # # The returned object is of type Gapic::Operation. You can use it to
1521
+ # # check the status of an operation, cancel it, or wait for results.
1522
+ # # Here is how to wait for a response.
1523
+ # result.wait_until_done! timeout: 60
1524
+ # if result.response?
1525
+ # p result.response
1526
+ # else
1527
+ # puts "No response received."
1528
+ # end
1529
+ #
1530
+ def create_firewall_endpoint_association request, options = nil
1531
+ raise ::ArgumentError, "request must be provided" if request.nil?
1532
+
1533
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::CreateFirewallEndpointAssociationRequest
1534
+
1535
+ # Converts hash and nil to an options object
1536
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1537
+
1538
+ # Customize the options with defaults
1539
+ metadata = @config.rpcs.create_firewall_endpoint_association.metadata.to_h
1540
+
1541
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1542
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1543
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1544
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1545
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1546
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1547
+
1548
+ header_params = {}
1549
+ if request.parent
1550
+ header_params["parent"] = request.parent
1551
+ end
1552
+
1553
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1554
+ metadata[:"x-goog-request-params"] ||= request_params_header
1555
+
1556
+ options.apply_defaults timeout: @config.rpcs.create_firewall_endpoint_association.timeout,
1557
+ metadata: metadata,
1558
+ retry_policy: @config.rpcs.create_firewall_endpoint_association.retry_policy
1559
+
1560
+ options.apply_defaults timeout: @config.timeout,
1561
+ metadata: @config.metadata,
1562
+ retry_policy: @config.retry_policy
1563
+
1564
+ @firewall_activation_stub.call_rpc :create_firewall_endpoint_association, request, options: options do |response, operation|
1565
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1566
+ yield response, operation if block_given?
1567
+ throw :response, response
1568
+ end
1569
+ rescue ::GRPC::BadStatus => e
1570
+ raise ::Google::Cloud::Error.from_error(e)
1571
+ end
1572
+
1573
+ ##
1574
+ # Deletes a single FirewallEndpointAssociation.
1575
+ #
1576
+ # @overload delete_firewall_endpoint_association(request, options = nil)
1577
+ # Pass arguments to `delete_firewall_endpoint_association` via a request object, either of type
1578
+ # {::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointAssociationRequest} or an equivalent Hash.
1579
+ #
1580
+ # @param request [::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointAssociationRequest, ::Hash]
1581
+ # A request object representing the call parameters. Required. To specify no
1582
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1583
+ # @param options [::Gapic::CallOptions, ::Hash]
1584
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1585
+ #
1586
+ # @overload delete_firewall_endpoint_association(name: nil, request_id: nil)
1587
+ # Pass arguments to `delete_firewall_endpoint_association` via keyword arguments. Note that at
1588
+ # least one keyword argument is required. To specify no parameters, or to keep all
1589
+ # the default parameter values, pass an empty Hash as a request object (see above).
1590
+ #
1591
+ # @param name [::String]
1592
+ # Required. Name of the resource
1593
+ # @param request_id [::String]
1594
+ # Optional. An optional request ID to identify requests. Specify a unique
1595
+ # request ID so that if you must retry your request, the server will know to
1596
+ # ignore the request if it has already been completed. The server will
1597
+ # guarantee that for at least 60 minutes after the first request.
1598
+ #
1599
+ # For example, consider a situation where you make an initial request and
1600
+ # the request times out. If you make the request again with the same request
1601
+ # ID, the server can check if original operation with the same request ID
1602
+ # was received, and if so, will ignore the second request. This prevents
1603
+ # clients from accidentally creating duplicate commitments.
1604
+ #
1605
+ # The request ID must be a valid UUID with the exception that zero UUID is
1606
+ # not supported (00000000-0000-0000-0000-000000000000).
1607
+ #
1608
+ # @yield [response, operation] Access the result along with the RPC operation
1609
+ # @yieldparam response [::Gapic::Operation]
1610
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1611
+ #
1612
+ # @return [::Gapic::Operation]
1613
+ #
1614
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1615
+ #
1616
+ # @example Basic example
1617
+ # require "google/cloud/network_security/v1"
1618
+ #
1619
+ # # Create a client object. The client can be reused for multiple calls.
1620
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
1621
+ #
1622
+ # # Create a request. To set request fields, pass in keyword arguments.
1623
+ # request = Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointAssociationRequest.new
1624
+ #
1625
+ # # Call the delete_firewall_endpoint_association method.
1626
+ # result = client.delete_firewall_endpoint_association request
1627
+ #
1628
+ # # The returned object is of type Gapic::Operation. You can use it to
1629
+ # # check the status of an operation, cancel it, or wait for results.
1630
+ # # Here is how to wait for a response.
1631
+ # result.wait_until_done! timeout: 60
1632
+ # if result.response?
1633
+ # p result.response
1634
+ # else
1635
+ # puts "No response received."
1636
+ # end
1637
+ #
1638
+ def delete_firewall_endpoint_association request, options = nil
1639
+ raise ::ArgumentError, "request must be provided" if request.nil?
1640
+
1641
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::DeleteFirewallEndpointAssociationRequest
1642
+
1643
+ # Converts hash and nil to an options object
1644
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1645
+
1646
+ # Customize the options with defaults
1647
+ metadata = @config.rpcs.delete_firewall_endpoint_association.metadata.to_h
1648
+
1649
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1650
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1651
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1652
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1653
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1654
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1655
+
1656
+ header_params = {}
1657
+ if request.name
1658
+ header_params["name"] = request.name
1659
+ end
1660
+
1661
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1662
+ metadata[:"x-goog-request-params"] ||= request_params_header
1663
+
1664
+ options.apply_defaults timeout: @config.rpcs.delete_firewall_endpoint_association.timeout,
1665
+ metadata: metadata,
1666
+ retry_policy: @config.rpcs.delete_firewall_endpoint_association.retry_policy
1667
+
1668
+ options.apply_defaults timeout: @config.timeout,
1669
+ metadata: @config.metadata,
1670
+ retry_policy: @config.retry_policy
1671
+
1672
+ @firewall_activation_stub.call_rpc :delete_firewall_endpoint_association, request, options: options do |response, operation|
1673
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1674
+ yield response, operation if block_given?
1675
+ throw :response, response
1676
+ end
1677
+ rescue ::GRPC::BadStatus => e
1678
+ raise ::Google::Cloud::Error.from_error(e)
1679
+ end
1680
+
1681
+ ##
1682
+ # Update a single FirewallEndpointAssociation.
1683
+ #
1684
+ # @overload update_firewall_endpoint_association(request, options = nil)
1685
+ # Pass arguments to `update_firewall_endpoint_association` via a request object, either of type
1686
+ # {::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointAssociationRequest} or an equivalent Hash.
1687
+ #
1688
+ # @param request [::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointAssociationRequest, ::Hash]
1689
+ # A request object representing the call parameters. Required. To specify no
1690
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1691
+ # @param options [::Gapic::CallOptions, ::Hash]
1692
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1693
+ #
1694
+ # @overload update_firewall_endpoint_association(update_mask: nil, firewall_endpoint_association: nil, request_id: nil)
1695
+ # Pass arguments to `update_firewall_endpoint_association` via keyword arguments. Note that at
1696
+ # least one keyword argument is required. To specify no parameters, or to keep all
1697
+ # the default parameter values, pass an empty Hash as a request object (see above).
1698
+ #
1699
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1700
+ # Required. Field mask is used to specify the fields to be overwritten in the
1701
+ # Association resource by the update.
1702
+ # The fields specified in the update_mask are relative to the resource, not
1703
+ # the full request. A field will be overwritten if it is in the mask. If the
1704
+ # user does not provide a mask then all fields will be overwritten.
1705
+ # @param firewall_endpoint_association [::Google::Cloud::NetworkSecurity::V1::FirewallEndpointAssociation, ::Hash]
1706
+ # Required. The resource being updated
1707
+ # @param request_id [::String]
1708
+ # Optional. An optional request ID to identify requests. Specify a unique
1709
+ # request ID so that if you must retry your request, the server will know to
1710
+ # ignore the request if it has already been completed. The server will
1711
+ # guarantee that for at least 60 minutes since the first request.
1712
+ #
1713
+ # For example, consider a situation where you make an initial request and
1714
+ # the request times out. If you make the request again with the same request
1715
+ # ID, the server can check if original operation with the same request ID
1716
+ # was received, and if so, will ignore the second request. This prevents
1717
+ # clients from accidentally creating duplicate commitments.
1718
+ #
1719
+ # The request ID must be a valid UUID with the exception that zero UUID is
1720
+ # not supported (00000000-0000-0000-0000-000000000000).
1721
+ #
1722
+ # @yield [response, operation] Access the result along with the RPC operation
1723
+ # @yieldparam response [::Gapic::Operation]
1724
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1725
+ #
1726
+ # @return [::Gapic::Operation]
1727
+ #
1728
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1729
+ #
1730
+ # @example Basic example
1731
+ # require "google/cloud/network_security/v1"
1732
+ #
1733
+ # # Create a client object. The client can be reused for multiple calls.
1734
+ # client = Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new
1735
+ #
1736
+ # # Create a request. To set request fields, pass in keyword arguments.
1737
+ # request = Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointAssociationRequest.new
1738
+ #
1739
+ # # Call the update_firewall_endpoint_association method.
1740
+ # result = client.update_firewall_endpoint_association request
1741
+ #
1742
+ # # The returned object is of type Gapic::Operation. You can use it to
1743
+ # # check the status of an operation, cancel it, or wait for results.
1744
+ # # Here is how to wait for a response.
1745
+ # result.wait_until_done! timeout: 60
1746
+ # if result.response?
1747
+ # p result.response
1748
+ # else
1749
+ # puts "No response received."
1750
+ # end
1751
+ #
1752
+ def update_firewall_endpoint_association request, options = nil
1753
+ raise ::ArgumentError, "request must be provided" if request.nil?
1754
+
1755
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkSecurity::V1::UpdateFirewallEndpointAssociationRequest
1756
+
1757
+ # Converts hash and nil to an options object
1758
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1759
+
1760
+ # Customize the options with defaults
1761
+ metadata = @config.rpcs.update_firewall_endpoint_association.metadata.to_h
1762
+
1763
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1764
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1765
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1766
+ gapic_version: ::Google::Cloud::NetworkSecurity::V1::VERSION
1767
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1768
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1769
+
1770
+ header_params = {}
1771
+ if request.firewall_endpoint_association&.name
1772
+ header_params["firewall_endpoint_association.name"] = request.firewall_endpoint_association.name
1773
+ end
1774
+
1775
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1776
+ metadata[:"x-goog-request-params"] ||= request_params_header
1777
+
1778
+ options.apply_defaults timeout: @config.rpcs.update_firewall_endpoint_association.timeout,
1779
+ metadata: metadata,
1780
+ retry_policy: @config.rpcs.update_firewall_endpoint_association.retry_policy
1781
+
1782
+ options.apply_defaults timeout: @config.timeout,
1783
+ metadata: @config.metadata,
1784
+ retry_policy: @config.retry_policy
1785
+
1786
+ @firewall_activation_stub.call_rpc :update_firewall_endpoint_association, request, options: options do |response, operation|
1787
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1788
+ yield response, operation if block_given?
1789
+ throw :response, response
1790
+ end
1791
+ rescue ::GRPC::BadStatus => e
1792
+ raise ::Google::Cloud::Error.from_error(e)
1793
+ end
1794
+
1795
+ ##
1796
+ # Configuration class for the FirewallActivation API.
1797
+ #
1798
+ # This class represents the configuration for FirewallActivation,
1799
+ # providing control over timeouts, retry behavior, logging, transport
1800
+ # parameters, and other low-level controls. Certain parameters can also be
1801
+ # applied individually to specific RPCs. See
1802
+ # {::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client::Configuration::Rpcs}
1803
+ # for a list of RPCs that can be configured independently.
1804
+ #
1805
+ # Configuration can be applied globally to all clients, or to a single client
1806
+ # on construction.
1807
+ #
1808
+ # @example
1809
+ #
1810
+ # # Modify the global config, setting the timeout for
1811
+ # # list_firewall_endpoints to 20 seconds,
1812
+ # # and all remaining timeouts to 10 seconds.
1813
+ # ::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.configure do |config|
1814
+ # config.timeout = 10.0
1815
+ # config.rpcs.list_firewall_endpoints.timeout = 20.0
1816
+ # end
1817
+ #
1818
+ # # Apply the above configuration only to a new client.
1819
+ # client = ::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new do |config|
1820
+ # config.timeout = 10.0
1821
+ # config.rpcs.list_firewall_endpoints.timeout = 20.0
1822
+ # end
1823
+ #
1824
+ # @!attribute [rw] endpoint
1825
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1826
+ # nil, indicating to use the default endpoint in the current universe domain.
1827
+ # @return [::String,nil]
1828
+ # @!attribute [rw] credentials
1829
+ # Credentials to send with calls. You may provide any of the following types:
1830
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
1831
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1832
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1833
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1834
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1835
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1836
+ # * (`nil`) indicating no credentials
1837
+ #
1838
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
1839
+ # is deprecated. Providing an unvalidated credential configuration to
1840
+ # Google APIs can compromise the security of your systems and data.
1841
+ #
1842
+ # @example
1843
+ #
1844
+ # # The recommended way to provide credentials is to use the `make_creds` method
1845
+ # # on the appropriate credentials class for your environment.
1846
+ #
1847
+ # require "googleauth"
1848
+ #
1849
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
1850
+ # json_key_io: ::File.open("/path/to/keyfile.json")
1851
+ # )
1852
+ #
1853
+ # client = ::Google::Cloud::NetworkSecurity::V1::FirewallActivation::Client.new do |config|
1854
+ # config.credentials = credentials
1855
+ # end
1856
+ #
1857
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
1858
+ # external source for authentication to Google Cloud, you must validate it before
1859
+ # providing it to a Google API client library. Providing an unvalidated credential
1860
+ # configuration to Google APIs can compromise the security of your systems and data.
1861
+ # For more information, refer to [Validate credential configurations from external
1862
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1863
+ # @return [::Object]
1864
+ # @!attribute [rw] scope
1865
+ # The OAuth scopes
1866
+ # @return [::Array<::String>]
1867
+ # @!attribute [rw] lib_name
1868
+ # The library name as recorded in instrumentation and logging
1869
+ # @return [::String]
1870
+ # @!attribute [rw] lib_version
1871
+ # The library version as recorded in instrumentation and logging
1872
+ # @return [::String]
1873
+ # @!attribute [rw] channel_args
1874
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
1875
+ # `GRPC::Core::Channel` object is provided as the credential.
1876
+ # @return [::Hash]
1877
+ # @!attribute [rw] interceptors
1878
+ # An array of interceptors that are run before calls are executed.
1879
+ # @return [::Array<::GRPC::ClientInterceptor>]
1880
+ # @!attribute [rw] timeout
1881
+ # The call timeout in seconds.
1882
+ # @return [::Numeric]
1883
+ # @!attribute [rw] metadata
1884
+ # Additional gRPC headers to be sent with the call.
1885
+ # @return [::Hash{::Symbol=>::String}]
1886
+ # @!attribute [rw] retry_policy
1887
+ # The retry policy. The value is a hash with the following keys:
1888
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1889
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1890
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1891
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1892
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1893
+ # trigger a retry.
1894
+ # @return [::Hash]
1895
+ # @!attribute [rw] quota_project
1896
+ # A separate project against which to charge quota.
1897
+ # @return [::String]
1898
+ # @!attribute [rw] universe_domain
1899
+ # The universe domain within which to make requests. This determines the
1900
+ # default endpoint URL. The default value of nil uses the environment
1901
+ # universe (usually the default "googleapis.com" universe).
1902
+ # @return [::String,nil]
1903
+ # @!attribute [rw] logger
1904
+ # A custom logger to use for request/response debug logging, or the value
1905
+ # `:default` (the default) to construct a default logger, or `nil` to
1906
+ # explicitly disable logging.
1907
+ # @return [::Logger,:default,nil]
1908
+ #
1909
+ class Configuration
1910
+ extend ::Gapic::Config
1911
+
1912
+ # @private
1913
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1914
+ DEFAULT_ENDPOINT = "networksecurity.googleapis.com"
1915
+
1916
+ config_attr :endpoint, nil, ::String, nil
1917
+ config_attr :credentials, nil do |value|
1918
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
1919
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC::Core::Channel
1920
+ allowed.any? { |klass| klass === value }
1921
+ end
1922
+ config_attr :scope, nil, ::String, ::Array, nil
1923
+ config_attr :lib_name, nil, ::String, nil
1924
+ config_attr :lib_version, nil, ::String, nil
1925
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
1926
+ config_attr :interceptors, nil, ::Array, nil
1927
+ config_attr :timeout, nil, ::Numeric, nil
1928
+ config_attr :metadata, nil, ::Hash, nil
1929
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1930
+ config_attr :quota_project, nil, ::String, nil
1931
+ config_attr :universe_domain, nil, ::String, nil
1932
+ config_attr :logger, :default, ::Logger, nil, :default
1933
+
1934
+ # @private
1935
+ def initialize parent_config = nil
1936
+ @parent_config = parent_config unless parent_config.nil?
1937
+
1938
+ yield self if block_given?
1939
+ end
1940
+
1941
+ ##
1942
+ # Configurations for individual RPCs
1943
+ # @return [Rpcs]
1944
+ #
1945
+ def rpcs
1946
+ @rpcs ||= begin
1947
+ parent_rpcs = nil
1948
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
1949
+ Rpcs.new parent_rpcs
1950
+ end
1951
+ end
1952
+
1953
+ ##
1954
+ # Configuration for the channel pool
1955
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
1956
+ #
1957
+ def channel_pool
1958
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
1959
+ end
1960
+
1961
+ ##
1962
+ # Configuration RPC class for the FirewallActivation API.
1963
+ #
1964
+ # Includes fields providing the configuration for each RPC in this service.
1965
+ # Each configuration object is of type `Gapic::Config::Method` and includes
1966
+ # the following configuration fields:
1967
+ #
1968
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
1969
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
1970
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
1971
+ # include the following keys:
1972
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1973
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1974
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1975
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1976
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1977
+ # trigger a retry.
1978
+ #
1979
+ class Rpcs
1980
+ ##
1981
+ # RPC-specific configuration for `list_firewall_endpoints`
1982
+ # @return [::Gapic::Config::Method]
1983
+ #
1984
+ attr_reader :list_firewall_endpoints
1985
+ ##
1986
+ # RPC-specific configuration for `list_project_firewall_endpoints`
1987
+ # @return [::Gapic::Config::Method]
1988
+ #
1989
+ attr_reader :list_project_firewall_endpoints
1990
+ ##
1991
+ # RPC-specific configuration for `get_firewall_endpoint`
1992
+ # @return [::Gapic::Config::Method]
1993
+ #
1994
+ attr_reader :get_firewall_endpoint
1995
+ ##
1996
+ # RPC-specific configuration for `get_project_firewall_endpoint`
1997
+ # @return [::Gapic::Config::Method]
1998
+ #
1999
+ attr_reader :get_project_firewall_endpoint
2000
+ ##
2001
+ # RPC-specific configuration for `create_firewall_endpoint`
2002
+ # @return [::Gapic::Config::Method]
2003
+ #
2004
+ attr_reader :create_firewall_endpoint
2005
+ ##
2006
+ # RPC-specific configuration for `create_project_firewall_endpoint`
2007
+ # @return [::Gapic::Config::Method]
2008
+ #
2009
+ attr_reader :create_project_firewall_endpoint
2010
+ ##
2011
+ # RPC-specific configuration for `delete_firewall_endpoint`
2012
+ # @return [::Gapic::Config::Method]
2013
+ #
2014
+ attr_reader :delete_firewall_endpoint
2015
+ ##
2016
+ # RPC-specific configuration for `delete_project_firewall_endpoint`
2017
+ # @return [::Gapic::Config::Method]
2018
+ #
2019
+ attr_reader :delete_project_firewall_endpoint
2020
+ ##
2021
+ # RPC-specific configuration for `update_firewall_endpoint`
2022
+ # @return [::Gapic::Config::Method]
2023
+ #
2024
+ attr_reader :update_firewall_endpoint
2025
+ ##
2026
+ # RPC-specific configuration for `update_project_firewall_endpoint`
2027
+ # @return [::Gapic::Config::Method]
2028
+ #
2029
+ attr_reader :update_project_firewall_endpoint
2030
+ ##
2031
+ # RPC-specific configuration for `list_firewall_endpoint_associations`
2032
+ # @return [::Gapic::Config::Method]
2033
+ #
2034
+ attr_reader :list_firewall_endpoint_associations
2035
+ ##
2036
+ # RPC-specific configuration for `get_firewall_endpoint_association`
2037
+ # @return [::Gapic::Config::Method]
2038
+ #
2039
+ attr_reader :get_firewall_endpoint_association
2040
+ ##
2041
+ # RPC-specific configuration for `create_firewall_endpoint_association`
2042
+ # @return [::Gapic::Config::Method]
2043
+ #
2044
+ attr_reader :create_firewall_endpoint_association
2045
+ ##
2046
+ # RPC-specific configuration for `delete_firewall_endpoint_association`
2047
+ # @return [::Gapic::Config::Method]
2048
+ #
2049
+ attr_reader :delete_firewall_endpoint_association
2050
+ ##
2051
+ # RPC-specific configuration for `update_firewall_endpoint_association`
2052
+ # @return [::Gapic::Config::Method]
2053
+ #
2054
+ attr_reader :update_firewall_endpoint_association
2055
+
2056
+ # @private
2057
+ def initialize parent_rpcs = nil
2058
+ list_firewall_endpoints_config = parent_rpcs.list_firewall_endpoints if parent_rpcs.respond_to? :list_firewall_endpoints
2059
+ @list_firewall_endpoints = ::Gapic::Config::Method.new list_firewall_endpoints_config
2060
+ list_project_firewall_endpoints_config = parent_rpcs.list_project_firewall_endpoints if parent_rpcs.respond_to? :list_project_firewall_endpoints
2061
+ @list_project_firewall_endpoints = ::Gapic::Config::Method.new list_project_firewall_endpoints_config
2062
+ get_firewall_endpoint_config = parent_rpcs.get_firewall_endpoint if parent_rpcs.respond_to? :get_firewall_endpoint
2063
+ @get_firewall_endpoint = ::Gapic::Config::Method.new get_firewall_endpoint_config
2064
+ get_project_firewall_endpoint_config = parent_rpcs.get_project_firewall_endpoint if parent_rpcs.respond_to? :get_project_firewall_endpoint
2065
+ @get_project_firewall_endpoint = ::Gapic::Config::Method.new get_project_firewall_endpoint_config
2066
+ create_firewall_endpoint_config = parent_rpcs.create_firewall_endpoint if parent_rpcs.respond_to? :create_firewall_endpoint
2067
+ @create_firewall_endpoint = ::Gapic::Config::Method.new create_firewall_endpoint_config
2068
+ create_project_firewall_endpoint_config = parent_rpcs.create_project_firewall_endpoint if parent_rpcs.respond_to? :create_project_firewall_endpoint
2069
+ @create_project_firewall_endpoint = ::Gapic::Config::Method.new create_project_firewall_endpoint_config
2070
+ delete_firewall_endpoint_config = parent_rpcs.delete_firewall_endpoint if parent_rpcs.respond_to? :delete_firewall_endpoint
2071
+ @delete_firewall_endpoint = ::Gapic::Config::Method.new delete_firewall_endpoint_config
2072
+ delete_project_firewall_endpoint_config = parent_rpcs.delete_project_firewall_endpoint if parent_rpcs.respond_to? :delete_project_firewall_endpoint
2073
+ @delete_project_firewall_endpoint = ::Gapic::Config::Method.new delete_project_firewall_endpoint_config
2074
+ update_firewall_endpoint_config = parent_rpcs.update_firewall_endpoint if parent_rpcs.respond_to? :update_firewall_endpoint
2075
+ @update_firewall_endpoint = ::Gapic::Config::Method.new update_firewall_endpoint_config
2076
+ update_project_firewall_endpoint_config = parent_rpcs.update_project_firewall_endpoint if parent_rpcs.respond_to? :update_project_firewall_endpoint
2077
+ @update_project_firewall_endpoint = ::Gapic::Config::Method.new update_project_firewall_endpoint_config
2078
+ list_firewall_endpoint_associations_config = parent_rpcs.list_firewall_endpoint_associations if parent_rpcs.respond_to? :list_firewall_endpoint_associations
2079
+ @list_firewall_endpoint_associations = ::Gapic::Config::Method.new list_firewall_endpoint_associations_config
2080
+ get_firewall_endpoint_association_config = parent_rpcs.get_firewall_endpoint_association if parent_rpcs.respond_to? :get_firewall_endpoint_association
2081
+ @get_firewall_endpoint_association = ::Gapic::Config::Method.new get_firewall_endpoint_association_config
2082
+ create_firewall_endpoint_association_config = parent_rpcs.create_firewall_endpoint_association if parent_rpcs.respond_to? :create_firewall_endpoint_association
2083
+ @create_firewall_endpoint_association = ::Gapic::Config::Method.new create_firewall_endpoint_association_config
2084
+ delete_firewall_endpoint_association_config = parent_rpcs.delete_firewall_endpoint_association if parent_rpcs.respond_to? :delete_firewall_endpoint_association
2085
+ @delete_firewall_endpoint_association = ::Gapic::Config::Method.new delete_firewall_endpoint_association_config
2086
+ update_firewall_endpoint_association_config = parent_rpcs.update_firewall_endpoint_association if parent_rpcs.respond_to? :update_firewall_endpoint_association
2087
+ @update_firewall_endpoint_association = ::Gapic::Config::Method.new update_firewall_endpoint_association_config
2088
+
2089
+ yield self if block_given?
2090
+ end
2091
+ end
2092
+ end
2093
+ end
2094
+ end
2095
+ end
2096
+ end
2097
+ end
2098
+ end