MCP Tools Reference: cloud-sql

Strumento: get_instance

Recupera i dettagli di un'istanza Cloud SQL.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_instance.

Curl Request
                  
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
}'
                

Schema di input

Richiesta di recupero dell'istanza.

SqlInstancesGetRequest

Rappresentazione JSON
{
  "instance": string,
  "project": string
}
Campi
instance

string

Obbligatorio. ID istanza database. L'ID progetto non è incluso.

project

string

Obbligatorio. ID progetto del progetto che contiene l'istanza.

Schema di output

Una risorsa istanza Cloud SQL.

DatabaseInstance

Rappresentazione JSON
{
  "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.
}
Campi
kind

string

Questo valore è sempre sql#instance.

state

enum (SqlInstanceState)

Lo stato di pubblicazione attuale dell'istanza Cloud SQL.

databaseVersion

enum (SqlDatabaseVersion)

Il tipo e la versione del motore del database. Il campo databaseVersion non può essere modificato dopo la creazione dell'istanza.

settings

object (Settings)

Le impostazioni utente.

etag

string

Questo campo è deprecato e verrà rimosso da una versione futura dell'API. Utilizza invece il campo settings.settingsVersion.

failoverReplica

object (SqlFailoverReplica)

Il nome e lo stato della replica di failover.

masterInstanceName

string

Il nome dell'istanza che fungerà da principale nella configurazione della replica.

replicaNames[]

string

Le repliche dell'istanza.

maxDiskSize
(deprecated)

string (Int64Value format)

La dimensione massima del disco dell'istanza in byte.

currentDiskSize
(deprecated)

string (Int64Value format)

L'utilizzo attuale del disco dell'istanza in byte. Questa proprietà è stata ritirata. Utilizza invece la metrica "cloudsql.googleapis.com/database/disk/bytes_used" nell'API Cloud Monitoring. Per i dettagli, consulta questo annuncio.

ipAddresses[]

object (IpMapping)

Gli indirizzi IP assegnati all'istanza.

serverCaCert

object (SslCert)

Configurazione SSL.

instanceType

enum (SqlInstanceType)

Il tipo di istanza.

project

string

L'ID progetto del progetto contenente l'istanza Cloud SQL. Il dominio delle app Google ha un prefisso, se applicabile.

ipv6Address
(deprecated)

string

L'indirizzo IPv6 assegnato all'istanza. (Obsoleto) Questa proprietà era applicabile solo alle istanze di prima generazione.

serviceAccountEmailAddress

string

L'indirizzo email del account di servizio assegnato all'istanza. Questa proprietà è di sola lettura.

onPremisesConfiguration

object (OnPremisesConfiguration)

Configurazione specifica per le istanze on-premise.

replicaConfiguration

object (ReplicaConfiguration)

Configurazione specifica per le repliche di failover e le repliche di lettura.

backendType

enum (SqlBackendType)

Il tipo di backend. SECOND_GEN: istanza del database Cloud SQL. EXTERNAL: un server di database non gestito da Google.

Questa proprietà è di sola lettura; utilizza la proprietà tier nell'oggetto settings per determinare il tipo di database.

selfLink

string

L'URI di questa risorsa.

suspensionReason[]

enum (SqlSuspensionReason)

Se lo stato dell'istanza è SUSPENDED, il motivo della sospensione.

connectionName

string

Nome della connessione dell'istanza Cloud SQL utilizzata nelle stringhe di connessione.

name

string

Nome dell'istanza Cloud SQL. L'ID progetto non è incluso.

region

string

La regione geografica dell'istanza Cloud SQL.

Può essere una delle regioni in cui opera Cloud SQL:

Ad esempio, asia-east1, europe-west1 e us-central1. Il valore predefinito è us-central1.

gceZone

string

La zona Compute Engine da cui viene attualmente gestita l'istanza. Questo valore potrebbe essere diverso dalla zona specificata al momento della creazione dell'istanza se l'istanza ha eseguito il failover nella zona secondaria. AVVISO: la modifica di questa impostazione potrebbe riavviare l'istanza.

secondaryGceZone

string

La zona Compute Engine da cui l'istanza di failover sta attualmente eseguendo il servizio per un'istanza regionale. Questo valore potrebbe essere diverso dalla zona specificata al momento della creazione dell'istanza se l'istanza ha eseguito il failover nella zona secondaria/di failover.

diskEncryptionConfiguration

object (DiskEncryptionConfiguration)

Configurazione della crittografia del disco specifica per un'istanza.

diskEncryptionStatus

object (DiskEncryptionStatus)

Stato della crittografia del disco specifico per un'istanza.

rootPassword

string

Password root iniziale. Utilizzare solo al momento della creazione. Devi impostare le password di root prima di poterti connettere alle istanze PostgreSQL.

scheduledMaintenance

object (SqlScheduledMaintenance)

L'ora di inizio di qualsiasi manutenzione pianificata imminente per questa istanza.

satisfiesPzs

boolean

Questo stato indica se l'istanza soddisfa PZS.

Lo stato è riservato per un uso futuro.

databaseInstalledVersion

string

Solo output. Memorizza la versione corrente del database in esecuzione sull'istanza, inclusa la versione secondaria, ad esempio MYSQL_8_0_18.

createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata l'istanza nel formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

availableMaintenanceVersions[]

string

Solo output. Elenca tutte le versioni di manutenzione applicabili all'istanza

maintenanceVersion

string

La versione software attuale sull'istanza.

upgradableDatabaseVersions[]

object (AvailableDatabaseVersion)

Solo output. Tutte le versioni del database disponibili per l'upgrade.

replicationCluster

object (ReplicationCluster)

Facoltativo. Una coppia di istanze principali e repliche per il ripristino di emergenza (RE). Una replica di RE è una replica tra regioni che designi per il failover nel caso in cui l'istanza principale subisca un errore regionale. Valido per MySQL e PostgreSQL.

satisfiesPzi

boolean

Solo output. Questo stato indica se l'istanza soddisfa PZI.

Lo stato è riservato per un uso futuro.

tags

map (key: string, value: string)

Facoltativo. Solo input. Immutabile. Chiavi e valori dei tag associati a questa istanza. Devi rappresentare ogni elemento nella mappa come: "<tag-key-namespaced-name>" : "<tag-value-short-name>".

Ad esempio, una singola risorsa può avere i seguenti tag:

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

Per saperne di più sulla creazione e sulla gestione dei tag, visita la pagina https://cloud.google.com/resource-manager/docs/tags/tags-overview.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

nodes[]

object (PoolNodeConfig)

Solo output. Voci contenenti informazioni su ogni nodo del pool di lettura.

dnsNames[]

object (DnsNameMapping)

Solo output. L'elenco dei nomi DNS utilizzati da questa istanza.

Campo unione _out_of_disk_report.

_out_of_disk_report può essere solo uno dei seguenti tipi:

outOfDiskReport

object (SqlOutOfDiskReport)

Questo campo rappresenta il report generato dal job di controllo proattivo del database per i problemi di spazio su disco insufficiente. * Scrittori: * il job proattivo di integrità del database per OOD. * Lettori: * il job proattivo di integrità del database

Campo unione _sql_network_architecture.

_sql_network_architecture può essere solo uno dei seguenti tipi:

sqlNetworkArchitecture

enum (SqlNetworkArchitecture)

Campo unione _psc_service_attachment_link.

_psc_service_attachment_link può essere solo uno dei seguenti tipi:

pscServiceAttachmentLink

string

Solo output. Il link al collegamento del servizio dell'istanza PSC.

Campo unione _dns_name.

_dns_name può essere solo uno dei seguenti tipi:

dnsName

string

Solo output. Il nome DNS dell'istanza.

Campo unione _primary_dns_name.

_primary_dns_name può essere solo uno dei seguenti tipi:

primaryDnsName
(deprecated)

string

Solo output. DEPRECATO: utilizza write_endpoint.

Campo unione _write_endpoint.

_write_endpoint può essere solo uno dei seguenti tipi:

writeEndpoint

string

Solo output. Il nome DNS dell'istanza principale in un gruppo di replica.

Campo unione _gemini_config.

_gemini_config può essere solo uno dei seguenti tipi:

geminiConfig

object (GeminiInstanceConfig)

Configurazione dell'istanza Gemini.

Campo unione _switch_transaction_logs_to_cloud_storage_enabled.

_switch_transaction_logs_to_cloud_storage_enabled può essere solo uno dei seguenti tipi:

switchTransactionLogsToCloudStorageEnabled

boolean

Solo input. Indica se Cloud SQL è abilitato per passare dall'archiviazione dei file di log di recupero point-in-time da un disco dati a Cloud Storage.

Campo unione _include_replicas_for_major_version_upgrade.

_include_replicas_for_major_version_upgrade può essere solo uno dei seguenti tipi:

includeReplicasForMajorVersionUpgrade

boolean

Solo input. Determina se viene eseguito un upgrade in loco della versione principale delle repliche quando viene avviato un upgrade in loco della versione principale di un'istanza primaria.

Campo unione _node_count.

_node_count può essere solo uno dei seguenti tipi:

nodeCount

integer

Il numero di nodi del pool di lettura in un pool di lettura.

Impostazioni

Rappresentazione JSON
{
  "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.
}
Campi
settingsVersion

string (Int64Value format)

La versione delle impostazioni dell'istanza. Questo è un campo obbligatorio per il metodo di aggiornamento per garantire che gli aggiornamenti simultanei vengano gestiti correttamente. Durante l'aggiornamento, utilizza il valore settingsVersion più recente per questa istanza e non tentare di aggiornarlo.

authorizedGaeApplications[]
(deprecated)

string

Gli ID app App Engine che possono accedere a questa istanza. (Ritirato) Applicato solo alle istanze di prima generazione.

tier

string

Il livello (o tipo di macchina) per questa istanza, ad esempio db-custom-1-3840. AVVISO: la modifica di questa impostazione riavvia l'istanza.

kind

string

Questo valore è sempre sql#settings.

userLabels

map (key: string, value: string)

Etichette fornite dall'utente, rappresentate come un dizionario in cui ogni etichetta è una singola coppia chiave-valore.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

availabilityType

enum (SqlAvailabilityType)

Tipo di disponibilità. Valori potenziali: * ZONAL: l'istanza pubblica dati da una sola zona. Le interruzioni in questa zona influiscono sull'accessibilità dei dati. * REGIONAL: l'istanza può pubblicare dati da più zone in una regione (è a disponibilità elevata)./

Per saperne di più, consulta la panoramica della configurazione ad alta disponibilità.

pricingPlan

enum (SqlPricingPlan)

Il piano tariffario per questa istanza. Può essere PER_USE o PACKAGE. Per le istanze di seconda generazione è supportato solo PER_USE.

replicationType
(deprecated)

enum (SqlReplicationType)

Il tipo di replica utilizzato da questa istanza. Può essere ASYNCHRONOUS o SYNCHRONOUS. (Obsoleto) Questa proprietà era applicabile solo alle istanze di prima generazione.

storageAutoResizeLimit

string (Int64Value format)

La dimensione massima a cui la capacità di archiviazione può essere aumentata automaticamente. Il valore predefinito è 0, il che significa che non esiste un limite.

activationPolicy

enum (SqlActivationPolicy)

Il criterio di attivazione specifica quando l'istanza viene attivata ed è applicabile solo quando lo stato dell'istanza è RUNNABLE. Valori validi: * ALWAYS: l'istanza è attiva e rimane tale anche in assenza di richieste di connessione. * NEVER: l'istanza è disattivata e non viene attivata, anche se arriva una richiesta di connessione.

ipConfiguration

object (IpConfiguration)

Le impostazioni per la gestione IP. Ciò consente di attivare o disattivare l'IP dell'istanza e di gestire le reti esterne che possono connettersi all'istanza. L'indirizzo IPv4 non può essere disattivato per le istanze di seconda generazione.

storageAutoResize

boolean

Configurazione per aumentare automaticamente le dimensioni dello spazio di archiviazione. Il valore predefinito è true.

locationPreference

object (LocationPreference)

Le impostazioni delle preferenze relative alla posizione. In questo modo, l'istanza può essere posizionata il più vicino possibile a un'app App Engine o a una zona Compute Engine per ottenere prestazioni migliori. La collocazione di App Engine era applicabile solo alle istanze di prima generazione.

databaseFlags[]

object (DatabaseFlags)

I flag di database passati all'istanza all'avvio.

dataDiskType

enum (SqlDataDiskType)

Il tipo di disco dati: PD_SSD (impostazione predefinita) o PD_HDD. Non utilizzato per le istanze di prima generazione.

maintenanceWindow

object (MaintenanceWindow)

Il periodo di manutenzione per questa istanza. Specifica quando l'istanza può essere riavviata per scopi di manutenzione.

backupConfiguration

object (BackupConfiguration)

La configurazione del backup giornaliero per l'istanza.

databaseReplicationEnabled

boolean

Configurazione specifica per le istanze di replica di lettura. Indica se la replica è attivata o meno. AVVISO: la modifica di questa impostazione riavvia l'istanza.

crashSafeReplicationEnabled
(deprecated)

boolean

Configurazione specifica per le istanze di replica di lettura. Indica se sono attivati i flag del database per la replica a prova di arresto anomalo. Questa proprietà era applicabile solo alle istanze di prima generazione.

dataDiskSizeGb

string (Int64Value format)

Le dimensioni del disco dati, in GB. La dimensione minima del disco dati è 10 GB.

activeDirectoryConfig

object (SqlActiveDirectoryConfig)

Configurazione di Active Directory, pertinente solo per Cloud SQL per SQL Server.

collation

string

Il nome delle regole di confronto dell'istanza del server.

denyMaintenancePeriods[]

object (DenyMaintenancePeriod)

Periodi in cui evitare la manutenzione

insightsConfig

object (InsightsConfig)

Configurazione degli approfondimenti, per ora pertinente solo per Postgres.

passwordValidationPolicy

object (PasswordValidationPolicy)

I criteri di convalida della password utente locale dell'istanza.

sqlServerAuditConfig

object (SqlServerAuditConfig)

Configurazione di audit specifica di SQL Server.

edition

enum (Edition)

Facoltativo. L'edizione dell'istanza.

connectorEnforcement

enum (ConnectorEnforcement)

Specifica se le connessioni devono utilizzare i connettori Cloud SQL. I valori delle opzioni includono: NOT_REQUIRED (le istanze Cloud SQL possono essere connesse senza Cloud SQL Connectors) e REQUIRED (consenti solo le connessioni che utilizzano Cloud SQL Connectors).

Tieni presente che l'utilizzo di REQUIRED disattiva tutte le reti autorizzate esistenti. Se questo campo non viene specificato durante la creazione di una nuova istanza, viene utilizzato NOT_REQUIRED. Se questo campo non viene specificato durante l'applicazione di patch o l'aggiornamento di un'istanza esistente, rimane invariato nell'istanza.

deletionProtectionEnabled

boolean

Configurazione per proteggerti dall'eliminazione accidentale delle istanze.

timeZone

string

Fuso orario del server, pertinente solo per Cloud SQL per SQL Server.

advancedMachineFeatures

object (AdvancedMachineFeatures)

Specifica la configurazione avanzata della macchina per le istanze pertinenti solo per SQL Server.

dataCacheConfig

object (DataCacheConfig)

Configurazione per la cache dei dati.

replicationLagMaxSeconds

integer

Facoltativo. Valore di configurazione per la ricreazione della replica dopo un determinato ritardo di replica

enableGoogleMlIntegration

boolean

Facoltativo. Quando questo parametro è impostato su true, le istanze Cloud SQL possono connettersi a Vertex AI per inoltrare richieste di previsioni e insight in tempo reale all'AI. Il valore predefinito è false. Questo vale solo per le istanze Cloud SQL per MySQL e Cloud SQL per PostgreSQL.

enableDataplexIntegration

boolean

Facoltativo. Per impostazione predefinita, le istanze Cloud SQL hanno l'estrazione dello schema disattivata per Dataplex. Se questo parametro è impostato su true, l'estrazione dello schema per Dataplex sulle istanze Cloud SQL viene attivata.

retainBackupsOnDelete

boolean

Facoltativo. Se questo parametro è impostato su true, Cloud SQL conserva i backup dell'istanza anche dopo l'eliminazione. Il backup ON_DEMAND verrà conservato finché il cliente non lo elimina o non elimina il progetto. Il backup AUTOMATICO verrà conservato in base all'impostazione di conservazione dei backup.

entraidConfig

object (SqlServerEntraIdConfig)

Facoltativo. La configurazione di Microsoft Entra ID per l'istanza SQL Server.

performanceCaptureConfig

object (PerformanceCaptureConfig)

Facoltativo. Configurazione per l'acquisizione delle prestazioni, fornisce metriche diagnostiche in situazioni di carico elevato.

Campo unione _data_disk_provisioned_iops.

_data_disk_provisioned_iops può essere solo uno dei seguenti tipi:

dataDiskProvisionedIops

string (int64 format)

Facoltativo. Numero di operazioni di I/O al secondo di cui è stato eseguito il provisioning per il disco dati. Questo campo viene utilizzato solo per i tipi di disco hyperdisk-balanced.

Campo unione _data_disk_provisioned_throughput.

_data_disk_provisioned_throughput può essere solo uno dei seguenti tipi:

dataDiskProvisionedThroughput

string (int64 format)

Facoltativo. Throughput di cui è stato eseguito il provisioning misurato in MiB al secondo per il disco di dati. Questo campo viene utilizzato solo per i tipi di disco hyperdisk-balanced.

Campo unione _connection_pool_config.

_connection_pool_config può essere solo uno dei seguenti tipi:

connectionPoolConfig

object (ConnectionPoolConfig)

Facoltativo. La configurazione del pool di connessioni gestito per l'istanza.

Campo unione _final_backup_config.

_final_backup_config può essere solo uno dei seguenti tipi:

finalBackupConfig

object (FinalBackupConfig)

Facoltativo. La configurazione di backup finale per l'istanza.

Campo unione _read_pool_auto_scale_config.

_read_pool_auto_scale_config può essere solo uno dei seguenti tipi:

readPoolAutoScaleConfig

object (ReadPoolAutoScaleConfig)

Facoltativo. La configurazione della scalabilità automatica del pool di lettura per l'istanza.

Campo unione _auto_upgrade_enabled.

_auto_upgrade_enabled può essere solo uno dei seguenti tipi:

autoUpgradeEnabled

boolean

Facoltativo. Configurazione dell'upgrade automatico di Cloud SQL per MySQL. Se questo parametro è impostato su true, l'upgrade automatico è abilitato per le versioni secondarie di MySQL 8.0. La versione di MySQL deve essere 8.0.35 o successive.

Campo unione _data_api_access.

_data_api_access può essere solo uno dei seguenti tipi:

dataApiAccess

enum (DataApiAccess)

Questo parametro controlla se consentire l'utilizzo dell'API ExecuteSql per connettersi all'istanza. Non consentito per impostazione predefinita.

Int64Value

Rappresentazione JSON
{
  "value": string
}
Campi
value

string (int64 format)

Il valore int64.

UserLabelsEntry

Rappresentazione JSON
{
  "key": string,
  "value": string
}
Campi
key

string

value

string

IpConfiguration

Rappresentazione JSON
{
  "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.
}
Campi
ipv4Enabled

boolean

Indica se all'istanza è assegnato un indirizzo IP pubblico.

privateNetwork

string

Il link alla risorsa per la rete VPC da cui l'istanza Cloud SQL è accessibile per l'IP privato. Ad esempio, /projects/myProject/global/networks/default. Questa impostazione può essere aggiornata, ma non rimossa dopo la configurazione.

requireSsl

boolean

Utilizza invece ssl_mode.

Se le connessioni SSL/TLS su IP sono applicate. Se impostato su false, consente connessioni non SSL/non TLS e SSL/TLS. Per le connessioni SSL/TLS, il certificato client non verrà verificato. Se impostato su true, consente solo connessioni criptate con SSL/TLS e con certificati client validi. Se vuoi applicare SSL/TLS senza applicare il requisito di certificati client validi, utilizza il flag ssl_mode anziché il flag require_ssl.

authorizedNetworks[]

object (AclEntry)

L'elenco delle reti esterne autorizzate a connettersi all'istanza utilizzando l'IP. Nella notazione CIDR, nota anche come notazione con barra (ad esempio: 157.197.200.0/24).

allocatedIpRange

string

Il nome dell'intervallo IP allocato per l'istanza Cloud SQL con IP privato. Ad esempio: "google-managed-services-default". Se impostato, l'IP dell'istanza verrà creato nell'intervallo allocato. Il nome dell'intervallo deve essere conforme a RFC 1035. Nello specifico, il nome deve avere una lunghezza compresa tra 1 e 63 caratteri e corrispondere all'espressione regolare [a-z]([-a-z0-9]*[a-z0-9])?.

enablePrivatePathForGoogleCloudServices

boolean

Controlla la connettività alle istanze con IP privato dai servizi Google, come BigQuery.

sslMode

enum (SslMode)

Specifica come viene applicato SSL/TLS nelle connessioni al database. Se devi utilizzare il flag require_ssl per la compatibilità con le versioni precedenti, sono valide solo le seguenti coppie di valori:

Per PostgreSQL e MySQL:

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

Per SQL Server:

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

Il valore di ssl_mode ha la priorità sul valore di require_ssl.

Ad esempio, per la coppia ssl_mode=ENCRYPTED_ONLY e require_ssl=false, ssl_mode=ENCRYPTED_ONLY significa accetta solo connessioni SSL, mentre require_ssl=false significa accetta connessioni non SSL e SSL. In questo caso, i database MySQL e PostgreSQL rispettano ssl_mode e accettano solo connessioni SSL.

customSubjectAlternativeNames[]

string

Facoltativo. Nomi alternativi del soggetto(SAN) personalizzati per un'istanza Cloud SQL.

Campo unione _psc_config.

_psc_config può essere solo uno dei seguenti tipi:

pscConfig

object (PscConfig)

Impostazioni PSC per questa istanza.

Campo unione _server_ca_mode.

_server_ca_mode può essere solo uno dei seguenti tipi:

serverCaMode

enum (CaMode)

Specifica il tipo di CA utilizzato per il certificato del server.

Campo unione _server_ca_pool.

_server_ca_pool può essere solo uno dei seguenti tipi:

serverCaPool

string

Facoltativo. Il nome della risorsa del pool di CA server per un'istanza con CUSTOMER_MANAGED_CAS_CA come server_ca_mode. Formato: projects/{PROJECT}/locations/{REGION}/caPools/{CA_POOL_ID}

Campo unione _server_certificate_rotation_mode.

_server_certificate_rotation_mode può essere solo uno dei seguenti tipi:

serverCertificateRotationMode

enum (ServerCertificateRotationMode)

Facoltativo. Controlla la funzionalità di rotazione automatica dei certificati server. Questa funzione è disattivata per impostazione predefinita. Se abilitato, il certificato server verrà ruotato automaticamente durante la manutenzione pianificata di Cloud SQL o gli aggiornamenti della manutenzione self-service fino a sei mesi prima della scadenza. Questa impostazione può essere configurata solo se server_ca_mode è GOOGLE_MANAGED_CAS_CA o CUSTOMER_MANAGED_CAS_CA.

BoolValue

Rappresentazione JSON
{
  "value": boolean
}
Campi
value

boolean

Il valore booleano.

AclEntry

Rappresentazione JSON
{
  "value": string,
  "expirationTime": string,
  "name": string,
  "kind": string
}
Campi
value

string

Il valore consentito per l'elenco di controllo dell'accesso.

expirationTime

string (Timestamp format)

L'ora in cui questa voce di controllo dell'accesso scade nel formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

name

string

Facoltativo. Un'etichetta per identificare questa voce.

kind

string

Questo valore è sempre sql#aclEntry.

Timestamp

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).

nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

PscConfig

Rappresentazione JSON
{
  "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.
}
Campi
allowedConsumerProjects[]

string

Facoltativo. L'elenco dei progetti consumer inclusi nella lista consentita per le connessioni PSC a questa istanza. È possibile connettersi a questa istanza con PSC da qualsiasi rete in questi progetti.

Ogni progetto consumer in questo elenco può essere rappresentato da un numero di progetto (numerico) o da un ID progetto (alfanumerico).

pscAutoConnections[]

object (PscAutoConnectionConfig)

Facoltativo. L'elenco delle impostazioni per gli endpoint consumer Private Service Connect richiesti che possono essere utilizzati per connettersi a questa istanza Cloud SQL.

networkAttachmentUri

string

Facoltativo. Il collegamento di rete della rete consumer a cui l'istanza Cloud SQL abilitata per Private Service Connect è autorizzata a connettersi tramite l'interfaccia PSC. Formato: projects/PROJECT/regions/REGION/networkAttachments/ID

Campo unione _psc_enabled.

_psc_enabled può essere solo uno dei seguenti tipi:

pscEnabled

boolean

Indica se la connettività PSC è abilitata per questa istanza.

PscAutoConnectionConfig

Rappresentazione JSON
{
  "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.
}
Campi
consumerProject

string

Facoltativo. Questo è l'ID progetto del progetto di servizio consumer di questo endpoint consumer.

Facoltativo. Ciò è applicabile solo se consumer_network è una rete VPC condivisa.

consumerNetwork

string

Facoltativo. La rete consumer di questo endpoint consumer. Deve essere un percorso della risorsa che includa sia il progetto host sia il nome della rete.

Ad esempio, projects/project1/global/networks/network1.

Il progetto host consumer di questa rete potrebbe essere diverso dal progetto di servizio consumer.

Campo unione _ip_address.

_ip_address può essere solo uno dei seguenti tipi:

ipAddress

string

L'indirizzo IP dell'endpoint consumer.

Campo unione _status.

_status può essere solo uno dei seguenti tipi:

status

string

Lo stato della connessione dell'endpoint consumer.

Campo unione _consumer_network_status.

_consumer_network_status può essere solo uno dei seguenti tipi:

consumerNetworkStatus

string

Lo stato delle norme di connessione della rete consumer.

LocationPreference

Rappresentazione JSON
{
  "followGaeApplication": string,
  "zone": string,
  "secondaryZone": string,
  "kind": string
}
Campi
followGaeApplication
(deprecated)

string

L'applicazione App Engine da seguire, che deve trovarsi nella stessa regione dell'istanza Cloud SQL. AVVISO: la modifica di questa impostazione potrebbe riavviare l'istanza.

zone

string

La zona Compute Engine preferita (ad esempio: us-central1-a, us-central1-b e così via). AVVISO: la modifica di questa impostazione potrebbe riavviare l'istanza.

secondaryZone

string

La zona Compute Engine preferita per il secondario/failover (ad esempio: us-central1-a, us-central1-b e così via). Per disattivare questo campo, impostalo su "no_secondary_zone".

kind

string

Questo valore è sempre sql#locationPreference.

DatabaseFlags

Rappresentazione JSON
{
  "name": string,
  "value": string
}
Campi
name

string

Il nome del flag. Questi flag vengono passati all'avvio dell'istanza, quindi includi sia le opzioni del server sia le variabili di sistema. I flag vengono specificati con trattini bassi, non trattini. Per saperne di più, consulta Configurazione dei flag di database nella documentazione di Cloud SQL.

value

string

Il valore del flag. I flag booleani sono impostati su on per true e off per false. Questo campo deve essere omesso se il flag non accetta un valore.

MaintenanceWindow

Rappresentazione JSON
{
  "hour": integer,
  "day": integer,
  "updateTrack": enum (SqlUpdateTrack),
  "kind": string
}
Campi
hour

integer

Ora del giorno: da 0 a 23. Specifica il fuso orario UTC.

day

integer

Giorno della settimana: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Specifica il fuso orario UTC. Restituito nell'output come numero intero, da 1 a 7, dove 1 equivale a lunedì.

updateTrack

enum (SqlUpdateTrack)

Impostazioni di tempistica per manutenzione: canary, stable o week5. Per saperne di più, consulta la sezione Informazioni sulla manutenzione delle istanze Cloud SQL.

kind

string

Questo valore è sempre sql#maintenanceWindow.

Int32Value

Rappresentazione JSON
{
  "value": integer
}
Campi
value

integer

Il valore int32.

BackupConfiguration

Rappresentazione JSON
{
  "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.
}
Campi
startTime

string

Ora di inizio per la configurazione del backup giornaliero nel fuso orario UTC in formato 24 ore: HH:MM.

enabled

boolean

Indica se questa configurazione è abilitata.

kind

string

Questo valore è sempre sql#backupConfiguration.

binaryLogEnabled

boolean

(Solo MySQL) Indica se il log binario è abilitato. Se la configurazione del backup è disattivata, anche binarylog deve essere disattivato.

replicationLogArchivingEnabled

boolean

Riservato per l'uso futuro.

location

string

Posizione del backup

pointInTimeRecoveryEnabled

boolean

Indica se il recupero point-in-time è abilitato.

backupRetentionSettings

object (BackupRetentionSettings)

Impostazioni di conservazione dei backup.

transactionLogRetentionDays

integer

Il numero di giorni di conservazione dei log delle transazioni per il ripristino point-in-time, da 1 a 7.

Campo unione _transactional_log_storage_state.

_transactional_log_storage_state può essere solo uno dei seguenti tipi:

transactionalLogStorageState

enum (TransactionalLogStorageState)

Solo output. Questo valore contiene la posizione di archiviazione dei log transazionali utilizzati per eseguire il recupero point-in-time (PITR) per il database.

Campo unione _backup_tier.

_backup_tier può essere solo uno dei seguenti tipi:

backupTier

enum (BackupTier)

Solo output. Livello di backup che gestisce i backup per l'istanza.

BackupRetentionSettings

Rappresentazione JSON
{
  "retentionUnit": enum (RetentionUnit),
  "retainedBackups": integer
}
Campi
retentionUnit

enum (RetentionUnit)

L'unità rappresentata da "retained_backups".

retainedBackups

integer

A seconda del valore di retention_unit, questo valore viene utilizzato per determinare se è necessario eliminare un backup. Se retention_unit è "COUNT", verranno conservati questo numero di backup.

SqlActiveDirectoryConfig

Rappresentazione JSON
{
  "kind": string,
  "domain": string,
  "mode": enum (ActiveDirectoryMode),
  "dnsServers": [
    string
  ],
  "adminCredentialSecretName": string,
  "organizationalUnit": string
}
Campi
kind

string

Questo valore è sempre sql#activeDirectoryConfig.

domain

string

Il nome del dominio (ad es. mydomain.com).

mode

enum (ActiveDirectoryMode)

Facoltativo. La modalità di configurazione di Active Directory.

dnsServers[]

string

Facoltativo. Indirizzi IPv4 del domain controller utilizzati per il bootstrap di Active Directory.

adminCredentialSecretName

string

Facoltativo. La chiave di Secret Manager che archivia le credenziali di amministratore. ad esempio projects/{project}/secrets/{secret}.

organizationalUnit

string

Facoltativo. Il nome distinto dell'unità organizzativa. Questo è il percorso gerarchico completo all'unità organizzativa.

DenyMaintenancePeriod

Rappresentazione JSON
{
  "startDate": string,
  "endDate": string,
  "time": string
}
Campi
startDate

string

Data di inizio del "periodo in cui evitare la manutenzione". Se l'anno della data di inizio è vuoto, anche l'anno della data di fine deve essere vuoto. In questo caso, significa che il periodo in cui evitare la manutenzione si ripete ogni anno. La data è nel formato aaaa-mm-gg, ad esempio 2020-11-01 o gg-mm, ad esempio 11-01

endDate

string

Data di fine del "periodo in cui evitare la manutenzione". Se l'anno della data di fine è vuoto, anche l'anno della data di inizio deve essere vuoto. In questo caso, significa che l'intervallo di assenza di manutenzione si ripete ogni anno. La data è nel formato aaaa-mm-gg, ad esempio 2020-11-01 o gg-mm, ad esempio 11-01

time

string

Ora in formato UTC in cui inizia il "periodo in cui evitare la manutenzione" nella data di inizio e termina nella data di fine. L'ora è nel formato HH:mm:SS, ad esempio 00:00:00

InsightsConfig

Rappresentazione JSON
{
  "queryInsightsEnabled": boolean,
  "recordClientAddress": boolean,
  "recordApplicationTags": boolean,
  "queryStringLength": integer,
  "queryPlansPerMinute": integer,
  "enhancedQueryInsightsEnabled": boolean
}
Campi
queryInsightsEnabled

boolean

Indica se la funzionalità Query Insights è abilitata.

recordClientAddress

boolean

Indica se Query Insights registra l'indirizzo client quando è attivato.

recordApplicationTags

boolean

Indica se Query Insights registra i tag delle applicazioni dalla query quando è abilitato.

queryStringLength

integer

Lunghezza massima della query memorizzata in byte. Valore predefinito: 1024 byte. Intervallo: 256-4500 byte. Le lunghezze delle query superiori al valore di questo campo verranno troncate a questo valore. Se non viene impostata, la lunghezza della query sarà il valore predefinito. La modifica della lunghezza delle query riavvierà il database.

queryPlansPerMinute

integer

Numero di piani di esecuzione delle query acquisiti da Insights al minuto per tutte le query combinate. Il valore predefinito è 5.

enhancedQueryInsightsEnabled

boolean

Facoltativo. Indica se la funzionalità Query Insights avanzato è abilitata.

PasswordValidationPolicy

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

integer

Numero minimo di caratteri consentiti.

complexity

enum (Complexity)

La complessità della password.

reuseInterval

integer

Numero di password precedenti che non possono essere riutilizzate.

disallowUsernameSubstring

boolean

Non consentire il nome utente come parte della password.

passwordChangeInterval

string (Duration format)

Intervallo minimo dopo il quale è possibile modificare la password. Questo flag è supportato solo per PostgreSQL.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

enablePasswordPolicy

boolean

Indica se attivare o meno la policy per le password. Se abilitate, le password devono soddisfare i requisiti di complessità. Mantieni attivato questo criterio per impedire accessi non autorizzati. Se disattivi questo criterio, vengono consentite password inefficaci.

disallowCompromisedCredentials
(deprecated)

boolean

Questo campo è deprecato e verrà rimosso in una versione futura dell'API.

Durata

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati in base a: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni

nanos

integer

Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo seconds pari a 0 e un campo nanos positivo o negativo. Per durate di un secondo o più, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds. Deve essere compreso tra -999.999.999 e +999.999.999 inclusi.

SqlServerAuditConfig

Rappresentazione JSON
{
  "kind": string,
  "bucket": string,
  "retentionInterval": string,
  "uploadInterval": string
}
Campi
kind

string

Questo valore è sempre sql#sqlServerAuditConfig

bucket

string

Il nome del bucket di destinazione (ad es. gs://mybucket).

retentionInterval

string (Duration format)

Per quanto tempo conservare i file di controllo generati.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

uploadInterval

string (Duration format)

La frequenza di caricamento dei file di controllo generati.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

AdvancedMachineFeatures

Rappresentazione JSON
{
  "threadsPerCore": integer
}
Campi
threadsPerCore

integer

Il numero di thread per core fisico.

DataCacheConfig

Rappresentazione JSON
{
  "dataCacheEnabled": boolean
}
Campi
dataCacheEnabled

boolean

Indica se la cache dei dati è abilitata per l'istanza.

ConnectionPoolConfig

Rappresentazione JSON
{
  "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.
}
Campi
flags[]

object (ConnectionPoolFlags)

Facoltativo. Elenco dei flag di configurazione del pool di connessioni.

Campo unione _connection_pooling_enabled.

_connection_pooling_enabled può essere solo uno dei seguenti tipi:

connectionPoolingEnabled

boolean

Indica se il pool di connessioni gestito è abilitato.

Campo unione _pooler_count.

_pooler_count può essere solo uno dei seguenti tipi:

poolerCount

integer

Solo output. Numero di pool di connessioni.

ConnectionPoolFlags

Rappresentazione JSON
{
  "name": string,
  "value": string
}
Campi
name

string

Obbligatorio. Il nome del flag.

value

string

Obbligatorio. Il valore del flag. I flag booleani sono impostati su on per true e off per false. Questo campo deve essere omesso se il flag non accetta un valore.

FinalBackupConfig

Rappresentazione JSON
{

  // 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.
}
Campi

Campo unione _enabled.

_enabled può essere solo uno dei seguenti tipi:

enabled

boolean

Se il backup finale è abilitato per l'istanza.

Campo unione _retention_days.

_retention_days può essere solo uno dei seguenti tipi:

retentionDays

integer

Il numero di giorni per conservare il backup finale dopo l'eliminazione dell'istanza. Il backup finale verrà eliminato definitivamente il giorno (time_of_instance_deletion + retention_days).

ReadPoolAutoScaleConfig

Rappresentazione JSON
{
  "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.
}
Campi
targetMetrics[]

object (TargetMetric)

Facoltativo. Metriche target per la scalabilità automatica del pool di lettura.

Campo unione _enabled.

_enabled può essere solo uno dei seguenti tipi:

enabled

boolean

Indica se la scalabilità automatica del pool di lettura è abilitata.

Campo unione _min_node_count.

_min_node_count può essere solo uno dei seguenti tipi:

minNodeCount

integer

Il numero minimo di nodi del pool di lettura da mantenere.

Campo unione _max_node_count.

_max_node_count può essere solo uno dei seguenti tipi:

maxNodeCount

integer

Il numero massimo di nodi del pool di lettura da mantenere.

Campo unione _disable_scale_in.

_disable_scale_in può essere solo uno dei seguenti tipi:

disableScaleIn

boolean

Indica se la scalabilità automatica del pool di lettura supporta le operazioni di fare lo scale in (rimozione dei nodi).

Campo unione _scale_in_cooldown_seconds.

_scale_in_cooldown_seconds può essere solo uno dei seguenti tipi:

scaleInCooldownSeconds

integer

Il periodo di raffreddamento per le operazioni di scale-in.

Campo unione _scale_out_cooldown_seconds.

_scale_out_cooldown_seconds può essere solo uno dei seguenti tipi:

scaleOutCooldownSeconds

integer

Il periodo di raffreddamento per le operazioni di scale out.

TargetMetric

Rappresentazione JSON
{

  // 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.
}
Campi

Campo unione _metric.

_metric può essere solo uno dei seguenti tipi:

metric

string

Il nome della metrica da utilizzare per la scalabilità automatica.

Campo unione _target_value.

_target_value può essere solo uno dei seguenti tipi:

targetValue

number

Il valore target per la metrica.

SqlServerEntraIdConfig

Rappresentazione JSON
{
  "kind": string,
  "tenantId": string,
  "applicationId": string
}
Campi
kind

string

Solo output. Questo valore è sempre sql#sqlServerEntraIdConfig

tenantId

string

Facoltativo. L'ID tenant per la configurazione di Entra ID.

applicationId

string

Facoltativo. L'ID applicazione per la configurazione di Entra ID.

PerformanceCaptureConfig

Rappresentazione JSON
{

  // 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.
}
Campi

Campo unione _enabled.

_enabled può essere solo uno dei seguenti tipi:

enabled

boolean

Facoltativo. Attiva o disattiva la funzionalità di acquisizione delle prestazioni.

Campo unione _probing_interval_seconds.

_probing_interval_seconds può essere solo uno dei seguenti tipi:

probingIntervalSeconds

integer

Facoltativo. L'intervallo di tempo in secondi tra due probe.

Campo unione _probe_threshold.

_probe_threshold può essere solo uno dei seguenti tipi:

probeThreshold

integer

Facoltativo. Il numero minimo di letture consecutive sopra la soglia che attiva l'acquisizione dello stato dell'istanza.

Campo unione _running_threads_threshold.

_running_threads_threshold può essere solo uno dei seguenti tipi:

runningThreadsThreshold

integer

Facoltativo. Il numero minimo di thread del server in esecuzione per attivare l'acquisizione sul server primario.

Campo unione _seconds_behind_source_threshold.

_seconds_behind_source_threshold può essere solo uno dei seguenti tipi:

secondsBehindSourceThreshold

integer

Facoltativo. Il numero minimo di secondi di ritardo della replica rispetto al primario per attivare l'acquisizione sulla replica.

Campo unione _transaction_duration_threshold.

_transaction_duration_threshold può essere solo uno dei seguenti tipi:

transactionDurationThreshold

integer

Facoltativo. Il tempo in secondi per cui una transazione deve essere aperta prima che il watcher inizi a registrarla.

SqlFailoverReplica

Rappresentazione JSON
{
  "name": string,
  "available": boolean
}
Campi
name

string

Il nome della replica di failover. Se specificata al momento della creazione dell'istanza, viene creata una replica di failover per l'istanza. Il nome non include l'ID progetto.

available

boolean

Lo stato di disponibilità della replica di failover. Uno stato falso indica che la replica di failover non è sincronizzata. Il failover dell'istanza principale può essere eseguito sulla replica di failover solo quando lo stato è true.

IpMapping

Rappresentazione JSON
{
  "type": enum (SqlIpAddressType),
  "ipAddress": string,
  "timeToRetire": string
}
Campi
type

enum (SqlIpAddressType)

Il tipo di questo indirizzo IP. Un indirizzo PRIMARY è un indirizzo pubblico che può accettare connessioni in entrata. Un indirizzo PRIVATE è un indirizzo privato che può accettare connessioni in entrata. Un indirizzo OUTGOING è l'indirizzo di origine delle connessioni provenienti dall'istanza, se supportato.

ipAddress

string

L'indirizzo IP assegnato.

timeToRetire

string (Timestamp format)

L'ora di ritiro di questo IP nel formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z. Questo campo è disponibile solo quando è pianificato il ritiro dell'IP.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

SslCert

Rappresentazione JSON
{
  "kind": string,
  "certSerialNumber": string,
  "cert": string,
  "createTime": string,
  "commonName": string,
  "expirationTime": string,
  "sha1Fingerprint": string,
  "instance": string,
  "selfLink": string
}
Campi
kind

string

Questo valore è sempre sql#sslCert.

certSerialNumber

string

Numero di serie, estratto dal certificato.

cert

string

Rappresentazione PEM.

createTime

string (Timestamp format)

L'ora in cui è stato creato il certificato nel formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

commonName

string

Nome fornito dall'utente. Limitato a [a-zA-Z.-_ ]+.

expirationTime

string (Timestamp format)

L'ora in cui il certificato scade nel formato RFC 3339, ad esempio 2012-11-15T16:19:00.094Z.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

sha1Fingerprint

string

Impronta SHA1.

instance

string

Nome dell'istanza del database.

selfLink

string

L'URI di questa risorsa.

OnPremisesConfiguration

Rappresentazione JSON
{
  "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)
}
Campi
hostPort

string

L'host e la porta dell'istanza on-premise nel formato host:porta

kind

string

Questo valore è sempre sql#onPremisesConfiguration.

username

string

Il nome utente per la connessione all'istanza on-premise.

password

string

La password per la connessione all'istanza on-premise.

caCertificate

string

Rappresentazione PEM del certificato x509 della CA attendibile.

clientCertificate

string

Rappresentazione PEM del certificato x509 della replica.

clientKey

string

Rappresentazione PEM della chiave privata della replica. La chiave pubblica corrispondente è codificata nel certificato del client.

dumpFilePath

string

Il file di dump per creare la replica Cloud SQL.

sourceInstance

object (InstanceReference)

Il riferimento all'istanza Cloud SQL se l'origine è Cloud SQL.

selectedObjects[]

object (SelectedObjects)

Facoltativo. Un elenco di oggetti che l'utente seleziona per la replica da un'istanza di origine esterna.

sslOption

enum (SslOption)

Facoltativo. Opzione SSL per la connessione di replica all'origine on-premise.

InstanceReference

Rappresentazione JSON
{
  "name": string,
  "region": string,
  "project": string
}
Campi
name

string

Il nome dell'istanza Cloud SQL a cui viene fatto riferimento. L'ID progetto non è incluso.

region

string

La regione dell'istanza Cloud SQL a cui viene fatto riferimento.

project

string

L'ID progetto dell'istanza Cloud SQL a cui viene fatto riferimento. Il valore predefinito è lo stesso ID progetto a cui fa riferimento l'istanza.

SelectedObjects

Rappresentazione JSON
{
  "database": string
}
Campi
database

string

Obbligatorio. Il nome del database di cui eseguire la migrazione.

ReplicaConfiguration

Rappresentazione JSON
{
  "kind": string,
  "mysqlReplicaConfiguration": {
    object (MySqlReplicaConfiguration)
  },
  "failoverTarget": boolean,
  "cascadableReplica": boolean
}
Campi
kind

string

Questo valore è sempre sql#replicaConfiguration.

mysqlReplicaConfiguration

object (MySqlReplicaConfiguration)

Configurazione specifica di MySQL durante la replica da un'istanza principale MySQL on-premise. Le informazioni di configurazione della replica, come nome utente, password, certificati e chiavi, non vengono memorizzate nei metadati dell'istanza. Le informazioni di configurazione vengono utilizzate solo per configurare la connessione di replica e vengono archiviate da MySQL in un file denominato master.info nella directory dei dati.

failoverTarget

boolean

Specifica se la replica è il target di failover. Se il campo è impostato su true, la replica verrà designata come replica di failover. Se l'istanza principale non funziona, l'istanza di replica verrà promossa come nuova istanza principale. È possibile specificare una sola replica come destinazione di failover e la replica deve trovarsi in una zona diversa rispetto all'istanza principale.

cascadableReplica

boolean

Facoltativo. Specifica se una replica di SQL Server è una replica a cascata. Una replica a cascata è una replica cross-regione di SQL Server che supporta una o più repliche al suo interno.

MySqlReplicaConfiguration

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

string

Percorso di un file di dump SQL in Google Cloud Storage da cui creare l'istanza di replica. L'URI è nel formato gs://bucketName/fileName. Sono supportati anche i file gzip compressi (.gz). I dump contengono le coordinate binlog da cui inizia la replica. A questo scopo, imposta --master-data su 1 quando utilizzi mysqldump.

username

string

Il nome utente per la connessione di replica.

password

string

La password per la connessione di replica.

connectRetryInterval

integer

Secondi di attesa tra i tentativi di connessione. Il valore predefinito di MySQL è 60 secondi.

masterHeartbeatPeriod

string (Int64Value format)

Intervallo in millisecondi tra i battiti di replica.

caCertificate

string

Rappresentazione PEM del certificato x509 della CA attendibile.

clientCertificate

string

Rappresentazione PEM del certificato x509 della replica.

clientKey

string

Rappresentazione PEM della chiave privata della replica. La chiave pubblica corrispondente è codificata nel certificato del client.

sslCipher

string

Un elenco di algoritmi di crittografia consentiti da utilizzare per la crittografia SSL.

verifyServerCertificate

boolean

Indica se controllare o meno il valore del nome comune dell'istanza principale nel certificato che invia durante l'handshake SSL.

kind

string

Questo valore è sempre sql#mysqlReplicaConfiguration.

DiskEncryptionConfiguration

Rappresentazione JSON
{
  "kmsKeyName": string,
  "kind": string
}
Campi
kmsKeyName

string

Nome risorsa della chiave KMS per la crittografia del disco

kind

string

Questo valore è sempre sql#diskEncryptionConfiguration.

DiskEncryptionStatus

Rappresentazione JSON
{
  "kmsKeyVersionName": string,
  "kind": string
}
Campi
kmsKeyVersionName

string

Versione della chiave KMS utilizzata per criptare la risorsa istanza Cloud SQL

kind

string

Questo valore è sempre sql#diskEncryptionStatus.

SqlScheduledMaintenance

Rappresentazione JSON
{
  "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.
}
Campi
startTime

string (Timestamp format)

L'ora di inizio di qualsiasi manutenzione pianificata imminente per questa istanza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

canDefer
(deprecated)

boolean

canReschedule

boolean

Indica se è possibile riprogrammare la manutenzione pianificata.

Campo unione _schedule_deadline_time.

_schedule_deadline_time può essere solo uno dei seguenti tipi:

scheduleDeadlineTime

string (Timestamp format)

La manutenzione non può essere riprogrammata per iniziare dopo questa scadenza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

SqlOutOfDiskReport

Rappresentazione JSON
{

  // 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.
}
Campi

Campo unione _sql_out_of_disk_state.

_sql_out_of_disk_state può essere solo uno dei seguenti tipi:

sqlOutOfDiskState

enum (SqlOutOfDiskState)

Questo campo rappresenta lo stato generato dal job di controllo proattivo dell'integrità del database per i problemi di spazio su disco insufficiente. * Scrittori: * il job proattivo di integrità del database per OOD. * Lettori: * il job proattivo di integrità del database

Campo unione _sql_min_recommended_increase_size_gb.

_sql_min_recommended_increase_size_gb può essere solo uno dei seguenti tipi:

sqlMinRecommendedIncreaseSizeGb

integer

Le dimensioni minime consigliate per l'aumento in gigabyte. Questo campo viene utilizzato dal frontend * Scrittori: * il job proattivo di integrità del database per OOD. * Lettori:

AvailableDatabaseVersion

Rappresentazione JSON
{

  // 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.
}
Campi

Campo unione _major_version.

_major_version può essere solo uno dei seguenti tipi:

majorVersion

string

Il nome della versione principale della versione.

Campo unione _name.

_name può essere solo uno dei seguenti tipi:

name

string

Il nome della versione del database. Per MySQL 8.0, questa stringa fornisce la versione principale e secondaria del database.

Campo unione _display_name.

_display_name può essere solo uno dei seguenti tipi:

displayName

string

Il nome visualizzato della versione del database.

ReplicationCluster

Rappresentazione JSON
{
  "psaWriteEndpoint": string,
  "failoverDrReplicaName": string,
  "drReplica": boolean
}
Campi
psaWriteEndpoint

string

Solo output. Se impostato, questo campo indica che questa istanza ha un endpoint DNS di accesso al servizio privato (PSA) che punta all'istanza principale del cluster. Se questa istanza è quella principale, l'endpoint DNS punta a questa istanza. Dopo un'operazione di switchover o di failover della replica, questo endpoint DNS punta all'istanza promossa. Questo è un campo di sola lettura, restituito all'utente come informazione. Questo campo può esistere anche se un'istanza autonoma non ha ancora una replica di RE o se la replica di RE viene eliminata.

failoverDrReplicaName

string

Facoltativo. Se l'istanza è un'istanza principale, questo campo identifica la replica di ripristino di emergenza (RE). Una replica di RE è una configurazione facoltativa per le istanze della versione Enterprise Plus. Se l'istanza è una replica di lettura, il campo non è impostato. Imposta questo campo sul nome di una replica per designare una replica di RE per un'istanza primaria. Rimuovi il nome della replica per rimuovere la designazione di replica di RE.

drReplica

boolean

Solo output. Campo di sola lettura che indica se la replica è una replica RE. Questo campo non è impostato se l'istanza è un'istanza principale.

GeminiInstanceConfig

Rappresentazione JSON
{

  // 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.
}
Campi

Campo unione _entitled.

_entitled può essere solo uno dei seguenti tipi:

entitled

boolean

Solo output. Indica se Gemini è abilitato.

Campo unione _google_vacuum_mgmt_enabled.

_google_vacuum_mgmt_enabled può essere solo uno dei seguenti tipi:

googleVacuumMgmtEnabled

boolean

Solo output. Indica se la gestione dell'aspirapolvere è attiva.

Campo unione _oom_session_cancel_enabled.

_oom_session_cancel_enabled può essere solo uno dei seguenti tipi:

oomSessionCancelEnabled

boolean

Solo output. Indica se l'annullamento della sessione di esaurimento della memoria (OOM) è abilitato.

Campo unione _active_query_enabled.

_active_query_enabled può essere solo uno dei seguenti tipi:

activeQueryEnabled

boolean

Solo output. Indica se la query attiva è abilitata.

Campo unione _index_advisor_enabled.

_index_advisor_enabled può essere solo uno dei seguenti tipi:

indexAdvisorEnabled

boolean

Solo output. Indica se i suggerimenti sull'indicizzazione sono abilitati.

Campo unione _flag_recommender_enabled.

_flag_recommender_enabled può essere solo uno dei seguenti tipi:

flagRecommenderEnabled

boolean

Solo output. Indica se il sistema di suggerimento dei flag è abilitato.

TagsEntry

Rappresentazione JSON
{
  "key": string,
  "value": string
}
Campi
key

string

value

string

PoolNodeConfig

Rappresentazione JSON
{
  "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.
}
Campi
ipAddresses[]

object (IpMapping)

Solo output. Mapping contenenti indirizzi IP che possono essere utilizzati per connettersi al nodo del pool di lettura.

dnsNames[]

object (DnsNameMapping)

Solo output. L'elenco dei nomi DNS utilizzati da questo nodo del pool di lettura.

pscAutoConnections[]

object (PscAutoConnectionConfig)

Solo output. L'elenco delle impostazioni per gli endpoint consumer di Private Service Connect (PSC) configurati automaticamente richiesti che possono essere utilizzati per connettersi a questo nodo del pool di lettura.

Campo unione _name.

_name può essere solo uno dei seguenti tipi:

name

string

Solo output. Il nome del nodo del pool di lettura, da utilizzare per recuperare metriche e log.

Campo unione _gce_zone.

_gce_zone può essere solo uno dei seguenti tipi:

gceZone

string

Solo output. La zona del nodo del pool di lettura.

Campo unione _dns_name.

_dns_name può essere solo uno dei seguenti tipi:

dnsName

string

Solo output. Il nome DNS del nodo del pool di lettura.

Campo unione _state.

_state può essere solo uno dei seguenti tipi:

state

enum (SqlInstanceState)

Solo output. Lo stato attuale del nodo del pool di lettura.

Campo unione _psc_service_attachment_link.

_psc_service_attachment_link può essere solo uno dei seguenti tipi:

pscServiceAttachmentLink

string

Solo output. Il collegamento del servizio Private Service Connect (PSC) del nodo del pool di lettura.

DnsNameMapping

Rappresentazione JSON
{
  "name": string,
  "connectionType": enum (ConnectionType),
  "dnsScope": enum (DnsScope),
  "recordManager": enum (RecordManager)
}
Campi
name

string

Solo output. Il nome DNS.

connectionType

enum (ConnectionType)

Solo output. Il tipo di connessione del nome DNS.

dnsScope

enum (DnsScope)

Solo output. L'ambito a cui si applica il nome DNS.

recordManager

enum (RecordManager)

Solo output. Il gestore di questo record DNS.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌