google-api-client 0.41.2 → 0.44.0

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

@@ -47,9 +47,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -79,15 +78,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] filter
         #   The standard list filter.
         # @param [String] name
@@ -126,9 +124,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -158,15 +155,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter
@@ -205,12 +201,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Performs asynchronous speech recognition: receive results via the
-        # google.longrunning.Operations interface. Returns either an
-        # `Operation.error` or an `Operation.response` which contains
-        # a `LongRunningRecognizeResponse` message.
-        # For more information on asynchronous speech recognition, see the
-        # [how-to](https://cloud.google.com/speech-to-text/docs/async-recognize).
+        # Performs asynchronous speech recognition: receive results via the google.
+        # longrunning.Operations interface. Returns either an `Operation.error` or an `
+        # Operation.response` which contains a `LongRunningRecognizeResponse` message.
+        # For more information on asynchronous speech recognition, see the [how-to](
+        # https://cloud.google.com/speech-to-text/docs/async-recognize).
         # @param [Google::Apis::SpeechV1p1beta1::LongRunningRecognizeRequest] long_running_recognize_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -240,8 +235,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Performs synchronous speech recognition: receive results after all audio
-        # has been sent and processed.
+        # Performs synchronous speech recognition: receive results after all audio has
+        # been sent and processed.
         # @param [Google::Apis::SpeechV1p1beta1::RecognizeRequest] recognize_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/speech_v2beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/speech-to-text/docs/quickstart-protocol
     module SpeechV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20200326'
+      REVISION = '20200824'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -48,8 +48,8 @@ module Google
       end
       
       # Describes the progress of a long-running `LongRunningRecognize` call. It is
-      # included in the `metadata` field of the `Operation` returned by the
-      # `GetOperation` call of the `google::longrunning::Operations` service.
+      # included in the `metadata` field of the `Operation` returned by the `
+      # GetOperation` call of the `google::longrunning::Operations` service.
       class LongRunningRecognizeMetadata
         include Google::Apis::Core::Hashable
       
@@ -59,8 +59,7 @@ module Google
         attr_accessor :last_update_time
       
         # Output only. Approximate percentage of audio processed thus far. Guaranteed to
-        # be 100
-        # when the audio is fully processed and the results are available.
+        # be 100 when the audio is fully processed and the results are available.
         # Corresponds to the JSON property `progressPercent`
         # @return [Fixnum]
         attr_accessor :progress_percent
@@ -70,8 +69,8 @@ module Google
         # @return [String]
         attr_accessor :start_time
       
-        # The URI of the audio file being transcribed. Empty if the audio was sent
-        # as byte content.
+        # The URI of the audio file being transcribed. Empty if the audio was sent as
+        # byte content.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -118,47 +117,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::SpeechV2beta1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -184,10 +181,10 @@ module Google
         # Output only. The confidence estimate between 0.0 and 1.0. A higher number
         # indicates an estimated greater likelihood that the recognized words are
         # correct. This field is set only for the top alternative of a non-streaming
-        # result or, of a streaming result where `is_final=true`.
-        # This field is not guaranteed to be accurate and users should not rely on it
-        # to be always provided.
-        # The default of 0.0 is a sentinel value indicating `confidence` was not set.
+        # result or, of a streaming result where `is_final=true`. This field is not
+        # guaranteed to be accurate and users should not rely on it to be always
+        # provided. The default of 0.0 is a sentinel value indicating `confidence` was
+        # not set.
         # Corresponds to the JSON property `confidence`
         # @return [Float]
         attr_accessor :confidence
@@ -220,26 +217,24 @@ module Google
       class SpeechRecognitionResult
         include Google::Apis::Core::Hashable
       
-        # Output only. May contain one or more recognition hypotheses (up to the
-        # maximum specified in `max_alternatives`).
-        # These alternatives are ordered in terms of accuracy, with the top (first)
-        # alternative being the most probable, as ranked by the recognizer.
+        # Output only. May contain one or more recognition hypotheses (up to the maximum
+        # specified in `max_alternatives`). These alternatives are ordered in terms of
+        # accuracy, with the top (first) alternative being the most probable, as ranked
+        # by the recognizer.
         # Corresponds to the JSON property `alternatives`
         # @return [Array<Google::Apis::SpeechV2beta1::SpeechRecognitionAlternative>]
         attr_accessor :alternatives
       
         # Output only. For multi-channel audio, this is the channel number corresponding
-        # to the
-        # recognized result for the audio from that channel.
-        # For `audio_channel_count` = N, its output values can range from `1` to `N`.
+        # to the recognized result for the audio from that channel. For `
+        # audio_channel_count` = N, its output values can range from `1` to `N`.
         # Corresponds to the JSON property `channelTag`
         # @return [Fixnum]
         attr_accessor :channel_tag
       
-        # Output only. The
-        # [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the
-        # language in this result. This language code was detected to have the most
-        # likelihood of being spoken in the audio.
+        # Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+        # language tag of the language in this result. This language code was detected
+        # to have the most likelihood of being spoken in the audio.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -256,12 +251,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -270,15 +265,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -302,40 +297,35 @@ module Google
         # Output only. The confidence estimate between 0.0 and 1.0. A higher number
         # indicates an estimated greater likelihood that the recognized words are
         # correct. This field is set only for the top alternative of a non-streaming
-        # result or, of a streaming result where `is_final=true`.
-        # This field is not guaranteed to be accurate and users should not rely on it
-        # to be always provided.
-        # The default of 0.0 is a sentinel value indicating `confidence` was not set.
+        # result or, of a streaming result where `is_final=true`. This field is not
+        # guaranteed to be accurate and users should not rely on it to be always
+        # provided. The default of 0.0 is a sentinel value indicating `confidence` was
+        # not set.
         # Corresponds to the JSON property `confidence`
         # @return [Float]
         attr_accessor :confidence
       
-        # Output only. Time offset relative to the beginning of the audio,
-        # and corresponding to the end of the spoken word.
-        # This field is only set if `enable_word_time_offsets=true` and only
-        # in the top hypothesis.
-        # This is an experimental feature and the accuracy of the time offset can
-        # vary.
+        # Output only. Time offset relative to the beginning of the audio, and
+        # corresponding to the end of the spoken word. This field is only set if `
+        # enable_word_time_offsets=true` and only in the top hypothesis. This is an
+        # experimental feature and the accuracy of the time offset can vary.
         # Corresponds to the JSON property `endOffset`
         # @return [String]
         attr_accessor :end_offset
       
-        # Output only. A distinct integer value is assigned for every speaker within
-        # the audio. This field specifies which one of those speakers was detected to
-        # have spoken this word. Value ranges from `1` to
-        # `diarization_config.max_speaker_count` . `speaker_tag` is set if
-        # `diarization_config.enable_speaker_diarization` = `true` and only in the
-        # top alternative.
+        # Output only. A distinct integer value is assigned for every speaker within the
+        # audio. This field specifies which one of those speakers was detected to have
+        # spoken this word. Value ranges from `1` to `diarization_config.
+        # max_speaker_count` . `speaker_tag` is set if `diarization_config.
+        # enable_speaker_diarization` = `true` and only in the top alternative.
         # Corresponds to the JSON property `speakerTag`
         # @return [Fixnum]
         attr_accessor :speaker_tag
       
-        # Output only. Time offset relative to the beginning of the audio,
-        # and corresponding to the start of the spoken word.
-        # This field is only set if `enable_word_time_offsets=true` and only
-        # in the top hypothesis.
-        # This is an experimental feature and the accuracy of the time offset can
-        # vary.
+        # Output only. Time offset relative to the beginning of the audio, and
+        # corresponding to the start of the spoken word. This field is only set if `
+        # enable_word_time_offsets=true` and only in the top hypothesis. This is an
+        # experimental feature and the accuracy of the time offset can vary.
         # Corresponds to the JSON property `startOffset`
         # @return [String]
         attr_accessor :start_offset

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

@@ -47,9 +47,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -79,15 +78,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter

data/generated/google/apis/sql_v1beta4.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/cloud-sql/
     module SqlV1beta4
       VERSION = 'V1beta4'
-      REVISION = '20200518'
+      REVISION = '20200820'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -26,14 +26,13 @@ module Google
       class AclEntry
         include Google::Apis::Core::Hashable
       
-        # The time when this access control entry expires in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # The time when this access control entry expires in RFC 3339 format, for
+        # example *2012-11-15T16:19:00.094Z*.
         # Corresponds to the JSON property `expirationTime`
         # @return [String]
         attr_accessor :expiration_time
       
-        # This is always <code>sql#aclEntry</code>.
+        # This is always *sql#aclEntry*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -43,7 +42,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The whitelisted value for the access control list.
+        # The allowlisted value for the access control list.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -103,7 +102,7 @@ module Google
         attr_accessor :enabled
         alias_method :enabled?, :enabled
       
-        # This is always <code>sql#backupConfiguration</code>.
+        # This is always *sql#backupConfiguration*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -125,8 +124,8 @@ module Google
         attr_accessor :replication_log_archiving_enabled
         alias_method :replication_log_archiving_enabled?, :replication_log_archiving_enabled
       
-        # Start time for the daily backup configuration in UTC timezone in the 24
-        # hour format - <code>HH:MM</code>.
+        # Start time for the daily backup configuration in UTC timezone in the 24 hour
+        # format - *HH:MM*.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -151,6 +150,11 @@ module Google
       class BackupRun
         include Google::Apis::Core::Hashable
       
+        # Specifies the kind of backup, PHYSICAL or DEFAULT_SNAPSHOT.
+        # Corresponds to the JSON property `backupKind`
+        # @return [String]
+        attr_accessor :backup_kind
+      
         # The description of this run, only applicable to on-demand backups.
         # Corresponds to the JSON property `description`
         # @return [String]
@@ -166,16 +170,14 @@ module Google
         # @return [Google::Apis::SqlV1beta4::DiskEncryptionStatus]
         attr_accessor :disk_encryption_status
       
-        # The time the backup operation completed in UTC timezone in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # 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`
         # @return [String]
         attr_accessor :end_time
       
-        # The time the run was enqueued in UTC timezone in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # The time the run was enqueued in UTC timezone in RFC 3339 format, for example *
+        # 2012-11-15T16:19:00.094Z*.
         # Corresponds to the JSON property `enqueuedTime`
         # @return [String]
         attr_accessor :enqueued_time
@@ -196,7 +198,7 @@ module Google
         # @return [String]
         attr_accessor :instance
       
-        # This is always <code>sql#backupRun</code>.
+        # This is always *sql#backupRun*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -211,9 +213,8 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # The time the backup operation actually started in UTC timezone in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # The time the backup operation actually started in UTC timezone in RFC 3339
+        # format, for example *2012-11-15T16:19:00.094Z*.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -228,9 +229,8 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # The start time of the backup window during which this the backup was
-        # attempted in <a href="https://tools.ietf.org/html/rfc3339">RFC 3339</a>
-        # format, for example <code>2012-11-15T16:19:00.094Z</code>.
+        # 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`
         # @return [String]
         attr_accessor :window_start_time
@@ -241,6 +241,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @backup_kind = args[:backup_kind] if args.key?(:backup_kind)
           @description = args[:description] if args.key?(:description)
           @disk_encryption_configuration = args[:disk_encryption_configuration] if args.key?(:disk_encryption_configuration)
           @disk_encryption_status = args[:disk_encryption_status] if args.key?(:disk_encryption_status)
@@ -268,13 +269,13 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::BackupRun>]
         attr_accessor :items
       
-        # This is always <code>sql#backupRunsList</code>.
+        # This is always *sql#backupRunsList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The continuation token, used to page through large result sets. Provide
-        # this value in a subsequent request to return the next page of results.
+        # The continuation token, used to page through large result sets. Provide this
+        # value in a subsequent request to return the next page of results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -305,7 +306,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :bin_log_position
       
-        # This is always <code>sql#binLogCoordinates</code>.
+        # This is always *sql#binLogCoordinates*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -336,7 +337,7 @@ module Google
         # @return [String]
         attr_accessor :destination_instance_name
       
-        # This is always <code>sql#cloneContext</code>.
+        # This is always *sql#cloneContext*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -369,18 +370,17 @@ module Google
       class Database
         include Google::Apis::Core::Hashable
       
-        # The MySQL charset value.
+        # The Cloud SQL charset value.
         # Corresponds to the JSON property `charset`
         # @return [String]
         attr_accessor :charset
       
-        # The MySQL collation value.
+        # The Cloud SQL collation value.
         # Corresponds to the JSON property `collation`
         # @return [String]
         attr_accessor :collation
       
-        # This field is deprecated and will be removed from a future version of the
-        # API.
+        # This field is deprecated and will be removed from a future version of the API.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -390,13 +390,13 @@ module Google
         # @return [String]
         attr_accessor :instance
       
-        # This is always <code>sql#database</code>.
+        # This is always *sql#database*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The name of the database in the Cloud SQL instance. This does not include
-        # the project ID or instance name.
+        # The name of the database in the Cloud SQL instance. This does not include the
+        # project ID or instance name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -439,18 +439,16 @@ module Google
       class DatabaseFlags
         include Google::Apis::Core::Hashable
       
-        # The name of the flag. These flags are passed at instance startup, so
-        # include both server options and system variables for MySQL. Flags should be
-        # specified with underscores, not hyphens. For more information, see <a
-        # href="/sql/docs/mysql/flags">Configuring Database Flags</a> in the Cloud
-        # SQL documentation.
+        # The name of the flag. These flags are passed at instance startup, so include
+        # both server options and system variables for MySQL. Flags are specified with
+        # underscores, not hyphens. For more information, see Configuring Database Flags
+        # in the Cloud SQL documentation.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The value of the flag. Booleans should be set to <code>on</code> for true
-        # and <code>off</code> for false. This field must be omitted if the flag
-        # doesn't take a value.
+        # The value of the flag. Booleans are set to *on* for true and *off* for false.
+        # This field must be omitted if the flag doesn't take a value.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -466,16 +464,13 @@ module Google
         end
       end
       
-      # A Cloud SQL instance resource.
+      # A Cloud SQL instance resource. Next field: 35
       class DatabaseInstance
         include Google::Apis::Core::Hashable
       
-        # <code>FIRST_GEN</code>: First Generation instance. MySQL only. <br
-        # /><code>SECOND_GEN</code>: Second Generation instance or PostgreSQL
-        # instance. <br /><code>EXTERNAL</code>: A database server that is not
-        # managed by Google. <br>This property is read-only; use the
-        # <code>tier</code> property in the <code>settings</code> object to determine
-        # the database type and Second or First Generation.
+        # *SECOND_GEN*: Cloud SQL database instance. *EXTERNAL*: A database server that
+        # is not managed by Google. This property is read-only; use the *tier* property
+        # in the *settings* object to determine the database type.
         # Corresponds to the JSON property `backendType`
         # @return [String]
         attr_accessor :backend_type
@@ -486,22 +481,18 @@ module Google
         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 <a
-        # href="https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/
-        # BtvFtdFeAgAJ">this
-        # announcement</a> for details.
+        # deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric
+        # in Cloud Monitoring API instead. Please see this announcement for details.
         # Corresponds to the JSON property `currentDiskSize`
         # @return [Fixnum]
         attr_accessor :current_disk_size
       
-        # The database engine type and version. The <code>databaseVersion</code>
-        # field can not be changed after instance creation.  MySQL Second Generation
-        # instances: <code>MYSQL_5_7</code> (default) or <code>MYSQL_5_6</code>.
-        # PostgreSQL instances: <code>POSTGRES_9_6</code> (default) or
-        # <code>POSTGRES_11 Beta</code> MySQL First Generation
-        # instances: <code>MYSQL_5_6</code> (default) or <code>MYSQL_5_5</code>
+        # The database engine type and version. The *databaseVersion* field cannot be
+        # changed after instance creation. MySQL instances: *MYSQL_5_7* (default), or *
+        # MYSQL_5_6*. PostgreSQL instances: *POSTGRES_9_6*, *POSTGRES_10*, *POSTGRES_11*
+        # or *POSTGRES_12* (default). SQL Server instances: *SQLSERVER_2017_STANDARD* (
+        # default), *SQLSERVER_2017_ENTERPRISE*, *SQLSERVER_2017_EXPRESS*, or *
+        # SQLSERVER_2017_WEB*.
         # Corresponds to the JSON property `databaseVersion`
         # @return [String]
         attr_accessor :database_version
@@ -516,14 +507,14 @@ module Google
         # @return [Google::Apis::SqlV1beta4::DiskEncryptionStatus]
         attr_accessor :disk_encryption_status
       
-        # This field is deprecated and will be removed from a future version of the
-        # API. Use the <code>settings.settingsVersion</code> field instead.
+        # This field is deprecated and will be removed from a future version of the API.
+        # Use the *settings.settingsVersion* field instead.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
-        # The name and status of the failover replica. This property is applicable
-        # only to Second Generation instances.
+        # The name and status of the failover replica. This property is applicable only
+        # to Second Generation instances.
         # Corresponds to the JSON property `failoverReplica`
         # @return [Google::Apis::SqlV1beta4::DatabaseInstance::FailoverReplica]
         attr_accessor :failover_replica
@@ -535,12 +526,10 @@ module Google
         # @return [String]
         attr_accessor :gce_zone
       
-        # The instance type. This can be one of the following.
-        # <br><code>CLOUD_SQL_INSTANCE</code>: A Cloud SQL instance that is not
-        # replicating from a master. <br><code>ON_PREMISES_INSTANCE</code>: An
-        # instance running on the
-        # customer's premises. <br><code>READ_REPLICA_INSTANCE</code>: A Cloud SQL
-        # instance configured as a read-replica.
+        # The instance type. This can be one of the following. *CLOUD_SQL_INSTANCE*: A
+        # Cloud SQL instance that is not replicating from a master. *
+        # ON_PREMISES_INSTANCE*: An instance running on the customer's premises. *
+        # READ_REPLICA_INSTANCE*: A Cloud SQL instance configured as a read-replica.
         # Corresponds to the JSON property `instanceType`
         # @return [String]
         attr_accessor :instance_type
@@ -550,13 +539,13 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::IpMapping>]
         attr_accessor :ip_addresses
       
-        # The IPv6 address assigned to the instance. This property is applicable only
-        # to First Generation instances.
+        # The IPv6 address assigned to the instance. (Deprecated) This property was
+        # applicable only to First Generation instances.
         # Corresponds to the JSON property `ipv6Address`
         # @return [String]
         attr_accessor :ipv6_address
       
-        # This is always <code>sql#instance</code>.
+        # This is always *sql#instance*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -587,13 +576,10 @@ module Google
         # @return [String]
         attr_accessor :project
       
-        # The geographical region. Can be <code>us-central</code>
-        # (<code>FIRST_GEN</code> instances only), <code>us-central1</code>
-        # (<code>SECOND_GEN</code> instances only), <code>asia-east1</code> or
-        # <code>europe-west1</code>. Defaults to <code>us-central</code> or
-        # <code>us-central1</code> depending on the instance type (First Generation
-        # or Second Generation). The region can not be changed after instance
-        # creation.
+        # The geographical region. Can be *us-central* (*FIRST_GEN* instances only) *us-
+        # central1* (*SECOND_GEN* instances only) *asia-east1* or *europe-west1*.
+        # Defaults to *us-central* or *us-central1* depending on the instance type. The
+        # region cannot be changed after instance creation.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -628,8 +614,8 @@ module Google
         # @return [Google::Apis::SqlV1beta4::SslCert]
         attr_accessor :server_ca_cert
       
-        # The service account email address assigned to the instance. This property
-        # is applicable only to Second Generation instances.
+        # The service account email address assigned to the instance. This property is
+        # applicable only to Second Generation instances.
         # Corresponds to the JSON property `serviceAccountEmailAddress`
         # @return [String]
         attr_accessor :service_account_email_address
@@ -640,13 +626,11 @@ module Google
         attr_accessor :settings
       
         # The current serving state of the Cloud SQL instance. This can be one of the
-        # following. <br><code>RUNNABLE</code>: The instance is running, or is ready
-        # to run when accessed. <br><code>SUSPENDED</code>: The instance is not
-        # available, for example due to problems with billing.
-        # <br><code>PENDING_CREATE</code>: The instance is being created.
-        # <br><code>MAINTENANCE</code>: The instance is down for maintenance.
-        # <br><code>FAILED</code>: The instance creation failed.
-        # <br><code>UNKNOWN_STATE</code>: The state of the instance is unknown.
+        # following. *RUNNABLE*: The instance is running, or is ready to run when
+        # accessed. *SUSPENDED*: The instance is not available, for example due to
+        # problems with billing. *PENDING_CREATE*: The instance is being created. *
+        # MAINTENANCE*: The instance is down for maintenance. *FAILED*: The instance
+        # creation failed. *UNKNOWN_STATE*: The state of the instance is unknown.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -693,23 +677,22 @@ module Google
           @suspension_reason = args[:suspension_reason] if args.key?(:suspension_reason)
         end
         
-        # The name and status of the failover replica. This property is applicable
-        # only to Second Generation instances.
+        # The name and status of the failover replica. This property is applicable only
+        # to Second Generation instances.
         class FailoverReplica
           include Google::Apis::Core::Hashable
         
-          # The availability status of the failover replica. A false status indicates
-          # that the failover replica is out of sync. The master can only failover to
-          # the failover replica when the status is true.
+          # The availability status of the failover replica. A false status indicates that
+          # the failover replica is out of sync. The master can only failover to the
+          # failover replica when the status is true.
           # Corresponds to the JSON property `available`
           # @return [Boolean]
           attr_accessor :available
           alias_method :available?, :available
         
           # 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.
+          # 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
@@ -735,7 +718,7 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::Database>]
         attr_accessor :items
       
-        # This is always <code>sql#databasesList</code>.
+        # This is always *sql#databasesList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -755,7 +738,7 @@ module Google
       class DemoteMasterConfiguration
         include Google::Apis::Core::Hashable
       
-        # This is always <code>sql#demoteMasterConfiguration</code>.
+        # This is always *sql#demoteMasterConfiguration*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -780,7 +763,7 @@ module Google
       class DemoteMasterContext
         include Google::Apis::Core::Hashable
       
-        # This is always <code>sql#demoteMasterContext</code>.
+        # This is always *sql#demoteMasterContext*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -796,13 +779,13 @@ module Google
         # @return [Google::Apis::SqlV1beta4::DemoteMasterConfiguration]
         attr_accessor :replica_configuration
       
-        # Verify GTID consistency for demote operation. Default value:
-        # <code>True</code>. Second Generation instances only.  Setting this flag to
-        # false enables you to bypass GTID consistency check between on-premises
-        # master and Cloud SQL instance during the demotion operation but also
-        # exposes you to the risk of future replication failures. Change the value
-        # only if you know the reason for the GTID divergence and are confident that
-        # doing so will not cause any replication issues.
+        # Verify GTID consistency for demote operation. Default value: *True*. Second
+        # Generation instances only. Setting this flag to false enables you to bypass
+        # GTID consistency check between on-premises master and Cloud SQL instance
+        # during the demotion operation but also exposes you to the risk of future
+        # replication failures. Change the value only if you know the reason for the
+        # GTID divergence and are confident that doing so will not cause any replication
+        # issues.
         # Corresponds to the JSON property `verifyGtidConsistency`
         # @return [Boolean]
         attr_accessor :verify_gtid_consistency
@@ -830,19 +813,19 @@ module Google
         # @return [String]
         attr_accessor :ca_certificate
       
-        # PEM representation of the slave's x509 certificate.
+        # PEM representation of the replica's x509 certificate.
         # Corresponds to the JSON property `clientCertificate`
         # @return [String]
         attr_accessor :client_certificate
       
-        # PEM representation of the slave's private key. The corresponsing public key
-        # is encoded in the client's certificate. The format of the slave's private
+        # PEM representation of the replica's private key. The corresponsing public key
+        # is encoded in the client's certificate. The format of the replica's private
         # key can be either PKCS #1 or PKCS #8.
         # Corresponds to the JSON property `clientKey`
         # @return [String]
         attr_accessor :client_key
       
-        # This is always <code>sql#demoteMasterMysqlReplicaConfiguration</code>.
+        # This is always *sql#demoteMasterMysqlReplicaConfiguration*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -876,7 +859,7 @@ module Google
       class DiskEncryptionConfiguration
         include Google::Apis::Core::Hashable
       
-        # This is always <code>sql#diskEncryptionConfiguration</code>.
+        # This is always *sql#diskEncryptionConfiguration*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -901,7 +884,7 @@ module Google
       class DiskEncryptionStatus
         include Google::Apis::Core::Hashable
       
-        # This is always <code>sql#diskEncryptionStatus</code>.
+        # This is always *sql#diskEncryptionStatus*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -931,27 +914,24 @@ module Google
         # @return [Google::Apis::SqlV1beta4::ExportContext::CsvExportOptions]
         attr_accessor :csv_export_options
       
-        # Databases to be exported. <br /> <b>MySQL instances:</b> If
-        # <code>fileType</code> is <code>SQL</code> and no database is specified, all
-        # databases are exported, except for the <code>mysql</code> system database.
-        # If <code>fileType</code> is <code>CSV</code>, you can specify one database,
-        # either by using this property or by using the
-        # <code>csvExportOptions.selectQuery</code> property, which takes precedence
-        # over this property. <br /> <b>PostgreSQL instances:</b> You must specify
-        # one database to be exported. If <code>fileType</code> is <code>CSV</code>,
-        # this database must match the one specified in the
-        # <code>csvExportOptions.selectQuery</code> property.
+        # Databases to be exported. *MySQL instances:* If *fileType* is *SQL* and no
+        # database is specified, all databases are exported, except for the *mysql*
+        # system database. If *fileType* is *CSV*, you can specify one database, either
+        # by using this property or by using the *csvExportOptions.selectQuery* property,
+        # which takes precedence over this property. *PostgreSQL instances:* You must
+        # specify one database to be exported. If *fileType* is *CSV*, this database
+        # must match the one specified in the *csvExportOptions.selectQuery* property.
         # Corresponds to the JSON property `databases`
         # @return [Array<String>]
         attr_accessor :databases
       
-        # The file type for the specified uri. <br><code>SQL</code>: The file
-        # contains SQL statements. <br><code>CSV</code>: The file contains CSV data.
+        # The file type for the specified uri. *SQL*: The file contains SQL statements. *
+        # CSV*: The file contains CSV data.
         # Corresponds to the JSON property `fileType`
         # @return [String]
         attr_accessor :file_type
       
-        # This is always <code>sql#exportContext</code>.
+        # This is always *sql#exportContext*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -967,12 +947,10 @@ module Google
         # @return [Google::Apis::SqlV1beta4::ExportContext::SqlExportOptions]
         attr_accessor :sql_export_options
       
-        # The path to the file in Google Cloud Storage where the export will be
-        # stored. The URI is in the form <code>gs:
-        # //bucketName/fileName</code>. If the file already exists, the requests
-        # // succeeds, but the operation fails. If <code>fileType</code> is
-        # // <code>SQL</code> and the filename ends with .gz, the contents are
-        # // compressed.
+        # The path to the file in Google Cloud Storage where the export will be stored.
+        # The URI is in the form *gs: //bucketName/fileName*. If the file already exists,
+        # the requests // succeeds, but the operation fails. If *fileType* is // *SQL*
+        # and the filename ends with .gz, the contents are // compressed.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -1026,9 +1004,9 @@ module Google
           attr_accessor :schema_only
           alias_method :schema_only?, :schema_only
         
-          # Tables to export, or that were exported, from the specified database. If
-          # you specify tables, specify one and only one database. For PostgreSQL
-          # instances, you can specify only one table.
+          # Tables to export, or that were exported, from the specified database. If you
+          # specify tables, specify one and only one database. For PostgreSQL instances,
+          # you can specify only one table.
           # Corresponds to the JSON property `tables`
           # @return [Array<String>]
           attr_accessor :tables
@@ -1048,12 +1026,10 @@ module Google
           class MysqlExportOptions
             include Google::Apis::Core::Hashable
           
-            # Option to include SQL statement required to set up replication.
-            # If set to <code>1</code>, the dump file includes
-            # a CHANGE MASTER TO statement with the binary log coordinates.
-            # If set to <code>2</code>, the CHANGE MASTER TO statement is written as
-            # a SQL comment, and has no effect.
-            # All other values are ignored.
+            # Option to include SQL statement required to set up replication. If set to *1*,
+            # the dump file includes a CHANGE MASTER TO statement with the binary log
+            # coordinates. If set to *2*, the CHANGE MASTER TO statement is written as a SQL
+            # comment, and has no effect. All other values are ignored.
             # Corresponds to the JSON property `masterData`
             # @return [Fixnum]
             attr_accessor :master_data
@@ -1074,7 +1050,7 @@ module Google
       class FailoverContext
         include Google::Apis::Core::Hashable
       
-        # This is always <code>sql#failoverContext</code>.
+        # This is always *sql#failoverContext*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1100,21 +1076,19 @@ module Google
       class Flag
         include Google::Apis::Core::Hashable
       
-        # Use this field if only certain integers are accepted. Can be combined
-        # with min_value and max_value to add additional values.
+        # Use this field if only certain integers are accepted. Can be combined with
+        # min_value and max_value to add additional values.
         # Corresponds to the JSON property `allowedIntValues`
         # @return [Array<Fixnum>]
         attr_accessor :allowed_int_values
       
-        # For <code>STRING</code> flags, a list of strings that the value can be set
-        # to.
+        # For *STRING* flags, a list of strings that the value can be set to.
         # Corresponds to the JSON property `allowedStringValues`
         # @return [Array<String>]
         attr_accessor :allowed_string_values
       
-        # The database version this flag applies to. Can be <code>MYSQL_5_5</code>,
-        # <code>MYSQL_5_6</code>, or <code>MYSQL_5_7</code>. <code>MYSQL_5_7</code>
-        # is applicable only to Second Generation instances.
+        # The database version this flag applies to. Can be *MYSQL_5_5*, *MYSQL_5_6*, or
+        # *MYSQL_5_7*. *MYSQL_5_7* is applicable only to Second Generation instances.
         # Corresponds to the JSON property `appliesTo`
         # @return [Array<String>]
         attr_accessor :applies_to
@@ -1125,23 +1099,23 @@ module Google
         attr_accessor :in_beta
         alias_method :in_beta?, :in_beta
       
-        # This is always <code>sql#flag</code>.
+        # This is always *sql#flag*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # For <code>INTEGER</code> flags, the maximum allowed value.
+        # For *INTEGER* flags, the maximum allowed value.
         # Corresponds to the JSON property `maxValue`
         # @return [Fixnum]
         attr_accessor :max_value
       
-        # For <code>INTEGER</code> flags, the minimum allowed value.
+        # For *INTEGER* flags, the minimum allowed value.
         # Corresponds to the JSON property `minValue`
         # @return [Fixnum]
         attr_accessor :min_value
       
-        # This is the name of the flag. Flag names always use underscores, not
-        # hyphens, e.g. <code>max_allowed_packet</code>
+        # This is the name of the flag. Flag names always use underscores, not hyphens,
+        # for example: *max_allowed_packet*
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1153,10 +1127,9 @@ module Google
         attr_accessor :requires_restart
         alias_method :requires_restart?, :requires_restart
       
-        # The type of the flag. Flags are typed to being <code>BOOLEAN</code>,
-        # <code>STRING</code>, <code>INTEGER</code> or <code>NONE</code>.
-        # <code>NONE</code> is used for flags which do not take a value, such as
-        # <code>skip_grant_tables</code>.
+        # The type of the flag. Flags are typed to being *BOOLEAN*, *STRING*, *INTEGER*
+        # or *NONE*. *NONE* is used for flags which do not take a value, such as *
+        # skip_grant_tables*.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1189,7 +1162,7 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::Flag>]
         attr_accessor :items
       
-        # This is always <code>sql#flagsList</code>.
+        # This is always *sql#flagsList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1219,17 +1192,16 @@ module Google
         # @return [Google::Apis::SqlV1beta4::ImportContext::CsvImportOptions]
         attr_accessor :csv_import_options
       
-        # The target database for the import. If <code>fileType</code> is
-        # <code>SQL</code>, this field is required only if the import file does not
-        # specify a database, and is overridden by any database specification in the
-        # import file. If <code>fileType</code> is <code>CSV</code>, one database
-        # must be specified.
+        # The target database for the import. If *fileType* is *SQL*, this field is
+        # required only if the import file does not specify a database, and is
+        # overridden by any database specification in the import file. If *fileType* is *
+        # CSV*, one database must be specified.
         # Corresponds to the JSON property `database`
         # @return [String]
         attr_accessor :database
       
-        # The file type for the specified uri. <br><code>SQL</code>: The file
-        # contains SQL statements. <br><code>CSV</code>: The file contains CSV data.
+        # The file type for the specified uri. *SQL*: The file contains SQL statements. *
+        # CSV*: The file contains CSV data.
         # Corresponds to the JSON property `fileType`
         # @return [String]
         attr_accessor :file_type
@@ -1239,16 +1211,15 @@ module Google
         # @return [String]
         attr_accessor :import_user
       
-        # This is always <code>sql#importContext</code>.
+        # This is always *sql#importContext*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Path to the import file in Cloud Storage, in the form
-        # <code>gs:
-        # //bucketName/fileName</code>. Compressed gzip files (.gz) are supported
-        # // when <code>fileType</code> is <code>SQL</code>. The instance must have
-        # // write permissions to the bucket and read access to the file.
+        # Path to the import file in Cloud Storage, in the form *gs: //bucketName/
+        # fileName*. Compressed gzip files (.gz) are supported // when *fileType* is *
+        # SQL*. The instance must have // write permissions to the bucket and read
+        # access to the file.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -1290,9 +1261,9 @@ module Google
           class EncryptionOptions
             include Google::Apis::Core::Hashable
           
-            # Path to the Certificate (.cer) in Cloud Storage, in the form
-            # <code>gs://bucketName/fileName</code>. The instance must have
-            # write permissions to the bucket and read access to the file.
+            # Path to the Certificate (.cer) in Cloud Storage, in the form *gs://bucketName/
+            # fileName*. The instance must have write permissions to the bucket and read
+            # access to the file.
             # Corresponds to the JSON property `certPath`
             # @return [String]
             attr_accessor :cert_path
@@ -1302,9 +1273,9 @@ module Google
             # @return [String]
             attr_accessor :pvk_password
           
-            # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
-            # form <code>gs://bucketName/fileName</code>. The instance must have
-            # write permissions to the bucket and read access to the file.
+            # Path to the Certificate Private Key (.pvk) in Cloud Storage, in the form *gs://
+            # bucketName/fileName*. The instance must have write permissions to the bucket
+            # and read access to the file.
             # Corresponds to the JSON property `pvkPath`
             # @return [String]
             attr_accessor :pvk_path
@@ -1326,8 +1297,8 @@ module Google
         class CsvImportOptions
           include Google::Apis::Core::Hashable
         
-          # The columns to which CSV data is imported. If not specified, all columns
-          # of the database table are loaded with CSV data.
+          # The columns to which CSV data is imported. If not specified, all columns of
+          # the database table are loaded with CSV data.
           # Corresponds to the JSON property `columns`
           # @return [Array<String>]
           attr_accessor :columns
@@ -1453,13 +1424,13 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::DatabaseInstance>]
         attr_accessor :items
       
-        # This is always <code>sql#instancesList</code>.
+        # This is always *sql#instancesList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The continuation token, used to page through large result sets. Provide
-        # this value in a subsequent request to return the next page of results.
+        # The continuation token, used to page through large result sets. Provide this
+        # value in a subsequent request to return the next page of results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1496,7 +1467,7 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::SslCert>]
         attr_accessor :certs
       
-        # This is always <code>sql#instancesListServerCas</code>.
+        # This is always *sql#instancesListServerCas*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1517,8 +1488,8 @@ module Google
       class InstancesRestoreBackupRequest
         include Google::Apis::Core::Hashable
       
-        # Database instance restore from backup context.
-        # Backup context contains source instance id and project id.
+        # Database instance restore from backup context. Backup context contains source
+        # instance id and project id.
         # Corresponds to the JSON property `restoreBackupContext`
         # @return [Google::Apis::SqlV1beta4::RestoreBackupContext]
         attr_accessor :restore_backup_context
@@ -1576,29 +1547,27 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The list of external networks that are allowed to connect to the instance
-        # using the IP. In <a
-        # href="http://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation">CIDR
-        # notation</a>, also known as 'slash' notation (e.g.
-        # <code>192.168.100.0/24</code>).
+        # using the IP. In 'CIDR' notation, also known as 'slash' notation (for example:
+        # *192.168.100.0/24*).
         # Corresponds to the JSON property `authorizedNetworks`
         # @return [Array<Google::Apis::SqlV1beta4::AclEntry>]
         attr_accessor :authorized_networks
       
-        # Whether the instance should be assigned an IP address or not.
+        # Whether the instance is assigned a public IP address or not.
         # Corresponds to the JSON property `ipv4Enabled`
         # @return [Boolean]
         attr_accessor :ipv4_enabled
         alias_method :ipv4_enabled?, :ipv4_enabled
       
         # The resource link for the VPC network from which the Cloud SQL instance is
-        # accessible for private IP. For example,
-        # <code>/projects/myProject/global/networks/default</code>. This setting can
-        # be updated, but it cannot be removed after it is set.
+        # accessible for private IP. For example, */projects/myProject/global/networks/
+        # default*. This setting can be updated, but it cannot be removed after it is
+        # set.
         # Corresponds to the JSON property `privateNetwork`
         # @return [String]
         attr_accessor :private_network
       
-        # Whether SSL connections over IP should be enforced or not.
+        # Whether SSL connections over IP are enforced or not.
         # Corresponds to the JSON property `requireSsl`
         # @return [Boolean]
         attr_accessor :require_ssl
@@ -1626,19 +1595,17 @@ module Google
         # @return [String]
         attr_accessor :ip_address
       
-        # The due time for this IP to be retired in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>. This field is only available when
-        # the IP is scheduled to be retired.
+        # The due time for this IP to be retired in RFC 3339 format, for example *2012-
+        # 11-15T16:19:00.094Z*. This field is only available when the IP is scheduled to
+        # be retired.
         # Corresponds to the JSON property `timeToRetire`
         # @return [String]
         attr_accessor :time_to_retire
       
-        # The type of this IP address. A <code>PRIMARY</code> address is a public
-        # address that can accept incoming connections. A <code>PRIVATE</code>
-        # address is a private address that can accept incoming connections. An
-        # <code>OUTGOING</code> address is the source address of connections
-        # originating from the instance, if supported.
+        # The type of this IP address. A *PRIMARY* address is a public address that can
+        # accept incoming connections. A *PRIVATE* address is a private 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
@@ -1655,26 +1622,26 @@ module Google
         end
       end
       
-      # 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 available, the instance will be located as close as possible
-      # within the region. Only one location may be specified.
+      # Preferred location. This specifies where a Cloud SQL instance is located,
+      # either in a specific Compute Engine zone, or co-located with an App Engine
+      # application. Note that if the preferred location is not available, the
+      # instance will be located as close as possible within the region. Only one
+      # location may be specified.
       class LocationPreference
         include Google::Apis::Core::Hashable
       
-        # The AppEngine application to follow, it must be in the same region as the
+        # The App Engine application to follow, it must be in the same region as the
         # Cloud SQL instance.
         # Corresponds to the JSON property `followGaeApplication`
         # @return [String]
         attr_accessor :follow_gae_application
       
-        # This is always <code>sql#locationPreference</code>.
+        # This is always *sql#locationPreference*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The preferred Compute Engine zone (e.g. us-central1-a, us-central1-b,
+        # The preferred Compute Engine zone (for example: us-central1-a, us-central1-b,
         # etc.).
         # Corresponds to the JSON property `zone`
         # @return [String]
@@ -1692,8 +1659,8 @@ module Google
         end
       end
       
-      # Maintenance window. This specifies when a v2 Cloud SQL instance should
-      # preferably be restarted for system maintenance purposes.
+      # Maintenance window. This specifies when a Cloud SQL instance is restarted for
+      # system maintenance purposes.
       class MaintenanceWindow
         include Google::Apis::Core::Hashable
       
@@ -1707,15 +1674,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :hour
       
-        # This is always <code>sql#maintenanceWindow</code>.
+        # This is always *sql#maintenanceWindow*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Maintenance timing setting: <code>canary</code> (Earlier) or
-        # <code>stable</code> (Later). <br /><a
-        # href="/sql/docs/db_path/instance-settings#maintenance-timing-2ndgen">
-        # Learn more</a>.
+        # Maintenance timing setting: *canary* (Earlier) or *stable* (Later). Learn more.
         # Corresponds to the JSON property `updateTrack`
         # @return [String]
         attr_accessor :update_track
@@ -1742,12 +1706,12 @@ module Google
         # @return [String]
         attr_accessor :ca_certificate
       
-        # PEM representation of the slave's x509 certificate.
+        # PEM representation of the replica's x509 certificate.
         # Corresponds to the JSON property `clientCertificate`
         # @return [String]
         attr_accessor :client_certificate
       
-        # PEM representation of the slave's private key. The corresponsing public key
+        # PEM representation of the replica's private key. The corresponsing public key
         # is encoded in the client's certificate.
         # Corresponds to the JSON property `clientKey`
         # @return [String]
@@ -1758,17 +1722,16 @@ module Google
         # @return [Fixnum]
         attr_accessor :connect_retry_interval
       
-        # Path to a SQL dump file in Google Cloud Storage from which the slave
-        # instance is to be created. The URI is in the form gs:
-        # //bucketName/fileName. Compressed gzip files (.gz) are also supported.
-        # // Dumps should have the binlog co-ordinates from which replication should
-        # // begin. This can be accomplished by setting --master-data to 1 when using
-        # // mysqldump.
+        # Path to a SQL dump file in Google Cloud Storage from which the replica
+        # instance is to be created. The URI is in the form gs://bucketName/fileName.
+        # Compressed gzip files (.gz) are also supported. Dumps have the binlog co-
+        # ordinates from which replication begins. This can be accomplished by setting --
+        # master-data to 1 when using mysqldump.
         # Corresponds to the JSON property `dumpFilePath`
         # @return [String]
         attr_accessor :dump_file_path
       
-        # This is always <code>sql#mysqlReplicaConfiguration</code>.
+        # This is always *sql#mysqlReplicaConfiguration*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1793,8 +1756,8 @@ module Google
         # @return [String]
         attr_accessor :username
       
-        # Whether or not to check the master's Common Name value in the certificate
-        # that it sends during the SSL handshake.
+        # Whether or not to check the master's Common Name value in the certificate that
+        # it sends during the SSL handshake.
         # Corresponds to the JSON property `verifyServerCertificate`
         # @return [Boolean]
         attr_accessor :verify_server_certificate
@@ -1829,12 +1792,12 @@ module Google
         # @return [String]
         attr_accessor :ca_certificate
       
-        # PEM representation of the slave's x509 certificate.
+        # PEM representation of the replica's x509 certificate.
         # Corresponds to the JSON property `clientCertificate`
         # @return [String]
         attr_accessor :client_certificate
       
-        # PEM representation of the slave's private key. The corresponsing public key
+        # PEM representation of the replica's private key. The corresponsing public key
         # is encoded in the client's certificate.
         # Corresponds to the JSON property `clientKey`
         # @return [String]
@@ -1850,7 +1813,7 @@ module Google
         # @return [String]
         attr_accessor :host_port
       
-        # This is always <code>sql#onPremisesConfiguration</code>.
+        # This is always *sql#onPremisesConfiguration*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1882,15 +1845,14 @@ module Google
         end
       end
       
-      # An Operation resource.&nbsp;For successful operations that return an
-      # Operation resource, only the fields relevant to the operation are populated
-      # in the resource.
+      # An Operation resource. For successful operations that return an Operation
+      # resource, only the fields relevant to the operation are populated in the
+      # resource.
       class Operation
         include Google::Apis::Core::Hashable
       
-        # The time this operation finished in UTC timezone in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # The time this operation finished in UTC timezone in RFC 3339 format, for
+        # example *2012-11-15T16:19:00.094Z*.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
@@ -1910,31 +1872,27 @@ module Google
         # @return [Google::Apis::SqlV1beta4::ImportContext]
         attr_accessor :import_context
       
-        # The time this operation was enqueued in UTC timezone in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # The time this operation was enqueued in UTC timezone in RFC 3339 format, for
+        # example *2012-11-15T16:19:00.094Z*.
         # Corresponds to the JSON property `insertTime`
         # @return [String]
         attr_accessor :insert_time
       
-        # This is always <code>sql#operation</code>.
+        # This is always *sql#operation*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # An identifier that uniquely identifies the operation. You can use this
-        # identifier to retrieve the Operations resource that has information about
-        # the operation.
+        # identifier to retrieve the Operations resource that has information about the
+        # operation.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The type of the operation. Valid values are <code>CREATE</code>,
-        # <code>DELETE</code>, <code>UPDATE</code>, <code>RESTART</code>,
-        # <code>IMPORT</code>, <code>EXPORT</code>, <code>BACKUP_VOLUME</code>,
-        # <code>RESTORE_VOLUME</code>, <code>CREATE_USER</code>,
-        # <code>DELETE_USER</code>, <code>CREATE_DATABASE</code>,
-        # <code>DELETE_DATABASE</code> .
+        # The type of the operation. Valid values are: *CREATE* *DELETE* *UPDATE* *
+        # RESTART* *IMPORT* *EXPORT* *BACKUP_VOLUME* *RESTORE_VOLUME* *CREATE_USER* *
+        # DELETE_USER* *CREATE_DATABASE* *DELETE_DATABASE*
         # Corresponds to the JSON property `operationType`
         # @return [String]
         attr_accessor :operation_type
@@ -1944,16 +1902,14 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # The time this operation actually started in UTC timezone in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # The time this operation actually started in UTC timezone in RFC 3339 format,
+        # for example *2012-11-15T16:19:00.094Z*.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # The status of an operation. Valid values are <code>PENDING</code>,
-        # <code>RUNNING</code>, <code>DONE</code>,
-        # <code>SQL_OPERATION_STATUS_UNSPECIFIED</code>.
+        # The status of an operation. Valid values are: *PENDING* *RUNNING* *DONE* *
+        # SQL_OPERATION_STATUS_UNSPECIFIED*
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -2011,7 +1967,7 @@ module Google
         # @return [String]
         attr_accessor :code
       
-        # This is always <code>sql#operationError</code>.
+        # This is always *sql#operationError*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2042,7 +1998,7 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::OperationError>]
         attr_accessor :errors
       
-        # This is always <code>sql#operationErrors</code>.
+        # This is always *sql#operationErrors*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2067,13 +2023,13 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::Operation>]
         attr_accessor :items
       
-        # This is always <code>sql#operationsList</code>.
+        # This is always *sql#operationsList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The continuation token, used to page through large result sets. Provide
-        # this value in a subsequent request to return the next page of results.
+        # The continuation token, used to page through large result sets. Provide this
+        # value in a subsequent request to return the next page of results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2094,18 +2050,17 @@ module Google
       class ReplicaConfiguration
         include Google::Apis::Core::Hashable
       
-        # Specifies if the replica is the failover target. If the field is set to
-        # <code>true</code> the replica will be designated as a failover replica. In
-        # case the master instance fails, the replica instance will be promoted as
-        # the new master instance.  <p>Only one replica can be specified as failover
-        # target, and the replica has to be in different zone with the master
-        # instance.
+        # Specifies if the replica is the failover target. If the field is set to *true*
+        # the replica will be designated as a failover replica. In case the master
+        # instance fails, the replica instance will be promoted as the new master
+        # instance. Only one replica can be specified as failover target, and the
+        # replica has to be in different zone with the master instance.
         # Corresponds to the JSON property `failoverTarget`
         # @return [Boolean]
         attr_accessor :failover_target
         alias_method :failover_target?, :failover_target
       
-        # This is always <code>sql#replicaConfiguration</code>.
+        # This is always *sql#replicaConfiguration*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2137,9 +2092,8 @@ module Google
         attr_accessor :reschedule_type
       
         # Optional. Timestamp when the maintenance shall be rescheduled to if
-        # reschedule_type=SPECIFIC_TIME, in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for
-        # example <code>2012-11-15T16:19:00.094Z</code>.
+        # reschedule_type=SPECIFIC_TIME, in RFC 3339 format, for example *2012-11-15T16:
+        # 19:00.094Z*.
         # Corresponds to the JSON property `scheduleTime`
         # @return [String]
         attr_accessor :schedule_time
@@ -2155,8 +2109,8 @@ module Google
         end
       end
       
-      # Database instance restore from backup context.
-      # Backup context contains source instance id and project id.
+      # Database instance restore from backup context. Backup context contains source
+      # instance id and project id.
       class RestoreBackupContext
         include Google::Apis::Core::Hashable
       
@@ -2170,7 +2124,7 @@ module Google
         # @return [String]
         attr_accessor :instance_id
       
-        # This is always <code>sql#restoreBackupContext</code>.
+        # This is always *sql#restoreBackupContext*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2197,7 +2151,7 @@ module Google
       class RotateServerCaContext
         include Google::Apis::Core::Hashable
       
-        # This is always <code>sql#rotateServerCaContext</code>.
+        # This is always *sql#rotateServerCaContext*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2224,32 +2178,25 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The activation policy specifies when the instance is activated; it is
-        # applicable only when the instance state is <code>RUNNABLE</code>. Valid
-        # values: <br><code>ALWAYS</code>: The instance is on, and remains so even in
-        # the absence of connection requests. <br><code>NEVER</code>: The instance is
-        # off; it is not activated, even if a connection request arrives.
-        # <br><code>ON_DEMAND</code>: First Generation instances only. The instance
-        # responds to incoming requests, and turns itself off when not in use.
-        # Instances with <code>PER_USE</code> pricing turn off after 15 minutes of
-        # inactivity. Instances with <code>PER_PACKAGE</code> pricing turn off after
-        # 12 hours of inactivity.
+        # applicable only when the instance state is RUNNABLE. Valid values: *ALWAYS*:
+        # The instance is on, and remains so even in the absence of connection requests.
+        # *NEVER*: The instance is off; it is not activated, even if a connection
+        # request arrives.
         # Corresponds to the JSON property `activationPolicy`
         # @return [String]
         attr_accessor :activation_policy
       
-        # The App Engine app IDs that can access this instance. First Generation
-        # instances only.
+        # The App Engine app IDs that can access this instance. (Deprecated) Applied to
+        # First Generation instances only.
         # Corresponds to the JSON property `authorizedGaeApplications`
         # @return [Array<String>]
         attr_accessor :authorized_gae_applications
       
-        # Availability type (PostgreSQL and MySQL instances only). Potential values:
-        # <br><code>ZONAL</code>: The instance serves data from only one zone.
-        # Outages in that zone affect data accessibility. <br><code>REGIONAL</code>:
-        # The instance can serve data from more than one zone in a region (it is
-        # highly available). <br>For more information, see <a
-        # href="https://cloud.google.com/sql/docs/postgres/high-availability">Overview
-        # of the High Availability Configuration</a>.
+        # Availability type. Potential values: *ZONAL*: The instance serves data from
+        # only one zone. Outages in that zone affect data accessibility. *REGIONAL*: The
+        # instance can serve data from more than one zone in a region (it is highly
+        # available). For more information, see Overview of the High Availability
+        # Configuration.
         # Corresponds to the JSON property `availabilityType`
         # @return [String]
         attr_accessor :availability_type
@@ -2259,22 +2206,26 @@ module Google
         # @return [Google::Apis::SqlV1beta4::BackupConfiguration]
         attr_accessor :backup_configuration
       
-        # Configuration specific to read replica instances. Indicates whether
-        # database flags for crash-safe replication are enabled. This property is
-        # only applicable to First Generation instances.
+        # The name of server Instance collation.
+        # Corresponds to the JSON property `collation`
+        # @return [String]
+        attr_accessor :collation
+      
+        # Configuration specific to read replica instances. Indicates whether database
+        # flags for crash-safe replication are enabled. This property was only
+        # applicable to First Generation instances.
         # Corresponds to the JSON property `crashSafeReplicationEnabled`
         # @return [Boolean]
         attr_accessor :crash_safe_replication_enabled
         alias_method :crash_safe_replication_enabled?, :crash_safe_replication_enabled
       
-        # The size of data disk, in GB. The data disk size minimum is 10GB. Not used
-        # for First Generation instances.
+        # The size of data disk, in GB. The data disk size minimum is 10GB.
         # Corresponds to the JSON property `dataDiskSizeGb`
         # @return [Fixnum]
         attr_accessor :data_disk_size_gb
       
-        # The type of data disk: <code>PD_SSD</code> (default) or
-        # <code>PD_HDD</code>. Not used for First Generation instances.
+        # The type of data disk: PD_SSD (default) or PD_HDD. Not used for First
+        # Generation instances.
         # Corresponds to the JSON property `dataDiskType`
         # @return [String]
         attr_accessor :data_disk_type
@@ -2296,74 +2247,68 @@ module Google
         # @return [Google::Apis::SqlV1beta4::IpConfiguration]
         attr_accessor :ip_configuration
       
-        # This is always <code>sql#settings</code>.
+        # This is always *sql#settings*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 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 available, the instance will be located as close as possible
-        # within the region. Only one location may be specified.
+        # Preferred location. This specifies where a Cloud SQL instance is located,
+        # either in a specific Compute Engine zone, or co-located with an App Engine
+        # application. Note that if the preferred location is not available, the
+        # instance will be located as close as possible within the region. Only one
+        # location may be specified.
         # Corresponds to the JSON property `locationPreference`
         # @return [Google::Apis::SqlV1beta4::LocationPreference]
         attr_accessor :location_preference
       
-        # Maintenance window. This specifies when a v2 Cloud SQL instance should
-        # preferably be restarted for system maintenance purposes.
+        # Maintenance window. This specifies when a Cloud SQL instance is restarted for
+        # system maintenance purposes.
         # Corresponds to the JSON property `maintenanceWindow`
         # @return [Google::Apis::SqlV1beta4::MaintenanceWindow]
         attr_accessor :maintenance_window
       
-        # The pricing plan for this instance. This can be either <code>PER_USE</code>
-        # or <code>PACKAGE</code>. Only <code>PER_USE</code> is supported for Second
-        # Generation instances.
+        # The pricing plan for this instance. This can be either *PER_USE* or *PACKAGE*.
+        # Only *PER_USE* is supported for Second Generation instances.
         # Corresponds to the JSON property `pricingPlan`
         # @return [String]
         attr_accessor :pricing_plan
       
-        # The type of replication this instance uses. This can be either
-        # <code>ASYNCHRONOUS</code> or <code>SYNCHRONOUS</code>. This property is
-        # only applicable to First Generation instances.
+        # The type of replication this instance uses. This can be either *ASYNCHRONOUS*
+        # or *SYNCHRONOUS*. (Deprecated_ This property was only applicable to First
+        # Generation instances.
         # Corresponds to the JSON property `replicationType`
         # @return [String]
         attr_accessor :replication_type
       
-        # The version of instance settings. This is a required field for update
-        # method to make sure concurrent updates are handled properly. During update,
-        # use the most recent settingsVersion value for this instance and do not try
-        # to update this value.
+        # The version of instance settings. This is a required field for update method
+        # to make sure concurrent updates are handled properly. During update, use the
+        # most recent settingsVersion value for this instance and do not try to update
+        # this value.
         # Corresponds to the JSON property `settingsVersion`
         # @return [Fixnum]
         attr_accessor :settings_version
       
         # Configuration to increase storage size automatically. The default value is
-        # true. Not used for First Generation instances.
+        # true.
         # Corresponds to the JSON property `storageAutoResize`
         # @return [Boolean]
         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. Not used
-        # for First Generation instances.
+        # The maximum size to which storage capacity can be automatically increased. The
+        # default value is 0, which specifies that there is no limit.
         # Corresponds to the JSON property `storageAutoResizeLimit`
         # @return [Fixnum]
         attr_accessor :storage_auto_resize_limit
       
-        # The tier (or machine type) for this instance, for example
-        # <code>db-n1-standard-1</code> (MySQL instances) or
-        # <code>db-custom-1-3840</code> (PostgreSQL instances). For MySQL instances,
-        # this property determines whether the instance is First or Second
-        # Generation. For more information, see <a
-        # href="/sql/docs/db_path/instance-settings">Instance Settings</a>.
+        # The tier (or machine type) for this instance, for example *db-n1-standard-1* (
+        # MySQL instances) or *db-custom-1-3840* (PostgreSQL instances).
         # Corresponds to the JSON property `tier`
         # @return [String]
         attr_accessor :tier
       
-        # User-provided labels, represented as a dictionary where each label is a
-        # single key value pair.
+        # User-provided labels, represented as a dictionary where each label is a single
+        # key value pair.
         # Corresponds to the JSON property `userLabels`
         # @return [Hash<String,String>]
         attr_accessor :user_labels
@@ -2378,6 +2323,7 @@ module Google
           @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)
+          @collation = args[:collation] if args.key?(:collation)
           @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)
           @data_disk_type = args[:data_disk_type] if args.key?(:data_disk_type)
@@ -2406,7 +2352,7 @@ module Google
         # @return [String]
         attr_accessor :detail
       
-        # This is always <code>sql#migrationSettingError</code>.
+        # This is always *sql#migrationSettingError*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2456,7 +2402,7 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::SqlExternalSyncSettingError>]
         attr_accessor :errors
       
-        # This is always <code>sql#migrationSettingErrorList</code>.
+        # This is always *sql#migrationSettingErrorList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2570,21 +2516,19 @@ module Google
         # @return [String]
         attr_accessor :cert_serial_number
       
-        # User supplied name.  Constrained to [a-zA-Z.-_ ]+.
+        # User supplied name. Constrained to [a-zA-Z.-_ ]+.
         # Corresponds to the JSON property `commonName`
         # @return [String]
         attr_accessor :common_name
       
-        # The time when the certificate was created in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>
+        # The time when the certificate was created in RFC 3339 format, for example *
+        # 2012-11-15T16:19:00.094Z*
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # The time when the certificate expires in <a
-        # href="https://tools.ietf.org/html/rfc3339">RFC 3339</a> format, for example
-        # <code>2012-11-15T16:19:00.094Z</code>.
+        # The time when the certificate expires in RFC 3339 format, for example *2012-11-
+        # 15T16:19:00.094Z*.
         # Corresponds to the JSON property `expirationTime`
         # @return [String]
         attr_accessor :expiration_time
@@ -2594,7 +2538,7 @@ module Google
         # @return [String]
         attr_accessor :instance
       
-        # This is always <code>sql#sslCert</code>.
+        # This is always *sql#sslCert*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2636,8 +2580,8 @@ module Google
         # @return [Google::Apis::SqlV1beta4::SslCert]
         attr_accessor :cert_info
       
-        # The private key for the client cert, in pem format.  Keep private in order
-        # to protect your security.
+        # The private key for the client cert, in pem format. Keep private in order to
+        # protect your security.
         # Corresponds to the JSON property `certPrivateKey`
         # @return [String]
         attr_accessor :cert_private_key
@@ -2676,8 +2620,8 @@ module Google
       class SslCertsInsertRequest
         include Google::Apis::Core::Hashable
       
-        # User supplied name.  Must be a distinct name from the other certificates
-        # for this instance.
+        # User supplied name. Must be a distinct name from the other certificates for
+        # this instance.
         # Corresponds to the JSON property `commonName`
         # @return [String]
         attr_accessor :common_name
@@ -2701,14 +2645,14 @@ module Google
         # @return [Google::Apis::SqlV1beta4::SslCertDetail]
         attr_accessor :client_cert
       
-        # This is always <code>sql#sslCertsInsert</code>.
+        # This is always *sql#sslCertsInsert*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # An Operation resource.&nbsp;For successful operations that return an
-        # Operation resource, only the fields relevant to the operation are populated
-        # in the resource.
+        # An Operation resource. For successful operations that return an Operation
+        # resource, only the fields relevant to the operation are populated in the
+        # resource.
         # Corresponds to the JSON property `operation`
         # @return [Google::Apis::SqlV1beta4::Operation]
         attr_accessor :operation
@@ -2740,7 +2684,7 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::SslCert>]
         attr_accessor :items
       
-        # This is always <code>sql#sslCertsList</code>.
+        # This is always *sql#sslCertsList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2770,7 +2714,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :ram
       
-        # This is always <code>sql#tier</code>.
+        # This is always *sql#tier*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2780,8 +2724,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :region
       
-        # An identifier for the machine type, for example, db-n1-standard-1. For
-        # related information, see <a href="/sql/pricing">Pricing</a>.
+        # An identifier for the machine type, for example, db-n1-standard-1. For related
+        # information, see Pricing.
         # Corresponds to the JSON property `tier`
         # @return [String]
         attr_accessor :tier
@@ -2809,7 +2753,7 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::Tier>]
         attr_accessor :items
       
-        # This is always <code>sql#tiersList</code>.
+        # This is always *sql#tiersList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2829,13 +2773,13 @@ module Google
       class TruncateLogContext
         include Google::Apis::Core::Hashable
       
-        # This is always <code>sql#truncateLogContext</code>.
+        # 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
-        # <code>MYSQL_GENERAL_TABLE</code> and <code>MYSQL_SLOW_TABLE</code>.
+        # 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
@@ -2855,34 +2799,31 @@ module Google
       class User
         include Google::Apis::Core::Hashable
       
-        # This field is deprecated and will be removed from a future version of the
-        # API.
+        # This field is deprecated and will be removed from a future version of the API.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
-        # The host name from which the user can connect. For <code>insert</code>
-        # operations, host defaults to an empty string. For <code>update</code>
-        # operations, host is specified as part of the request URL. The host name
-        # cannot be updated after insertion.
+        # The host name from which the user can connect. For *insert* operations, host
+        # defaults to an empty string. For *update* operations, host is specified as
+        # part of the request URL. The host name cannot be updated after insertion.
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
       
-        # The name of the Cloud SQL instance. This does not include the project ID.
-        # Can be omitted for <code>update</code> since it is already specified on the
-        # URL.
+        # The name of the Cloud SQL instance. This does not include the project ID. Can
+        # be omitted for *update* since it is already specified on the URL.
         # Corresponds to the JSON property `instance`
         # @return [String]
         attr_accessor :instance
       
-        # This is always <code>sql#user</code>.
+        # This is always *sql#user*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The name of the user in the Cloud SQL instance. Can be omitted for
-        # <code>update</code> since it is already specified in the URL.
+        # The name of the user in the Cloud SQL instance. Can be omitted for *update*
+        # since it is already specified in the URL.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2893,8 +2834,8 @@ module Google
         attr_accessor :password
       
         # The project ID of the project containing the Cloud SQL database. The Google
-        # apps domain is prefixed if applicable. Can be omitted for
-        # <code>update</code> since it is already specified on the URL.
+        # apps domain is prefixed if applicable. Can be omitted for *update* since it is
+        # already specified on the URL.
         # Corresponds to the JSON property `project`
         # @return [String]
         attr_accessor :project
@@ -2904,6 +2845,12 @@ module Google
         # @return [Google::Apis::SqlV1beta4::SqlServerUserDetails]
         attr_accessor :sqlserver_user_details
       
+        # The user type. It determines the method to authenticate the user during login.
+        # The default is the database's built-in user type.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2918,6 +2865,7 @@ module Google
           @password = args[:password] if args.key?(:password)
           @project = args[:project] if args.key?(:project)
           @sqlserver_user_details = args[:sqlserver_user_details] if args.key?(:sqlserver_user_details)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
@@ -2930,14 +2878,14 @@ module Google
         # @return [Array<Google::Apis::SqlV1beta4::User>]
         attr_accessor :items
       
-        # This is always <code>sql#usersList</code>.
+        # This is always *sql#usersList*.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # An identifier that uniquely identifies the operation. You can use this
-        # identifier to retrieve the Operations resource that has information about
-        # the operation.
+        # identifier to retrieve the Operations resource that has information about the
+        # operation.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token