google-cloud-app_engine-v1 0.2.0 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63794941a7d4c11917924c1ce1306755b0afea07747297ea9bfad29d26d98793
-  data.tar.gz: 15835bfe2fda664c4a9e511a0c55d6b51694d8a89835521f7f739c3e448317f6
+  metadata.gz: 75db990aef798981b48a838937b7efadf8056d205100c13dcd090e9a2a240ed7
+  data.tar.gz: 8e506a925ce59b3c03c0fda5b0ea4025bf6f2bcf242c7ff74f36900131c25ed0
 SHA512:
-  metadata.gz: 4f59bcd391ce20cff38864fb40bf4d42e18738498aa4b2dfaa89a91178590fddc2d2b490bf850e133ac26569a0f26aaaf47b1998a15c7cadee71894523036228
-  data.tar.gz: '047313934e02b17c3e3e353f7494a992cfd00ddc02622f3524651a02e470b2d4a81961e0bcd0ad61f8f0dae1fc24482e4de9503b06dccf85a5db4eaccb3e6167'
+  metadata.gz: 27a0e34749bdf4d5379d1a3565721a649f6e0378c0a4b185a68c93c539a00c8bb7678c77d9380309e0f3fa6810aa8618f0ed6bfc46de9f4d3368bb1bdfa3257d
+  data.tar.gz: 49510fcceee41312cedefaee9e298de35206fda344e960af6d031c0ea4898104bf2610b9e16914c1bc9d6f8c3af2cef254d62ea0ff58248859f9b8d0782ec381

data/AUTHENTICATION.md

@@ -66,11 +66,11 @@ The environment variables that google-cloud-app_engine-v1
 checks for credentials are configured on the service Credentials class (such as
 {::Google::Cloud::AppEngine::V1::Applications::Credentials}):
 
-1. `APP_ENGINE_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `APP_ENGINE_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+* `APP_ENGINE_CREDENTIALS` - Path to JSON file, or JSON contents
+* `APP_ENGINE_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
 
 ```ruby
 require "google/cloud/app_engine/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
 
 ### Configuration
 
-The **Credentials JSON** can be configured instead of placing them in
-environment variables. Either on an individual client initialization:
+The path to the **Credentials JSON** file can be configured instead of storing
+it in an environment variable. Either on an individual client initialization:
 
 ```ruby
 require "google/cloud/app_engine/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/app_engine/v1"

data/README.md

@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
 require "google/cloud/app_engine/v1"
 
 client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
-request = my_create_request
+request = ::Google::Cloud::AppEngine::V1::GetApplicationRequest.new # (request fields as keyword arguments...)
 response = client.get_application request
 ```
 

data/lib/google/appengine/v1/instance_pb.rb

@@ -3,6 +3,8 @@
 
 require 'google/protobuf'
 
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -24,6 +26,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :vm_status, :string, 14
       optional :vm_debug_enabled, :bool, 15
       optional :vm_ip, :string, 16
+      optional :vm_liveness, :enum, 17, "google.appengine.v1.Instance.Liveness.LivenessState"
+    end
+    add_message "google.appengine.v1.Instance.Liveness" do
+    end
+    add_enum "google.appengine.v1.Instance.Liveness.LivenessState" do
+      value :LIVENESS_STATE_UNSPECIFIED, 0
+      value :UNKNOWN, 1
+      value :HEALTHY, 2
+      value :UNHEALTHY, 3
+      value :DRAINING, 4
+      value :TIMEOUT, 5
     end
     add_enum "google.appengine.v1.Instance.Availability" do
       value :UNSPECIFIED, 0
@@ -38,6 +51,8 @@ module Google
     module AppEngine
       module V1
         Instance = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.appengine.v1.Instance").msgclass
+        Instance::Liveness = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.appengine.v1.Instance.Liveness").msgclass
+        Instance::Liveness::LivenessState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.appengine.v1.Instance.Liveness.LivenessState").enummodule
         Instance::Availability = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.appengine.v1.Instance.Availability").enummodule
       end
     end

data/lib/google/appengine/v1/location_pb.rb

@@ -3,12 +3,14 @@
 
 require 'google/protobuf'
 
+require 'google/api/field_behavior_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/appengine/v1/location.proto", :syntax => :proto3) do
     add_message "google.appengine.v1.LocationMetadata" do
       optional :standard_environment_available, :bool, 2
       optional :flexible_environment_available, :bool, 4
+      optional :search_api_available, :bool, 6
     end
   end
 end

data/lib/google/appengine/v1/network_settings_pb.rb

@@ -6,6 +6,15 @@ require 'google/protobuf'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/appengine/v1/network_settings.proto", :syntax => :proto3) do
+    add_message "google.appengine.v1.NetworkSettings" do
+      optional :ingress_traffic_allowed, :enum, 1, "google.appengine.v1.NetworkSettings.IngressTrafficAllowed"
+    end
+    add_enum "google.appengine.v1.NetworkSettings.IngressTrafficAllowed" do
+      value :INGRESS_TRAFFIC_ALLOWED_UNSPECIFIED, 0
+      value :INGRESS_TRAFFIC_ALLOWED_ALL, 1
+      value :INGRESS_TRAFFIC_ALLOWED_INTERNAL_ONLY, 2
+      value :INGRESS_TRAFFIC_ALLOWED_INTERNAL_AND_LB, 3
+    end
   end
 end
 
@@ -13,6 +22,8 @@ module Google
   module Cloud
     module AppEngine
       module V1
+        NetworkSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.appengine.v1.NetworkSettings").msgclass
+        NetworkSettings::IngressTrafficAllowed = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.appengine.v1.NetworkSettings.IngressTrafficAllowed").enummodule
       end
     end
   end

data/lib/google/appengine/v1/operation_pb.rb

@@ -3,6 +3,7 @@
 
 require 'google/protobuf'
 
+require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/lib/google/appengine/v1/service_pb.rb

@@ -3,6 +3,7 @@
 
 require 'google/protobuf'
 
+require 'google/appengine/v1/network_settings_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/appengine/v1/service.proto", :syntax => :proto3) do
@@ -10,6 +11,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :id, :string, 2
       optional :split, :message, 3, "google.appengine.v1.TrafficSplit"
+      optional :network_settings, :message, 6, "google.appengine.v1.NetworkSettings"
     end
     add_message "google.appengine.v1.TrafficSplit" do
       optional :shard_by, :enum, 1, "google.appengine.v1.TrafficSplit.ShardBy"

data/lib/google/appengine/v1/version_pb.rb

@@ -5,6 +5,7 @@ require 'google/protobuf'
 
 require 'google/appengine/v1/app_yaml_pb'
 require 'google/appengine/v1/deploy_pb'
+require 'google/appengine/v1/network_settings_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/api/annotations_pb'
@@ -30,11 +31,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :disk_usage_bytes, :int64, 18
       optional :runtime_api_version, :string, 21
       optional :runtime_main_executable_path, :string, 22
+      optional :service_account, :string, 127
       repeated :handlers, :message, 100, "google.appengine.v1.UrlMap"
       repeated :error_handlers, :message, 101, "google.appengine.v1.ErrorHandler"
       repeated :libraries, :message, 102, "google.appengine.v1.Library"
       optional :api_config, :message, 103, "google.appengine.v1.ApiConfigHandler"
       map :env_variables, :string, :string, 104
+      map :build_env_variables, :string, :string, 125
       optional :default_expiration, :message, 105, "google.protobuf.Duration"
       optional :health_check, :message, 106, "google.appengine.v1.HealthCheck"
       optional :readiness_check, :message, 112, "google.appengine.v1.ReadinessCheck"
@@ -127,6 +130,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :disk_gb, :double, 2
       optional :memory_gb, :double, 3
       repeated :volumes, :message, 4, "google.appengine.v1.Volume"
+      optional :kms_key_reference, :string, 5
     end
     add_message "google.appengine.v1.VpcAccessConnector" do
       optional :name, :string, 1

data/lib/google/cloud/app_engine/v1/applications/client.rb

@@ -39,13 +39,12 @@ module Google
             # See {::Google::Cloud::AppEngine::V1::Applications::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all Applications clients:
-            #
-            #     ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all Applications clients
+            #   ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -92,19 +91,15 @@ module Google
             ##
             # Create a new Applications client object.
             #
-            # ## Examples
-            #
-            # To create a new Applications client with the default
-            # configuration:
-            #
-            #     client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
+            # @example
             #
-            # To create a new Applications client with a custom
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::AppEngine::V1::Applications::Client.new
             #
-            #     client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Applications client.
             # @yieldparam config [Client::Configuration]
@@ -124,14 +119,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -215,7 +209,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_application.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_application.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @applications_stub.call_rpc :get_application, request, options: options do |response, operation|
@@ -281,7 +277,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_application.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_application.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @applications_stub.call_rpc :create_application, request, options: options do |response, operation|
@@ -356,7 +354,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_application.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_application.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @applications_stub.call_rpc :update_application, request, options: options do |response, operation|
@@ -432,7 +432,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.repair_application.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.repair_application.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @applications_stub.call_rpc :repair_application, request, options: options do |response, operation|
@@ -457,22 +459,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for get_application
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.get_application.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.get_application.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # get_application to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::AppEngine::V1::Applications::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.get_application.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.get_application.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/app_engine/v1/applications/operations.rb

@@ -82,7 +82,7 @@ module Google
               # Create credentials
               credentials = @config.credentials
               credentials ||= Credentials.default scope: @config.scope
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -169,7 +169,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_operations.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_operations.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :list_operations, request, options: options do |response, operation|
@@ -239,7 +241,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
@@ -309,7 +313,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
@@ -384,7 +390,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.cancel_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.cancel_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
@@ -396,9 +404,9 @@ module Google
             end
 
             ##
-            # Waits for the specified long-running operation until it is done or reaches
-            # at most a specified timeout, returning the latest state.  If the operation
-            # is already done, the latest state is immediately returned.  If the timeout
+            # Waits until the specified long-running operation is done or reaches at most
+            # a specified timeout, returning the latest state.  If the operation is
+            # already done, the latest state is immediately returned.  If the timeout
             # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
             # timeout is used.  If the server does not support this method, it returns
             # `google.rpc.Code.UNIMPLEMENTED`.
@@ -456,7 +464,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.wait_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
@@ -481,22 +491,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_operations
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Longrunning::Operations::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Longrunning::Operations::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_operations to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Longrunning::Operations::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Longrunning::Operations::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.