google-api-client 0.9.8 → 0.10.2

data/generated/google/apis/sqladmin_v1beta4.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/sql/docs/reference/latest
     module SqladminV1beta4
       VERSION = 'V1beta4'
-      REVISION = '20160509'
+      REVISION = '20170217'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/sqladmin_v1beta4/classes.rb

@@ -105,6 +105,11 @@ module Google
       class BackupRun
         include Google::Apis::Core::Hashable
       
+        # The description of this run, only applicable to on-demand backups.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
         # The time the backup operation completed in UTC timezone in RFC 3339 format,
         # for example 2012-11-15T16:19:00.094Z.
         # Corresponds to the JSON property `endTime`
@@ -154,6 +159,11 @@ module Google
         # @return [String]
         attr_accessor :status
       
+        # The type of this run; can be either "AUTOMATED" or "ON_DEMAND".
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
         # The start time of the backup window during which this the backup was attempted
         # in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
         # Corresponds to the JSON property `windowStartTime`
@@ -166,6 +176,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @description = args[:description] if args.key?(:description)
           @end_time = args[:end_time] if args.key?(:end_time)
           @enqueued_time = args[:enqueued_time] if args.key?(:enqueued_time)
           @error = args[:error] if args.key?(:error)
@@ -175,6 +186,7 @@ module Google
           @self_link = args[:self_link] if args.key?(:self_link)
           @start_time = args[:start_time] if args.key?(:start_time)
           @status = args[:status] if args.key?(:status)
+          @type = args[:type] if args.key?(:type)
           @window_start_time = args[:window_start_time] if args.key?(:window_start_time)
         end
       end
@@ -377,6 +389,11 @@ module Google
         # @return [String]
         attr_accessor :backend_type
       
+        # Connection name of the Cloud SQL instance used in connection strings.
+        # Corresponds to the JSON property `connectionName`
+        # @return [String]
+        attr_accessor :connection_name
+      
         # The current disk usage of the instance in bytes. This property has been
         # deprecated. Users should use the "cloudsql.googleapis.com/database/disk/
         # bytes_used" metric in Cloud Monitoring API instead. Please see https://groups.
@@ -518,6 +535,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @backend_type = args[:backend_type] if args.key?(:backend_type)
+          @connection_name = args[:connection_name] if args.key?(:connection_name)
           @current_disk_size = args[:current_disk_size] if args.key?(:current_disk_size)
           @database_version = args[:database_version] if args.key?(:database_version)
           @etag = args[:etag] if args.key?(:etag)
@@ -555,7 +573,9 @@ module Google
           attr_accessor :available
           alias_method :available?, :available
         
-          # The name of the failover replica.
+          # The name of the failover replica. If specified at instance creation, a
+          # failover replica is created for the instance. The name doesn't include the
+          # project ID. This property is applicable only to Second Generation instances.
           # Corresponds to the JSON property `name`
           # @return [String]
           attr_accessor :name
@@ -1021,6 +1041,25 @@ module Google
         end
       end
       
+      # Instance truncate log request.
+      class InstancesTruncateLogRequest
+        include Google::Apis::Core::Hashable
+      
+        # Database Instance truncate log context.
+        # Corresponds to the JSON property `truncateLogContext`
+        # @return [Google::Apis::SqladminV1beta4::TruncateLogContext]
+        attr_accessor :truncate_log_context
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @truncate_log_context = args[:truncate_log_context] if args.key?(:truncate_log_context)
+        end
+      end
+      
       # IP Management configuration.
       class IpConfiguration
         include Google::Apis::Core::Hashable
@@ -1073,6 +1112,13 @@ module Google
         # @return [DateTime]
         attr_accessor :time_to_retire
       
+        # The type of this IP address. A PRIMARY address is an address that can accept
+        # incoming connections. An OUTGOING address is the source address of connections
+        # originating from the instance, if supported.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1081,6 +1127,32 @@ module Google
         def update!(**args)
           @ip_address = args[:ip_address] if args.key?(:ip_address)
           @time_to_retire = args[:time_to_retire] if args.key?(:time_to_retire)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # User defined labels for Cloud SQL instances.
+      class Labels
+        include Google::Apis::Core::Hashable
+      
+        # The key of the label.
+        # Corresponds to the JSON property `key`
+        # @return [String]
+        attr_accessor :key
+      
+        # The value of the label.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @key = args[:key] if args.key?(:key)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
@@ -1541,13 +1613,17 @@ module Google
       class Settings
         include Google::Apis::Core::Hashable
       
-        # The activation policy for this instance. This specifies when the instance
-        # should be activated and is applicable only when the instance state is RUNNABLE.
-        # This can be one of the following.
-        # ALWAYS: The instance should always be active.
-        # NEVER: The instance should never be activated.
-        # ON_DEMAND: The instance is activated upon receiving requests; only applicable
-        # to First Generation instances.
+        # The activation policy specifies when the instance is activated; it is
+        # applicable only when the instance state is RUNNABLE. The activation policy
+        # cannot be updated together with other settings for Second Generation instances.
+        # Valid values:
+        # ALWAYS: The instance is on; it is not deactivated by inactivity.
+        # NEVER: The instance is off; it is not activated, even if a connection request
+        # arrives.
+        # ON_DEMAND: The instance responds to incoming requests, and turns itself off
+        # when not in use. Instances with PER_USE pricing turn off after 15 minutes of
+        # inactivity. Instances with PER_PACKAGE pricing turn off after 12 hours of
+        # inactivity.
         # Corresponds to the JSON property `activationPolicy`
         # @return [String]
         attr_accessor :activation_policy
@@ -1558,6 +1634,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :authorized_gae_applications
       
+        # Reserved for future use.
+        # Corresponds to the JSON property `availabilityType`
+        # @return [String]
+        attr_accessor :availability_type
+      
         # Database instance backup configuration.
         # Corresponds to the JSON property `backupConfiguration`
         # @return [Google::Apis::SqladminV1beta4::BackupConfiguration]
@@ -1605,6 +1686,11 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # User defined labels.
+        # Corresponds to the JSON property `labels`
+        # @return [Array<Google::Apis::SqladminV1beta4::Labels>]
+        attr_accessor :labels
+      
         # Preferred location. This specifies where a Cloud SQL instance should
         # preferably be located, either in a specific Compute Engine zone, or co-located
         # with an App Engine application. Note that if the preferred location is not
@@ -1647,6 +1733,13 @@ module Google
         attr_accessor :storage_auto_resize
         alias_method :storage_auto_resize?, :storage_auto_resize
       
+        # The maximum size to which storage capacity can be automatically increased. The
+        # default value is 0, which specifies that there is no limit. Applies only to
+        # Second Generation instances.
+        # Corresponds to the JSON property `storageAutoResizeLimit`
+        # @return [String]
+        attr_accessor :storage_auto_resize_limit
+      
         # The tier of service for this instance, for example D1, D2. For more
         # information, see pricing.
         # Corresponds to the JSON property `tier`
@@ -1661,6 +1754,7 @@ module Google
         def update!(**args)
           @activation_policy = args[:activation_policy] if args.key?(:activation_policy)
           @authorized_gae_applications = args[:authorized_gae_applications] if args.key?(:authorized_gae_applications)
+          @availability_type = args[:availability_type] if args.key?(:availability_type)
           @backup_configuration = args[:backup_configuration] if args.key?(:backup_configuration)
           @crash_safe_replication_enabled = args[:crash_safe_replication_enabled] if args.key?(:crash_safe_replication_enabled)
           @data_disk_size_gb = args[:data_disk_size_gb] if args.key?(:data_disk_size_gb)
@@ -1669,12 +1763,14 @@ module Google
           @database_replication_enabled = args[:database_replication_enabled] if args.key?(:database_replication_enabled)
           @ip_configuration = args[:ip_configuration] if args.key?(:ip_configuration)
           @kind = args[:kind] if args.key?(:kind)
+          @labels = args[:labels] if args.key?(:labels)
           @location_preference = args[:location_preference] if args.key?(:location_preference)
           @maintenance_window = args[:maintenance_window] if args.key?(:maintenance_window)
           @pricing_plan = args[:pricing_plan] if args.key?(:pricing_plan)
           @replication_type = args[:replication_type] if args.key?(:replication_type)
           @settings_version = args[:settings_version] if args.key?(:settings_version)
           @storage_auto_resize = args[:storage_auto_resize] if args.key?(:storage_auto_resize)
+          @storage_auto_resize_limit = args[:storage_auto_resize_limit] if args.key?(:storage_auto_resize_limit)
           @tier = args[:tier] if args.key?(:tier)
         end
       end
@@ -1897,8 +1993,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The applicable regions for this tier. Can be us-east1, europe-west1 or asia-
-        # east1.
+        # The applicable regions for this tier.
         # Corresponds to the JSON property `region`
         # @return [Array<String>]
         attr_accessor :region
@@ -1948,6 +2043,32 @@ module Google
         end
       end
       
+      # Database Instance truncate log context.
+      class TruncateLogContext
+        include Google::Apis::Core::Hashable
+      
+        # This is always sql#truncateLogContext.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The type of log to truncate. Valid values are MYSQL_GENERAL_TABLE and
+        # MYSQL_SLOW_TABLE.
+        # Corresponds to the JSON property `logType`
+        # @return [String]
+        attr_accessor :log_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @log_type = args[:log_type] if args.key?(:log_type)
+        end
+      end
+      
       # A Cloud SQL user resource.
       class User
         include Google::Apis::Core::Hashable

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

@@ -172,6 +172,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class InstancesTruncateLogRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class IpConfiguration
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -184,6 +190,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Labels
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class LocationPreference
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -298,6 +310,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TruncateLogContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class User
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -334,6 +352,7 @@ module Google
       class BackupRun
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
           property :end_time, as: 'endTime', type: DateTime
       
           property :enqueued_time, as: 'enqueuedTime', type: DateTime
@@ -347,6 +366,7 @@ module Google
           property :start_time, as: 'startTime', type: DateTime
       
           property :status, as: 'status'
+          property :type, as: 'type'
           property :window_start_time, as: 'windowStartTime', type: DateTime
       
         end
@@ -407,6 +427,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :backend_type, as: 'backendType'
+          property :connection_name, as: 'connectionName'
           property :current_disk_size, as: 'currentDiskSize'
           property :database_version, as: 'databaseVersion'
           property :etag, as: 'etag'
@@ -585,6 +606,14 @@ module Google
         end
       end
       
+      class InstancesTruncateLogRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :truncate_log_context, as: 'truncateLogContext', class: Google::Apis::SqladminV1beta4::TruncateLogContext, decorator: Google::Apis::SqladminV1beta4::TruncateLogContext::Representation
+      
+        end
+      end
+      
       class IpConfiguration
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -601,6 +630,15 @@ module Google
           property :ip_address, as: 'ipAddress'
           property :time_to_retire, as: 'timeToRetire', type: DateTime
       
+          property :type, as: 'type'
+        end
+      end
+      
+      class Labels
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :key, as: 'key'
+          property :value, as: 'value'
         end
       end
       
@@ -727,6 +765,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :activation_policy, as: 'activationPolicy'
           collection :authorized_gae_applications, as: 'authorizedGaeApplications'
+          property :availability_type, as: 'availabilityType'
           property :backup_configuration, as: 'backupConfiguration', class: Google::Apis::SqladminV1beta4::BackupConfiguration, decorator: Google::Apis::SqladminV1beta4::BackupConfiguration::Representation
       
           property :crash_safe_replication_enabled, as: 'crashSafeReplicationEnabled'
@@ -738,6 +777,8 @@ module Google
           property :ip_configuration, as: 'ipConfiguration', class: Google::Apis::SqladminV1beta4::IpConfiguration, decorator: Google::Apis::SqladminV1beta4::IpConfiguration::Representation
       
           property :kind, as: 'kind'
+          collection :labels, as: 'labels', class: Google::Apis::SqladminV1beta4::Labels, decorator: Google::Apis::SqladminV1beta4::Labels::Representation
+      
           property :location_preference, as: 'locationPreference', class: Google::Apis::SqladminV1beta4::LocationPreference, decorator: Google::Apis::SqladminV1beta4::LocationPreference::Representation
       
           property :maintenance_window, as: 'maintenanceWindow', class: Google::Apis::SqladminV1beta4::MaintenanceWindow, decorator: Google::Apis::SqladminV1beta4::MaintenanceWindow::Representation
@@ -746,6 +787,7 @@ module Google
           property :replication_type, as: 'replicationType'
           property :settings_version, as: 'settingsVersion'
           property :storage_auto_resize, as: 'storageAutoResize'
+          property :storage_auto_resize_limit, as: 'storageAutoResizeLimit'
           property :tier, as: 'tier'
         end
       end
@@ -832,6 +874,14 @@ module Google
         end
       end
       
+      class TruncateLogContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kind, as: 'kind'
+          property :log_type, as: 'logType'
+        end
+      end
+      
       class User
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -136,6 +136,48 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new backup run on demand. This method is applicable only to Second
+        # Generation instances.
+        # @param [String] project
+        #   Project ID of the project that contains the instance.
+        # @param [String] instance
+        #   Cloud SQL instance ID. This does not include the project ID.
+        # @param [Google::Apis::SqladminV1beta4::BackupRun] backup_run_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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqladminV1beta4::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 insert_backup_run(project, instance, backup_run_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'projects/{project}/instances/{instance}/backupRuns', options)
+          command.request_representation = Google::Apis::SqladminV1beta4::BackupRun::Representation
+          command.request_object = backup_run_object
+          command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
+          command.response_class = Google::Apis::SqladminV1beta4::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['instance'] = instance unless instance.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists all backup runs associated with a given instance and configuration in
         # the reverse chronological order of the enqueued time.
         # @param [String] project
@@ -436,6 +478,9 @@ module Google
         end
         
         # List all available database flags for Google Cloud SQL instances.
+        # @param [String] database_version
+        #   Database version for flag retrieval. Flags are specific to the database
+        #   version.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -457,10 +502,11 @@ module Google
         # @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_flags(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_flags(database_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, 'flags', options)
           command.response_representation = Google::Apis::SqladminV1beta4::ListFlagsResponse::Representation
           command.response_class = Google::Apis::SqladminV1beta4::ListFlagsResponse
+          command.query['databaseVersion'] = database_version unless database_version.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['userIp'] = user_ip unless user_ip.nil?
@@ -754,6 +800,8 @@ module Google
         # instance name.
         # @param [String] project
         #   Project ID of the project for which to list Cloud SQL instances.
+        # @param [String] filter
+        #   A filter expression for filtering listed instances.
         # @param [Fixnum] max_results
         #   The maximum number of results to return per response.
         # @param [String] page_token
@@ -780,11 +828,12 @@ module Google
         # @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_instances(project, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_instances(project, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, 'projects/{project}/instances', options)
           command.response_representation = Google::Apis::SqladminV1beta4::ListInstancesResponse::Representation
           command.response_class = Google::Apis::SqladminV1beta4::ListInstancesResponse
           command.params['project'] = project unless project.nil?
+          command.query['filter'] = filter unless filter.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -1070,6 +1119,47 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Truncate MySQL general and slow query log tables
+        # @param [String] project
+        #   Project ID of the Cloud SQL project.
+        # @param [String] instance
+        #   Cloud SQL instance ID. This does not include the project ID.
+        # @param [Google::Apis::SqladminV1beta4::InstancesTruncateLogRequest] instances_truncate_log_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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqladminV1beta4::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 truncate_instance_log(project, instance, instances_truncate_log_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'projects/{project}/instances/{instance}/truncateLog', options)
+          command.request_representation = Google::Apis::SqladminV1beta4::InstancesTruncateLogRequest::Representation
+          command.request_object = instances_truncate_log_request_object
+          command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
+          command.response_class = Google::Apis::SqladminV1beta4::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['instance'] = instance unless instance.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Updates settings of a Cloud SQL instance. Caution: This is not a partial
         # update, so you must include values for all the settings that you want to
         # retain. For partial updates, use patch.