Class: Google::Cloud::Sql::V1::DatabaseInstance

Inherits:
Object
  • Object
show all
Extended by:
Protobuf::MessageExts::ClassMethods
Includes:
Protobuf::MessageExts
Defined in:
proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb

Overview

A Cloud SQL instance resource.

Defined Under Namespace

Modules: SqlInstanceState, SqlNetworkArchitecture Classes: PoolNodeConfig, SqlFailoverReplica, SqlOutOfDiskReport, SqlScheduledMaintenance, TagsEntry

Instance Attribute Summary collapse

Instance Attribute Details

#available_maintenance_versions::Array<::String> (readonly)

Returns Output only. List all maintenance versions applicable on the instance.

Returns:

  • (::Array<::String>)

    Output only. List all maintenance versions applicable on the instance



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#backend_type::Google::Cloud::Sql::V1::SqlBackendType

Returns The backend type. 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.

Returns:

  • (::Google::Cloud::Sql::V1::SqlBackendType)

    The backend type. 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.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#connection_name::String

Returns Connection name of the Cloud SQL instance used in connection strings.

Returns:

  • (::String)

    Connection name of the Cloud SQL instance used in connection strings.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#create_time::Google::Protobuf::Timestamp (readonly)

Returns Output only. The time when the instance was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#current_disk_size::Google::Protobuf::Int64Value

Deprecated.

This field is deprecated and may be removed in the next major version update.

Returns The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see this announcement for details.

Returns:

  • (::Google::Protobuf::Int64Value)

    The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see this announcement for details.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#database_installed_version::String (readonly)

Returns Output only. Stores the current database version running on the instance including minor version such as MYSQL_8_0_18.

Returns:

  • (::String)

    Output only. Stores the current database version running on the instance including minor version such as MYSQL_8_0_18.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#database_version::Google::Cloud::Sql::V1::SqlDatabaseVersion

Returns The database engine type and version. The databaseVersion field cannot be changed after instance creation.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#disk_encryption_configuration::Google::Cloud::Sql::V1::DiskEncryptionConfiguration

Returns Disk encryption configuration specific to an instance.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#disk_encryption_status::Google::Cloud::Sql::V1::DiskEncryptionStatus

Returns Disk encryption status specific to an instance.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#dns_name::String (readonly)

Returns Output only. The dns name of the instance.

Returns:

  • (::String)

    Output only. The dns name of the instance.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#dns_names::Array<::Google::Cloud::Sql::V1::DnsNameMapping> (readonly)

Returns Output only. The list of DNS names used by this instance.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#etag::String

Returns This field is deprecated and will be removed from a future version of the API. Use the settings.settingsVersion field instead.

Returns:

  • (::String)

    This field is deprecated and will be removed from a future version of the API. Use the settings.settingsVersion field instead.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#failover_replica::Google::Cloud::Sql::V1::DatabaseInstance::SqlFailoverReplica

Returns The name and status of the failover replica.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#gce_zone::String

Returns The Compute Engine zone that the instance is currently serving from. This value could be different from the zone that was specified when the instance was created if the instance has failed over to its secondary zone. WARNING: Changing this might restart the instance.

Returns:

  • (::String)

    The Compute Engine zone that the instance is currently serving from. This value could be different from the zone that was specified when the instance was created if the instance has failed over to its secondary zone. WARNING: Changing this might restart the instance.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#gemini_config::Google::Cloud::Sql::V1::GeminiInstanceConfig

Returns Gemini instance configuration.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#include_replicas_for_major_version_upgrade::Google::Protobuf::BoolValue

Returns Input only. Determines whether an in-place major version upgrade of replicas happens when an in-place major version upgrade of a primary instance is initiated.

Returns:

  • (::Google::Protobuf::BoolValue)

    Input only. Determines whether an in-place major version upgrade of replicas happens when an in-place major version upgrade of a primary instance is initiated.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#instance_type::Google::Cloud::Sql::V1::SqlInstanceType

Returns The instance type.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#ip_addresses::Array<::Google::Cloud::Sql::V1::IpMapping>

Returns The assigned IP addresses for the instance.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#ipv6_address::String

Deprecated.

This field is deprecated and may be removed in the next major version update.

Returns The IPv6 address assigned to the instance. (Deprecated) This property was applicable only to First Generation instances.

Returns:

  • (::String)

    The IPv6 address assigned to the instance. (Deprecated) This property was applicable only to First Generation instances.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#kind::String

Returns This is always sql#instance.

Returns:

  • (::String)

    This is always sql#instance.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#maintenance_version::String

Returns The current software version on the instance.

Returns:

  • (::String)

    The current software version on the instance.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#master_instance_name::String

Returns The name of the instance which will act as primary in the replication setup.

Returns:

  • (::String)

    The name of the instance which will act as primary in the replication setup.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#max_disk_size::Google::Protobuf::Int64Value

Deprecated.

This field is deprecated and may be removed in the next major version update.

Returns The maximum disk size of the instance in bytes.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#name::String

Returns Name of the Cloud SQL instance. This does not include the project ID.

Returns:

  • (::String)

    Name of the Cloud SQL instance. This does not include the project ID.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#node_count::Integer

Returns The number of read pool nodes in a read pool.

Returns:

  • (::Integer)

    The number of read pool nodes in a read pool.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#nodes::Array<::Google::Cloud::Sql::V1::DatabaseInstance::PoolNodeConfig> (readonly)

Returns Output only. Entries containing information about each read pool node of the read pool.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#on_premises_configuration::Google::Cloud::Sql::V1::OnPremisesConfiguration

Returns Configuration specific to on-premises instances.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#out_of_disk_report::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport

Returns This field represents the report generated by the proactive database wellness job for OutOfDisk issues.

  • Writers:
    • the proactive database wellness job for OOD.
  • Readers:
    • the proactive database wellness job.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#primary_dns_name::String (readonly)

Deprecated.

This field is deprecated and may be removed in the next major version update.

Returns Output only. DEPRECATED: please use write_endpoint instead.

Returns:

  • (::String)

    Output only. DEPRECATED: please use write_endpoint instead.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#project::String

Returns The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.

Returns:

  • (::String)

    The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

Returns Output only. The link to service attachment of PSC instance.

Returns:

  • (::String)

    Output only. The link to service attachment of PSC instance.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#region::String

Returns The geographical region of the Cloud SQL instance.

It can be one of the regions where Cloud SQL operates:

For example, asia-east1, europe-west1, and us-central1. The default value is us-central1.

Returns:

  • (::String)

    The geographical region of the Cloud SQL instance.

    It can be one of the regions where Cloud SQL operates:

    For example, asia-east1, europe-west1, and us-central1. The default value is us-central1.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#replica_configuration::Google::Cloud::Sql::V1::ReplicaConfiguration

Returns Configuration specific to failover replicas and read replicas.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#replica_names::Array<::String>

Returns The replicas of the instance.

Returns:

  • (::Array<::String>)

    The replicas of the instance.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#replication_cluster::Google::Cloud::Sql::V1::ReplicationCluster

Returns Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL.

Returns:

  • (::Google::Cloud::Sql::V1::ReplicationCluster)

    Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#root_password::String

Returns Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances.

Returns:

  • (::String)

    Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#satisfies_pzi::Google::Protobuf::BoolValue (readonly)

Returns Output only. This status indicates whether the instance satisfies PZI.

The status is reserved for future use.

Returns:

  • (::Google::Protobuf::BoolValue)

    Output only. This status indicates whether the instance satisfies PZI.

    The status is reserved for future use.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#satisfies_pzs::Google::Protobuf::BoolValue

Returns This status indicates whether the instance satisfies PZS.

The status is reserved for future use.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#scheduled_maintenance::Google::Cloud::Sql::V1::DatabaseInstance::SqlScheduledMaintenance

Returns The start time of any upcoming scheduled maintenance for this instance.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#secondary_gce_zone::String

Returns The Compute Engine zone that the failover instance is currently serving from for a regional instance. This value could be different from the zone that was specified when the instance was created if the instance has failed over to its secondary/failover zone.

Returns:

  • (::String)

    The Compute Engine zone that the failover instance is currently serving from for a regional instance. This value could be different from the zone that was specified when the instance was created if the instance has failed over to its secondary/failover zone.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

Returns The URI of this resource.

Returns:

  • (::String)

    The URI of this resource.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#server_ca_cert::Google::Cloud::Sql::V1::SslCert

Returns SSL configuration.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#service_account_email_address::String

Returns The service account email address assigned to the instance.\This property is read-only.

Returns:

  • (::String)

    The service account email address assigned to the instance.\This property is read-only.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#settings::Google::Cloud::Sql::V1::Settings

Returns The user settings.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#sql_network_architecture::Google::Cloud::Sql::V1::DatabaseInstance::SqlNetworkArchitecture



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#state::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState

Returns The current serving state of the Cloud SQL instance.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#suspension_reason::Array<::Google::Cloud::Sql::V1::SqlSuspensionReason>

Returns If the instance state is SUSPENDED, the reason for the suspension.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#switch_transaction_logs_to_cloud_storage_enabled::Google::Protobuf::BoolValue

Returns Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage.

Returns:

  • (::Google::Protobuf::BoolValue)

    Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#tags::Google::Protobuf::Map{::String => ::String}

Returns Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: "<tag-key-namespaced-name>" : "<tag-value-short-name>".

For example, a single resource can have the following tags:

  "123/environment": "production",
  "123/costCenter": "marketing",

For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview.

Returns:

  • (::Google::Protobuf::Map{::String => ::String})

    Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: "<tag-key-namespaced-name>" : "<tag-value-short-name>".

    For example, a single resource can have the following tags:

      "123/environment": "production",
      "123/costCenter": "marketing",
    

    For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#upgradable_database_versions::Array<::Google::Cloud::Sql::V1::AvailableDatabaseVersion> (readonly)

Returns Output only. All database versions that are available for upgrade.

Returns:



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end

#write_endpoint::String (readonly)

Returns Output only. The dns name of the primary instance in a replication group.

Returns:

  • (::String)

    Output only. The dns name of the primary instance in a replication group.



1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
# File 'proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb', line 1341

class DatabaseInstance
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # @!attribute [rw] name
  #   @return [::String]
  #     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.
  # @!attribute [rw] available
  #   @return [::Google::Protobuf::BoolValue]
  #     The availability status of the failover replica. A false status indicates
  #     that the failover replica is out of sync. The primary instance can only
  #     failover to the failover replica when the status is true.
  class SqlFailoverReplica
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Any scheduled maintenance for this instance.
  # @!attribute [rw] start_time
  #   @return [::Google::Protobuf::Timestamp]
  #     The start time of any upcoming scheduled maintenance for this instance.
  # @!attribute [rw] can_defer
  #   @deprecated This field is deprecated and may be removed in the next major version update.
  #   @return [::Boolean]
  # @!attribute [rw] can_reschedule
  #   @return [::Boolean]
  #     If the scheduled maintenance can be rescheduled.
  # @!attribute [rw] schedule_deadline_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Maintenance cannot be rescheduled to start beyond this deadline.
  class SqlScheduledMaintenance
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # This message wraps up the information written by out-of-disk detection job.
  # @!attribute [rw] sql_out_of_disk_state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlOutOfDiskReport::SqlOutOfDiskState]
  #     This field represents the state generated by the proactive database
  #     wellness job for OutOfDisk issues.
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  #       *  the proactive database wellness job
  # @!attribute [rw] sql_min_recommended_increase_size_gb
  #   @return [::Integer]
  #     The minimum recommended increase size in GigaBytes
  #     This field is consumed by the frontend
  #     *  Writers:
  #       *  the proactive database wellness job for OOD.
  #     *  Readers:
  class SqlOutOfDiskReport
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # This enum lists all possible states regarding out-of-disk issues.
    module SqlOutOfDiskState
      # Unspecified state
      SQL_OUT_OF_DISK_STATE_UNSPECIFIED = 0

      # The instance has plenty space on data disk
      NORMAL = 1

      # Data disk is almost used up. It is shutdown to prevent data
      # corruption.
      SOFT_SHUTDOWN = 2
    end
  end

  # Details of a single read pool node of a read pool.
  # @!attribute [r] name
  #   @return [::String]
  #     Output only. The name of the read pool node, to be used for retrieving
  #     metrics and logs.
  # @!attribute [r] gce_zone
  #   @return [::String]
  #     Output only. The zone of the read pool node.
  # @!attribute [r] ip_addresses
  #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
  #     Output only. Mappings containing IP addresses that can be used to connect
  #     to the read pool node.
  # @!attribute [r] dns_name
  #   @return [::String]
  #     Output only. The DNS name of the read pool node.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Sql::V1::DatabaseInstance::SqlInstanceState]
  #     Output only. The current state of the read pool node.
  # @!attribute [r] dns_names
  #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
  #     Output only. The list of DNS names used by this read pool node.
  # @!attribute [r] psc_service_attachment_link
  #   @return [::String]
  #     Output only. The Private Service Connect (PSC) service attachment of the
  #     read pool node.
  # @!attribute [r] psc_auto_connections
  #   @return [::Array<::Google::Cloud::Sql::V1::PscAutoConnectionConfig>]
  #     Output only. The list of settings for requested automatically-setup
  #     Private Service Connect (PSC) consumer endpoints that can be used to
  #     connect to this read pool node.
  class PoolNodeConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class TagsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The current serving state of the database instance.
  module SqlInstanceState
    # The state of the instance is unknown.
    SQL_INSTANCE_STATE_UNSPECIFIED = 0

    # The instance is running, or has been stopped by owner.
    RUNNABLE = 1

    # The instance is not available, for example due to problems with billing.
    SUSPENDED = 2

    # The instance is being deleted.
    PENDING_DELETE = 3

    # The instance is being created.
    PENDING_CREATE = 4

    # The instance is down for maintenance.
    MAINTENANCE = 5

    # The creation of the instance failed or a fatal error occurred during
    # maintenance.
    FAILED = 6

    # Deprecated
    ONLINE_MAINTENANCE = 7

    # (Applicable to read pool nodes only.) The read pool node needs to be
    # repaired. The database might be unavailable.
    REPAIRING = 8
  end

  # The SQL network architecture for the instance.
  module SqlNetworkArchitecture
    SQL_NETWORK_ARCHITECTURE_UNSPECIFIED = 0

    # The instance uses the new network architecture.
    NEW_NETWORK_ARCHITECTURE = 1

    # The instance uses the old network architecture.
    OLD_NETWORK_ARCHITECTURE = 2
  end
end