google-api-client 0.9.11 → 0.9.12

data/generated/google/apis/appengine_v1beta5/representations.rb

@@ -208,13 +208,31 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Instance
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListInstancesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Instance
+      class DebugInstanceRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListLocationsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Location
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
@@ -591,15 +609,6 @@ module Google
         end
       end
       
-      class ListInstancesResponse
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          collection :instances, as: 'instances', class: Google::Apis::AppengineV1beta5::Instance, decorator: Google::Apis::AppengineV1beta5::Instance::Representation
-      
-          property :next_page_token, as: 'nextPageToken'
-        end
-      end
-      
       class Instance
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -621,6 +630,40 @@ module Google
         end
       end
       
+      class ListInstancesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :instances, as: 'instances', class: Google::Apis::AppengineV1beta5::Instance, decorator: Google::Apis::AppengineV1beta5::Instance::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class DebugInstanceRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class ListLocationsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :locations, as: 'locations', class: Google::Apis::AppengineV1beta5::Location, decorator: Google::Apis::AppengineV1beta5::Location::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class Location
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :location_id, as: 'locationId'
+          hash :labels, as: 'labels'
+          hash :metadata, as: 'metadata'
+        end
+      end
+      
       class OperationMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -658,6 +701,8 @@ module Google
       class LocationMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :standard_environment_available, as: 'standardEnvironmentAvailable'
+          property :flexible_environment_available, as: 'flexibleEnvironmentAvailable'
         end
       end
     end

data/generated/google/apis/appengine_v1beta5/service.rb

@@ -46,9 +46,43 @@ module Google
           super('https://appengine.googleapis.com/', '')
         end
         
+        # Creates an App Engine application for a Google Cloud Platform project. This
+        # requires a project that excludes an App Engine application. For details about
+        # creating a project without an application, see the [Google Cloud Resource
+        # Manager create project topic](https://cloud.google.com/resource-manager/docs/
+        # creating-project).
+        # @param [Google::Apis::AppengineV1beta5::Application] application_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AppengineV1beta5::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppengineV1beta5::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_app(application_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta5/apps', options)
+          command.request_representation = Google::Apis::AppengineV1beta5::Application::Representation
+          command.request_object = application_object
+          command.response_representation = Google::Apis::AppengineV1beta5::Operation::Representation
+          command.response_class = Google::Apis::AppengineV1beta5::Operation
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets information about an application.
         # @param [String] apps_id
-        #   Part of `name`. Name of the application to get. For example: "apps/myapp".
+        #   Part of `name`. Name of the application to get. Example: `apps/myapp`.
         # @param [Boolean] ensure_resources_exist
         #   Certain resources associated with an application are created on-demand.
         #   Controls whether these resources should be created when performing the `GET`
@@ -160,10 +194,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a service and all enclosed versions.
+        # Deletes the specified service and all enclosed versions.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource requested. For example: "apps/myapp/
-        #   services/default".
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [String] fields
@@ -194,10 +228,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the current configuration of the service.
+        # Gets the current configuration of the specified service.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource requested. For example: "apps/myapp/
-        #   services/default".
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [String] fields
@@ -230,7 +264,7 @@ module Google
         
         # Lists all the services in the application.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource requested. For example: "apps/myapp".
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp`.
         # @param [Fixnum] page_size
         #   Maximum results to return per page.
         # @param [String] page_token
@@ -266,16 +300,26 @@ module Google
         
         # Updates the configuration of the specified service.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource to update. For example: "apps/myapp/
-        #   services/default".
+        #   Part of `name`. Name of the resource to update. Example: `apps/myapp/services/
+        #   default`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [Google::Apis::AppengineV1beta5::Service] service_object
         # @param [String] mask
         #   Standard field mask for the set of fields to be updated.
         # @param [Boolean] migrate_traffic
-        #   Whether to use Traffic Migration to shift traffic gradually. Traffic can only
-        #   be migrated from a single version to another single version.
+        #   Set to `true` to gradually shift traffic from one version to another single
+        #   version. By default, traffic is shifted immediately. For gradual traffic
+        #   migration, the target version must be located within instances that are
+        #   configured for both [warmup requests](https://cloud.google.com/appengine/docs/
+        #   admin-api/reference/rest/v1beta5/apps.services.versions#inboundservicetype)
+        #   and [automatic scaling](https://cloud.google.com/appengine/docs/admin-api/
+        #   reference/rest/v1beta5/apps.services.versions#automaticscaling). You must
+        #   specify the [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/
+        #   reference/rest/v1beta5/apps.services#shardby) field in the Service resource.
+        #   Gradual traffic migration is not supported in the App Engine flexible
+        #   environment. For examples, see [Migrating and Splitting Traffic](https://cloud.
+        #   google.com/appengine/docs/admin-api/migrating-splitting-traffic).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -308,7 +352,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deploys new code and resource files to a version.
+        # Deploys new code and resource files to a new version.
         # @param [String] apps_id
         #   Part of `name`. Name of the resource to update. For example: "apps/myapp/
         #   services/default".
@@ -347,8 +391,8 @@ module Google
         
         # Deletes an existing version.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource requested. For example: "apps/myapp/
-        #   services/default/versions/v1".
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default/versions/v1`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [String] versions_id
@@ -382,10 +426,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets application deployment information.
+        # Gets the specified Version resource. By default, only a `BASIC_VIEW` will be
+        # returned. Specify the `FULL_VIEW` parameter to get the full resource.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource requested. For example: "apps/myapp/
-        #   services/default/versions/v1".
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default/versions/v1`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [String] versions_id
@@ -424,8 +469,8 @@ module Google
         
         # Lists the versions of a service.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource requested. For example: "apps/myapp/
-        #   services/default".
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [String] view
@@ -467,22 +512,23 @@ module Google
         
         # Updates the specified Version resource. You can specify the following fields
         # depending on the App Engine environment and type of scaling that the version
-        # resource uses: * [`serving_status`](/appengine/docs/admin-api/reference/rest/
-        # v1beta5/apps.services.versions#Version.FIELDS.serving_status): For Version
-        # resources that use basic scaling, manual scaling, or run in the App Engine
-        # flexible environment. * [`instance_class`](/appengine/docs/admin-api/reference/
-        # rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): For
-        # Version resources that run in the App Engine standard environment. * [`
-        # automatic_scaling.min_idle_instances`](/appengine/docs/admin-api/reference/
-        # rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For
-        # Version resources that use automatic scaling and run in the App Engine
-        # standard environment. * [`automatic_scaling.max_idle_instances`](/appengine/
-        # docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.
+        # resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/
+        # admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.
+        # serving_status): For Version resources that use basic scaling, manual scaling,
+        # or run in the App Engine flexible environment. * [`instance_class`](https://
+        # cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.
+        # versions#Version.FIELDS.instance_class): For Version resources that run in the
+        # App Engine standard environment. * [`automatic_scaling.min_idle_instances`](
+        # https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.
+        # services.versions#Version.FIELDS.automatic_scaling): For Version resources
+        # that use automatic scaling and run in the App Engine standard environment. * [`
+        # automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/
+        # admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.
         # automatic_scaling): For Version resources that use automatic scaling and run
         # in the App Engine standard environment.
         # @param [String] apps_id
-        #   Part of `name`. Name of the resource to update. For example: "apps/myapp/
-        #   services/default/versions/1".
+        #   Part of `name`. Name of the resource to update. Example: `apps/myapp/services/
+        #   default/versions/1`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [String] versions_id
@@ -522,10 +568,90 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the instances of a version.
+        # Stops a running instance.
         # @param [String] apps_id
         #   Part of `name`. Name of the resource requested. For example: "apps/myapp/
-        #   services/default/versions/v1".
+        #   services/default/versions/v1/instances/instance-1".
+        # @param [String] services_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] versions_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] instances_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AppengineV1beta5::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppengineV1beta5::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_app_service_version_instance(apps_id, services_id, versions_id, instances_id, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}', options)
+          command.response_representation = Google::Apis::AppengineV1beta5::Operation::Representation
+          command.response_class = Google::Apis::AppengineV1beta5::Operation
+          command.params['appsId'] = apps_id unless apps_id.nil?
+          command.params['servicesId'] = services_id unless services_id.nil?
+          command.params['versionsId'] = versions_id unless versions_id.nil?
+          command.params['instancesId'] = instances_id unless instances_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets instance information.
+        # @param [String] apps_id
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default/versions/v1/instances/instance-1`.
+        # @param [String] services_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] versions_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] instances_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AppengineV1beta5::Instance] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppengineV1beta5::Instance]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_app_service_version_instance(apps_id, services_id, versions_id, instances_id, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}', options)
+          command.response_representation = Google::Apis::AppengineV1beta5::Instance::Representation
+          command.response_class = Google::Apis::AppengineV1beta5::Instance
+          command.params['appsId'] = apps_id unless apps_id.nil?
+          command.params['servicesId'] = services_id unless services_id.nil?
+          command.params['versionsId'] = versions_id unless versions_id.nil?
+          command.params['instancesId'] = instances_id unless instances_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the instances of a version.
+        # @param [String] apps_id
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default/versions/v1`.
         # @param [String] services_id
         #   Part of `name`. See documentation of `appsId`.
         # @param [String] versions_id
@@ -564,6 +690,126 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Enables debugging on a VM instance. This allows you to use the SSH command to
+        # connect to the virtual machine where the instance lives. While in "debug mode",
+        # the instance continues to serve live traffic. You should delete the instance
+        # when you are done debugging and then allow the system to take over and
+        # determine if another instance should be started. Only applicable for instances
+        # in App Engine flexible environment.
+        # @param [String] apps_id
+        #   Part of `name`. Name of the resource requested. Example: `apps/myapp/services/
+        #   default/versions/v1/instances/instance-1`.
+        # @param [String] services_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] versions_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] instances_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [Google::Apis::AppengineV1beta5::DebugInstanceRequest] debug_instance_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AppengineV1beta5::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppengineV1beta5::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def debug_instance(apps_id, services_id, versions_id, instances_id, debug_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}:debug', options)
+          command.request_representation = Google::Apis::AppengineV1beta5::DebugInstanceRequest::Representation
+          command.request_object = debug_instance_request_object
+          command.response_representation = Google::Apis::AppengineV1beta5::Operation::Representation
+          command.response_class = Google::Apis::AppengineV1beta5::Operation
+          command.params['appsId'] = apps_id unless apps_id.nil?
+          command.params['servicesId'] = services_id unless services_id.nil?
+          command.params['versionsId'] = versions_id unless versions_id.nil?
+          command.params['instancesId'] = instances_id unless instances_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists information about the supported locations for this service.
+        # @param [String] apps_id
+        #   Part of `name`. The resource that owns the locations collection, if applicable.
+        # @param [String] filter
+        #   The standard list filter.
+        # @param [Fixnum] page_size
+        #   The standard list page size.
+        # @param [String] page_token
+        #   The standard list page token.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AppengineV1beta5::ListLocationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppengineV1beta5::ListLocationsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_app_locations(apps_id, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta5/apps/{appsId}/locations', options)
+          command.response_representation = Google::Apis::AppengineV1beta5::ListLocationsResponse::Representation
+          command.response_class = Google::Apis::AppengineV1beta5::ListLocationsResponse
+          command.params['appsId'] = apps_id unless apps_id.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Get information about a location.
+        # @param [String] apps_id
+        #   Part of `name`. Resource name for the location.
+        # @param [String] locations_id
+        #   Part of `name`. See documentation of `appsId`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AppengineV1beta5::Location] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppengineV1beta5::Location]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_app_location(apps_id, locations_id, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta5/apps/{appsId}/locations/{locationsId}', options)
+          command.response_representation = Google::Apis::AppengineV1beta5::Location::Representation
+          command.response_class = Google::Apis::AppengineV1beta5::Location
+          command.params['appsId'] = apps_id unless apps_id.nil?
+          command.params['locationsId'] = locations_id unless locations_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected