google-cloud-app_engine-v1 0.3.0 → 0.3.4

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 (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.