google-cloud-alloy_db-v1 0.1.0 → 0.3.0

data/proto_docs/google/cloud/alloydb/v1/resources.rb

@@ -100,7 +100,7 @@ module Google
           end
         end
 
-        # SSL configuration for an AlloyDB Cluster.
+        # SSL configuration.
         # @!attribute [rw] ssl_mode
         #   @return [::Google::Cloud::AlloyDB::V1::SslConfig::SslMode]
         #     Optional. SSL mode. Specifies client-server SSL/TLS connection behavior.
@@ -114,7 +114,7 @@ module Google
 
           # SSL mode options.
           module SslMode
-            # SSL mode not specified. Defaults to SSL_MODE_ALLOW.
+            # SSL mode not specified. Defaults to ENCRYPTED_ONLY.
             SSL_MODE_UNSPECIFIED = 0
 
             # SSL connections are optional. CA verification not enforced.
@@ -129,6 +129,12 @@ module Google
             # Clients must have certificates signed by a Cluster CA, e.g. via
             # GenerateClientCertificate.
             SSL_MODE_VERIFY_CA = 3
+
+            # SSL connections are optional. CA verification not enforced.
+            ALLOW_UNENCRYPTED_AND_ENCRYPTED = 4
+
+            # SSL connections are required. CA verification not enforced.
+            ENCRYPTED_ONLY = 5
           end
 
           # Certificate Authority (CA) source for SSL/TLS certificates.
@@ -241,6 +247,50 @@ module Google
           end
         end
 
+        # ContinuousBackupConfig describes the continuous backups recovery
+        # configurations of a cluster.
+        # @!attribute [rw] enabled
+        #   @return [::Boolean]
+        #     Whether ContinuousBackup is enabled.
+        # @!attribute [rw] recovery_window_days
+        #   @return [::Integer]
+        #     The number of days backups and logs will be retained, which determines the
+        #     window of time that data is recoverable for. If not set, it defaults to 14
+        #     days.
+        # @!attribute [rw] encryption_config
+        #   @return [::Google::Cloud::AlloyDB::V1::EncryptionConfig]
+        #     The encryption config can be specified to encrypt the
+        #     backups with a customer-managed encryption key (CMEK). When this field is
+        #     not specified, the backup will then use default encryption scheme to
+        #     protect the user data.
+        class ContinuousBackupConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # ContinuousBackupInfo describes the continuous backup properties of a
+        # cluster.
+        # @!attribute [r] encryption_info
+        #   @return [::Google::Cloud::AlloyDB::V1::EncryptionInfo]
+        #     Output only. The encryption information for the WALs and backups required
+        #     for ContinuousBackup.
+        # @!attribute [r] enabled_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. When ContinuousBackup was most recently enabled. Set to null
+        #     if ContinuousBackup is not enabled.
+        # @!attribute [r] schedule
+        #   @return [::Array<::Google::Type::DayOfWeek>]
+        #     Output only. Days of the week on which a continuous backup is taken. Output
+        #     only field. Ignored if passed into the request.
+        # @!attribute [r] earliest_restorable_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The earliest restorable time that can be restored to. Output
+        #     only field.
+        class ContinuousBackupInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Message describing a BackupSource.
         # @!attribute [r] backup_uid
         #   @return [::String]
@@ -256,6 +306,20 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Message describing a ContinuousBackupSource.
+        # @!attribute [rw] cluster
+        #   @return [::String]
+        #     Required. The source cluster from which to restore. This cluster must have
+        #     continuous backup enabled for this operation to succeed. For the required
+        #     format, see the comment on the Cluster.name field.
+        # @!attribute [rw] point_in_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Required. The point in time to restore to.
+        class ContinuousBackupSource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A cluster is a collection of regional AlloyDB resources. It can include a
         # primary instance and one or more read pool instances.
         # All cluster resources share a storage layer, which scales as needed.
@@ -343,7 +407,7 @@ module Google
         #     documentation for the message type.
         # @!attribute [rw] ssl_config
         #   @return [::Google::Cloud::AlloyDB::V1::SslConfig]
-        #     SSL configuration for this AlloyDB Cluster.
+        #     SSL configuration for this AlloyDB cluster.
         # @!attribute [rw] encryption_config
         #   @return [::Google::Cloud::AlloyDB::V1::EncryptionConfig]
         #     Optional. The encryption config can be specified to encrypt the data disks
@@ -354,6 +418,12 @@ module Google
         # @!attribute [r] encryption_info
         #   @return [::Google::Cloud::AlloyDB::V1::EncryptionInfo]
         #     Output only. The encryption information for the cluster.
+        # @!attribute [rw] continuous_backup_config
+        #   @return [::Google::Cloud::AlloyDB::V1::ContinuousBackupConfig]
+        #     Optional. Continuous backup configuration for this cluster.
+        # @!attribute [r] continuous_backup_info
+        #   @return [::Google::Cloud::AlloyDB::V1::ContinuousBackupInfo]
+        #     Output only. Continuous backup properties for this cluster.
         # @!attribute [rw] secondary_config
         #   @return [::Google::Cloud::AlloyDB::V1::Cluster::SecondaryConfig]
         #     Cross Region replication config specific to SECONDARY cluster.
@@ -505,8 +575,11 @@ module Google
         # @!attribute [rw] availability_type
         #   @return [::Google::Cloud::AlloyDB::V1::Instance::AvailabilityType]
         #     Availability type of an Instance.
-        #     Defaults to REGIONAL for both primary and read instances.
-        #     Note that primary and read instances can have different availability types.
+        #     If empty, defaults to REGIONAL for primary instances.
+        #     For read pools, availability_type is always UNSPECIFIED. Instances in the
+        #     read pools are evenly distributed across available zones within the region
+        #     (i.e. read pools with more than one node will have a node in at
+        #     least two zones).
         # @!attribute [rw] gce_zone
         #   @return [::String]
         #     The Compute Engine zone that the instance should serve from, per
@@ -716,10 +789,11 @@ module Google
           end
 
           # The Availability type of an instance. Potential values:
-          #   <br><b>ZONAL</b>: The instance serves data from only one zone.
-          # Outages in that zone affect instance availability.
-          #   <br><b>REGIONAL</b>: The instance can serve data from more than one zone
-          #   in a region (it is highly available).
+          #
+          # - ZONAL: The instance serves data from only one zone. Outages in that
+          #     zone affect instance availability.
+          # - REGIONAL: The instance can serve data from more than one zone in a
+          #     region (it is highly available).
           module AvailabilityType
             # This is an unknown Availability type.
             AVAILABILITY_TYPE_UNSPECIFIED = 0
@@ -779,7 +853,7 @@ module Google
         # @!attribute [rw] cluster_name
         #   @return [::String]
         #     Required. The full resource name of the backup source cluster
-        #     (e.g., projects/<project>/locations/<location>/clusters/<cluster_id>).
+        #     (e.g., projects/\\{project}/locations/\\{region}/clusters/\\{cluster_id}).
         # @!attribute [r] reconciling
         #   @return [::Boolean]
         #     Output only. Reconciling (https://google.aip.dev/128#reconciliation), if
@@ -952,16 +1026,37 @@ module Google
           end
         end
 
-        # The supported database engine versions.
-        module DatabaseVersion
-          # This is an unknown database version.
-          DATABASE_VERSION_UNSPECIFIED = 0
+        # Message describing User object.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Name of the resource in the form of
+        #     projects/\\{project}/locations/\\{location}/cluster/\\{cluster}/users/\\{user}.
+        # @!attribute [rw] password
+        #   @return [::String]
+        #     Input only. Password for the user.
+        # @!attribute [rw] database_roles
+        #   @return [::Array<::String>]
+        #     Optional. List of database roles this user has.
+        #     The database role strings are subject to the PostgreSQL naming conventions.
+        # @!attribute [rw] user_type
+        #   @return [::Google::Cloud::AlloyDB::V1::User::UserType]
+        #     Optional. Type of this user.
+        class User
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # DEPRECATED - The database version is Postgres 13.
-          POSTGRES_13 = 1
+          # Enum that details the user type.
+          module UserType
+            # Unspecified user type.
+            USER_TYPE_UNSPECIFIED = 0
 
-          # The database version is Postgres 14.
-          POSTGRES_14 = 2
+            # The default user type that authenticates via password-based
+            # authentication.
+            ALLOYDB_BUILT_IN = 1
+
+            # Database user that can authenticate via IAM-Based authentication.
+            ALLOYDB_IAM_USER = 2
+          end
         end
 
         # View on Instance. Pass this enum to rpcs that returns an Instance message to
@@ -979,6 +1074,35 @@ module Google
           # For read pool instance, this includes details of each node in the pool.
           INSTANCE_VIEW_FULL = 2
         end
+
+        # View on Cluster. Pass this enum to rpcs that returns a cluster message to
+        # control which subsets of fields to get.
+        module ClusterView
+          # CLUSTER_VIEW_UNSPECIFIED Not specified, equivalent to BASIC.
+          CLUSTER_VIEW_UNSPECIFIED = 0
+
+          # BASIC server responses include all the relevant cluster details, excluding
+          # Cluster.ContinuousBackupInfo.EarliestRestorableTime and other view-specific
+          # fields. The default value.
+          CLUSTER_VIEW_BASIC = 1
+
+          # CONTINUOUS_BACKUP response returns all the fields from BASIC plus
+          # the earliest restorable time if continuous backups are enabled.
+          # May increase latency.
+          CLUSTER_VIEW_CONTINUOUS_BACKUP = 2
+        end
+
+        # The supported database engine versions.
+        module DatabaseVersion
+          # This is an unknown database version.
+          DATABASE_VERSION_UNSPECIFIED = 0
+
+          # DEPRECATED - The database version is Postgres 13.
+          POSTGRES_13 = 1
+
+          # The database version is Postgres 14.
+          POSTGRES_14 = 2
+        end
       end
     end
   end

data/proto_docs/google/cloud/alloydb/v1/service.rb

@@ -66,15 +66,54 @@ module Google
         #   @return [::String]
         #     Required. The name of the resource. For the required format, see the
         #     comment on the Cluster.name field.
+        # @!attribute [rw] view
+        #   @return [::Google::Cloud::AlloyDB::V1::ClusterView]
+        #     Optional. The view of the cluster to return. Returns all default fields if
+        #     not set.
         class GetClusterRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The location of the new cluster. For the required
+        #     format, see the comment on the Cluster.name field.
+        # @!attribute [rw] cluster_id
+        #   @return [::String]
+        #     Required. ID of the requesting object (the secondary cluster).
+        # @!attribute [rw] cluster
+        #   @return [::Google::Cloud::AlloyDB::V1::Cluster]
+        #     Required. Configuration of the requesting object (the secondary cluster).
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, performs request validation (e.g. permission checks and
+        #     any other type of validation), but do not actually execute the create
+        #     request.
+        class CreateSecondaryClusterRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Message for creating a Cluster
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the parent resource. For the required format, see the
+        #     Required. The location of the new cluster. For the required format, see the
         #     comment on the Cluster.name field.
         # @!attribute [rw] cluster_id
         #   @return [::String]
@@ -184,11 +223,49 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Message for promoting a Cluster
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the resource. For the required format, see the
+        #     comment on the Cluster.name field
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. The current etag of the Cluster.
+        #     If an etag is provided and does not match the current etag of the Cluster,
+        #     deletion will be blocked and an ABORTED error will be returned.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, performs request validation (e.g. permission checks and
+        #     any other type of validation), but do not actually execute the delete.
+        class PromoteClusterRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Message for restoring a Cluster from a backup or another cluster at a given
         # point in time.
         # @!attribute [rw] backup_source
         #   @return [::Google::Cloud::AlloyDB::V1::BackupSource]
         #     Backup source.
+        # @!attribute [rw] continuous_backup_source
+        #   @return [::Google::Cloud::AlloyDB::V1::ContinuousBackupSource]
+        #     ContinuousBackup source. Continuous backup needs to be enabled in the
+        #     source cluster for this operation to succeed.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The name of the parent resource. For the required format, see the
@@ -315,6 +392,42 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Message for creating a Secondary Instance
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the parent resource. For the required format, see the
+        #     comment on the Instance.name field.
+        # @!attribute [rw] instance_id
+        #   @return [::String]
+        #     Required. ID of the requesting object.
+        # @!attribute [rw] instance
+        #   @return [::Google::Cloud::AlloyDB::V1::Instance]
+        #     Required. The resource being created
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, performs request validation (e.g. permission checks and
+        #     any other type of validation), but do not actually execute the create
+        #     request.
+        class CreateSecondaryInstanceRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # See usage below for notes.
         # @!attribute [rw] create_instance_requests
         #   @return [::Array<::Google::Cloud::AlloyDB::V1::CreateInstanceRequest>]
@@ -362,6 +475,7 @@ module Google
         end
 
         # Message for metadata that is specific to BatchCreateInstances API.
+        # NEXT_ID: 3
         # @!attribute [rw] instance_targets
         #   @return [::Array<::String>]
         #     The instances being created in the API call. Each string in this list
@@ -401,6 +515,7 @@ module Google
         #   2. Instance2 = ROLLED_BACK
         #   3. Instance3 = FAILED
         #   4. Instance4 = FAILED
+        #
         # However, while the operation is running, the instance might be in other
         # states including PENDING_CREATE, ACTIVE, DELETING and CREATING. The states
         # / do not get further updated once the operation is done.
@@ -561,6 +676,49 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Message for triggering fault injection on an instance
+        # @!attribute [rw] fault_type
+        #   @return [::Google::Cloud::AlloyDB::V1::InjectFaultRequest::FaultType]
+        #     Required. The type of fault to be injected in an instance.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the resource. For the required format, see the
+        #     comment on the Instance.name field.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, performs request validation (e.g. permission checks and
+        #     any other type of validation), but do not actually execute the fault
+        #     injection.
+        class InjectFaultRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # FaultType contains all valid types of faults that can be injected to an
+          # instance.
+          module FaultType
+            # The fault type is unknown.
+            FAULT_TYPE_UNSPECIFIED = 0
+
+            # Stop the VM
+            STOP_VM = 1
+          end
+        end
+
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the resource. For the required format, see the
@@ -809,6 +967,154 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Message for requesting list of Users
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Parent value for ListUsersRequest
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Requested page size. Server may return fewer items than
+        #     requested. If unspecified, server will pick an appropriate default.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A token identifying a page of results the server should return.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filtering results
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Hint for how to order the results
+        class ListUsersRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for response to listing Users
+        # @!attribute [rw] users
+        #   @return [::Array<::Google::Cloud::AlloyDB::V1::User>]
+        #     The list of User
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token identifying a page of results the server should return.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListUsersResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for getting a User
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the resource. For the required format, see the
+        #     comment on the User.name field.
+        class GetUserRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for creating a User
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Value for parent.
+        # @!attribute [rw] user_id
+        #   @return [::String]
+        #     Required. ID of the requesting object.
+        # @!attribute [rw] user
+        #   @return [::Google::Cloud::AlloyDB::V1::User]
+        #     Required. The resource being created
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, the backend validates the request, but doesn't actually
+        #     execute it.
+        class CreateUserRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for updating a User
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Field mask is used to specify the fields to be overwritten in the
+        #     User resource by the update.
+        #     The fields specified in the update_mask are relative to the resource, not
+        #     the full request. A field will be overwritten if it is in the mask. If the
+        #     user does not provide a mask then all fields will be overwritten.
+        # @!attribute [rw] user
+        #   @return [::Google::Cloud::AlloyDB::V1::User]
+        #     Required. The resource being updated
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, the backend validates the request, but doesn't actually
+        #     execute it.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     Optional. Allow missing fields in the update mask.
+        class UpdateUserRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for deleting a User
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the resource. For the required format, see the
+        #     comment on the User.name field.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, the backend validates the request, but doesn't actually
+        #     execute it.
+        class DeleteUserRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    # Example 4: Pack and unpack a message in Go
+    #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # JSON
-    #
+    # ====
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/protobuf/timestamp.rb

@@ -69,7 +69,6 @@ module Google
     #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
-    #
     # Example 5: Compute Timestamp from Java `Instant.now()`.
     #
     #     Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
     #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
     #             .setNanos(now.getNano()).build();
     #
-    #
     # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
     # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
     # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
     # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]