google-cloud-sql-v1beta4 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -318,6 +318,73 @@ module Google
318
318
  extend ::Google::Protobuf::MessageExts::ClassMethods
319
319
  end
320
320
 
321
+ # Request message for SqlSslCertsService.UpdateCustomerManagedCertificate.
322
+ # @!attribute [rw] instance
323
+ # @return [::String]
324
+ # Required. Cloud SQL instance ID. This does not include the project ID.
325
+ # @!attribute [rw] project
326
+ # @return [::String]
327
+ # Required. Project ID of the project that contains the instance.
328
+ # @!attribute [rw] customer_managed_certificate_config
329
+ # @return [::Google::Cloud::Sql::V1beta4::CustomerManagedCertificateConfig]
330
+ # Required. The customer managed certificate bundle SSL configuration to
331
+ # update.
332
+ # @!attribute [rw] update_mask
333
+ # @return [::Google::Protobuf::FieldMask]
334
+ # Optional. The list of fields to be updated.
335
+ # @!attribute [rw] allow_missing
336
+ # @return [::Boolean]
337
+ # Optional. If set to true, and the customer managed certificate bundle
338
+ # configuration is not found, a new customer managed certificate bundle
339
+ # configuration will be created. In this situation, `update_mask` is ignored.
340
+ # @!attribute [rw] certificate_bundle
341
+ # @return [::String]
342
+ # Required. Name tag of the customer managed certificate bundle to update. It
343
+ # must be alphanumeric and have a maximum length of 10 characters.
344
+ class UpdateCustomerManagedCertificateRequest
345
+ include ::Google::Protobuf::MessageExts
346
+ extend ::Google::Protobuf::MessageExts::ClassMethods
347
+ end
348
+
349
+ # Request message for SqlSslCertsService.DeleteCustomerManagedCertificate.
350
+ # @!attribute [rw] instance
351
+ # @return [::String]
352
+ # Required. Cloud SQL instance ID. This does not include the project ID.
353
+ # @!attribute [rw] project
354
+ # @return [::String]
355
+ # Required. Project ID of the project that contains the instance.
356
+ # @!attribute [rw] certificate_bundle
357
+ # @return [::String]
358
+ # Required. Name tag of the customer managed certificate bundle to delete. It
359
+ # must be alphanumeric and have a maximum length of 10 characters.
360
+ class DeleteCustomerManagedCertificateRequest
361
+ include ::Google::Protobuf::MessageExts
362
+ extend ::Google::Protobuf::MessageExts::ClassMethods
363
+ end
364
+
365
+ # Request message for SqlSslCertsService.ListCustomerManagedCertificates.
366
+ # @!attribute [rw] instance
367
+ # @return [::String]
368
+ # Required. Cloud SQL instance ID. This does not include the project ID.
369
+ # @!attribute [rw] project
370
+ # @return [::String]
371
+ # Required. Project ID of the project that contains the instance.
372
+ class ListCustomerManagedCertificatesRequest
373
+ include ::Google::Protobuf::MessageExts
374
+ extend ::Google::Protobuf::MessageExts::ClassMethods
375
+ end
376
+
377
+ # Response message for SqlSslCertsService.ListCustomerManagedCertificates.
378
+ # @!attribute [rw] customer_managed_certificates
379
+ # @return [::Array<::Google::Cloud::Sql::V1beta4::CustomerManagedCertificateConfig>]
380
+ # Required. List of customer managed SSL configurations for the instance.
381
+ # Note: Sensitive private keys (e.g., PEER_CLIENT_KEY) are redacted in this
382
+ # response.
383
+ class ListCustomerManagedCertificatesResponse
384
+ include ::Google::Protobuf::MessageExts
385
+ extend ::Google::Protobuf::MessageExts::ClassMethods
386
+ end
387
+
321
388
  # @!attribute [rw] instance
322
389
  # @return [::String]
323
390
  # The ID of the Cloud SQL instance to be cloned (source). This does not
@@ -662,6 +729,40 @@ module Google
662
729
  extend ::Google::Protobuf::MessageExts::ClassMethods
663
730
  end
664
731
 
732
+ # Instance start request.
733
+ # @!attribute [rw] instance
734
+ # @return [::String]
735
+ # Required. Cloud SQL instance ID. This does not include the project ID.
736
+ # @!attribute [rw] project
737
+ # @return [::String]
738
+ # Required. Project ID of the project that contains the instance to be
739
+ # started.
740
+ # @!attribute [rw] location
741
+ # @return [::String]
742
+ # Optional. The region of the Cloud SQL instance, for example `us-central1`.
743
+ # If omitted, the region is determined from the instance.
744
+ class SqlInstancesStartRequest
745
+ include ::Google::Protobuf::MessageExts
746
+ extend ::Google::Protobuf::MessageExts::ClassMethods
747
+ end
748
+
749
+ # Instance stop request.
750
+ # @!attribute [rw] instance
751
+ # @return [::String]
752
+ # Required. Cloud SQL instance ID. This does not include the project ID.
753
+ # @!attribute [rw] project
754
+ # @return [::String]
755
+ # Required. Project ID of the project that contains the instance to be
756
+ # stopped.
757
+ # @!attribute [rw] location
758
+ # @return [::String]
759
+ # Optional. The region of the Cloud SQL instance, for example `us-central1`.
760
+ # If omitted, the region is determined from the instance.
761
+ class SqlInstancesStopRequest
762
+ include ::Google::Protobuf::MessageExts
763
+ extend ::Google::Protobuf::MessageExts::ClassMethods
764
+ end
765
+
665
766
  # @!attribute [rw] instance
666
767
  # @return [::String]
667
768
  # Cloud SQL instance ID. This does not include the project ID.
@@ -1168,6 +1269,25 @@ module Google
1168
1269
  extend ::Google::Protobuf::MessageExts::ClassMethods
1169
1270
  end
1170
1271
 
1272
+ # Execute read only SQL statements request.
1273
+ # Execute SQL statements in read-only mode request.
1274
+ # @!attribute [rw] instance
1275
+ # @return [::String]
1276
+ # Required. Database instance ID. This does not include the project ID.
1277
+ # @!attribute [rw] project
1278
+ # @return [::String]
1279
+ # Required. Project ID of the project that contains the instance.
1280
+ # @!attribute [rw] body
1281
+ # @return [::Google::Cloud::Sql::V1beta4::ExecuteSqlReadOnlyPayload]
1282
+ # Required. The request body.
1283
+ # @!attribute [rw] location
1284
+ # @return [::String]
1285
+ # Optional. Region of the Cloud SQL instance.
1286
+ class SqlInstancesExecuteSqlReadOnlyRequest
1287
+ include ::Google::Protobuf::MessageExts
1288
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1289
+ end
1290
+
1171
1291
  # Execute SQL statements request.
1172
1292
  # @!attribute [rw] instance
1173
1293
  # @return [::String]
@@ -1214,6 +1334,47 @@ module Google
1214
1334
  extend ::Google::Protobuf::MessageExts::ClassMethods
1215
1335
  end
1216
1336
 
1337
+ # The request payload used to execute SQL statements in read-only mode.
1338
+ # @!attribute [rw] user
1339
+ # @return [::String]
1340
+ # Optional. The name of an existing database user to connect to the database.
1341
+ # When `auto_iam_authn` is set to true, this field is ignored and the API
1342
+ # caller's IAM user is used.
1343
+ # @!attribute [rw] sql_statement
1344
+ # @return [::String]
1345
+ # Required. SQL statements to run on the database. It can be a single
1346
+ # statement or a sequence of statements separated by semicolons.
1347
+ # @!attribute [rw] database
1348
+ # @return [::String]
1349
+ # Optional. Name of the database on which the statement will be executed.
1350
+ # For Postgres and SQL Server it's required, for MySQL it's optional.
1351
+ # @!attribute [rw] password_secret_version
1352
+ # @return [::String]
1353
+ # Optional. The resource name of the Secret Manager secret holding the
1354
+ # password for the user to log into the database. The secret should be
1355
+ # created using the regional endpoint (for API) or from the Regional
1356
+ # Secrets page (for UI), and stored in the same region as the Cloud SQL
1357
+ # instance. The expected resource name format is
1358
+ # `projects/{project}/locations/{location}/secrets/{secret}/versions/{secret_version}`.
1359
+ # This field is used together with the `user` field.
1360
+ # The secret resource name will not be stored.
1361
+ #
1362
+ # Note: The following fields are mutually exclusive: `password_secret_version`, `auto_iam_authn`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1363
+ # @!attribute [rw] auto_iam_authn
1364
+ # @return [::Boolean]
1365
+ # Optional. When set to true, the API caller identity associated with the
1366
+ # request is used for database authentication. The API caller must be an
1367
+ # IAM user in the database.
1368
+ #
1369
+ # Note: The following fields are mutually exclusive: `auto_iam_authn`, `password_secret_version`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1370
+ # @!attribute [rw] row_limit
1371
+ # @return [::Integer]
1372
+ # Optional. The maximum number of rows returned per SQL statement.
1373
+ class ExecuteSqlReadOnlyPayload
1374
+ include ::Google::Protobuf::MessageExts
1375
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1376
+ end
1377
+
1217
1378
  # The request payload used to execute SQL statements.
1218
1379
  # @!attribute [rw] user
1219
1380
  # @return [::String]
@@ -1281,6 +1442,30 @@ module Google
1281
1442
  end
1282
1443
  end
1283
1444
 
1445
+ # Execute SQL statements response.
1446
+ # Execute SQL statements in read-only mode response.
1447
+ # @!attribute [rw] messages
1448
+ # @return [::Array<::Google::Cloud::Sql::V1beta4::SqlInstancesExecuteSqlResponse::Message>]
1449
+ # A list of notices and warnings generated during query execution.
1450
+ # For PostgreSQL, this includes all notices and warnings.
1451
+ # For MySQL, this includes warnings generated by the last executed statement.
1452
+ # To retrieve all warnings for a multi-statement query, `SHOW WARNINGS` must
1453
+ # be executed after each statement.
1454
+ # @!attribute [rw] metadata
1455
+ # @return [::Google::Cloud::Sql::V1beta4::Metadata]
1456
+ # The additional metadata information regarding the execution of the SQL
1457
+ # statements.
1458
+ # @!attribute [rw] results
1459
+ # @return [::Array<::Google::Cloud::Sql::V1beta4::QueryResult>]
1460
+ # The list of results after executing all the SQL statements.
1461
+ # @!attribute [rw] status
1462
+ # @return [::Google::Rpc::Status]
1463
+ # Contains the error from the database if the SQL execution failed.
1464
+ class SqlInstancesExecuteSqlReadOnlyResponse
1465
+ include ::Google::Protobuf::MessageExts
1466
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1467
+ end
1468
+
1284
1469
  # @!attribute [rw] messages
1285
1470
  # @return [::Array<::Google::Cloud::Sql::V1beta4::SqlInstancesExecuteSqlResponse::Message>]
1286
1471
  # A list of notices and warnings generated during query execution.
@@ -1450,6 +1635,48 @@ module Google
1450
1635
  extend ::Google::Protobuf::MessageExts::ClassMethods
1451
1636
  end
1452
1637
 
1638
+ # Request message for SqlInstancesService.ReconcileNetworking.
1639
+ # @!attribute [rw] instance
1640
+ # @return [::String]
1641
+ # Required. Cloud SQL instance ID.
1642
+ # @!attribute [rw] project
1643
+ # @return [::String]
1644
+ # Required. Project ID of the project that contains the instance.
1645
+ # @!attribute [rw] psc_dns
1646
+ # @return [::Google::Cloud::Sql::V1beta4::PscDnsReconcileNetworkingRequest]
1647
+ # Request to recreate Private Service Connect DNS write endpoints and
1648
+ # reconcile Private Service Connect connectivity infrastructure for the
1649
+ # instance.
1650
+ # @!attribute [rw] location
1651
+ # @return [::String]
1652
+ # Optional. Region of the Cloud SQL instance.
1653
+ class SqlInstancesReconcileNetworkingRequest
1654
+ include ::Google::Protobuf::MessageExts
1655
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1656
+ end
1657
+
1658
+ # Request parameters specific to PSC DNS networking reconciliation.
1659
+ # @!attribute [rw] networks
1660
+ # @return [::Array<::String>]
1661
+ # Optional. List of specific consumer VPC networks to reconcile. They must be
1662
+ # specified as full resource names (e.g.,
1663
+ # "projects/my-consumer-project/global/networks/prod-vpc"). If empty,
1664
+ # recreates Write Endpoints for all the consumer networks associated with
1665
+ # this instance.
1666
+ # @!attribute [rw] force
1667
+ # @return [::Boolean]
1668
+ # Optional. Set `true` to force the reset and reapplication of Private
1669
+ # Service Connect connectivity infrastructure if standard reconciliation does
1670
+ # not resolve automated DNS issues. This operation might cause a brief
1671
+ # disruption in network connectivity for connected VPC networks while
1672
+ # settings are reapplied. Use this option only when standard reconciliation
1673
+ # fails to resolve networking issues (for example, if connectivity resources
1674
+ # are stuck in an updating or creating state).
1675
+ class PscDnsReconcileNetworkingRequest
1676
+ include ::Google::Protobuf::MessageExts
1677
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1678
+ end
1679
+
1453
1680
  # External Sync parallel level.
1454
1681
  module ExternalSyncParallelLevel
1455
1682
  # Unknown sync parallel level. Will be defaulted to OPTIMAL.
@@ -846,6 +846,15 @@ module Google
846
846
  # @return [::Google::Cloud::Sql::V1beta4::DatabaseInstance::DatabaseCenterIntegration]
847
847
  # Optional. State of the Database Center integration for this instance.
848
848
  # When unspecified, Database Center integration is enabled by default.
849
+ # @!attribute [r] workload_replay_config
850
+ # @return [::Google::Cloud::Sql::V1beta4::WorkloadReplayConfig]
851
+ # Output only. The workload replay configuration for this instance. This
852
+ # field is set only for workload replay instances.
853
+ # @!attribute [r] workload_capture_config
854
+ # @return [::Google::Cloud::Sql::V1beta4::WorkloadCaptureConfig]
855
+ # Output only. The workload capture configuration for this instance. This
856
+ # field is set only when an active workload capture is present on the
857
+ # instance.
849
858
  class DatabaseInstance
850
859
  include ::Google::Protobuf::MessageExts
851
860
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1074,6 +1083,135 @@ module Google
1074
1083
  end
1075
1084
  end
1076
1085
 
1086
+ # The workload replay configuration for a Cloud SQL replay instance.
1087
+ # @!attribute [r] workload_id
1088
+ # @return [::String]
1089
+ # Output only. The ID of the captured workload being replayed.
1090
+ # @!attribute [r] source_instance
1091
+ # @return [::String]
1092
+ # Output only. The name of the source instance, excluding the project ID,
1093
+ # where the workload was captured.
1094
+ # @!attribute [r] replay_mode
1095
+ # @return [::Google::Cloud::Sql::V1beta4::WorkloadReplayConfig::ReplayMode]
1096
+ # Output only. The mode of the workload replay.
1097
+ # @!attribute [r] state
1098
+ # @return [::Google::Cloud::Sql::V1beta4::WorkloadReplayConfig::State]
1099
+ # Output only. The state of the workload replay.
1100
+ # @!attribute [r] start_time
1101
+ # @return [::Google::Protobuf::Timestamp]
1102
+ # Output only. The start time of the workload replay.
1103
+ # @!attribute [r] end_time
1104
+ # @return [::Google::Protobuf::Timestamp]
1105
+ # Output only. The end time of the workload replay. This field is unset while
1106
+ # the replay is running.
1107
+ class WorkloadReplayConfig
1108
+ include ::Google::Protobuf::MessageExts
1109
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1110
+
1111
+ # The mode of workload replay.
1112
+ module ReplayMode
1113
+ # Default value. This value is unused.
1114
+ REPLAY_MODE_UNSPECIFIED = 0
1115
+
1116
+ # Live workload replay mode.
1117
+ LIVE = 1
1118
+
1119
+ # Offline (delayed) workload replay mode.
1120
+ OFFLINE = 2
1121
+ end
1122
+
1123
+ # The state of the workload replay.
1124
+ module State
1125
+ # Default value. This value is unused.
1126
+ STATE_UNSPECIFIED = 0
1127
+
1128
+ # Workload replay is currently running.
1129
+ RUNNING = 1
1130
+
1131
+ # Workload replay completed successfully. Cloud SQL sets this state when
1132
+ # all captured workload files finish replaying or when you explicitly
1133
+ # stop the replay.
1134
+ COMPLETED = 2
1135
+
1136
+ # Workload replay failed.
1137
+ FAILED = 3
1138
+
1139
+ # Workload replay was terminated automatically. Cloud SQL sets this state
1140
+ # when it automatically stops the replay because of a conflicting
1141
+ # operation.
1142
+ TERMINATED = 4
1143
+ end
1144
+ end
1145
+
1146
+ # The workload capture configuration for a Cloud SQL primary instance.
1147
+ # @!attribute [r] workload_id
1148
+ # @return [::String]
1149
+ # Output only. The ID of the captured workload.
1150
+ # @!attribute [r] capture_mode
1151
+ # @return [::Google::Cloud::Sql::V1beta4::WorkloadCaptureConfig::CaptureMode]
1152
+ # Output only. The mode of the workload capture.
1153
+ # @!attribute [r] state
1154
+ # @return [::Google::Cloud::Sql::V1beta4::WorkloadCaptureConfig::State]
1155
+ # Output only. The state of the workload capture.
1156
+ # @!attribute [r] start_time
1157
+ # @return [::Google::Protobuf::Timestamp]
1158
+ # Output only. The start time of the workload capture.
1159
+ # @!attribute [r] end_time
1160
+ # @return [::Google::Protobuf::Timestamp]
1161
+ # Output only. The end time of the workload capture. This field is unset
1162
+ # while the capture is running.
1163
+ # @!attribute [r] replay_instance
1164
+ # @return [::String]
1165
+ # Output only. The name of the replay instance, excluding the project ID, if
1166
+ # live replay is enabled.
1167
+ # @!attribute [r] retention_days
1168
+ # @return [::Integer]
1169
+ # Output only. The retention period in days for the captured workload.
1170
+ # @!attribute [r] backup_id
1171
+ # @return [::String]
1172
+ # Output only. The base backup ID associated with the workload capture.
1173
+ # @!attribute [r] max_capture_duration
1174
+ # @return [::Google::Protobuf::Duration]
1175
+ # Output only. The maximum duration for this workload capture.
1176
+ class WorkloadCaptureConfig
1177
+ include ::Google::Protobuf::MessageExts
1178
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1179
+
1180
+ # The mode of workload capture.
1181
+ module CaptureMode
1182
+ # Default value. This value is unused.
1183
+ CAPTURE_MODE_UNSPECIFIED = 0
1184
+
1185
+ # Captures the workload on the primary instance without live replay.
1186
+ CAPTURE_ONLY = 1
1187
+
1188
+ # Captures the workload and simultaneously replays it on a live replay
1189
+ # instance.
1190
+ CAPTURE_AND_LIVE_REPLAY = 2
1191
+ end
1192
+
1193
+ # The state of the workload capture.
1194
+ module State
1195
+ # Default value. This value is unused.
1196
+ STATE_UNSPECIFIED = 0
1197
+
1198
+ # Workload capture is currently running.
1199
+ RUNNING = 1
1200
+
1201
+ # Workload capture completed successfully. Cloud SQL sets this state when
1202
+ # you explicitly stop the capture.
1203
+ COMPLETED = 2
1204
+
1205
+ # Workload capture failed.
1206
+ FAILED = 3
1207
+
1208
+ # Workload capture was terminated automatically. Cloud SQL sets this state
1209
+ # when it automatically stops the capture because of a conflicting
1210
+ # operation or because the capture reached its maximum duration.
1211
+ TERMINATED = 4
1212
+ end
1213
+ end
1214
+
1077
1215
  # DNS metadata.
1078
1216
  # @!attribute [r] name
1079
1217
  # @return [::String]
@@ -3213,6 +3351,10 @@ module Google
3213
3351
 
3214
3352
  # Sends a message to a Cloud SQL agent.
3215
3353
  AGENT_SEND_MESSAGE = 59
3354
+
3355
+ # Reconciles network infrastructure (e.g. Private Service Connect,
3356
+ # Automated DNS Records).
3357
+ RECONCILE_NETWORKING = 64
3216
3358
  end
3217
3359
 
3218
3360
  # The status of an operation.
@@ -3541,6 +3683,14 @@ module Google
3541
3683
  # @!attribute [rw] insights_config
3542
3684
  # @return [::Google::Cloud::Sql::V1beta4::InsightsConfig]
3543
3685
  # Insights configuration, for now relevant only for Postgres.
3686
+ # @!attribute [rw] msdtc_enabled
3687
+ # @return [::Boolean]
3688
+ # Optional. Enables Microsoft Distributed Transaction Coordinator (MSDTC) for
3689
+ # SQL Server.
3690
+ # @!attribute [rw] msdtc_rpc_auth_mode
3691
+ # @return [::Google::Cloud::Sql::V1beta4::Settings::MsdtcRpcAuthMode]
3692
+ # Optional. RPC authentication mode for Microsoft Distributed Transaction
3693
+ # Coordinator (MSDTC).
3544
3694
  # @!attribute [rw] password_validation_policy
3545
3695
  # @return [::Google::Cloud::Sql::V1beta4::PasswordValidationPolicy]
3546
3696
  # The local user password validation policy of the instance for PostgreSQL
@@ -3634,6 +3784,10 @@ module Google
3634
3784
  # @return [::Google::Cloud::Sql::V1beta4::PerformanceCaptureConfig]
3635
3785
  # Optional. Configuration for Performance Capture, provides diagnostic
3636
3786
  # metrics during high load situations.
3787
+ # @!attribute [rw] initial_users_config
3788
+ # @return [::Google::Cloud::Sql::V1beta4::InitialUsersConfig]
3789
+ # Optional. Input only. Users to be created on the instance during instance
3790
+ # creation.
3637
3791
  class Settings
3638
3792
  include ::Google::Protobuf::MessageExts
3639
3793
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3662,6 +3816,30 @@ module Google
3662
3816
  ON_DEMAND = 3
3663
3817
  end
3664
3818
 
3819
+ # RPC authentication modes for Microsoft Distributed Transaction Coordinator
3820
+ # (MSDTC).
3821
+ module MsdtcRpcAuthMode
3822
+ # Unspecified RPC authentication mode.
3823
+ MSDTC_RPC_AUTH_MODE_UNSPECIFIED = 0
3824
+
3825
+ # Allow only secure RPC calls. Both servers (caller and receiver) must
3826
+ # successfully verify each other's identities, typically using Active
3827
+ # Directory machine accounts and Kerberos Service Principal Names (SPNs).
3828
+ # This is equivalent to Mutual Authentication in Microsoft SQL Server on
3829
+ # Windows.
3830
+ ALLOW_ONLY_SECURE_RPC_CALLS = 1
3831
+
3832
+ # Similar to Incoming authentication mode in Microsoft SQL Server on
3833
+ # Windows, the caller authenticates to the receiver.
3834
+ # The receiver verifies the caller's identity, but the Receiver does not
3835
+ # authenticate itself back to the caller.
3836
+ FALLBACK_TO_UNSECURE_RPC_IF_NECESSARY = 2
3837
+
3838
+ # No authentication. Highly insecure and thus should only be used on
3839
+ # already secure networks and never over public IP.
3840
+ TURN_OFF_RPC_SECURITY = 3
3841
+ end
3842
+
3665
3843
  # The list of Cloud SQL editions available to users.
3666
3844
  module Edition
3667
3845
  # The instance did not specify the edition.
@@ -3855,6 +4033,54 @@ module Google
3855
4033
  extend ::Google::Protobuf::MessageExts::ClassMethods
3856
4034
  end
3857
4035
 
4036
+ # DNS Entry for the primary instance in a replication topology.
4037
+ # @!attribute [rw] dns
4038
+ # @return [::String]
4039
+ # Required. The DNS name.
4040
+ # @!attribute [rw] ipv4_address
4041
+ # @return [::String]
4042
+ # Required. The IP address.
4043
+ class DNSEntry
4044
+ include ::Google::Protobuf::MessageExts
4045
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4046
+ end
4047
+
4048
+ # A single certificate or key in a customer managed certificate bundle.
4049
+ # @!attribute [rw] certificate_type
4050
+ # @return [::Google::Cloud::Sql::V1beta4::CertificateType]
4051
+ # Required. The certificate type.
4052
+ # @!attribute [rw] content
4053
+ # @return [::String]
4054
+ # Required. Input only. The PEM-encoded certificate or key content in base64
4055
+ # format.
4056
+ # @!attribute [r] file_path
4057
+ # @return [::String]
4058
+ # Output only. File path of the PEM-encoded certificate or key content.
4059
+ class CustomerManagedCertificate
4060
+ include ::Google::Protobuf::MessageExts
4061
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4062
+ end
4063
+
4064
+ # Customer managed certificate SSL configuration.
4065
+ # @!attribute [r] bundle
4066
+ # @return [::String]
4067
+ # Output only. The name of the customer managed certificate configuration.
4068
+ # This name will be used to identify a certificate bundle.
4069
+ # @!attribute [rw] intent
4070
+ # @return [::Google::Cloud::Sql::V1beta4::Intent]
4071
+ # Required. The intent for this customer managed certificate configuration.
4072
+ # @!attribute [rw] primary_dns_record
4073
+ # @return [::Google::Cloud::Sql::V1beta4::DNSEntry]
4074
+ # DNS name associated with the primary instance in a replication topology.
4075
+ # This is needed to insert a DNS entry in a replica VM.
4076
+ # @!attribute [rw] customer_managed_certificates
4077
+ # @return [::Array<::Google::Cloud::Sql::V1beta4::CustomerManagedCertificate>]
4078
+ # Required. The server CA certificate, client key and client certificate.
4079
+ class CustomerManagedCertificateConfig
4080
+ include ::Google::Protobuf::MessageExts
4081
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4082
+ end
4083
+
3858
4084
  # SslCerts create ephemeral certificate request.
3859
4085
  # @!attribute [rw] public_key
3860
4086
  # @return [::String]
@@ -4035,6 +4261,68 @@ module Google
4035
4261
  extend ::Google::Protobuf::MessageExts::ClassMethods
4036
4262
  end
4037
4263
 
4264
+ # Configuration for users created during instance creation.
4265
+ # @!attribute [rw] initial_users
4266
+ # @return [::Array<::Google::Cloud::Sql::V1beta4::InitialUsersConfig::InitialUser>]
4267
+ # Optional. List of IAM users to be created during instance creation.
4268
+ # A maximum of 5 users are allowed.
4269
+ class InitialUsersConfig
4270
+ include ::Google::Protobuf::MessageExts
4271
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4272
+
4273
+ # Configuration for an IAM user created during instance creation.
4274
+ # @!attribute [rw] name
4275
+ # @return [::String]
4276
+ # Required. The name of the user in the Cloud SQL instance.
4277
+ # @!attribute [rw] type
4278
+ # @return [::Google::Cloud::Sql::V1beta4::InitialUsersConfig::InitialUser::SqlUserType]
4279
+ # Required. The user type. Cannot be BUILT_IN.
4280
+ # @!attribute [rw] roles
4281
+ # @return [::Array<::String>]
4282
+ # Optional. The database roles to be assigned to the user. If empty, will
4283
+ # grant role `cloudsqlsuperuser`.
4284
+ class InitialUser
4285
+ include ::Google::Protobuf::MessageExts
4286
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4287
+
4288
+ # The user type.
4289
+ module SqlUserType
4290
+ # The database's built-in user type. Not supported for initial user
4291
+ # creation.
4292
+ BUILT_IN = 0
4293
+
4294
+ # Cloud IAM user.
4295
+ # MySQL will truncate the @ and domain when it stores the user.
4296
+ CLOUD_IAM_USER = 1
4297
+
4298
+ # Cloud IAM service account.
4299
+ # For PostgreSQL, omit the .gserviceaccount.com suffix.
4300
+ # MySQL will truncate the @ and domain when it stores the user.
4301
+ CLOUD_IAM_SERVICE_ACCOUNT = 2
4302
+
4303
+ # Cloud IAM group.
4304
+ CLOUD_IAM_GROUP = 3
4305
+
4306
+ # Login for a user that belongs to the Cloud IAM group. Not supported for
4307
+ # initial user creation.
4308
+ CLOUD_IAM_GROUP_USER = 4
4309
+
4310
+ # Login for a service account that belongs to the
4311
+ # Cloud IAM group. Not supported for initial user creation.
4312
+ CLOUD_IAM_GROUP_SERVICE_ACCOUNT = 5
4313
+
4314
+ # Cloud IAM workforce identity.
4315
+ CLOUD_IAM_WORKFORCE_IDENTITY = 6
4316
+
4317
+ # Microsoft Entra ID user. Not supported for initial user creation.
4318
+ ENTRAID_USER = 7
4319
+
4320
+ # Active Directory user. Not supported for initial user creation.
4321
+ ACTIVE_DIRECTORY_USER = 8
4322
+ end
4323
+ end
4324
+ end
4325
+
4038
4326
  # Connection pool flags for Cloud SQL instances managed connection pool
4039
4327
  # configuration.
4040
4328
  # @!attribute [rw] name
@@ -4182,6 +4470,10 @@ module Google
4182
4470
  # instance. Each workload capture generates a unique ID in the format
4183
4471
  # `workload-<epoch_timestamp>` (for example, `workload-1786046400`). Use this
4184
4472
  # ID to start executing the recorded SQL queries.
4473
+ # @!attribute [r] source_instance
4474
+ # @return [::String]
4475
+ # Output only. The name of the source Cloud SQL instance where the workload
4476
+ # was captured, excluding the project ID (for example, `my-source-instance`).
4185
4477
  class StartWorkloadReplayContext
4186
4478
  include ::Google::Protobuf::MessageExts
4187
4479
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -4265,6 +4557,39 @@ module Google
4265
4557
  REPLICA_INCLUDED_SELF_SERVICE_MAINTENANCE = 4
4266
4558
  end
4267
4559
 
4560
+ # Certificate type for customer managed certificates.
4561
+ module CertificateType
4562
+ # Unspecified certificate type.
4563
+ CERTIFICATE_TYPE_UNSPECIFIED = 0
4564
+
4565
+ # The x509 PEM-encoded certificate of the CA that signed the source database
4566
+ # server's certificate.
4567
+ CERTIFICATE_TYPE_PEER_SERVER_CA = 1
4568
+
4569
+ # The unencrypted PKCS#1 or PKCS#8 PEM-encoded private key associated with
4570
+ # the Client Certificate.
4571
+ CERTIFICATE_TYPE_PEER_CLIENT_KEY = 2
4572
+
4573
+ # The x509 PEM-encoded certificate used by the client to authenticate
4574
+ # against the source database server.
4575
+ CERTIFICATE_TYPE_PEER_CLIENT_CERTIFICATE = 3
4576
+ end
4577
+
4578
+ # Intent for the customer managed certificate configuration.
4579
+ module Intent
4580
+ # Unspecified intent.
4581
+ INTENT_UNSPECIFIED = 0
4582
+
4583
+ # Configures customer-managed certificates for pg_logical extension to
4584
+ # achieve mTLS authentication.
4585
+ PG_LOGICAL = 1
4586
+
4587
+ # Configures customer-managed certificates for built-in PostgreSQL native
4588
+ # replication to achieve mTLS authentication. Supported for Cloud SQL for
4589
+ # PostgreSQL 10 and later.
4590
+ NATIVE_REPLICATION = 2
4591
+ end
4592
+
4268
4593
  # The status of a backup run.
4269
4594
  module SqlBackupRunStatus
4270
4595
  # The status of the run is unknown.
@@ -138,6 +138,9 @@ module Google
138
138
  # @!attribute [r] backup_id
139
139
  # @return [::String]
140
140
  # Output only. The base backup ID associated with the workload capture.
141
+ # @!attribute [r] capture_mode
142
+ # @return [::Google::Cloud::Sql::V1beta4::WorkloadCapture::WorkloadCaptureMode]
143
+ # Output only. The capture mode of the workload capture.
141
144
  class WorkloadCapture
142
145
  include ::Google::Protobuf::MessageExts
143
146
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -162,6 +165,19 @@ module Google
162
165
  # or when the maximum duration is reached.
163
166
  TERMINATED = 4
164
167
  end
168
+
169
+ # Specifies the mode of the workload capture.
170
+ module WorkloadCaptureMode
171
+ # Default value. This value is unused.
172
+ WORKLOAD_CAPTURE_MODE_UNSPECIFIED = 0
173
+
174
+ # Records and stores the workload without live replay.
175
+ CAPTURE_ONLY = 1
176
+
177
+ # Records the workload and simultaneously replays it on a live replay
178
+ # instance.
179
+ CAPTURE_AND_LIVE_REPLAY = 2
180
+ end
165
181
  end
166
182
  end
167
183
  end