MCP Tools Reference: cloud-sql

Tool: get_instance

Details zu einer Cloud SQL-Instanz abrufen.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool get_instance aufrufen.

Curl-Anfrage
                  
curl --location 'https://sqladmin.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

Eingabeschema

Instanz-GET-Anfrage.

SqlInstancesGetRequest

JSON-Darstellung
{
  "instance": string,
  "project": string
}
Felder
instance

string

Erforderlich. ID der Datenbankinstanz. Die Projekt-ID ist darin nicht enthalten.

project

string

Erforderlich. Projekt-ID des Projekts mit der Instanz.

Ausgabeschema

Eine Cloud SQL-Instanzressource.

DatabaseInstance

JSON-Darstellung
{
  "kind": string,
  "state": enum (SqlInstanceState),
  "databaseVersion": enum (SqlDatabaseVersion),
  "settings": {
    object (Settings)
  },
  "etag": string,
  "failoverReplica": {
    object (SqlFailoverReplica)
  },
  "masterInstanceName": string,
  "replicaNames": [
    string
  ],
  "maxDiskSize": string,
  "currentDiskSize": string,
  "ipAddresses": [
    {
      object (IpMapping)
    }
  ],
  "serverCaCert": {
    object (SslCert)
  },
  "instanceType": enum (SqlInstanceType),
  "project": string,
  "ipv6Address": string,
  "serviceAccountEmailAddress": string,
  "onPremisesConfiguration": {
    object (OnPremisesConfiguration)
  },
  "replicaConfiguration": {
    object (ReplicaConfiguration)
  },
  "backendType": enum (SqlBackendType),
  "selfLink": string,
  "suspensionReason": [
    enum (SqlSuspensionReason)
  ],
  "connectionName": string,
  "name": string,
  "region": string,
  "gceZone": string,
  "secondaryGceZone": string,
  "diskEncryptionConfiguration": {
    object (DiskEncryptionConfiguration)
  },
  "diskEncryptionStatus": {
    object (DiskEncryptionStatus)
  },
  "rootPassword": string,
  "scheduledMaintenance": {
    object (SqlScheduledMaintenance)
  },
  "satisfiesPzs": boolean,
  "databaseInstalledVersion": string,
  "createTime": string,
  "availableMaintenanceVersions": [
    string
  ],
  "maintenanceVersion": string,
  "upgradableDatabaseVersions": [
    {
      object (AvailableDatabaseVersion)
    }
  ],
  "replicationCluster": {
    object (ReplicationCluster)
  },
  "satisfiesPzi": boolean,
  "tags": {
    string: string,
    ...
  },
  "nodes": [
    {
      object (PoolNodeConfig)
    }
  ],
  "dnsNames": [
    {
      object (DnsNameMapping)
    }
  ],

  // Union field _out_of_disk_report can be only one of the following:
  "outOfDiskReport": {
    object (SqlOutOfDiskReport)
  }
  // End of list of possible types for union field _out_of_disk_report.

  // Union field _sql_network_architecture can be only one of the following:
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  // End of list of possible types for union field _sql_network_architecture.

  // Union field _psc_service_attachment_link can be only one of the following:
  "pscServiceAttachmentLink": string
  // End of list of possible types for union field _psc_service_attachment_link.

  // Union field _dns_name can be only one of the following:
  "dnsName": string
  // End of list of possible types for union field _dns_name.

  // Union field _primary_dns_name can be only one of the following:
  "primaryDnsName": string
  // End of list of possible types for union field _primary_dns_name.

  // Union field _write_endpoint can be only one of the following:
  "writeEndpoint": string
  // End of list of possible types for union field _write_endpoint.

  // Union field _gemini_config can be only one of the following:
  "geminiConfig": {
    object (GeminiInstanceConfig)
  }
  // End of list of possible types for union field _gemini_config.

  // Union field _switch_transaction_logs_to_cloud_storage_enabled can be only
  // one of the following:
  "switchTransactionLogsToCloudStorageEnabled": boolean
  // End of list of possible types for union field
  // _switch_transaction_logs_to_cloud_storage_enabled.

  // Union field _include_replicas_for_major_version_upgrade can be only one of
  // the following:
  "includeReplicasForMajorVersionUpgrade": boolean
  // End of list of possible types for union field
  // _include_replicas_for_major_version_upgrade.

  // Union field _node_count can be only one of the following:
  "nodeCount": integer
  // End of list of possible types for union field _node_count.
}
Felder
kind

string

Dies ist immer sql#instance.

state

enum (SqlInstanceState)

Der aktuelle Bereitstellungsstatus der Cloud SQL-Instanz.

databaseVersion

enum (SqlDatabaseVersion)

Der Typ und die Version der Datenbank-Engine. Das Feld databaseVersion kann nach dem Erstellen der Instanz nicht mehr geändert werden.

settings

object (Settings)

Die Nutzereinstellungen.

etag

string

Dieses Feld ist veraltet und wird aus einer zukünftigen Version der API entfernt. Verwenden Sie stattdessen das Feld settings.settingsVersion.

failoverReplica

object (SqlFailoverReplica)

Der Name und der Status des Failover-Replikats.

masterInstanceName

string

Der Name der Instanz, die in der Replikationseinrichtung als primäre Instanz fungiert.

replicaNames[]

string

Die Replikate der Instanz.

maxDiskSize
(deprecated)

string (Int64Value format)

Die maximale Datenträgergröße der Instanz in Byte.

currentDiskSize
(deprecated)

string (Int64Value format)

Die aktuelle Laufwerknutzung der Instanz in Byte. Dieses Attribut wird nicht mehr unterstützt. Verwenden Sie stattdessen den Messwert „cloudsql.googleapis.com/database/disk/bytes_used“ in der Cloud Monitoring API. Weitere Informationen

ipAddresses[]

object (IpMapping)

Die der Instanz zugewiesenen IP-Adressen.

serverCaCert

object (SslCert)

SSL-Konfiguration

instanceType

enum (SqlInstanceType)

Der Instanztyp.

project

string

Die Projekt-ID des Projekts, das die Cloud SQL-Instanz enthält. Der Google Apps-Domain wird gegebenenfalls ein Präfix vorangestellt.

ipv6Address
(deprecated)

string

Die der Instanz zugewiesene IPv6-Adresse. (Eingestellt) Dieses Attribut galt nur für Instanzen der ersten Generation.

serviceAccountEmailAddress

string

Die dem Dienstkonto zugewiesene E-Mail-Adresse der Instanz.\Diese Property ist schreibgeschützt.

onPremisesConfiguration

object (OnPremisesConfiguration)

Konfiguration für lokale Instanzen.

replicaConfiguration

object (ReplicaConfiguration)

Konfiguration speziell für Failover-Replikate und Lesereplikate.

backendType

enum (SqlBackendType)

Der Backend-Typ. SECOND_GEN: Cloud SQL-Datenbankinstanz. EXTERNAL: Ein Datenbankserver, der nicht von Google verwaltet wird.

Diese Property ist schreibgeschützt. Verwenden Sie die Property tier im Objekt settings, um den Datenbanktyp zu ermitteln.

selfLink

string

Der URI dieser Ressource.

suspensionReason[]

enum (SqlSuspensionReason)

Wenn der Instanzstatus SUSPENDED ist, wird der Grund für die Sperrung angegeben.

connectionName

string

Der Verbindungsname der Cloud SQL-Instanz, die in Verbindungsstrings verwendet wird.

name

string

Name der Cloud SQL-Instanz. Die Projekt-ID ist darin nicht enthalten.

region

string

Die geografische Region der Cloud SQL-Instanz.

Dies kann eine der Regionen sein, in denen Cloud SQL verfügbar ist:

Zum Beispiel: asia-east1, europe-west1 und us-central1. Der Standardwert ist us-central1.

gceZone

string

Die Compute Engine-Zone, aus der die Instanz derzeit bereitstellt. Dieser Wert kann sich von der Zone unterscheiden, die bei der Erstellung der Instanz angegeben wurde, wenn für die Instanz ein Failover auf die sekundäre Zone durchgeführt wurde. ACHTUNG: Durch das Ändern dieser Einstellung wird die Instanz möglicherweise neu gestartet.

secondaryGceZone

string

Die Compute Engine-Zone, aus der die Failover-Instanz derzeit für eine regionale Instanz bereitstellt. Dieser Wert kann sich von der Zone unterscheiden, die bei der Erstellung der Instanz angegeben wurde, wenn für die Instanz ein Failover auf die sekundäre Zone oder Failover-Zone durchgeführt wurde.

diskEncryptionConfiguration

object (DiskEncryptionConfiguration)

Laufwerkverschlüsselungskonfiguration für eine Instanz.

diskEncryptionStatus

object (DiskEncryptionStatus)

Laufwerkverschlüsselungsstatus für eine Instanz.

rootPassword

string

Anfängliches Root-Passwort. Nur bei der Erstellung verwenden. Sie müssen Root-Passwörter festlegen, bevor Sie eine Verbindung zu PostgreSQL-Instanzen herstellen können.

scheduledMaintenance

object (SqlScheduledMaintenance)

Die Startzeit einer geplanten Wartung für diese Instanz.

satisfiesPzs

boolean

Dieser Status gibt an, ob die Instanz PZS erfüllt.

Der Status ist für die zukünftige Verwendung reserviert.

databaseInstalledVersion

string

Nur Ausgabe. Speichert die aktuelle Datenbankversion, die auf der Instanz ausgeführt wird, einschließlich der Nebenversion, z. B. MYSQL_8_0_18.

createTime

string (Timestamp format)

Nur Ausgabe. Die Uhrzeit, zu der die Instanz im RFC 3339-Format erstellt wurde, z. B. 2012-11-15T16:19:00.094Z.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

availableMaintenanceVersions[]

string

Nur Ausgabe. Alle Wartungsversionen auflisten, die für die Instanz gelten

maintenanceVersion

string

Die aktuelle Softwareversion auf der Instanz.

upgradableDatabaseVersions[]

object (AvailableDatabaseVersion)

Nur Ausgabe. Alle Datenbankversionen, für die ein Upgrade verfügbar ist.

replicationCluster

object (ReplicationCluster)

Optional. Ein Paar aus primärer Instanz und DR-Replikat (Disaster Recovery, DR). Ein DR-Replikat ist ein regionenübergreifendes Replikat, das Sie für das Failover festlegen, falls die primäre Instanz einen regionalen Ausfall erleidet. Gilt für MySQL und PostgreSQL.

satisfiesPzi

boolean

Nur Ausgabe. Dieser Status gibt an, ob die Instanz PZI erfüllt.

Der Status ist für die zukünftige Verwendung reserviert.

tags

map (key: string, value: string)

Optional. Nur Eingabe. Nicht veränderbar. Tag-Schlüssel und Tag-Werte, die an diese Instanz gebunden sind. Jedes Element in der Karte muss so dargestellt werden: "<tag-key-namespaced-name>" : "<tag-value-short-name>".

Eine einzelne Ressource kann beispielsweise die folgenden Tags haben:

  "123/environment": "production",
  "123/costCenter": "marketing",

Weitere Informationen zum Erstellen und Verwalten von Tags finden Sie unter https://cloud.google.com/resource-manager/docs/tags/tags-overview.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

nodes[]

object (PoolNodeConfig)

Nur Ausgabe. Einträge mit Informationen zu jedem Lesepoolknoten des Lesepools.

dnsNames[]

object (DnsNameMapping)

Nur Ausgabe. Die Liste der DNS-Namen, die von dieser Instanz verwendet werden.

Union-Feld _out_of_disk_report.

Für _out_of_disk_report ist nur einer der folgenden Werte zulässig:

outOfDiskReport

object (SqlOutOfDiskReport)

Dieses Feld stellt den Bericht dar, der vom proaktiven Datenbank-Wellness-Job für Probleme mit dem Speicherplatzmangel generiert wird. * Autoren: * Der proaktive Datenbank-Wellness-Job für OOD. * Leser: * der proaktive Datenbank-Wellness-Job

Union-Feld _sql_network_architecture.

Für _sql_network_architecture ist nur einer der folgenden Werte zulässig:

sqlNetworkArchitecture

enum (SqlNetworkArchitecture)

Union-Feld _psc_service_attachment_link.

Für _psc_service_attachment_link ist nur einer der folgenden Werte zulässig:

pscServiceAttachmentLink

string

Nur Ausgabe. Der Link zum Dienstanhang der PSC-Instanz.

Union-Feld _dns_name.

Für _dns_name ist nur einer der folgenden Werte zulässig:

dnsName

string

Nur Ausgabe. Der DNS-Name der Instanz.

Union-Feld _primary_dns_name.

Für _primary_dns_name ist nur einer der folgenden Werte zulässig:

primaryDnsName
(deprecated)

string

Nur Ausgabe. VERALTET: Verwenden Sie stattdessen „write_endpoint“.

Union-Feld _write_endpoint.

Für _write_endpoint ist nur einer der folgenden Werte zulässig:

writeEndpoint

string

Nur Ausgabe. Der DNS-Name der primären Instanz in einer Replikationsgruppe.

Union-Feld _gemini_config.

Für _gemini_config ist nur einer der folgenden Werte zulässig:

geminiConfig

object (GeminiInstanceConfig)

Konfiguration der Gemini-Instanz.

Union-Feld _switch_transaction_logs_to_cloud_storage_enabled.

Für _switch_transaction_logs_to_cloud_storage_enabled ist nur einer der folgenden Werte zulässig:

switchTransactionLogsToCloudStorageEnabled

boolean

Nur Eingabe. Gibt an, ob Cloud SQL so konfiguriert ist, dass die Logdateien für die Wiederherstellung zu einem bestimmten Zeitpunkt von einer Datenlaufwerk auf Cloud Storage umgestellt werden.

Union-Feld _include_replicas_for_major_version_upgrade.

Für _include_replicas_for_major_version_upgrade ist nur einer der folgenden Werte zulässig:

includeReplicasForMajorVersionUpgrade

boolean

Nur Eingabe. Gibt an, ob ein direktes Upgrade der Hauptversion von Replikaten erfolgt, wenn ein direktes Upgrade der Hauptversion einer primären Instanz initiiert wird.

Union-Feld _node_count.

Für _node_count ist nur einer der folgenden Werte zulässig:

nodeCount

integer

Die Anzahl der Lesepoolknoten in einem Lesepool.

Einstellungen

JSON-Darstellung
{
  "settingsVersion": string,
  "authorizedGaeApplications": [
    string
  ],
  "tier": string,
  "kind": string,
  "userLabels": {
    string: string,
    ...
  },
  "availabilityType": enum (SqlAvailabilityType),
  "pricingPlan": enum (SqlPricingPlan),
  "replicationType": enum (SqlReplicationType),
  "storageAutoResizeLimit": string,
  "activationPolicy": enum (SqlActivationPolicy),
  "ipConfiguration": {
    object (IpConfiguration)
  },
  "storageAutoResize": boolean,
  "locationPreference": {
    object (LocationPreference)
  },
  "databaseFlags": [
    {
      object (DatabaseFlags)
    }
  ],
  "dataDiskType": enum (SqlDataDiskType),
  "maintenanceWindow": {
    object (MaintenanceWindow)
  },
  "backupConfiguration": {
    object (BackupConfiguration)
  },
  "databaseReplicationEnabled": boolean,
  "crashSafeReplicationEnabled": boolean,
  "dataDiskSizeGb": string,
  "activeDirectoryConfig": {
    object (SqlActiveDirectoryConfig)
  },
  "collation": string,
  "denyMaintenancePeriods": [
    {
      object (DenyMaintenancePeriod)
    }
  ],
  "insightsConfig": {
    object (InsightsConfig)
  },
  "passwordValidationPolicy": {
    object (PasswordValidationPolicy)
  },
  "sqlServerAuditConfig": {
    object (SqlServerAuditConfig)
  },
  "edition": enum (Edition),
  "connectorEnforcement": enum (ConnectorEnforcement),
  "deletionProtectionEnabled": boolean,
  "timeZone": string,
  "advancedMachineFeatures": {
    object (AdvancedMachineFeatures)
  },
  "dataCacheConfig": {
    object (DataCacheConfig)
  },
  "replicationLagMaxSeconds": integer,
  "enableGoogleMlIntegration": boolean,
  "enableDataplexIntegration": boolean,
  "retainBackupsOnDelete": boolean,
  "entraidConfig": {
    object (SqlServerEntraIdConfig)
  },
  "performanceCaptureConfig": {
    object (PerformanceCaptureConfig)
  },

  // Union field _data_disk_provisioned_iops can be only one of the following:
  "dataDiskProvisionedIops": string
  // End of list of possible types for union field _data_disk_provisioned_iops.

  // Union field _data_disk_provisioned_throughput can be only one of the
  // following:
  "dataDiskProvisionedThroughput": string
  // End of list of possible types for union field
  // _data_disk_provisioned_throughput.

  // Union field _connection_pool_config can be only one of the following:
  "connectionPoolConfig": {
    object (ConnectionPoolConfig)
  }
  // End of list of possible types for union field _connection_pool_config.

  // Union field _final_backup_config can be only one of the following:
  "finalBackupConfig": {
    object (FinalBackupConfig)
  }
  // End of list of possible types for union field _final_backup_config.

  // Union field _read_pool_auto_scale_config can be only one of the following:
  "readPoolAutoScaleConfig": {
    object (ReadPoolAutoScaleConfig)
  }
  // End of list of possible types for union field _read_pool_auto_scale_config.

  // Union field _auto_upgrade_enabled can be only one of the following:
  "autoUpgradeEnabled": boolean
  // End of list of possible types for union field _auto_upgrade_enabled.

  // Union field _data_api_access can be only one of the following:
  "dataApiAccess": enum (DataApiAccess)
  // End of list of possible types for union field _data_api_access.
}
Felder
settingsVersion

string (Int64Value format)

Die Version der Instanzeinstellungen. Dies ist ein Pflichtfeld für die Aktualisierungsmethode, damit gleichzeitige Aktualisierungen ordnungsgemäß verarbeitet werden. Verwenden Sie während des Updates den aktuellen Wert von „settingsVersion“ für diese Instanz und versuchen Sie nicht, diesen Wert zu aktualisieren.

authorizedGaeApplications[]
(deprecated)

string

Die App Engine-App-IDs, die auf diese Instanz zugreifen können. (Eingestellt) Wird nur auf Instanzen der ersten Generation angewendet.

tier

string

Die Stufe oder der Maschinentyp für diese Instanz, z. B. db-custom-1-3840. ACHTUNG: Wenn Sie diese Einstellung ändern, wird die Instanz neu gestartet.

kind

string

Dies ist immer sql#settings.

userLabels

map (key: string, value: string)

Vom Nutzer bereitgestellte Labels, die als Wörterbuch dargestellt werden, wobei jedes Label ein einzelnes Schlüssel/Wert-Paar ist.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

availabilityType

enum (SqlAvailabilityType)

Verfügbarkeitstyp Mögliche Werte: * ZONAL: Die Instanz stellt Daten aus nur einer Zone bereit. Ausfälle in dieser Zone wirken sich auf die Datenverfügbarkeit aus. * REGIONAL: Die Instanz kann Daten aus mehreren Zonen in einer Region bereitstellen (hohe Verfügbarkeit)./

Weitere Informationen finden Sie unter Hochverfügbarkeit konfigurieren – Übersicht.

pricingPlan

enum (SqlPricingPlan)

Das Preismodell für diese Instanz. Dies kann entweder PER_USE oder PACKAGE sein. Nur PER_USE wird für Instanzen der zweiten Generation unterstützt.

replicationType
(deprecated)

enum (SqlReplicationType)

Der Replikationstyp, der für diese Instanz verwendet wird. Dies kann entweder ASYNCHRONOUS oder SYNCHRONOUS sein. (Eingestellt) Dieses Attribut galt nur für Instanzen der ersten Generation.

storageAutoResizeLimit

string (Int64Value format)

Die maximale Größe, auf die die Speicherkapazität automatisch erhöht werden kann. Der Standardwert ist 0, d. h. es gibt kein Limit.

activationPolicy

enum (SqlActivationPolicy)

Die Aktivierungsrichtlinie gibt an, wann die Instanz aktiviert wird. Sie ist nur anwendbar, wenn der Instanzstatus RUNNABLE ist. Gültige Werte: * ALWAYS: Die Instanz ist eingeschaltet und bleibt so, auch wenn keine Verbindungsanfragen vorliegen. * NEVER: Die Instanz ist ausgeschaltet. Sie ist nicht aktiviert, auch wenn eine Verbindungsanfrage eingeht.

ipConfiguration

object (IpConfiguration)

Die Einstellungen für die IP-Verwaltung. So können Sie die Instanz-IP aktivieren oder deaktivieren und verwalten, welche externen Netzwerke eine Verbindung zur Instanz herstellen können. Die IPv4-Adresse kann für Instanzen der zweiten Generation nicht deaktiviert werden.

storageAutoResize

boolean

Konfiguration zum automatischen Erhöhen der Speichergröße. Der Standardwert ist true.

locationPreference

object (LocationPreference)

Die Einstellungen für die Standorteinstellung. So kann die Instanz für eine bessere Leistung so nah wie möglich an einer App Engine-Anwendung oder einer Compute Engine-Zone platziert werden. Die App Engine-Colocation galt nur für Instanzen der ersten Generation.

databaseFlags[]

object (DatabaseFlags)

Die Datenbank-Flags, die beim Starten an die Instanz übergeben werden.

dataDiskType

enum (SqlDataDiskType)

Der Typ des Datenlaufwerks: PD_SSD (Standard) oder PD_HDD. Wird für Instanzen der ersten Generation nicht verwendet.

maintenanceWindow

object (MaintenanceWindow)

Das Wartungsfenster für diese Instanz. Damit wird angegeben, wann die Instanz zu Wartungszwecken neu gestartet werden kann.

backupConfiguration

object (BackupConfiguration)

Die Konfiguration für die tägliche Sicherung für die Instanz.

databaseReplicationEnabled

boolean

Konfiguration speziell für Lesereplikatinstanzen. Gibt an, ob die Replikation aktiviert ist. ACHTUNG: Wenn Sie diese Einstellung ändern, wird die Instanz neu gestartet.

crashSafeReplicationEnabled
(deprecated)

boolean

Konfiguration speziell für Lesereplikatinstanzen. Gibt an, ob Datenbank-Flags für die absturzsichere Replikation aktiviert sind. Dieses Attribut galt nur für Instanzen der ersten Generation.

dataDiskSizeGb

string (Int64Value format)

Die Größe des Datenlaufwerks in GB. Die Mindestgröße für das Datenlaufwerk beträgt 10 GB.

activeDirectoryConfig

object (SqlActiveDirectoryConfig)

Active Directory-Konfiguration, die nur für Cloud SQL for SQL Server relevant ist.

collation

string

Der Name der Sortierung der Serverinstanz.

denyMaintenancePeriods[]

object (DenyMaintenancePeriod)

Wartungsperioden ablehnen

insightsConfig

object (InsightsConfig)

Konfiguration von Statistiken, derzeit nur für Postgres relevant.

passwordValidationPolicy

object (PasswordValidationPolicy)

Die Richtlinie zur Validierung von Passwörtern lokaler Nutzer der Instanz.

sqlServerAuditConfig

object (SqlServerAuditConfig)

SQL Server-spezifische Audit-Konfiguration.

edition

enum (Edition)

Optional. Die Edition der Instanz.

connectorEnforcement

enum (ConnectorEnforcement)

Gibt an, ob für Verbindungen Cloud SQL-Connectors verwendet werden müssen. Zu den Optionswerten gehören: NOT_REQUIRED (Cloud SQL-Instanzen können ohne Cloud SQL-Connectors verbunden werden) und REQUIRED (Es sind nur Verbindungen zulässig, die Cloud SQL-Connectors verwenden).

Hinweis: Wenn Sie REQUIRED verwenden, werden alle vorhandenen autorisierten Netzwerke deaktiviert. Wenn dieses Feld beim Erstellen einer neuen Instanz nicht angegeben wird, wird NOT_REQUIRED verwendet. Wenn dieses Feld beim Patchen oder Aktualisieren einer vorhandenen Instanz nicht angegeben wird, bleibt es in der Instanz unverändert.

deletionProtectionEnabled

boolean

Konfiguration zum Schutz vor versehentlichem Löschen von Instanzen.

timeZone

string

Serverzeitzone, nur relevant für Cloud SQL for SQL Server.

advancedMachineFeatures

object (AdvancedMachineFeatures)

Gibt die erweiterte Maschinenkonfiguration für die Instanzen an, die nur für SQL Server relevant ist.

dataCacheConfig

object (DataCacheConfig)

Konfiguration für den Datencache.

replicationLagMaxSeconds

integer

Optional. Konfigurationswert für die Neuerstellung eines Replikats nach einer bestimmten Replikationsverzögerung

enableGoogleMlIntegration

boolean

Optional. Wenn dieser Parameter auf „true“ gesetzt ist, können Cloud SQL-Instanzen eine Verbindung zu Vertex AI herstellen, um Anfragen für Echtzeitvorhersagen und Statistiken an die KI zu übergeben. Der Standardwert ist „false“. Dies gilt nur für Cloud SQL for MySQL- und Cloud SQL for PostgreSQL-Instanzen.

enableDataplexIntegration

boolean

Optional. Standardmäßig ist die Schemaextraktion für Dataplex für Cloud SQL-Instanzen deaktiviert. Wenn dieser Parameter auf „true“ gesetzt ist, wird die Schemaextraktion für Dataplex für Cloud SQL-Instanzen aktiviert.

retainBackupsOnDelete

boolean

Optional. Wenn dieser Parameter auf „true“ gesetzt ist, behält Cloud SQL Sicherungen der Instanz auch nach dem Löschen der Instanz bei. Die ON_DEMAND-Sicherung wird beibehalten, bis der Kunde die Sicherung oder das Projekt löscht. Die AUTOMATISCHE Sicherung wird entsprechend der Einstellung für die Aufbewahrung von Sicherungen aufbewahrt.

entraidConfig

object (SqlServerEntraIdConfig)

Optional. Die Microsoft Entra ID-Konfiguration für die SQL Server-Instanz.

performanceCaptureConfig

object (PerformanceCaptureConfig)

Optional. Konfiguration für Performance Capture, die Diagnosedaten bei hoher Last bereitstellt.

Union-Feld _data_disk_provisioned_iops.

Für _data_disk_provisioned_iops ist nur einer der folgenden Werte zulässig:

dataDiskProvisionedIops

string (int64 format)

Optional. Bereitgestellte Anzahl von E/A-Vorgängen pro Sekunde für das Datenlaufwerk. Dieses Feld wird nur für Hyperdisk Balanced-Laufwerkstypen verwendet.

Union-Feld _data_disk_provisioned_throughput.

Für _data_disk_provisioned_throughput ist nur einer der folgenden Werte zulässig:

dataDiskProvisionedThroughput

string (int64 format)

Optional. Bereitgestellter Durchsatz in MiB pro Sekunde für die Datenfestplatte. Dieses Feld wird nur für Hyperdisk Balanced-Laufwerkstypen verwendet.

Union-Feld _connection_pool_config.

Für _connection_pool_config ist nur einer der folgenden Werte zulässig:

connectionPoolConfig

object (ConnectionPoolConfig)

Optional. Die Konfiguration des verwalteten Verbindungs-Poolings für die Instanz.

Union-Feld _final_backup_config.

Für _final_backup_config ist nur einer der folgenden Werte zulässig:

finalBackupConfig

object (FinalBackupConfig)

Optional. Die endgültige Sicherungskonfiguration für die Instanz.

Union-Feld _read_pool_auto_scale_config.

Für _read_pool_auto_scale_config ist nur einer der folgenden Werte zulässig:

readPoolAutoScaleConfig

object (ReadPoolAutoScaleConfig)

Optional. Die Autoscaling-Konfiguration des Lesepools für die Instanz.

Union-Feld _auto_upgrade_enabled.

Für _auto_upgrade_enabled ist nur einer der folgenden Werte zulässig:

autoUpgradeEnabled

boolean

Optional. Konfiguration für das automatische Upgrade von Cloud SQL for MySQL. Wenn dieser Parameter auf „true“ gesetzt ist, ist das automatische Upgrade für MySQL 8.0-Nebenversionen aktiviert. Die MySQL-Version muss 8.0.35 oder höher sein.

Union-Feld _data_api_access.

Für _data_api_access ist nur einer der folgenden Werte zulässig:

dataApiAccess

enum (DataApiAccess)

Mit diesem Parameter wird gesteuert, ob die ExecuteSql API zum Herstellen einer Verbindung zur Instanz verwendet werden darf. Standardmäßig nicht zulässig.

Int64Value

JSON-Darstellung
{
  "value": string
}
Felder
value

string (int64 format)

Der int64-Wert.

UserLabelsEntry

JSON-Darstellung
{
  "key": string,
  "value": string
}
Felder
key

string

value

string

IpConfiguration

JSON-Darstellung
{
  "ipv4Enabled": boolean,
  "privateNetwork": string,
  "requireSsl": boolean,
  "authorizedNetworks": [
    {
      object (AclEntry)
    }
  ],
  "allocatedIpRange": string,
  "enablePrivatePathForGoogleCloudServices": boolean,
  "sslMode": enum (SslMode),
  "customSubjectAlternativeNames": [
    string
  ],

  // Union field _psc_config can be only one of the following:
  "pscConfig": {
    object (PscConfig)
  }
  // End of list of possible types for union field _psc_config.

  // Union field _server_ca_mode can be only one of the following:
  "serverCaMode": enum (CaMode)
  // End of list of possible types for union field _server_ca_mode.

  // Union field _server_ca_pool can be only one of the following:
  "serverCaPool": string
  // End of list of possible types for union field _server_ca_pool.

  // Union field _server_certificate_rotation_mode can be only one of the
  // following:
  "serverCertificateRotationMode": enum (ServerCertificateRotationMode)
  // End of list of possible types for union field
  // _server_certificate_rotation_mode.
}
Felder
ipv4Enabled

boolean

Gibt an, ob der Instanz eine öffentliche IP-Adresse zugewiesen ist.

privateNetwork

string

Der Ressourcenlink für das VPC-Netzwerk, über das die Cloud SQL-Instanz über eine private IP-Adresse zugänglich ist. Beispiel: /projects/myProject/global/networks/default. Diese Einstellung kann aktualisiert, aber nach dem Festlegen nicht mehr entfernt werden.

requireSsl

boolean

Verwenden Sie stattdessen ssl_mode.

Gibt an, ob SSL/TLS-Verbindungen über IP erzwungen werden. Wenn „false“ festgelegt ist, sind sowohl Nicht-SSL-/Nicht-TLS- als auch SSL/TLS-Verbindungen zulässig. Bei SSL/TLS-Verbindungen wird das Clientzertifikat nicht geprüft. Wenn diese Option auf „true“ gesetzt ist, sind nur Verbindungen zulässig, die mit SSL/TLS und mit gültigen Client-Zertifikaten verschlüsselt wurden. Wenn Sie SSL/TLS erzwingen möchten, ohne gültige Clientzertifikate zu erzwingen, verwenden Sie das Flag ssl_mode anstelle des Flags require_ssl.

authorizedNetworks[]

object (AclEntry)

Die Liste der externen Netzwerke, die über die IP-Adresse eine Verbindung zur Instanz herstellen dürfen. In der CIDR-Notation, auch als „Slash-Notation“ bezeichnet (z. B. 157.197.200.0/24).

allocatedIpRange

string

Der Name des zugewiesenen IP-Bereichs für die Cloud SQL-Instanz mit privater IP-Adresse. Beispiel: „google-managed-services-default“. Wenn diese Option festgelegt ist, wird die IP-Adresse der Instanz im zugewiesenen Bereich erstellt. Der Bereichsname muss RFC 1035 entsprechen. Der Name muss zwischen 1 und 63 Zeichen lang sein und dem regulären Ausdruck [a-z]([-a-z0-9]*[a-z0-9])?. entsprechen.

enablePrivatePathForGoogleCloudServices

boolean

Steuert die Verbindung zu Instanzen mit privater IP-Adresse von Google-Diensten wie BigQuery.

sslMode

enum (SslMode)

Geben Sie an, wie SSL/TLS in Datenbankverbindungen erzwungen wird. Wenn Sie das Flag require_ssl aus Gründen der Abwärtskompatibilität verwenden müssen, sind nur die folgenden Wertepaare gültig:

Für PostgreSQL und MySQL:

  • ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED und require_ssl=false
  • ssl_mode=ENCRYPTED_ONLY und require_ssl=false
  • ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED und require_ssl=true

Für SQL Server:

  • ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED und require_ssl=false
  • ssl_mode=ENCRYPTED_ONLY und require_ssl=true

Der Wert von ssl_mode hat Vorrang vor dem Wert von require_ssl.

Für das Paar ssl_mode=ENCRYPTED_ONLY und require_ssl=false bedeutet ssl_mode=ENCRYPTED_ONLY beispielsweise, dass nur SSL-Verbindungen akzeptiert werden, während require_ssl=false bedeutet, dass sowohl Nicht-SSL- als auch SSL-Verbindungen akzeptiert werden. In diesem Fall wird ssl_mode von MySQL- und PostgreSQL-Datenbanken berücksichtigt und es werden nur SSL-Verbindungen akzeptiert.

customSubjectAlternativeNames[]

string

Optional. Benutzerdefinierte alternative Antragstellernamen(Subject Alternative Names, SANs) für eine Cloud SQL-Instanz.

Union-Feld _psc_config.

Für _psc_config ist nur einer der folgenden Werte zulässig:

pscConfig

object (PscConfig)

PSC-Einstellungen für diese Instanz.

Union-Feld _server_ca_mode.

Für _server_ca_mode ist nur einer der folgenden Werte zulässig:

serverCaMode

enum (CaMode)

Geben Sie an, welcher Typ von Zertifizierungsstelle für das Serverzertifikat verwendet wird.

Union-Feld _server_ca_pool.

Für _server_ca_pool ist nur einer der folgenden Werte zulässig:

serverCaPool

string

Optional. Der Ressourcenname des Server-CA-Pools für eine Instanz mit CUSTOMER_MANAGED_CAS_CA als server_ca_mode. Format: projects/{PROJECT}/locations/{REGION}/caPools/{CA_POOL_ID}

Union-Feld _server_certificate_rotation_mode.

Für _server_certificate_rotation_mode ist nur einer der folgenden Werte zulässig:

serverCertificateRotationMode

enum (ServerCertificateRotationMode)

Optional. Steuert die Funktion für die automatische Rotation von Serverzertifikaten. Diese Funktion ist standardmäßig deaktiviert. Wenn diese Option aktiviert ist, wird das Serverzertifikat während der geplanten Wartung von Cloud SQL oder bei Self-Service-Wartungsupdates bis zu sechs Monate vor Ablauf automatisch rotiert. Diese Einstellung kann nur festgelegt werden, wenn „server_ca_mode“ entweder „GOOGLE_MANAGED_CAS_CA“ oder „CUSTOMER_MANAGED_CAS_CA“ ist.

BoolValue

JSON-Darstellung
{
  "value": boolean
}
Felder
value

boolean

Der boolesche Wert.

AclEntry

JSON-Darstellung
{
  "value": string,
  "expirationTime": string,
  "name": string,
  "kind": string
}
Felder
value

string

Der zugelassene Wert für die Zugriffssteuerungsliste.

expirationTime

string (Timestamp format)

Die Zeit, zu der dieser Zugriffskontrolleintrag im RFC 3339-Format abläuft, z. B. 2012-11-15T16:19:00.094Z.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

name

string

Optional. Ein Label zur Identifizierung dieses Eintrags.

kind

string

Dies ist immer sql#aclEntry.

Zeitstempel

JSON-Darstellung
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).

nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

PscConfig

JSON-Darstellung
{
  "allowedConsumerProjects": [
    string
  ],
  "pscAutoConnections": [
    {
      object (PscAutoConnectionConfig)
    }
  ],
  "networkAttachmentUri": string,

  // Union field _psc_enabled can be only one of the following:
  "pscEnabled": boolean
  // End of list of possible types for union field _psc_enabled.
}
Felder
allowedConsumerProjects[]

string

Optional. Die Liste der Nutzerprojekte, die für PSC-Verbindungen zu dieser Instanz auf der Zulassungsliste stehen. Über PSC kann von jedem Netzwerk in diesen Projekten eine Verbindung zu dieser Instanz hergestellt werden.

Jedes Nutzerprojekt in dieser Liste kann durch eine Projektnummer (numerisch) oder eine Projekt-ID (alphanumerisch) dargestellt werden.

pscAutoConnections[]

object (PscAutoConnectionConfig)

Optional. Die Liste der Einstellungen für angeforderte Private Service Connect-Endpunkte, die verwendet werden können, um eine Verbindung zu dieser Cloud SQL-Instanz herzustellen.

networkAttachmentUri

string

Optional. Der Netzwerkanhang des Nutzer-Netzwerks, mit dem die für Private Service Connect aktivierte Cloud SQL-Instanz über die PSC-Schnittstelle verbunden werden darf. Format: projects/PROJECT/regions/REGION/networkAttachments/ID

Union-Feld _psc_enabled.

Für _psc_enabled ist nur einer der folgenden Werte zulässig:

pscEnabled

boolean

Gibt an, ob PSC-Verbindungen für diese Instanz aktiviert sind.

PscAutoConnectionConfig

JSON-Darstellung
{
  "consumerProject": string,
  "consumerNetwork": string,

  // Union field _ip_address can be only one of the following:
  "ipAddress": string
  // End of list of possible types for union field _ip_address.

  // Union field _status can be only one of the following:
  "status": string
  // End of list of possible types for union field _status.

  // Union field _consumer_network_status can be only one of the following:
  "consumerNetworkStatus": string
  // End of list of possible types for union field _consumer_network_status.
}
Felder
consumerProject

string

Optional. Dies ist die Projekt-ID des Nutzerdienstprojekts dieses Nutzerendpunkts.

Optional. Dies gilt nur, wenn „consumer_network“ ein freigegebenes VPC-Netzwerk ist.

consumerNetwork

string

Optional. Das Verbrauchernetzwerk dieses Verbraucherendpunkts. Dies muss ein Ressourcenpfad sein, der sowohl das Hostprojekt als auch den Netzwerknamen enthält.

Beispiel: projects/project1/global/networks/network1.

Das Hostprojekt des Nutzers für dieses Netzwerk kann sich vom Dienstprojekt des Nutzers unterscheiden.

Union-Feld _ip_address.

Für _ip_address ist nur einer der folgenden Werte zulässig:

ipAddress

string

Die IP-Adresse des Verbraucherendpunkts.

Union-Feld _status.

Für _status ist nur einer der folgenden Werte zulässig:

status

string

Der Verbindungsstatus des Nutzerendpunkts.

Union-Feld _consumer_network_status.

Für _consumer_network_status ist nur einer der folgenden Werte zulässig:

consumerNetworkStatus

string

Der Status der Verbindungsrichtlinie des Consumer-Netzwerks.

LocationPreference

JSON-Darstellung
{
  "followGaeApplication": string,
  "zone": string,
  "secondaryZone": string,
  "kind": string
}
Felder
followGaeApplication
(deprecated)

string

Die App Engine-Anwendung muss sich in derselben Region wie die Cloud SQL-Instanz befinden. ACHTUNG: Durch das Ändern dieser Einstellung wird die Instanz möglicherweise neu gestartet.

zone

string

Die bevorzugte Compute Engine-Zone (z. B. us-central1-a, us-central1-b usw.). ACHTUNG: Durch das Ändern dieser Einstellung wird die Instanz möglicherweise neu gestartet.

secondaryZone

string

Die bevorzugte Compute Engine-Zone für den sekundären/Failover-Standort (z. B. us-central1-a, us-central1-b usw.). Wenn Sie dieses Feld deaktivieren möchten, legen Sie es auf „no_secondary_zone“ fest.

kind

string

Dies ist immer sql#locationPreference.

DatabaseFlags

JSON-Darstellung
{
  "name": string,
  "value": string
}
Felder
name

string

Der Name des Flags. Diese Flags werden beim Start der Instanz übergeben. Geben Sie also sowohl Serveroptionen als auch Systemvariablen an. Flags werden mit Unterstrichen und nicht mit Bindestrichen angegeben. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Datenbank-Flags konfigurieren.

value

string

Der Wert des Flags. Boolesche Flags sind auf on für „wahr“ und auf off für „falsch“ gesetzt. Dieses Feld muss weggelassen werden, wenn das Flag keinen Wert annimmt.

MaintenanceWindow

JSON-Darstellung
{
  "hour": integer,
  "day": integer,
  "updateTrack": enum (SqlUpdateTrack),
  "kind": string
}
Felder
hour

integer

Stunde: 0 bis 23. Geben Sie in der UTC-Zeitzone an.

day

integer

Wochentag – MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY oder SUNDAY. Geben Sie in der UTC-Zeitzone an. Wird in der Ausgabe als Ganzzahl zwischen 1 und 7 zurückgegeben, wobei 1 dem Montag entspricht.

updateTrack

enum (SqlUpdateTrack)

Einstellungen für den Wartungszeitpunkt: canary, stable oder week5. Weitere Informationen finden Sie unter Wartung für Cloud SQL-Instanzen.

kind

string

Dies ist immer sql#maintenanceWindow.

Int32Value

JSON-Darstellung
{
  "value": integer
}
Felder
value

integer

Der int32-Wert.

BackupConfiguration

JSON-Darstellung
{
  "startTime": string,
  "enabled": boolean,
  "kind": string,
  "binaryLogEnabled": boolean,
  "replicationLogArchivingEnabled": boolean,
  "location": string,
  "pointInTimeRecoveryEnabled": boolean,
  "backupRetentionSettings": {
    object (BackupRetentionSettings)
  },
  "transactionLogRetentionDays": integer,

  // Union field _transactional_log_storage_state can be only one of the
  // following:
  "transactionalLogStorageState": enum (TransactionalLogStorageState)
  // End of list of possible types for union field
  // _transactional_log_storage_state.

  // Union field _backup_tier can be only one of the following:
  "backupTier": enum (BackupTier)
  // End of list of possible types for union field _backup_tier.
}
Felder
startTime

string

Startzeit für die Konfiguration der täglichen Sicherung in der UTC-Zeitzone im 24‑Stunden-Format – HH:MM.

enabled

boolean

Gibt an, ob diese Konfiguration aktiviert ist.

kind

string

Dies ist immer sql#backupConfiguration.

binaryLogEnabled

boolean

(Nur MySQL) Gibt an, ob das Binärlog aktiviert ist. Wenn die Sicherungskonfiguration deaktiviert ist, muss auch das Binärlog deaktiviert werden.

replicationLogArchivingEnabled

boolean

Reserviert für zukünftige Verwendungen.

location

string

Speicherort der Sicherung

pointInTimeRecoveryEnabled

boolean

Gibt an, ob die Wiederherstellung zu einem bestimmten Zeitpunkt aktiviert ist.

backupRetentionSettings

object (BackupRetentionSettings)

Einstellungen für die Aufbewahrung von Sicherungen.

transactionLogRetentionDays

integer

Die Anzahl der Tage, die Transaktionslogs für die Wiederherstellung zu einem bestimmten Zeitpunkt aufbewahrt werden (von 1 bis 7).

Union-Feld _transactional_log_storage_state.

Für _transactional_log_storage_state ist nur einer der folgenden Werte zulässig:

transactionalLogStorageState

enum (TransactionalLogStorageState)

Nur Ausgabe. Dieser Wert enthält den Speicherort der Transaktionslogs, die zum Ausführen der Wiederherstellung zu einem bestimmten Zeitpunkt für die Datenbank verwendet werden.

Union-Feld _backup_tier.

Für _backup_tier ist nur einer der folgenden Werte zulässig:

backupTier

enum (BackupTier)

Nur Ausgabe. Sicherungsstufe, die die Sicherungen für die Instanz verwaltet.

BackupRetentionSettings

JSON-Darstellung
{
  "retentionUnit": enum (RetentionUnit),
  "retainedBackups": integer
}
Felder
retentionUnit

enum (RetentionUnit)

Die Einheit, die „retained_backups“ darstellt.

retainedBackups

integer

Je nach Wert von „retention_unit“ wird damit bestimmt, ob eine Sicherung gelöscht werden muss. Wenn „retention_unit“ „COUNT“ ist, werden so viele Sicherungen beibehalten.

SqlActiveDirectoryConfig

JSON-Darstellung
{
  "kind": string,
  "domain": string,
  "mode": enum (ActiveDirectoryMode),
  "dnsServers": [
    string
  ],
  "adminCredentialSecretName": string,
  "organizationalUnit": string
}
Felder
kind

string

Dies ist immer sql#activeDirectoryConfig.

domain

string

Der Name der Domain, z.B. meine-domain.de.

mode

enum (ActiveDirectoryMode)

Optional. Der Modus der Active Directory-Konfiguration.

dnsServers[]

string

Optional. IPv4-Adressen des Domaincontrollers, die zum Bootstrapping von Active Directory verwendet werden.

adminCredentialSecretName

string

Optional. Der Secret Manager-Schlüssel, in dem die Administratoranmeldedaten gespeichert sind. z.B. projects/{project}/secrets/{secret}.

organizationalUnit

string

Optional. Der Distinguished Name der Organisationseinheit. Dies ist der vollständige hierarchische Pfad zur Organisationseinheit.

DenyMaintenancePeriod

JSON-Darstellung
{
  "startDate": string,
  "endDate": string,
  "time": string
}
Felder
startDate

string

Startdatum des „Zeitraum für Wartungsausschluss“. Wenn das Jahr des Startdatums leer ist, muss auch das Jahr des Enddatums leer sein. In diesem Fall wiederholt sich der Zeitraum für den Wartungsausschluss jedes Jahr. Das Datum hat das Format JJJJ-MM-TT, z.B. 2020-11-01 oder MM-TT, z.B. 11-01

endDate

string

Enddatum des „Zeitraum für Wartungsausschluss“. Wenn das Jahr des Enddatums leer ist, muss auch das Jahr des Startdatums leer sein. In diesem Fall bedeutet das, dass sich das Wartungsintervall jedes Jahr wiederholt. Das Datum hat das Format JJJJ-MM-TT, z.B. 2020-11-01 oder MM-TT, z.B. 11-01

time

string

Die Uhrzeit in UTC, zu der der Zeitraum für den Wartungsausschluss am start_date beginnt und am end_date endet. Die Zeit wird im Format HH: mm:SS angegeben, d.h.: 00:00:00

InsightsConfig

JSON-Darstellung
{
  "queryInsightsEnabled": boolean,
  "recordClientAddress": boolean,
  "recordApplicationTags": boolean,
  "queryStringLength": integer,
  "queryPlansPerMinute": integer,
  "enhancedQueryInsightsEnabled": boolean
}
Felder
queryInsightsEnabled

boolean

Gibt an, ob die Funktion „Abfragestatistiken“ aktiviert ist.

recordClientAddress

boolean

Gibt an, ob die Clientadresse in Query Insights aufgezeichnet wird, wenn die Funktion aktiviert ist.

recordApplicationTags

boolean

Gibt an, ob Query Insights Anwendungstags aus Abfragen aufzeichnet, wenn die Funktion aktiviert ist.

queryStringLength

integer

Maximale Länge der gespeicherten Abfrage in Byte. Standardwert: 1.024 Byte. Bereich: 256–4.500 Byte. Abfragelängen, die diesen Feldwert überschreiten, werden auf diesen Wert gekürzt. Wenn kein Wert festgelegt ist, wird die Abfragelänge als Standardwert verwendet. Wenn Sie die Abfragelänge ändern, wird die Datenbank neu gestartet.

queryPlansPerMinute

integer

Anzahl der Abfrageausführungspläne, die von Insights pro Minute für alle Abfragen zusammen erfasst werden. Der Standardwert ist 5.

enhancedQueryInsightsEnabled

boolean

Optional. Gibt an, ob die Funktion „Erweiterte Query Insights“ aktiviert ist.

PasswordValidationPolicy

JSON-Darstellung
{
  "minLength": integer,
  "complexity": enum (Complexity),
  "reuseInterval": integer,
  "disallowUsernameSubstring": boolean,
  "passwordChangeInterval": string,
  "enablePasswordPolicy": boolean,
  "disallowCompromisedCredentials": boolean
}
Felder
minLength

integer

Mindestanzahl der zulässigen Zeichen.

complexity

enum (Complexity)

Die Komplexität des Passworts.

reuseInterval

integer

Anzahl der vorherigen Passwörter, die nicht wiederverwendet werden können.

disallowUsernameSubstring

boolean

Verhindert die Verwendung des Nutzernamens im Passwort.

passwordChangeInterval

string (Duration format)

Das Mindestintervall, nach dem das Passwort geändert werden kann. Dieses Flag wird nur für PostgreSQL unterstützt.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

enablePasswordPolicy

boolean

Gibt an, ob die Passwortrichtlinie aktiviert werden soll. Wenn diese Option aktiviert ist, müssen Passwörter die Anforderungen an die Komplexität erfüllen. Lassen Sie diese Richtlinie aktiviert, um unberechtigte Zugriffe zu verhindern. Wenn diese Richtlinie deaktiviert ist, sind schwache Passwörter zulässig.

disallowCompromisedCredentials
(deprecated)

boolean

Dieses Feld ist veraltet und wird in einer zukünftigen Version der API entfernt.

Dauer

JSON-Darstellung
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Signierte Sekunden des Zeitraums. Muss zwischen -315.576.000.000 und +315.576.000.000 (einschließlich) liegen. Hinweis: Diese Grenzen werden so berechnet: 60 Sek./Min. × 60 Min./Std. × 24 Std./Tag × 365,25 Tage/Jahr × 10.000 Jahre

nanos

integer

Signierte Sekundenbruchteile mit Nanosekunden-Auflösung für den Zeitraum. Dauern von weniger als einer Sekunde werden mit dem Feld „0“ seconds und einem positiven oder negativen Feld nanos dargestellt. Bei Zeiträumen von einer Sekunde oder mehr muss ein Wert ungleich null für das Feld nanos dasselbe Vorzeichen wie das Feld seconds haben. Muss zwischen -999.999.999 und +999.999.999 liegen (einschließlich).

SqlServerAuditConfig

JSON-Darstellung
{
  "kind": string,
  "bucket": string,
  "retentionInterval": string,
  "uploadInterval": string
}
Felder
kind

string

Dies ist immer sql#sqlServerAuditConfig.

bucket

string

Der Name des Ziel-Buckets (z.B. gs://mybucket).

retentionInterval

string (Duration format)

Wie lange generierte Audit-Dateien aufbewahrt werden sollen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

uploadInterval

string (Duration format)

Die Häufigkeit, mit der generierte Audit-Dateien hochgeladen werden.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

AdvancedMachineFeatures

JSON-Darstellung
{
  "threadsPerCore": integer
}
Felder
threadsPerCore

integer

Die Anzahl der Threads pro physischem Kern.

DataCacheConfig

JSON-Darstellung
{
  "dataCacheEnabled": boolean
}
Felder
dataCacheEnabled

boolean

Gibt an, ob der Datencache für die Instanz aktiviert ist.

ConnectionPoolConfig

JSON-Darstellung
{
  "flags": [
    {
      object (ConnectionPoolFlags)
    }
  ],

  // Union field _connection_pooling_enabled can be only one of the following:
  "connectionPoolingEnabled": boolean
  // End of list of possible types for union field _connection_pooling_enabled.

  // Union field _pooler_count can be only one of the following:
  "poolerCount": integer
  // End of list of possible types for union field _pooler_count.
}
Felder
flags[]

object (ConnectionPoolFlags)

Optional. Liste der Konfigurationsflags für Verbindungspools.

Union-Feld _connection_pooling_enabled.

Für _connection_pooling_enabled ist nur einer der folgenden Werte zulässig:

connectionPoolingEnabled

boolean

Gibt an, ob das verwaltete Verbindungs-Pooling aktiviert ist.

Union-Feld _pooler_count.

Für _pooler_count ist nur einer der folgenden Werte zulässig:

poolerCount

integer

Nur Ausgabe. Anzahl der Verbindungspooler.

ConnectionPoolFlags

JSON-Darstellung
{
  "name": string,
  "value": string
}
Felder
name

string

Erforderlich. Der Name des Flags.

value

string

Erforderlich. Der Wert des Flags. Boolesche Flags sind auf on für „wahr“ und auf off für „falsch“ gesetzt. Dieses Feld muss weggelassen werden, wenn das Flag keinen Wert annimmt.

FinalBackupConfig

JSON-Darstellung
{

  // Union field _enabled can be only one of the following:
  "enabled": boolean
  // End of list of possible types for union field _enabled.

  // Union field _retention_days can be only one of the following:
  "retentionDays": integer
  // End of list of possible types for union field _retention_days.
}
Felder

Union-Feld _enabled.

Für _enabled ist nur einer der folgenden Werte zulässig:

enabled

boolean

Gibt an, ob die abschließende Sicherung für die Instanz aktiviert ist.

Union-Feld _retention_days.

Für _retention_days ist nur einer der folgenden Werte zulässig:

retentionDays

integer

Die Anzahl der Tage, die die letzte Sicherung nach dem Löschen der Instanz aufbewahrt wird. Die endgültige Sicherung wird nach (time_of_instance_deletion + retention_days) gelöscht.

ReadPoolAutoScaleConfig

JSON-Darstellung
{
  "targetMetrics": [
    {
      object (TargetMetric)
    }
  ],

  // Union field _enabled can be only one of the following:
  "enabled": boolean
  // End of list of possible types for union field _enabled.

  // Union field _min_node_count can be only one of the following:
  "minNodeCount": integer
  // End of list of possible types for union field _min_node_count.

  // Union field _max_node_count can be only one of the following:
  "maxNodeCount": integer
  // End of list of possible types for union field _max_node_count.

  // Union field _disable_scale_in can be only one of the following:
  "disableScaleIn": boolean
  // End of list of possible types for union field _disable_scale_in.

  // Union field _scale_in_cooldown_seconds can be only one of the following:
  "scaleInCooldownSeconds": integer
  // End of list of possible types for union field _scale_in_cooldown_seconds.

  // Union field _scale_out_cooldown_seconds can be only one of the following:
  "scaleOutCooldownSeconds": integer
  // End of list of possible types for union field _scale_out_cooldown_seconds.
}
Felder
targetMetrics[]

object (TargetMetric)

Optional. Zielmesswerte für das automatische Skalieren von Lesepools.

Union-Feld _enabled.

Für _enabled ist nur einer der folgenden Werte zulässig:

enabled

boolean

Gibt an, ob die automatische Skalierung des Lesepools aktiviert ist.

Union-Feld _min_node_count.

Für _min_node_count ist nur einer der folgenden Werte zulässig:

minNodeCount

integer

Die Mindestanzahl der Lesepoolknoten, die verwaltet werden müssen.

Union-Feld _max_node_count.

Für _max_node_count ist nur einer der folgenden Werte zulässig:

maxNodeCount

integer

Maximale Anzahl der Knoten im Lesepool, die verwaltet werden sollen.

Union-Feld _disable_scale_in.

Für _disable_scale_in ist nur einer der folgenden Werte zulässig:

disableScaleIn

boolean

Gibt an, ob das Autoscaling des Lesepools das Herunterskalieren (Entfernen von Knoten) unterstützt.

Union-Feld _scale_in_cooldown_seconds.

Für _scale_in_cooldown_seconds ist nur einer der folgenden Werte zulässig:

scaleInCooldownSeconds

integer

Die Wartezeit für das Herunterskalieren.

Union-Feld _scale_out_cooldown_seconds.

Für _scale_out_cooldown_seconds ist nur einer der folgenden Werte zulässig:

scaleOutCooldownSeconds

integer

Die Wartezeit für Scale-out-Vorgänge.

TargetMetric

JSON-Darstellung
{

  // Union field _metric can be only one of the following:
  "metric": string
  // End of list of possible types for union field _metric.

  // Union field _target_value can be only one of the following:
  "targetValue": number
  // End of list of possible types for union field _target_value.
}
Felder

Union-Feld _metric.

Für _metric ist nur einer der folgenden Werte zulässig:

metric

string

Der Messwertname, der für die automatische Skalierung verwendet werden soll.

Union-Feld _target_value.

Für _target_value ist nur einer der folgenden Werte zulässig:

targetValue

number

Der Zielwert für den Messwert.

SqlServerEntraIdConfig

JSON-Darstellung
{
  "kind": string,
  "tenantId": string,
  "applicationId": string
}
Felder
kind

string

Nur Ausgabe. Dies ist immer sql#sqlServerEntraIdConfig.

tenantId

string

Optional. Die Mandanten-ID für die Entra ID-Konfiguration.

applicationId

string

Optional. Die Anwendungs-ID für die Entra ID-Konfiguration.

PerformanceCaptureConfig

JSON-Darstellung
{

  // Union field _enabled can be only one of the following:
  "enabled": boolean
  // End of list of possible types for union field _enabled.

  // Union field _probing_interval_seconds can be only one of the following:
  "probingIntervalSeconds": integer
  // End of list of possible types for union field _probing_interval_seconds.

  // Union field _probe_threshold can be only one of the following:
  "probeThreshold": integer
  // End of list of possible types for union field _probe_threshold.

  // Union field _running_threads_threshold can be only one of the following:
  "runningThreadsThreshold": integer
  // End of list of possible types for union field _running_threads_threshold.

  // Union field _seconds_behind_source_threshold can be only one of the
  // following:
  "secondsBehindSourceThreshold": integer
  // End of list of possible types for union field
  // _seconds_behind_source_threshold.

  // Union field _transaction_duration_threshold can be only one of the
  // following:
  "transactionDurationThreshold": integer
  // End of list of possible types for union field
  // _transaction_duration_threshold.
}
Felder

Union-Feld _enabled.

Für _enabled ist nur einer der folgenden Werte zulässig:

enabled

boolean

Optional. Aktivieren oder deaktivieren Sie die Funktion „Performance Capture“.

Union-Feld _probing_interval_seconds.

Für _probing_interval_seconds ist nur einer der folgenden Werte zulässig:

probingIntervalSeconds

integer

Optional. Das Zeitintervall in Sekunden zwischen zwei beliebigen Tests.

Union-Feld _probe_threshold.

Für _probe_threshold ist nur einer der folgenden Werte zulässig:

probeThreshold

integer

Optional. Die Mindestanzahl aufeinanderfolgender Messwerte über dem Schwellenwert, die das Erfassen des Instanzstatus auslösen.

Union-Feld _running_threads_threshold.

Für _running_threads_threshold ist nur einer der folgenden Werte zulässig:

runningThreadsThreshold

integer

Optional. Die Mindestanzahl von Server-Threads, die ausgeführt werden müssen, damit die Erfassung auf dem primären Server ausgelöst wird.

Union-Feld _seconds_behind_source_threshold.

Für _seconds_behind_source_threshold ist nur einer der folgenden Werte zulässig:

secondsBehindSourceThreshold

integer

Optional. Die Mindestanzahl von Sekunden, die das Replikat hinter der primären Instanz zurückliegen muss, damit die Erfassung auf dem Replikat ausgelöst wird.

Union-Feld _transaction_duration_threshold.

Für _transaction_duration_threshold ist nur einer der folgenden Werte zulässig:

transactionDurationThreshold

integer

Optional. Die Zeit in Sekunden, die eine Transaktion offen sein muss, bevor der Beobachter sie aufzeichnet.

SqlFailoverReplica

JSON-Darstellung
{
  "name": string,
  "available": boolean
}
Felder
name

string

Der Name des Failover-Replikats. Wenn beim Erstellen der Instanz angegeben, wird ein Failover-Replikat für die Instanz erstellt. Der Name enthält nicht die Projekt-ID.

available

boolean

Der Verfügbarkeitsstatus des Failover-Replikats. Ein falscher Status gibt an, dass das Failover-Replikat nicht synchronisiert ist. Die primäre Instanz kann nur dann ein Failover auf das Failover-Replikat ausführen, wenn der Status „true“ ist.

IpMapping

JSON-Darstellung
{
  "type": enum (SqlIpAddressType),
  "ipAddress": string,
  "timeToRetire": string
}
Felder
type

enum (SqlIpAddressType)

Der Typ dieser IP-Adresse. Eine PRIMARY-Adresse ist eine öffentliche Adresse, die eingehende Verbindungen akzeptieren kann. Eine PRIVATE-Adresse ist eine private Adresse, die eingehende Verbindungen akzeptieren kann. Eine OUTGOING-Adresse ist die Quelladresse von Verbindungen, die von der Instanz stammen, sofern dies unterstützt wird.

ipAddress

string

Die zugewiesene IP-Adresse.

timeToRetire

string (Timestamp format)

Die Fälligkeitszeit für die Deaktivierung dieser IP-Adresse im RFC 3339-Format, z. B. 2012-11-15T16:19:00.094Z. Dieses Feld ist nur verfügbar, wenn die IP-Adresse demnächst eingestellt wird.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

SslCert

JSON-Darstellung
{
  "kind": string,
  "certSerialNumber": string,
  "cert": string,
  "createTime": string,
  "commonName": string,
  "expirationTime": string,
  "sha1Fingerprint": string,
  "instance": string,
  "selfLink": string
}
Felder
kind

string

Dies ist immer sql#sslCert.

certSerialNumber

string

Seriennummer aus dem Zertifikat

cert

string

PEM-Darstellung

createTime

string (Timestamp format)

Die Uhrzeit, zu der das Zertifikat im RFC 3339-Format erstellt wurde, z. B. 2012-11-15T16:19:00.094Z

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

commonName

string

Vom Nutzer bereitgestellter Name. Auf [a-zA-Z.-_ ]+. beschränkt.

expirationTime

string (Timestamp format)

Die Zeit, zu der das Zertifikat im RFC 3339-Format abläuft, z. B. 2012-11-15T16:19:00.094Z.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

sha1Fingerprint

string

SHA1-Fingerabdruck.

instance

string

Name der Datenbankinstanz.

selfLink

string

Der URI dieser Ressource.

OnPremisesConfiguration

JSON-Darstellung
{
  "hostPort": string,
  "kind": string,
  "username": string,
  "password": string,
  "caCertificate": string,
  "clientCertificate": string,
  "clientKey": string,
  "dumpFilePath": string,
  "sourceInstance": {
    object (InstanceReference)
  },
  "selectedObjects": [
    {
      object (SelectedObjects)
    }
  ],
  "sslOption": enum (SslOption)
}
Felder
hostPort

string

Der Host und der Port der lokalen Instanz im Format host:port.

kind

string

Dies ist immer sql#onPremisesConfiguration.

username

string

Der Nutzername für die Verbindung mit der On-Premise-Instanz.

password

string

Das Passwort für die Verbindung mit der lokalen Instanz.

caCertificate

string

PEM-Darstellung des x509-Zertifikats der vertrauenswürdigen Zertifizierungsstelle.

clientCertificate

string

PEM-Darstellung des x509-Zertifikats des Replikats.

clientKey

string

PEM-Darstellung des privaten Schlüssels des Replikats. Der entsprechende öffentliche Schlüssel ist im Zertifikat des Clients codiert.

dumpFilePath

string

Die Dumpdatei zum Erstellen des Cloud SQL-Replikats.

sourceInstance

object (InstanceReference)

Der Verweis auf die Cloud SQL-Instanz, wenn die Quelle Cloud SQL ist.

selectedObjects[]

object (SelectedObjects)

Optional. Eine Liste mit Objekten, die der Nutzer zur Replikation aus einer externen Quellinstanz auswählt.

sslOption

enum (SslOption)

Optional. SSL-Option für die Replikatverbindung zur lokalen Quelle.

InstanceReference

JSON-Darstellung
{
  "name": string,
  "region": string,
  "project": string
}
Felder
name

string

Der Name der Cloud SQL-Instanz, auf die verwiesen wird. Die Projekt-ID ist darin nicht enthalten.

region

string

Die Region der Cloud SQL-Instanz, auf die verwiesen wird.

project

string

Die Projekt-ID der Cloud SQL-Instanz, auf die verwiesen wird. Standardmäßig wird dieselbe Projekt-ID verwendet, auf die sich die Instanz bezieht.

SelectedObjects

JSON-Darstellung
{
  "database": string
}
Felder
database

string

Erforderlich. Der Name der zu migrierenden Datenbank.

ReplicaConfiguration

JSON-Darstellung
{
  "kind": string,
  "mysqlReplicaConfiguration": {
    object (MySqlReplicaConfiguration)
  },
  "failoverTarget": boolean,
  "cascadableReplica": boolean
}
Felder
kind

string

Dies ist immer sql#replicaConfiguration.

mysqlReplicaConfiguration

object (MySqlReplicaConfiguration)

MySQL-spezifische Konfiguration bei der Replikation von einer primären MySQL-Instanz vor Ort. Informationen zur Replikationskonfiguration wie Nutzername, Passwort, Zertifikate und Schlüssel werden nicht in den Instanzmetadaten gespeichert. Die Konfigurationsinformationen werden nur zum Einrichten der Replikationsverbindung verwendet und von MySQL in einer Datei namens master.info im Datenverzeichnis gespeichert.

failoverTarget

boolean

Gibt an, ob das Replikat das Failover-Ziel ist. Wenn das Feld auf true gesetzt ist, wird das Replikat als Failover-Replikat festgelegt. Wenn die primäre Instanz ausfällt, wird die Replikatinstanz zur neuen primären Instanz hochgestuft. Nur ein Replikat kann als Failover-Ziel angegeben werden und das Replikat muss sich in einer anderen Zone als die primäre Instanz befinden.

cascadableReplica

boolean

Optional. Gibt an, ob ein SQL Server-Replikat ein kaskadierbares Replikat ist. Ein kaskadierbares Replikat ist ein SQL Server-Replikat für mehrere Regionen, das untergeordnete Replikate unterstützt.

MySqlReplicaConfiguration

JSON-Darstellung
{
  "dumpFilePath": string,
  "username": string,
  "password": string,
  "connectRetryInterval": integer,
  "masterHeartbeatPeriod": string,
  "caCertificate": string,
  "clientCertificate": string,
  "clientKey": string,
  "sslCipher": string,
  "verifyServerCertificate": boolean,
  "kind": string
}
Felder
dumpFilePath

string

Pfad zu einer SQL-Dumpdatei in Google Cloud Storage, aus der die Replikatinstanz erstellt werden soll. Der URI hat das Format gs://bucketName/fileName. Komprimierte gzip-Dateien (.gz) werden ebenfalls unterstützt. Dumps enthalten die Binlog-Koordinaten, ab denen die Replikation beginnt. Dazu müssen Sie beim Verwenden von mysqldump „--master-data“ auf „1“ setzen.

username

string

Der Nutzername für die Replikationsverbindung.

password

string

Das Passwort für die Replikationsverbindung.

connectRetryInterval

integer

Anzahl der Sekunden, die zwischen Verbindungsversuchen gewartet werden soll. Der Standardwert von MySQL beträgt 60 Sekunden.

masterHeartbeatPeriod

string (Int64Value format)

Intervall zwischen Replikations-Heartbeats in Millisekunden.

caCertificate

string

PEM-Darstellung des x509-Zertifikats der vertrauenswürdigen Zertifizierungsstelle.

clientCertificate

string

PEM-Darstellung des x509-Zertifikats des Replikats.

clientKey

string

PEM-Darstellung des privaten Schlüssels des Replikats. Der entsprechende öffentliche Schlüssel ist im Zertifikat des Clients codiert.

sslCipher

string

Eine Liste der zulässigen Chiffren für die SSL-Verschlüsselung.

verifyServerCertificate

boolean

Gibt an, ob der Wert „Common Name“ der primären Instanz im Zertifikat geprüft werden soll, das während des SSL-Handshakes gesendet wird.

kind

string

Dies ist immer sql#mysqlReplicaConfiguration.

DiskEncryptionConfiguration

JSON-Darstellung
{
  "kmsKeyName": string,
  "kind": string
}
Felder
kmsKeyName

string

Ressourcenname des KMS-Schlüssels für die Laufwerkverschlüsselung

kind

string

Dies ist immer sql#diskEncryptionConfiguration.

DiskEncryptionStatus

JSON-Darstellung
{
  "kmsKeyVersionName": string,
  "kind": string
}
Felder
kmsKeyVersionName

string

Zur Verschlüsselung der Cloud SQL-Instanzressource verwendete KMS-Schlüsselversion

kind

string

Dies ist immer sql#diskEncryptionStatus.

SqlScheduledMaintenance

JSON-Darstellung
{
  "startTime": string,
  "canDefer": boolean,
  "canReschedule": boolean,

  // Union field _schedule_deadline_time can be only one of the following:
  "scheduleDeadlineTime": string
  // End of list of possible types for union field _schedule_deadline_time.
}
Felder
startTime

string (Timestamp format)

Die Startzeit einer geplanten Wartung für diese Instanz.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

canDefer
(deprecated)

boolean

canReschedule

boolean

Gibt an, ob die geplante Wartung verschoben werden kann.

Union-Feld _schedule_deadline_time.

Für _schedule_deadline_time ist nur einer der folgenden Werte zulässig:

scheduleDeadlineTime

string (Timestamp format)

Die Wartung kann nicht auf einen Zeitpunkt nach dieser Frist verschoben werden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

SqlOutOfDiskReport

JSON-Darstellung
{

  // Union field _sql_out_of_disk_state can be only one of the following:
  "sqlOutOfDiskState": enum (SqlOutOfDiskState)
  // End of list of possible types for union field _sql_out_of_disk_state.

  // Union field _sql_min_recommended_increase_size_gb can be only one of the
  // following:
  "sqlMinRecommendedIncreaseSizeGb": integer
  // End of list of possible types for union field
  // _sql_min_recommended_increase_size_gb.
}
Felder

Union-Feld _sql_out_of_disk_state.

Für _sql_out_of_disk_state ist nur einer der folgenden Werte zulässig:

sqlOutOfDiskState

enum (SqlOutOfDiskState)

Dieses Feld stellt den Status dar, der vom proaktiven Datenbank-Wellness-Job für Probleme mit dem Speicherplatz generiert wird. * Autoren: * Der proaktive Datenbank-Wellness-Job für OOD. * Leser: * der proaktive Datenbank-Wellness-Job

Union-Feld _sql_min_recommended_increase_size_gb.

Für _sql_min_recommended_increase_size_gb ist nur einer der folgenden Werte zulässig:

sqlMinRecommendedIncreaseSizeGb

integer

Die empfohlene Mindestgröße der Erhöhung in Gigabyte. Dieses Feld wird vom Frontend verwendet. * Schreiber: * der proaktive Datenbank-Wellness-Job für OOD. * Leser:

AvailableDatabaseVersion

JSON-Darstellung
{

  // Union field _major_version can be only one of the following:
  "majorVersion": string
  // End of list of possible types for union field _major_version.

  // Union field _name can be only one of the following:
  "name": string
  // End of list of possible types for union field _name.

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.
}
Felder

Union-Feld _major_version.

Für _major_version ist nur einer der folgenden Werte zulässig:

majorVersion

string

Der Name der Hauptversion der Version.

Union-Feld _name.

Für _name ist nur einer der folgenden Werte zulässig:

name

string

Der Name der Datenbankversion. Für MySQL 8.0 enthält dieser String die Haupt- und Nebenversion der Datenbank.

Union-Feld _display_name.

Für _display_name ist nur einer der folgenden Werte zulässig:

displayName

string

Der Anzeigename der Datenbankversion.

ReplicationCluster

JSON-Darstellung
{
  "psaWriteEndpoint": string,
  "failoverDrReplicaName": string,
  "drReplica": boolean
}
Felder
psaWriteEndpoint

string

Nur Ausgabe. Wenn dieses Feld festgelegt ist, gibt es an, dass diese Instanz einen DNS-Endpunkt für den privaten Dienstzugriff (Private Service Access, PSA) hat, der auf die primäre Instanz des Clusters verweist. Wenn diese Instanz die primäre ist, verweist der DNS-Endpunkt auf diese Instanz. Nach einem Switchover- oder Replikat-Failover-Vorgang verweist dieser DNS-Endpunkt auf die hochgestufte Instanz. Dieses Feld ist schreibgeschützt und wird dem Nutzer als Information zurückgegeben. Dieses Feld kann auch dann vorhanden sein, wenn eine eigenständige Instanz noch kein DR-Replikat hat oder das DR-Replikat gelöscht wurde.

failoverDrReplicaName

string

Optional. Wenn die Instanz eine primäre Instanz ist, wird in diesem Feld das DR-Replikat (Disaster Recovery, Notfallwiederherstellung) angegeben. Ein DR-Replikat ist eine optionale Konfiguration für Enterprise Plus-Instanzen. Wenn die Instanz ein Lesereplikat ist, wird das Feld nicht festgelegt. Legen Sie dieses Feld auf einen Replikatnamen fest, um ein DR-Replikat für eine primäre Instanz festzulegen. Entfernen Sie den Namen des Replikats, um die Kennzeichnung des DR-Replikats zu entfernen.

drReplica

boolean

Nur Ausgabe. Schreibgeschütztes Feld, das angibt, ob das Replikat ein DR-Replikat ist. Dieses Feld ist nicht festgelegt, wenn die Instanz eine primäre Instanz ist.

GeminiInstanceConfig

JSON-Darstellung
{

  // Union field _entitled can be only one of the following:
  "entitled": boolean
  // End of list of possible types for union field _entitled.

  // Union field _google_vacuum_mgmt_enabled can be only one of the following:
  "googleVacuumMgmtEnabled": boolean
  // End of list of possible types for union field _google_vacuum_mgmt_enabled.

  // Union field _oom_session_cancel_enabled can be only one of the following:
  "oomSessionCancelEnabled": boolean
  // End of list of possible types for union field _oom_session_cancel_enabled.

  // Union field _active_query_enabled can be only one of the following:
  "activeQueryEnabled": boolean
  // End of list of possible types for union field _active_query_enabled.

  // Union field _index_advisor_enabled can be only one of the following:
  "indexAdvisorEnabled": boolean
  // End of list of possible types for union field _index_advisor_enabled.

  // Union field _flag_recommender_enabled can be only one of the following:
  "flagRecommenderEnabled": boolean
  // End of list of possible types for union field _flag_recommender_enabled.
}
Felder

Union-Feld _entitled.

Für _entitled ist nur einer der folgenden Werte zulässig:

entitled

boolean

Nur Ausgabe. Gibt an, ob Gemini aktiviert ist.

Union-Feld _google_vacuum_mgmt_enabled.

Für _google_vacuum_mgmt_enabled ist nur einer der folgenden Werte zulässig:

googleVacuumMgmtEnabled

boolean

Nur Ausgabe. Gibt an, ob die Staubsaugerverwaltung aktiviert ist.

Union-Feld _oom_session_cancel_enabled.

Für _oom_session_cancel_enabled ist nur einer der folgenden Werte zulässig:

oomSessionCancelEnabled

boolean

Nur Ausgabe. Gibt an, ob das Beenden der OOM-Sitzung (Out-of-Memory) aktiviert ist.

Union-Feld _active_query_enabled.

Für _active_query_enabled ist nur einer der folgenden Werte zulässig:

activeQueryEnabled

boolean

Nur Ausgabe. Gibt an, ob die aktive Abfrage aktiviert ist.

Union-Feld _index_advisor_enabled.

Für _index_advisor_enabled ist nur einer der folgenden Werte zulässig:

indexAdvisorEnabled

boolean

Nur Ausgabe. Gibt an, ob der Indexberater aktiviert ist.

Union-Feld _flag_recommender_enabled.

Für _flag_recommender_enabled ist nur einer der folgenden Werte zulässig:

flagRecommenderEnabled

boolean

Nur Ausgabe. Gibt an, ob die Empfehlungsfunktion für Flags aktiviert ist.

TagsEntry

JSON-Darstellung
{
  "key": string,
  "value": string
}
Felder
key

string

value

string

PoolNodeConfig

JSON-Darstellung
{
  "ipAddresses": [
    {
      object (IpMapping)
    }
  ],
  "dnsNames": [
    {
      object (DnsNameMapping)
    }
  ],
  "pscAutoConnections": [
    {
      object (PscAutoConnectionConfig)
    }
  ],

  // Union field _name can be only one of the following:
  "name": string
  // End of list of possible types for union field _name.

  // Union field _gce_zone can be only one of the following:
  "gceZone": string
  // End of list of possible types for union field _gce_zone.

  // Union field _dns_name can be only one of the following:
  "dnsName": string
  // End of list of possible types for union field _dns_name.

  // Union field _state can be only one of the following:
  "state": enum (SqlInstanceState)
  // End of list of possible types for union field _state.

  // Union field _psc_service_attachment_link can be only one of the following:
  "pscServiceAttachmentLink": string
  // End of list of possible types for union field _psc_service_attachment_link.
}
Felder
ipAddresses[]

object (IpMapping)

Nur Ausgabe. Zuordnungen mit IP-Adressen, die zum Herstellen einer Verbindung zum Lesepoolknoten verwendet werden können.

dnsNames[]

object (DnsNameMapping)

Nur Ausgabe. Die Liste der DNS-Namen, die von diesem Knoten des Lesepools verwendet werden.

pscAutoConnections[]

object (PscAutoConnectionConfig)

Nur Ausgabe. Die Liste der Einstellungen für angeforderte automatisch eingerichtete Private Service Connect-Endpunkte (PSC), die verwendet werden können, um eine Verbindung zu diesem Lesepoolknoten herzustellen.

Union-Feld _name.

Für _name ist nur einer der folgenden Werte zulässig:

name

string

Nur Ausgabe. Der Name des Lesepoolknotens, der zum Abrufen von Messwerten und Logs verwendet werden soll.

Union-Feld _gce_zone.

Für _gce_zone ist nur einer der folgenden Werte zulässig:

gceZone

string

Nur Ausgabe. Die Zone des Lesepoolknotens.

Union-Feld _dns_name.

Für _dns_name ist nur einer der folgenden Werte zulässig:

dnsName

string

Nur Ausgabe. Der DNS-Name des Lesepoolknotens.

Union-Feld _state.

Für _state ist nur einer der folgenden Werte zulässig:

state

enum (SqlInstanceState)

Nur Ausgabe. Der aktuelle Status des Lesepoolknotens.

Union-Feld _psc_service_attachment_link.

Für _psc_service_attachment_link ist nur einer der folgenden Werte zulässig:

pscServiceAttachmentLink

string

Nur Ausgabe. Der Private Service Connect-Dienstanhang (PSC) des Lesepoolknotens.

DnsNameMapping

JSON-Darstellung
{
  "name": string,
  "connectionType": enum (ConnectionType),
  "dnsScope": enum (DnsScope),
  "recordManager": enum (RecordManager)
}
Felder
name

string

Nur Ausgabe. Der DNS-Name.

connectionType

enum (ConnectionType)

Nur Ausgabe. Der Verbindungstyp des DNS-Namens.

dnsScope

enum (DnsScope)

Nur Ausgabe. Der Bereich, auf den sich der DNS-Name bezieht.

recordManager

enum (RecordManager)

Nur Ausgabe. Der Administrator für diesen DNS-Eintrag.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌