google-cloud-app_engine-v1 0.3.0 → 0.3.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (36) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +8 -8
  3. data/README.md +1 -1
  4. data/lib/google/appengine/v1/app_yaml_pb.rb +2 -2
  5. data/lib/google/appengine/v1/appengine_pb.rb +2 -2
  6. data/lib/google/appengine/v1/appengine_services_pb.rb +8 -8
  7. data/lib/google/appengine/v1/application_pb.rb +2 -2
  8. data/lib/google/appengine/v1/audit_data_pb.rb +2 -2
  9. data/lib/google/appengine/v1/certificate_pb.rb +2 -2
  10. data/lib/google/appengine/v1/deploy_pb.rb +2 -2
  11. data/lib/google/appengine/v1/deployed_files_pb.rb +1 -1
  12. data/lib/google/appengine/v1/domain_mapping_pb.rb +1 -1
  13. data/lib/google/appengine/v1/domain_pb.rb +1 -1
  14. data/lib/google/appengine/v1/firewall_pb.rb +1 -1
  15. data/lib/google/appengine/v1/instance_pb.rb +2 -2
  16. data/lib/google/appengine/v1/location_pb.rb +2 -2
  17. data/lib/google/appengine/v1/network_settings_pb.rb +1 -1
  18. data/lib/google/appengine/v1/operation_pb.rb +2 -2
  19. data/lib/google/appengine/v1/service_pb.rb +2 -2
  20. data/lib/google/appengine/v1/version_pb.rb +2 -2
  21. data/lib/google/cloud/app_engine/v1/applications/client.rb +138 -50
  22. data/lib/google/cloud/app_engine/v1/applications/operations.rb +149 -37
  23. data/lib/google/cloud/app_engine/v1/authorized_certificates/client.rb +151 -57
  24. data/lib/google/cloud/app_engine/v1/authorized_domains/client.rb +59 -41
  25. data/lib/google/cloud/app_engine/v1/domain_mappings/client.rb +172 -57
  26. data/lib/google/cloud/app_engine/v1/domain_mappings/operations.rb +149 -37
  27. data/lib/google/cloud/app_engine/v1/firewall/client.rb +174 -61
  28. data/lib/google/cloud/app_engine/v1/instances/client.rb +142 -53
  29. data/lib/google/cloud/app_engine/v1/instances/operations.rb +149 -37
  30. data/lib/google/cloud/app_engine/v1/services/client.rb +142 -53
  31. data/lib/google/cloud/app_engine/v1/services/operations.rb +149 -37
  32. data/lib/google/cloud/app_engine/v1/version.rb +1 -1
  33. data/lib/google/cloud/app_engine/v1/versions/client.rb +172 -57
  34. data/lib/google/cloud/app_engine/v1/versions/operations.rb +149 -37
  35. data/proto_docs/google/api/field_behavior.rb +7 -1
  36. metadata +13 -7
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 2a2a6cb328aaac1e6b4ea230fff89522ef010f2e2735368da3cc04083e137907
4
- data.tar.gz: a8c8d9d71293890ae2acf49842d5ea200f97d20903df3979a5f44698b49b33f9
3
+ metadata.gz: d8218681be9f825cd2d29ee40e92fce8f0517118f416d8b90c1ddf53d9538c92
4
+ data.tar.gz: 35037a1ccee5c76cfea2606670b7bba8fff1d8467b7d307a6e1cf11e0acf998e
5
5
  SHA512:
6
- metadata.gz: 8b3ac914016d41c5481b18aebd6274b9669aede41a184c394a14334d84d9539aa70bd93db081b9854738eaaf3ba8e6cd5d45166f2e6cb6a286055a1adfaa6dd0
7
- data.tar.gz: e838179461b954c28d138d73437357ec9efbd02ed0b0faa6e03691450c66954a75d49ff0ddc0699ebc67d9c202432b392db23ca6e7e9c95f0a27b69d8f868797
6
+ metadata.gz: 2ec3ef56426903d69f7f5e8cdcabb344c931e82f6e09be441bd102247a6e9b57509aed773485dc404bafc9ffdeba41f11545ab9abace894b0d0b9b64dcf5ed44
7
+ data.tar.gz: c1a3f559079eade0cb2eba23f08e43d619f79751f8549dc4ac4775d297bef3bfb42981beb00c69bb0c749a8e5c184c4ca462dbaffed5c17f7a83f7793adfaea5
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-app_engine-v1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  {::Google::Cloud::AppEngine::V1::Applications::Credentials}):
68
68
 
69
- 1. `APP_ENGINE_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `APP_ENGINE_KEYFILE` - Path to JSON file, or JSON contents
71
- 3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- 4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- 5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
69
+ * `APP_ENGINE_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `APP_ENGINE_KEYFILE` - Path to JSON file, or JSON contents
71
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
+ * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
74
 
75
75
  ```ruby
76
76
  require "google/cloud/app_engine/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
82
82
 
83
83
  ### Configuration
84
84
 
85
- The **Credentials JSON** can be configured instead of placing them in
86
- environment variables. Either on an individual client initialization:
85
+ The path to the **Credentials JSON** file can be configured instead of storing
86
+ it in an environment variable. Either on an individual client initialization:
87
87
 
88
88
  ```ruby
89
89
  require "google/cloud/app_engine/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
93
93
  end
94
94
  ```
95
95
 
96
- Or configured globally for all clients:
96
+ Or globally for all clients:
97
97
 
98
98
  ```ruby
99
99
  require "google/cloud/app_engine/v1"
data/README.md CHANGED
@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
33
33
  require "google/cloud/app_engine/v1"
34
34
 
35
35
  client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
36
- request = my_create_request
36
+ request = ::Google::Cloud::AppEngine::V1::GetApplicationRequest.new # (request fields as keyword arguments...)
37
37
  response = client.get_application request
38
38
  ```
39
39
 
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/app_yaml.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/protobuf/duration_pb'
7
5
  require 'google/api/annotations_pb'
6
+ require 'google/protobuf'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/appengine/v1/app_yaml.proto", :syntax => :proto3) do
10
10
  add_message "google.appengine.v1.ApiConfigHandler" do
@@ -1,8 +1,6 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/appengine.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/appengine/v1/application_pb'
7
5
  require 'google/appengine/v1/certificate_pb'
8
6
  require 'google/appengine/v1/domain_pb'
@@ -16,6 +14,8 @@ require 'google/longrunning/operations_pb'
16
14
  require 'google/protobuf/empty_pb'
17
15
  require 'google/protobuf/field_mask_pb'
18
16
  require 'google/api/client_pb'
17
+ require 'google/protobuf'
18
+
19
19
  Google::Protobuf::DescriptorPool.generated_pool.build do
20
20
  add_file("google/appengine/v1/appengine.proto", :syntax => :proto3) do
21
21
  add_message "google.appengine.v1.GetApplicationRequest" do
@@ -27,7 +27,7 @@ module Google
27
27
  # Manages App Engine applications.
28
28
  class Service
29
29
 
30
- include GRPC::GenericService
30
+ include ::GRPC::GenericService
31
31
 
32
32
  self.marshal_class_method = :encode
33
33
  self.unmarshal_class_method = :decode
@@ -68,7 +68,7 @@ module Google
68
68
  # Manages services of an application.
69
69
  class Service
70
70
 
71
- include GRPC::GenericService
71
+ include ::GRPC::GenericService
72
72
 
73
73
  self.marshal_class_method = :encode
74
74
  self.unmarshal_class_method = :decode
@@ -90,7 +90,7 @@ module Google
90
90
  # Manages versions of a service.
91
91
  class Service
92
92
 
93
- include GRPC::GenericService
93
+ include ::GRPC::GenericService
94
94
 
95
95
  self.marshal_class_method = :encode
96
96
  self.unmarshal_class_method = :decode
@@ -151,7 +151,7 @@ module Google
151
151
  # Manages instances of a version.
152
152
  class Service
153
153
 
154
- include GRPC::GenericService
154
+ include ::GRPC::GenericService
155
155
 
156
156
  self.marshal_class_method = :encode
157
157
  self.unmarshal_class_method = :decode
@@ -203,7 +203,7 @@ module Google
203
203
  # set to "allow" if not otherwise specified by the user.
204
204
  class Service
205
205
 
206
- include GRPC::GenericService
206
+ include ::GRPC::GenericService
207
207
 
208
208
  self.marshal_class_method = :encode
209
209
  self.unmarshal_class_method = :decode
@@ -235,7 +235,7 @@ module Google
235
235
  # [Webmaster Central](https://www.google.com/webmasters/verification/home).
236
236
  class Service
237
237
 
238
- include GRPC::GenericService
238
+ include ::GRPC::GenericService
239
239
 
240
240
  self.marshal_class_method = :encode
241
241
  self.unmarshal_class_method = :decode
@@ -252,7 +252,7 @@ module Google
252
252
  # administer any SSL certificates applicable to their authorized domains.
253
253
  class Service
254
254
 
255
- include GRPC::GenericService
255
+ include ::GRPC::GenericService
256
256
 
257
257
  self.marshal_class_method = :encode
258
258
  self.unmarshal_class_method = :decode
@@ -280,7 +280,7 @@ module Google
280
280
  # Manages domains serving an application.
281
281
  class Service
282
282
 
283
- include GRPC::GenericService
283
+ include ::GRPC::GenericService
284
284
 
285
285
  self.marshal_class_method = :encode
286
286
  self.unmarshal_class_method = :decode
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/application.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/protobuf/duration_pb'
7
5
  require 'google/api/annotations_pb'
6
+ require 'google/protobuf'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/appengine/v1/application.proto", :syntax => :proto3) do
10
10
  add_message "google.appengine.v1.Application" do
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/audit_data.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/appengine/v1/appengine_pb'
7
5
  require 'google/api/annotations_pb'
6
+ require 'google/protobuf'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/appengine/v1/audit_data.proto", :syntax => :proto3) do
10
10
  add_message "google.appengine.v1.AuditData" do
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/certificate.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/protobuf/timestamp_pb'
7
5
  require 'google/api/annotations_pb'
6
+ require 'google/protobuf'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/appengine/v1/certificate.proto", :syntax => :proto3) do
10
10
  add_message "google.appengine.v1.AuthorizedCertificate" do
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/deploy.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/protobuf/duration_pb'
7
5
  require 'google/api/annotations_pb'
6
+ require 'google/protobuf'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/appengine/v1/deploy.proto", :syntax => :proto3) do
10
10
  add_message "google.appengine.v1.Deployment" do
@@ -1,9 +1,9 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/deployed_files.proto
3
3
 
4
+ require 'google/api/annotations_pb'
4
5
  require 'google/protobuf'
5
6
 
6
- require 'google/api/annotations_pb'
7
7
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
8
  add_file("google/appengine/v1/deployed_files.proto", :syntax => :proto3) do
9
9
  end
@@ -1,9 +1,9 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/domain_mapping.proto
3
3
 
4
+ require 'google/api/annotations_pb'
4
5
  require 'google/protobuf'
5
6
 
6
- require 'google/api/annotations_pb'
7
7
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
8
  add_file("google/appengine/v1/domain_mapping.proto", :syntax => :proto3) do
9
9
  add_message "google.appengine.v1.DomainMapping" do
@@ -1,9 +1,9 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/domain.proto
3
3
 
4
+ require 'google/api/annotations_pb'
4
5
  require 'google/protobuf'
5
6
 
6
- require 'google/api/annotations_pb'
7
7
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
8
  add_file("google/appengine/v1/domain.proto", :syntax => :proto3) do
9
9
  add_message "google.appengine.v1.AuthorizedDomain" do
@@ -1,9 +1,9 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/firewall.proto
3
3
 
4
+ require 'google/api/annotations_pb'
4
5
  require 'google/protobuf'
5
6
 
6
- require 'google/api/annotations_pb'
7
7
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
8
  add_file("google/appengine/v1/firewall.proto", :syntax => :proto3) do
9
9
  add_message "google.appengine.v1.FirewallRule" do
@@ -1,12 +1,12 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/instance.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/field_behavior_pb'
7
5
  require 'google/api/resource_pb'
8
6
  require 'google/protobuf/timestamp_pb'
9
7
  require 'google/api/annotations_pb'
8
+ require 'google/protobuf'
9
+
10
10
  Google::Protobuf::DescriptorPool.generated_pool.build do
11
11
  add_file("google/appengine/v1/instance.proto", :syntax => :proto3) do
12
12
  add_message "google.appengine.v1.Instance" do
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/location.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/field_behavior_pb'
7
5
  require 'google/api/annotations_pb'
6
+ require 'google/protobuf'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/appengine/v1/location.proto", :syntax => :proto3) do
10
10
  add_message "google.appengine.v1.LocationMetadata" do
@@ -1,9 +1,9 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/network_settings.proto
3
3
 
4
+ require 'google/api/annotations_pb'
4
5
  require 'google/protobuf'
5
6
 
6
- require 'google/api/annotations_pb'
7
7
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
8
  add_file("google/appengine/v1/network_settings.proto", :syntax => :proto3) do
9
9
  add_message "google.appengine.v1.NetworkSettings" do
@@ -1,11 +1,11 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/operation.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/protobuf/duration_pb'
7
5
  require 'google/protobuf/timestamp_pb'
8
6
  require 'google/api/annotations_pb'
7
+ require 'google/protobuf'
8
+
9
9
  Google::Protobuf::DescriptorPool.generated_pool.build do
10
10
  add_file("google/appengine/v1/operation.proto", :syntax => :proto3) do
11
11
  add_message "google.appengine.v1.OperationMetadataV1" do
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/service.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/appengine/v1/network_settings_pb'
7
5
  require 'google/api/annotations_pb'
6
+ require 'google/protobuf'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/appengine/v1/service.proto", :syntax => :proto3) do
10
10
  add_message "google.appengine.v1.Service" do
@@ -1,14 +1,14 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/appengine/v1/version.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/appengine/v1/app_yaml_pb'
7
5
  require 'google/appengine/v1/deploy_pb'
8
6
  require 'google/appengine/v1/network_settings_pb'
9
7
  require 'google/protobuf/duration_pb'
10
8
  require 'google/protobuf/timestamp_pb'
11
9
  require 'google/api/annotations_pb'
10
+ require 'google/protobuf'
11
+
12
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
13
13
  add_file("google/appengine/v1/version.proto", :syntax => :proto3) do
14
14
  add_message "google.appengine.v1.Version" do
@@ -39,13 +39,12 @@ module Google
39
39
  # See {::Google::Cloud::AppEngine::V1::Applications::Client::Configuration}
40
40
  # for a description of the configuration fields.
41
41
  #
42
- # ## Example
42
+ # @example
43
43
  #
44
- # To modify the configuration for all Applications clients:
45
- #
46
- # ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
47
- # config.timeout = 10.0
48
- # end
44
+ # # Modify the configuration for all Applications clients
45
+ # ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
46
+ # config.timeout = 10.0
47
+ # end
49
48
  #
50
49
  # @yield [config] Configure the Client client.
51
50
  # @yieldparam config [Client::Configuration]
@@ -92,19 +91,15 @@ module Google
92
91
  ##
93
92
  # Create a new Applications client object.
94
93
  #
95
- # ## Examples
96
- #
97
- # To create a new Applications client with the default
98
- # configuration:
99
- #
100
- # client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
94
+ # @example
101
95
  #
102
- # To create a new Applications client with a custom
103
- # configuration:
96
+ # # Create a client using the default configuration
97
+ # client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
104
98
  #
105
- # client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
106
- # config.timeout = 10.0
107
- # end
99
+ # # Create a client using a custom configuration
100
+ # client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
101
+ # config.timeout = 10.0
102
+ # end
108
103
  #
109
104
  # @yield [config] Configure the Applications client.
110
105
  # @yieldparam config [Client::Configuration]
@@ -124,14 +119,13 @@ module Google
124
119
 
125
120
  # Create credentials
126
121
  credentials = @config.credentials
127
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
122
+ # Use self-signed JWT if the endpoint is unchanged from default,
128
123
  # but only if the default endpoint does not have a region prefix.
129
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
130
- @config.endpoint == Client.configure.endpoint &&
124
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
131
125
  !@config.endpoint.split(".").first.include?("-")
132
126
  credentials ||= Credentials.default scope: @config.scope,
133
127
  enable_self_signed_jwt: enable_self_signed_jwt
134
- if credentials.is_a?(String) || credentials.is_a?(Hash)
128
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
135
129
  credentials = Credentials.new credentials, scope: @config.scope
136
130
  end
137
131
  @quota_project_id = @config.quota_project
@@ -189,6 +183,21 @@ module Google
189
183
  #
190
184
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
191
185
  #
186
+ # @example Basic example
187
+ # require "google/cloud/app_engine/v1"
188
+ #
189
+ # # Create a client object. The client can be reused for multiple calls.
190
+ # client = Google::Cloud::AppEngine::V1::Applications::Client.new
191
+ #
192
+ # # Create a request. To set request fields, pass in keyword arguments.
193
+ # request = Google::Cloud::AppEngine::V1::GetApplicationRequest.new
194
+ #
195
+ # # Call the get_application method.
196
+ # result = client.get_application request
197
+ #
198
+ # # The returned object is of type Google::Cloud::AppEngine::V1::Application.
199
+ # p result
200
+ #
192
201
  def get_application request, options = nil
193
202
  raise ::ArgumentError, "request must be provided" if request.nil?
194
203
 
@@ -206,16 +215,20 @@ module Google
206
215
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
207
216
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
208
217
 
209
- header_params = {
210
- "name" => request.name
211
- }
218
+ header_params = {}
219
+ if request.name
220
+ header_params["name"] = request.name
221
+ end
222
+
212
223
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
213
224
  metadata[:"x-goog-request-params"] ||= request_params_header
214
225
 
215
226
  options.apply_defaults timeout: @config.rpcs.get_application.timeout,
216
227
  metadata: metadata,
217
228
  retry_policy: @config.rpcs.get_application.retry_policy
218
- options.apply_defaults metadata: @config.metadata,
229
+
230
+ options.apply_defaults timeout: @config.timeout,
231
+ metadata: @config.metadata,
219
232
  retry_policy: @config.retry_policy
220
233
 
221
234
  @applications_stub.call_rpc :get_application, request, options: options do |response, operation|
@@ -261,6 +274,28 @@ module Google
261
274
  #
262
275
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
263
276
  #
277
+ # @example Basic example
278
+ # require "google/cloud/app_engine/v1"
279
+ #
280
+ # # Create a client object. The client can be reused for multiple calls.
281
+ # client = Google::Cloud::AppEngine::V1::Applications::Client.new
282
+ #
283
+ # # Create a request. To set request fields, pass in keyword arguments.
284
+ # request = Google::Cloud::AppEngine::V1::CreateApplicationRequest.new
285
+ #
286
+ # # Call the create_application method.
287
+ # result = client.create_application request
288
+ #
289
+ # # The returned object is of type Gapic::Operation. You can use this
290
+ # # object to check the status of an operation, cancel it, or wait
291
+ # # for results. Here is how to block until completion:
292
+ # result.wait_until_done! timeout: 60
293
+ # if result.response?
294
+ # p result.response
295
+ # else
296
+ # puts "Error!"
297
+ # end
298
+ #
264
299
  def create_application request, options = nil
265
300
  raise ::ArgumentError, "request must be provided" if request.nil?
266
301
 
@@ -281,7 +316,9 @@ module Google
281
316
  options.apply_defaults timeout: @config.rpcs.create_application.timeout,
282
317
  metadata: metadata,
283
318
  retry_policy: @config.rpcs.create_application.retry_policy
284
- options.apply_defaults metadata: @config.metadata,
319
+
320
+ options.apply_defaults timeout: @config.timeout,
321
+ metadata: @config.metadata,
285
322
  retry_policy: @config.retry_policy
286
323
 
287
324
  @applications_stub.call_rpc :create_application, request, options: options do |response, operation|
@@ -330,6 +367,28 @@ module Google
330
367
  #
331
368
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
332
369
  #
370
+ # @example Basic example
371
+ # require "google/cloud/app_engine/v1"
372
+ #
373
+ # # Create a client object. The client can be reused for multiple calls.
374
+ # client = Google::Cloud::AppEngine::V1::Applications::Client.new
375
+ #
376
+ # # Create a request. To set request fields, pass in keyword arguments.
377
+ # request = Google::Cloud::AppEngine::V1::UpdateApplicationRequest.new
378
+ #
379
+ # # Call the update_application method.
380
+ # result = client.update_application request
381
+ #
382
+ # # The returned object is of type Gapic::Operation. You can use this
383
+ # # object to check the status of an operation, cancel it, or wait
384
+ # # for results. Here is how to block until completion:
385
+ # result.wait_until_done! timeout: 60
386
+ # if result.response?
387
+ # p result.response
388
+ # else
389
+ # puts "Error!"
390
+ # end
391
+ #
333
392
  def update_application request, options = nil
334
393
  raise ::ArgumentError, "request must be provided" if request.nil?
335
394
 
@@ -347,16 +406,20 @@ module Google
347
406
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
348
407
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
349
408
 
350
- header_params = {
351
- "name" => request.name
352
- }
409
+ header_params = {}
410
+ if request.name
411
+ header_params["name"] = request.name
412
+ end
413
+
353
414
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
354
415
  metadata[:"x-goog-request-params"] ||= request_params_header
355
416
 
356
417
  options.apply_defaults timeout: @config.rpcs.update_application.timeout,
357
418
  metadata: metadata,
358
419
  retry_policy: @config.rpcs.update_application.retry_policy
359
- options.apply_defaults metadata: @config.metadata,
420
+
421
+ options.apply_defaults timeout: @config.timeout,
422
+ metadata: @config.metadata,
360
423
  retry_policy: @config.retry_policy
361
424
 
362
425
  @applications_stub.call_rpc :update_application, request, options: options do |response, operation|
@@ -406,6 +469,28 @@ module Google
406
469
  #
407
470
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
408
471
  #
472
+ # @example Basic example
473
+ # require "google/cloud/app_engine/v1"
474
+ #
475
+ # # Create a client object. The client can be reused for multiple calls.
476
+ # client = Google::Cloud::AppEngine::V1::Applications::Client.new
477
+ #
478
+ # # Create a request. To set request fields, pass in keyword arguments.
479
+ # request = Google::Cloud::AppEngine::V1::RepairApplicationRequest.new
480
+ #
481
+ # # Call the repair_application method.
482
+ # result = client.repair_application request
483
+ #
484
+ # # The returned object is of type Gapic::Operation. You can use this
485
+ # # object to check the status of an operation, cancel it, or wait
486
+ # # for results. Here is how to block until completion:
487
+ # result.wait_until_done! timeout: 60
488
+ # if result.response?
489
+ # p result.response
490
+ # else
491
+ # puts "Error!"
492
+ # end
493
+ #
409
494
  def repair_application request, options = nil
410
495
  raise ::ArgumentError, "request must be provided" if request.nil?
411
496
 
@@ -423,16 +508,20 @@ module Google
423
508
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
424
509
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
425
510
 
426
- header_params = {
427
- "name" => request.name
428
- }
511
+ header_params = {}
512
+ if request.name
513
+ header_params["name"] = request.name
514
+ end
515
+
429
516
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
430
517
  metadata[:"x-goog-request-params"] ||= request_params_header
431
518
 
432
519
  options.apply_defaults timeout: @config.rpcs.repair_application.timeout,
433
520
  metadata: metadata,
434
521
  retry_policy: @config.rpcs.repair_application.retry_policy
435
- options.apply_defaults metadata: @config.metadata,
522
+
523
+ options.apply_defaults timeout: @config.timeout,
524
+ metadata: @config.metadata,
436
525
  retry_policy: @config.retry_policy
437
526
 
438
527
  @applications_stub.call_rpc :repair_application, request, options: options do |response, operation|
@@ -457,22 +546,21 @@ module Google
457
546
  # Configuration can be applied globally to all clients, or to a single client
458
547
  # on construction.
459
548
  #
460
- # # Examples
461
- #
462
- # To modify the global config, setting the timeout for get_application
463
- # to 20 seconds, and all remaining timeouts to 10 seconds:
464
- #
465
- # ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
466
- # config.timeout = 10.0
467
- # config.rpcs.get_application.timeout = 20.0
468
- # end
469
- #
470
- # To apply the above configuration only to a new client:
471
- #
472
- # client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
473
- # config.timeout = 10.0
474
- # config.rpcs.get_application.timeout = 20.0
475
- # end
549
+ # @example
550
+ #
551
+ # # Modify the global config, setting the timeout for
552
+ # # get_application to 20 seconds,
553
+ # # and all remaining timeouts to 10 seconds.
554
+ # ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
555
+ # config.timeout = 10.0
556
+ # config.rpcs.get_application.timeout = 20.0
557
+ # end
558
+ #
559
+ # # Apply the above configuration only to a new client.
560
+ # client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
561
+ # config.timeout = 10.0
562
+ # config.rpcs.get_application.timeout = 20.0
563
+ # end
476
564
  #
477
565
  # @!attribute [rw] endpoint
478
566
  # The hostname or hostname:port of the service endpoint.