MCP Tools Reference: cloud-sql

Herramienta: get_instance

Obtén los detalles de una instancia de Cloud SQL.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP get_instance.

Solicitud de Curl
                  
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
}'
                

Esquema de entrada

Es una solicitud de obtención de instancias.

SqlInstancesGetRequest

Representación JSON
{
  "instance": string,
  "project": string
}
Campos
instance

string

Obligatorio. El ID de instancia de la base de datos. Esto no incluye el ID del proyecto.

project

string

Obligatorio. El ID del proyecto que contiene la instancia.

Esquema de salida

Es un recurso de instancia de Cloud SQL.

DatabaseInstance

Representación 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.
}
Campos
kind

string

Siempre es sql#instance.

state

enum (SqlInstanceState)

El estado de entrega actual de la instancia de Cloud SQL.

databaseVersion

enum (SqlDatabaseVersion)

El tipo y la versión del motor de base de datos. El campo databaseVersion no se puede cambiar después de crear la instancia.

settings

object (Settings)

Es la configuración del usuario.

etag

string

Este campo está obsoleto y se quitará en una versión futura de la API. En su lugar, usa el campo settings.settingsVersion.

failoverReplica

object (SqlFailoverReplica)

El nombre y el estado de la réplica de conmutación por error.

masterInstanceName

string

Es el nombre de la instancia que actuará como principal en la configuración de replicación.

replicaNames[]

string

Son las réplicas de la instancia.

maxDiskSize
(deprecated)

string (Int64Value format)

Es el tamaño máximo del disco de la instancia en bytes.

currentDiskSize
(deprecated)

string (Int64Value format)

Es el uso actual del disco de la instancia en bytes. Esta propiedad dejó de estar disponible. En su lugar, usa la métrica "cloudsql.googleapis.com/database/disk/bytes_used" en la API de Cloud Monitoring. Consulta este anuncio para obtener más información.

ipAddresses[]

object (IpMapping)

Son las direcciones IP asignadas a la instancia.

serverCaCert

object (SslCert)

Configuración de SSL

instanceType

enum (SqlInstanceType)

Es el tipo de instancia.

project

string

Es el ID del proyecto que contiene la instancia de Cloud SQL. El dominio de las apps de Google tiene un prefijo si corresponde.

ipv6Address
(deprecated)

string

Es la dirección IPv6 asignada a la instancia. (Obsoleto) Esta propiedad solo se aplicaba a las instancias de primera generación.

serviceAccountEmailAddress

string

Es la dirección de correo electrónico de la cuenta de servicio asignada a la instancia.\nEsta propiedad es de solo lectura.

onPremisesConfiguration

object (OnPremisesConfiguration)

Es la configuración específica para las instancias locales.

replicaConfiguration

object (ReplicaConfiguration)

Es la configuración específica de las réplicas de conmutación por error y las réplicas de lectura.

backendType

enum (SqlBackendType)

Es el tipo de backend. SECOND_GEN: Instancia de base de datos de Cloud SQL. EXTERNAL: Es un servidor de bases de datos que no administra Google.

Esta propiedad es de solo lectura. Usa la propiedad tier en el objeto settings para determinar el tipo de base de datos.

selfLink

string

Es el URI de este recurso.

suspensionReason[]

enum (SqlSuspensionReason)

Si el estado de la instancia es SUSPENDED, se indica el motivo de la suspensión.

connectionName

string

Nombre de conexión de la instancia de Cloud SQL que se usa en las cadenas de conexión.

name

string

Es el nombre de la instancia de Cloud SQL. Esto no incluye el ID del proyecto.

region

string

Es la región geográfica de la instancia de Cloud SQL.

Puede ser una de las regiones en las que opera Cloud SQL:

Por ejemplo, asia-east1, europe-west1 y us-central1. El valor predeterminado es us-central1.

gceZone

string

Es la zona de Compute Engine desde la que se entrega la instancia actualmente. Este valor podría ser diferente de la zona que se especificó cuando se creó la instancia si esta realizó una conmutación por error a su zona secundaria. ADVERTENCIA: Si cambias este parámetro, es posible que se reinicie la instancia.

secondaryGceZone

string

Es la zona de Compute Engine desde la que actualmente se entrega la instancia de conmutación por error para una instancia regional. Este valor podría ser diferente de la zona que se especificó cuando se creó la instancia si esta conmutó por error a su zona secundaria o de conmutación por error.

diskEncryptionConfiguration

object (DiskEncryptionConfiguration)

Es la configuración de encriptación de disco específica de una instancia.

diskEncryptionStatus

object (DiskEncryptionStatus)

Es el estado de encriptación del disco específico de una instancia.

rootPassword

string

Es la contraseña raíz inicial. Solo se usa en la creación. Debes establecer contraseñas de raíz antes de poder conectarte a instancias de PostgreSQL.

scheduledMaintenance

object (SqlScheduledMaintenance)

Es la hora de inicio de cualquier mantenimiento programado próximo para esta instancia.

satisfiesPzs

boolean

Este estado indica si la instancia satisface la PZS.

El estado está reservado para uso futuro.

databaseInstalledVersion

string

Solo salida. Almacena la versión actual de la base de datos que se ejecuta en la instancia, incluida la versión secundaria, como MYSQL_8_0_18.

createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó la instancia, en formato RFC 3339, por ejemplo, 2012-11-15T16:19:00.094Z.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

availableMaintenanceVersions[]

string

Solo salida. Enumera todas las versiones de mantenimiento aplicables en la instancia

maintenanceVersion

string

Es la versión de software actual en la instancia.

upgradableDatabaseVersions[]

object (AvailableDatabaseVersion)

Solo salida. Son todas las versiones de la base de datos que están disponibles para la actualización.

replicationCluster

object (ReplicationCluster)

Es opcional. Un par de instancia principal y réplica de recuperación ante desastres (DR). Una réplica de DR es una réplica entre regiones que designas para la conmutación por error en caso de que la instancia principal experimente una falla regional. Se aplica a MySQL y PostgreSQL.

satisfiesPzi

boolean

Solo salida. Este estado indica si la instancia satisface la PZI.

El estado está reservado para uso futuro.

tags

map (key: string, value: string)

Es opcional. Solo entrada. Inmutable. Son las claves y los valores de las etiquetas que están vinculados a esta instancia. Debes representar cada elemento del mapa de la siguiente manera: "<tag-key-namespaced-name>" : "<tag-value-short-name>".

Por ejemplo, un solo recurso puede tener las siguientes etiquetas:

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

Para obtener más información sobre la creación y administración de etiquetas, consulta https://cloud.google.com/resource-manager/docs/tags/tags-overview.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

nodes[]

object (PoolNodeConfig)

Solo salida. Son entradas que contienen información sobre cada nodo del grupo de lectura.

dnsNames[]

object (DnsNameMapping)

Solo salida. Es la lista de nombres de DNS que usa esta instancia.

Campo de unión _out_of_disk_report.

_out_of_disk_report puede ser una de las siguientes opciones:

outOfDiskReport

object (SqlOutOfDiskReport)

Este campo representa el informe generado por el trabajo proactivo de estado de la base de datos para los problemas de OutOfDisk. * Escritores: * El trabajo proactivo de estado de la base de datos para OOD. * Lectores: * El trabajo proactivo de estado de la base de datos

Campo de unión _sql_network_architecture.

_sql_network_architecture puede ser una de las siguientes opciones:

sqlNetworkArchitecture

enum (SqlNetworkArchitecture)

Campo de unión _psc_service_attachment_link.

_psc_service_attachment_link puede ser una de las siguientes opciones:

pscServiceAttachmentLink

string

Solo salida. Es el vínculo al adjunto de servicio de la instancia de PSC.

Campo de unión _dns_name.

_dns_name puede ser una de las siguientes opciones:

dnsName

string

Solo salida. Es el nombre de DNS de la instancia.

Campo de unión _primary_dns_name.

_primary_dns_name puede ser una de las siguientes opciones:

primaryDnsName
(deprecated)

string

Solo salida. OBSOLETO: En su lugar, usa write_endpoint.

Campo de unión _write_endpoint.

_write_endpoint puede ser una de las siguientes opciones:

writeEndpoint

string

Solo salida. Es el nombre de DNS de la instancia principal en un grupo de replicación.

Campo de unión _gemini_config.

_gemini_config puede ser una de las siguientes opciones:

geminiConfig

object (GeminiInstanceConfig)

Es la configuración de la instancia de Gemini.

Campo de unión _switch_transaction_logs_to_cloud_storage_enabled.

_switch_transaction_logs_to_cloud_storage_enabled puede ser una de las siguientes opciones:

switchTransactionLogsToCloudStorageEnabled

boolean

Solo entrada. Indica si Cloud SQL está habilitado para cambiar el almacenamiento de los archivos de registro de recuperación de un momento determinado de un disco de datos a Cloud Storage.

Campo de unión _include_replicas_for_major_version_upgrade.

_include_replicas_for_major_version_upgrade puede ser una de las siguientes opciones:

includeReplicasForMajorVersionUpgrade

boolean

Solo entrada. Determina si se produce una actualización local de la versión principal de las réplicas cuando se inicia una actualización local de la versión principal de una instancia principal.

Campo de unión _node_count.

_node_count puede ser una de las siguientes opciones:

nodeCount

integer

Es la cantidad de nodos de grupo de lectura en un grupo de lectura.

Configuración

Representación 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.
}
Campos
settingsVersion

string (Int64Value format)

Es la versión de la configuración de la instancia. Este es un campo obligatorio para el método de actualización, ya que garantiza que las actualizaciones simultáneas se controlen correctamente. Durante la actualización, usa el valor de settingsVersion más reciente para esta instancia y no intentes actualizar este valor.

authorizedGaeApplications[]
(deprecated)

string

Son los IDs de las apps de App Engine que pueden acceder a esta instancia. (Obsoleto) Se aplica solo a las instancias de primera generación.

tier

string

Es el nivel (o tipo de máquina) de esta instancia, por ejemplo, db-custom-1-3840. ADVERTENCIA: Si cambias este parámetro, se reiniciará la instancia.

kind

string

Siempre es sql#settings.

userLabels

map (key: string, value: string)

Son las etiquetas proporcionadas por el usuario, representadas como un diccionario en el que cada etiqueta es un solo par clave-valor.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

availabilityType

enum (SqlAvailabilityType)

Es el tipo de disponibilidad. Valores posibles: * ZONAL: La instancia solo entrega datos de una zona. Las interrupciones en esa zona afectan la accesibilidad a los datos. * REGIONAL: La instancia puede entregar datos desde más de una zona en una región (es de alta disponibilidad)./

Para obtener más información, consulta Descripción general de la configuración de alta disponibilidad.

pricingPlan

enum (SqlPricingPlan)

Es el plan de precios para esta instancia. Puede ser PER_USE o PACKAGE. Solo se admite PER_USE para las instancias de segunda generación.

replicationType
(deprecated)

enum (SqlReplicationType)

Es el tipo de replicación que usa esta instancia. Puede ser ASYNCHRONOUS o SYNCHRONOUS. (Obsoleto) Esta propiedad solo se aplicaba a las instancias de primera generación.

storageAutoResizeLimit

string (Int64Value format)

Es el tamaño máximo al que se puede aumentar automáticamente la capacidad de almacenamiento. El valor predeterminado es 0, que especifica que no hay límite.

activationPolicy

enum (SqlActivationPolicy)

La política de activación especifica cuándo se activa la instancia y solo se aplica cuando el estado de la instancia es RUNNABLE. Valores válidos: * ALWAYS: La instancia está activada y permanece así incluso en ausencia de solicitudes de conexión. * NEVER: La instancia está apagada; no está activada, incluso si llega una solicitud de conexión.

ipConfiguration

object (IpConfiguration)

Es la configuración de la administración de IP. Esto permite habilitar o inhabilitar la IP de la instancia y administrar qué redes externas pueden conectarse a ella. La dirección IPv4 no se puede inhabilitar para las instancias de segunda generación.

storageAutoResize

boolean

Es la configuración para aumentar el tamaño de almacenamiento de forma automática. El valor predeterminado es verdadero.

locationPreference

object (LocationPreference)

Es la configuración de preferencias de ubicación. Esto permite que la instancia se ubique lo más cerca posible de una app de App Engine o de una zona de Compute Engine para obtener un mejor rendimiento. La colocación conjunta de App Engine solo se aplicaba a las instancias de primera generación.

databaseFlags[]

object (DatabaseFlags)

Son las marcas de base de datos que se pasan a la instancia durante el inicio.

dataDiskType

enum (SqlDataDiskType)

Tipo de disco de datos: PD_SSD (predeterminado) o PD_HDD. No se usa para instancias de primera generación.

maintenanceWindow

object (MaintenanceWindow)

Es el período de mantenimiento de esta instancia. Especifica cuándo se puede reiniciar la instancia por motivos de mantenimiento.

backupConfiguration

object (BackupConfiguration)

Es la configuración de copia de seguridad diaria para la instancia.

databaseReplicationEnabled

boolean

Es la configuración específica de las instancias de réplica de lectura. Indica si la replicación está habilitada o no. ADVERTENCIA: Si cambias este parámetro, se reiniciará la instancia.

crashSafeReplicationEnabled
(deprecated)

boolean

Es la configuración específica de las instancias de réplica de lectura. Indica si las marcas de la base de datos para la replicación a prueba de fallas están habilitadas. Esta propiedad solo se aplicaba a las instancias de primera generación.

dataDiskSizeGb

string (Int64Value format)

Tamaño del disco de datos en GB. El tamaño mínimo del disco de datos es de 10 GB.

activeDirectoryConfig

object (SqlActiveDirectoryConfig)

Es la configuración de Active Directory, que solo es relevante para Cloud SQL para SQL Server.

collation

string

Es el nombre de la intercalación de la instancia del servidor.

denyMaintenancePeriods[]

object (DenyMaintenancePeriod)

Rechazo del período de mantenimiento

insightsConfig

object (InsightsConfig)

Configuración de estadísticas, por ahora solo relevante para Postgres.

passwordValidationPolicy

object (PasswordValidationPolicy)

Es la política de validación de contraseñas de usuario local de la instancia.

sqlServerAuditConfig

object (SqlServerAuditConfig)

Es la configuración de auditoría específica de SQL Server.

edition

enum (Edition)

Es opcional. Es la edición de la instancia.

connectorEnforcement

enum (ConnectorEnforcement)

Especifica si las conexiones deben usar conectores de Cloud SQL. Los valores de las opciones incluyen los siguientes: NOT_REQUIRED (las instancias de Cloud SQL se pueden conectar sin conectores de Cloud SQL) y REQUIRED (solo se permiten las conexiones que usan conectores de Cloud SQL).

Ten en cuenta que, si usas REQUIRED, se inhabilitarán todas las redes autorizadas existentes. Si no se especifica este campo cuando se crea una instancia nueva, se usa NOT_REQUIRED. Si este campo no se especifica cuando se aplica un parche o se actualiza una instancia existente, se deja sin cambios en la instancia.

deletionProtectionEnabled

boolean

Es la configuración para proteger contra la eliminación accidental de instancias.

timeZone

string

Es la zona horaria del servidor, que solo es relevante para Cloud SQL para SQL Server.

advancedMachineFeatures

object (AdvancedMachineFeatures)

Especifica la configuración avanzada de la máquina para las instancias, solo relevante para SQL Server.

dataCacheConfig

object (DataCacheConfig)

Es la configuración de la caché de datos.

replicationLagMaxSeconds

integer

Es opcional. Valor de configuración para la recreación de la réplica después de un cierto retraso de replicación

enableGoogleMlIntegration

boolean

Es opcional. Cuando este parámetro se establece en verdadero, las instancias de Cloud SQL pueden conectarse a Vertex AI para pasar solicitudes de predicciones y estadísticas en tiempo real a la IA. El valor predeterminado es falso. Esto solo se aplica a las instancias de Cloud SQL para MySQL y Cloud SQL para PostgreSQL.

enableDataplexIntegration

boolean

Es opcional. De forma predeterminada, las instancias de Cloud SQL tienen inhabilitada la extracción de esquemas para Dataplex. Cuando este parámetro se establece en verdadero, se activa la extracción de esquemas para Dataplex en instancias de Cloud SQL.

retainBackupsOnDelete

boolean

Es opcional. Cuando este parámetro se establece en verdadero, Cloud SQL retiene copias de seguridad de la instancia incluso después de que se borra. La copia de seguridad ON_DEMAND se conservará hasta que el cliente la borre o borre el proyecto. La copia de seguridad AUTOMÁTICA se conservará según el parámetro de configuración de retención de copias de seguridad.

entraidConfig

object (SqlServerEntraIdConfig)

Es opcional. Es la configuración de Microsoft Entra ID para la instancia de SQL Server.

performanceCaptureConfig

object (PerformanceCaptureConfig)

Es opcional. Es la configuración de la captura de rendimiento, que proporciona métricas de diagnóstico en situaciones de carga alta.

Campo de unión _data_disk_provisioned_iops.

_data_disk_provisioned_iops puede ser una de las siguientes opciones:

dataDiskProvisionedIops

string (int64 format)

Es opcional. Cantidad aprovisionada de operaciones de E/S por segundo para el disco de datos. Este campo solo se usa para los tipos de discos Hyperdisk Balanced.

Campo de unión _data_disk_provisioned_throughput.

_data_disk_provisioned_throughput puede ser una de las siguientes opciones:

dataDiskProvisionedThroughput

string (int64 format)

Es opcional. Es la capacidad de procesamiento aprovisionada medida en MiB por segundo para el disco de datos. Este campo solo se usa para los tipos de discos Hyperdisk Balanced.

Campo de unión _connection_pool_config.

_connection_pool_config puede ser una de las siguientes opciones:

connectionPoolConfig

object (ConnectionPoolConfig)

Es opcional. Es la configuración de la agrupación de conexiones administrada para la instancia.

Campo de unión _final_backup_config.

_final_backup_config puede ser una de las siguientes opciones:

finalBackupConfig

object (FinalBackupConfig)

Es opcional. Es la configuración final de la copia de seguridad de la instancia.

Campo de unión _read_pool_auto_scale_config.

_read_pool_auto_scale_config puede ser una de las siguientes opciones:

readPoolAutoScaleConfig

object (ReadPoolAutoScaleConfig)

Es opcional. Es la configuración del ajuste de escala automático del grupo de lectura para la instancia.

Campo de unión _auto_upgrade_enabled.

_auto_upgrade_enabled puede ser una de las siguientes opciones:

autoUpgradeEnabled

boolean

Es opcional. Es la configuración de actualización automática de Cloud SQL para MySQL. Cuando este parámetro se establece como verdadero, se habilita la actualización automática para las versiones secundarias de MySQL 8.0. La versión de MySQL debe ser 8.0.35 o posterior.

Campo de unión _data_api_access.

_data_api_access puede ser una de las siguientes opciones:

dataApiAccess

enum (DataApiAccess)

Este parámetro controla si se permite usar la API de ExecuteSql para conectarse a la instancia. No se permite de forma predeterminada.

Int64Value

Representación JSON
{
  "value": string
}
Campos
value

string (int64 format)

Es el valor int64.

UserLabelsEntry

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

IpConfiguration

Representación 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.
}
Campos
ipv4Enabled

boolean

Indica si se asigna una dirección IP pública a la instancia.

privateNetwork

string

Es el vínculo del recurso para la red de VPC desde la que se puede acceder a la instancia de Cloud SQL con una IP privada. Por ejemplo, /projects/myProject/global/networks/default. Este parámetro de configuración se puede actualizar, pero no se puede quitar después de establecerlo.

requireSsl

boolean

Utiliza ssl_mode en lugar de esta función.

Indica si se aplican las conexiones SSL/TLS a través de IP. Si se configura como falso, se permiten conexiones sin SSL/TLS y con SSL/TLS. Para las conexiones SSL/TLS, no se verificará el certificado de cliente. Si se establece como verdadero, solo se permiten conexiones encriptadas con SSL/TLS y con certificados de cliente válidos. Si deseas aplicar SSL/TLS sin aplicar el requisito de certificados de cliente válidos, usa la marca ssl_mode en lugar de la marca require_ssl.

authorizedNetworks[]

object (AclEntry)

Es la lista de redes externas que pueden conectarse a la instancia con la IP. En notación CIDR, también conocida como notación de barra (por ejemplo, 157.197.200.0/24)

allocatedIpRange

string

Es el nombre del rango de IP asignado para la instancia de Cloud SQL con IP privada. Por ejemplo, "google-managed-services-default". Si se configura, la IP de la instancia se creará en el rango asignado. El nombre del rango debe cumplir con RFC 1035. Específicamente, el nombre debe tener entre 1 y 63 caracteres, y coincidir con la expresión regular [a-z]([-a-z0-9]*[a-z0-9])?..

enablePrivatePathForGoogleCloudServices

boolean

Controla la conectividad a instancias con IP privada desde los servicios de Google, como BigQuery.

sslMode

enum (SslMode)

Especifica cómo se aplica SSL/TLS en las conexiones de bases de datos. Si debes usar la marca require_ssl para la retrocompatibilidad, solo son válidos los siguientes pares de valores:

Para PostgreSQL y MySQL, haz lo siguiente:

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

Para SQL Server, haz lo siguiente:

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

El valor de ssl_mode tiene prioridad sobre el valor de require_ssl.

Por ejemplo, para el par ssl_mode=ENCRYPTED_ONLY y require_ssl=false, ssl_mode=ENCRYPTED_ONLY significa que solo se aceptan conexiones SSL, mientras que require_ssl=false significa que se aceptan tanto conexiones SSL como no SSL. En este caso, las bases de datos de MySQL y PostgreSQL respetan ssl_mode y solo aceptan conexiones SSL.

customSubjectAlternativeNames[]

string

Es opcional. Son los nombres alternativos del sujeto(SAN) personalizados para una instancia de Cloud SQL.

Campo de unión _psc_config.

_psc_config puede ser una de las siguientes opciones:

pscConfig

object (PscConfig)

Es la configuración del PSC para esta instancia.

Campo de unión _server_ca_mode.

_server_ca_mode puede ser una de las siguientes opciones:

serverCaMode

enum (CaMode)

Especifica qué tipo de CA se usa para el certificado del servidor.

Campo de unión _server_ca_pool.

_server_ca_pool puede ser una de las siguientes opciones:

serverCaPool

string

Es opcional. Es el nombre del recurso del grupo de CA del servidor para una instancia con CUSTOMER_MANAGED_CAS_CA como server_ca_mode. Formato: projects/{PROJECT}/locations/{REGION}/caPools/{CA_POOL_ID}

Campo de unión _server_certificate_rotation_mode.

_server_certificate_rotation_mode puede ser una de las siguientes opciones:

serverCertificateRotationMode

enum (ServerCertificateRotationMode)

Es opcional. Controla la función de rotación automática de certificados de servidor. Esta función está inhabilitada de forma predeterminada. Cuando se habilita, el certificado de servidor se rotará automáticamente durante el mantenimiento programado de Cloud SQL o las actualizaciones de mantenimiento de autoservicio hasta seis meses antes de su vencimiento. Este parámetro de configuración solo se puede establecer si server_ca_mode es GOOGLE_MANAGED_CAS_CA o CUSTOMER_MANAGED_CAS_CA.

BoolValue

Representación JSON
{
  "value": boolean
}
Campos
value

boolean

Es el valor booleano.

AclEntry

Representación JSON
{
  "value": string,
  "expirationTime": string,
  "name": string,
  "kind": string
}
Campos
value

string

Es el valor incluido en la lista de entidades permitidas para la lista de control de acceso.

expirationTime

string (Timestamp format)

Fecha y hora en que vence esta entrada de control de acceso, en formato RFC 3339, por ejemplo, 2012-11-15T16:19:00.094Z.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

name

string

Es opcional. Es una etiqueta para identificar esta entrada.

kind

string

Siempre es sql#aclEntry.

Marca de tiempo

Representación JSON
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).

nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

PscConfig

Representación 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.
}
Campos
allowedConsumerProjects[]

string

Es opcional. Es la lista de proyectos de consumidor incluidos en la lista de entidades permitidas para las conexiones de PSC a esta instancia. Se puede conectar a esta instancia con PSC desde cualquier red de estos proyectos.

Cada proyecto del consumidor en esta lista puede estar representado por un número de proyecto (numérico) o por un ID de proyecto (alfanumérico).

pscAutoConnections[]

object (PscAutoConnectionConfig)

Es opcional. Es la lista de parámetros de configuración para los extremos de consumidor de Private Service Connect solicitados que se pueden usar para conectarse a esta instancia de Cloud SQL.

networkAttachmentUri

string

Es opcional. Es el adjunto de red de la red del consumidor a la que la instancia de Cloud SQL habilitada para Private Service Connect está autorizada a conectarse a través de la interfaz de PSC. El formato es projects/PROJECT/regions/REGION/networkAttachments/ID.

Campo de unión _psc_enabled.

_psc_enabled puede ser una de las siguientes opciones:

pscEnabled

boolean

Indica si la conectividad de PSC está habilitada para esta instancia.

PscAutoConnectionConfig

Representación 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.
}
Campos
consumerProject

string

Es opcional. Es el ID del proyecto de servicio del consumidor de este extremo del consumidor.

Es opcional. Esto solo se aplica si consumer_network es una red de VPC compartida.

consumerNetwork

string

Es opcional. Es la red del consumidor de este extremo del consumidor. Debe ser una ruta de acceso al recurso que incluya el proyecto host y el nombre de la red.

Por ejemplo, projects/project1/global/networks/network1.

El proyecto host del consumidor de esta red puede ser diferente del proyecto de servicio del consumidor.

Campo de unión _ip_address.

_ip_address puede ser una de las siguientes opciones:

ipAddress

string

Es la dirección IP del extremo del consumidor.

Campo de unión _status.

_status puede ser una de las siguientes opciones:

status

string

Es el estado de conexión del extremo del consumidor.

Campo de unión _consumer_network_status.

_consumer_network_status puede ser una de las siguientes opciones:

consumerNetworkStatus

string

Es el estado de la política de conexión de la red del consumidor.

LocationPreference

Representación JSON
{
  "followGaeApplication": string,
  "zone": string,
  "secondaryZone": string,
  "kind": string
}
Campos
followGaeApplication
(deprecated)

string

La aplicación de App Engine que se debe seguir debe estar en la misma región que la instancia de Cloud SQL. ADVERTENCIA: Si cambias este parámetro, es posible que se reinicie la instancia.

zone

string

Zona de Compute Engine preferida (por ejemplo, us-central1-a, us-central1-b, etcétera) ADVERTENCIA: Si cambias este parámetro, es posible que se reinicie la instancia.

secondaryZone

string

Zona de Compute Engine preferida para la instancia secundaria o de conmutación por error (por ejemplo, us-central1-a, us-central1-b, etcétera). Para inhabilitar este campo, configúralo como "no_secondary_zone".

kind

string

Siempre es sql#locationPreference.

Marcas de bases de datos

Representación JSON
{
  "name": string,
  "value": string
}
Campos
name

string

Es el nombre de la marca. Estas marcas se pasan al inicio de la instancia, por lo que incluyen tanto las opciones del servidor como las variables del sistema. Las marcas se especifican con guiones bajos, no con guiones. Para obtener más información, consulta Configura marcas de bases de datos en la documentación de Cloud SQL.

value

string

Es el valor de la marca. Las marcas booleanas se configuran en on para verdadero y off para falso. Este campo se debe omitir si la marca no toma un valor.

MaintenanceWindow

Representación JSON
{
  "hour": integer,
  "day": integer,
  "updateTrack": enum (SqlUpdateTrack),
  "kind": string
}
Campos
hour

integer

Hora del día: de 0 a 23. Especifica en la zona horaria UTC.

day

integer

Día de la semana: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Especifica en la zona horaria UTC. Se devuelve en la salida como un número entero, del 1 al 7, donde 1 equivale al lunes.

updateTrack

enum (SqlUpdateTrack)

Configuración del horario de mantenimiento: canary, stable o week5. Para obtener más información, consulta Información sobre el mantenimiento en instancias de Cloud SQL.

kind

string

Siempre es sql#maintenanceWindow.

Int32Value

Representación JSON
{
  "value": integer
}
Campos
value

integer

Es el valor int32.

BackupConfiguration

Representación 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.
}
Campos
startTime

string

Hora de inicio para la configuración de la copia de seguridad diaria en la zona horaria UTC en formato de 24 horas: HH:MM.

enabled

boolean

Indica si esta configuración está habilitada.

kind

string

Siempre es sql#backupConfiguration.

binaryLogEnabled

boolean

(Solo para MySQL) Indica si el registro binario está habilitado. Si la configuración de copia de seguridad está inhabilitada, también se debe inhabilitar el registro binario.

replicationLogArchivingEnabled

boolean

Se reserva para usarlo más adelante.

location

string

Ubicación de la copia de seguridad

pointInTimeRecoveryEnabled

boolean

Indica si la recuperación de un momento determinado está habilitada.

backupRetentionSettings

object (BackupRetentionSettings)

Configuración de retención de copias de seguridad

transactionLogRetentionDays

integer

Cantidad de días de registros de transacciones que conservamos para la recuperación a un momento determinado, del 1 al 7.

Campo de unión _transactional_log_storage_state.

_transactional_log_storage_state puede ser una de las siguientes opciones:

transactionalLogStorageState

enum (TransactionalLogStorageState)

Solo salida. Este valor contiene la ubicación de almacenamiento de los registros de transacciones que se usan para realizar la recuperación de un momento determinado (PITR) de la base de datos.

Campo de unión _backup_tier.

_backup_tier puede ser una de las siguientes opciones:

backupTier

enum (BackupTier)

Solo salida. Es el nivel de copia de seguridad que administra las copias de seguridad de la instancia.

BackupRetentionSettings

Representación JSON
{
  "retentionUnit": enum (RetentionUnit),
  "retainedBackups": integer
}
Campos
retentionUnit

enum (RetentionUnit)

Unidad que representa "retained_backups".

retainedBackups

integer

Según el valor de retention_unit, se usa para determinar si se debe borrar una copia de seguridad. Si retention_unit es "COUNT", conservaremos esta cantidad de copias de seguridad.

SqlActiveDirectoryConfig

Representación JSON
{
  "kind": string,
  "domain": string,
  "mode": enum (ActiveDirectoryMode),
  "dnsServers": [
    string
  ],
  "adminCredentialSecretName": string,
  "organizationalUnit": string
}
Campos
kind

string

Siempre es sql#activeDirectoryConfig.

domain

string

Nombre del dominio (p. ej., mydomain.com)

mode

enum (ActiveDirectoryMode)

Es opcional. Es el modo de configuración de Active Directory.

dnsServers[]

string

Es opcional. Son las direcciones IPv4 del controlador de dominio que se usan para iniciar Active Directory.

adminCredentialSecretName

string

Es opcional. Es la clave de Secret Manager que almacena la credencial del administrador. (p.ej., projects/{project}/secrets/{secret}).

organizationalUnit

string

Es opcional. Nombre de la unidad organizativa. Es la ruta jerárquica completa a la unidad organizativa.

DenyMaintenancePeriod

Representación JSON
{
  "startDate": string,
  "endDate": string,
  "time": string
}
Campos
startDate

string

Fecha de inicio del "período de rechazo del mantenimiento". Si el año de la fecha de inicio está vacío, el año de la fecha de finalización también debe estar vacío. En este caso, significa que el rechazo del período de mantenimiento se repite cada año. La fecha está en formato aaaa-mm-dd, es decir: 2020-11-01 o mm-dd, es decir, 11-01

endDate

string

Fecha de finalización del "período de rechazo del mantenimiento". Si el año de la fecha de finalización está vacío, el año de la fecha de inicio también debe estar vacío. En este caso, significa que el intervalo sin mantenimiento se repite cada año. La fecha está en formato aaaa-mm-dd, es decir: 2020-11-01 o mm-dd, es decir, 11-01

time

string

Es la hora en UTC en la que comienza el "período de rechazo del mantenimiento" en start_date y finaliza en end_date. La hora está en formato HH: mm:SS, es decir: 00:00:00

InsightsConfig

Representación JSON
{
  "queryInsightsEnabled": boolean,
  "recordClientAddress": boolean,
  "recordApplicationTags": boolean,
  "queryStringLength": integer,
  "queryPlansPerMinute": integer,
  "enhancedQueryInsightsEnabled": boolean
}
Campos
queryInsightsEnabled

boolean

Indica si la función de Estadísticas de consultas está habilitada.

recordClientAddress

boolean

Indica si las Estadísticas de consultas registrarán la dirección del cliente cuando estén habilitadas.

recordApplicationTags

boolean

Indica si las Estadísticas de consultas registrarán etiquetas de aplicaciones de la consulta cuando estén habilitadas.

queryStringLength

integer

Es la longitud máxima de la búsqueda almacenada en bytes. El valor predeterminado es de 1,024 bytes. Rango: de 256 a 4,500 bytes. Las longitudes de búsqueda superiores al valor de este campo se truncarán a este valor. Cuando no se configura, la longitud de la búsqueda será el valor predeterminado. Si cambias la longitud de la consulta, se reiniciará la base de datos.

queryPlansPerMinute

integer

Cantidad de planes de ejecución de consultas que captura Insights por minuto para todas las consultas combinadas. El valor predeterminado es 5.

enhancedQueryInsightsEnabled

boolean

Es opcional. Indica si la función de estadísticas de consultas mejoradas está habilitada.

PasswordValidationPolicy

Representación JSON
{
  "minLength": integer,
  "complexity": enum (Complexity),
  "reuseInterval": integer,
  "disallowUsernameSubstring": boolean,
  "passwordChangeInterval": string,
  "enablePasswordPolicy": boolean,
  "disallowCompromisedCredentials": boolean
}
Campos
minLength

integer

Es la cantidad mínima de caracteres permitidos.

complexity

enum (Complexity)

Es la complejidad de la contraseña.

reuseInterval

integer

Cantidad de contraseñas anteriores que no se pueden volver a usar.

disallowUsernameSubstring

boolean

No permitir el nombre de usuario como parte de la contraseña

passwordChangeInterval

string (Duration format)

Es el intervalo mínimo después del cual se puede cambiar la contraseña. Esta marca solo es compatible con PostgreSQL.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

enablePasswordPolicy

boolean

Indica si se debe habilitar la política de contraseñas. Cuando se habilita, las contraseñas deben cumplir con los requisitos de complejidad. Mantén habilitada esta política para ayudar a evitar el acceso no autorizado. Si inhabilitas esta política, se permitirán las contraseñas débiles.

disallowCompromisedCredentials
(deprecated)

boolean

Este campo dejó de estar disponible y se quitará en una versión futura de la API.

Duración

Representación JSON
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Son los segundos firmados del período. Debe estar entre -315,576,000,000 y +315,576,000,000, inclusive. Nota: Estos límites se calculan de la siguiente manera: 60 s/min * 60 min/h * 24 h/día * 365.25 días/año * 10,000 años.

nanos

integer

Fracciones firmadas de un segundo con una resolución de nanosegundos del período. Las duraciones inferiores a un segundo se representan con un campo seconds igual a 0 y un campo nanos positivo o negativo. Para duraciones de un segundo o más, un valor distinto de cero para el campo nanos debe tener el mismo signo que el campo seconds. Debe ser un valor entre -999,999,999 y +999,999,999, inclusive.

SqlServerAuditConfig

Representación JSON
{
  "kind": string,
  "bucket": string,
  "retentionInterval": string,
  "uploadInterval": string
}
Campos
kind

string

Siempre es sql#sqlServerAuditConfig.

bucket

string

Nombre del bucket de destino (p.ej., gs://mybucket).

retentionInterval

string (Duration format)

Tiempo durante el que se conservan los archivos de auditoría generados.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

uploadInterval

string (Duration format)

Con qué frecuencia se deben subir los archivos de auditoría generados.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

AdvancedMachineFeatures

Representación JSON
{
  "threadsPerCore": integer
}
Campos
threadsPerCore

integer

Es la cantidad de subprocesos por núcleo físico.

DataCacheConfig

Representación JSON
{
  "dataCacheEnabled": boolean
}
Campos
dataCacheEnabled

boolean

Indica si la caché de datos está habilitada para la instancia.

ConnectionPoolConfig

Representación 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.
}
Campos
flags[]

object (ConnectionPoolFlags)

Es opcional. Es una lista de marcas de configuración del grupo de conexiones.

Campo de unión _connection_pooling_enabled.

_connection_pooling_enabled puede ser una de las siguientes opciones:

connectionPoolingEnabled

boolean

Indica si la agrupación de conexiones administradas está habilitada.

Campo de unión _pooler_count.

_pooler_count puede ser una de las siguientes opciones:

poolerCount

integer

Solo salida. Cantidad de agrupadores de conexiones.

ConnectionPoolFlags

Representación JSON
{
  "name": string,
  "value": string
}
Campos
name

string

Obligatorio. Es el nombre de la marca.

value

string

Obligatorio. Es el valor de la marca. Las marcas booleanas se configuran en on para verdadero y off para falso. Este campo se debe omitir si la marca no toma un valor.

FinalBackupConfig

Representación 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.
}
Campos

Campo de unión _enabled.

_enabled puede ser una de las siguientes opciones:

enabled

boolean

Indica si la copia de seguridad final está habilitada para la instancia.

Campo de unión _retention_days.

_retention_days puede ser una de las siguientes opciones:

retentionDays

integer

Es la cantidad de días que se retendrá la copia de seguridad final después de la eliminación de la instancia. La copia de seguridad final se borrará en (time_of_instance_deletion + retention_days).

ReadPoolAutoScaleConfig

Representación 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.
}
Campos
targetMetrics[]

object (TargetMetric)

Es opcional. Son las métricas objetivo para el ajuste de escala automático del grupo de lectura.

Campo de unión _enabled.

_enabled puede ser una de las siguientes opciones:

enabled

boolean

Indica si está habilitado el ajuste de escala automático del grupo de lectura.

Campo de unión _min_node_count.

_min_node_count puede ser una de las siguientes opciones:

minNodeCount

integer

Es la cantidad mínima de nodos del grupo de lectura que se deben mantener.

Campo de unión _max_node_count.

_max_node_count puede ser una de las siguientes opciones:

maxNodeCount

integer

Es la cantidad máxima de nodos del grupo de lectura que se deben mantener.

Campo de unión _disable_scale_in.

_disable_scale_in puede ser una de las siguientes opciones:

disableScaleIn

boolean

Indica si el ajuste de escala automático del grupo de lectura admite operaciones de reducción de escala (quitar nodos).

Campo de unión _scale_in_cooldown_seconds.

_scale_in_cooldown_seconds puede ser una de las siguientes opciones:

scaleInCooldownSeconds

integer

Es el período de inactividad para las operaciones de reducción.

Campo de unión _scale_out_cooldown_seconds.

_scale_out_cooldown_seconds puede ser una de las siguientes opciones:

scaleOutCooldownSeconds

integer

Es el período de inactividad para las operaciones de escalamiento horizontal.

TargetMetric

Representación 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.
}
Campos

Campo de unión _metric.

_metric puede ser una de las siguientes opciones:

metric

string

Es el nombre de la métrica que se usará para el ajuste de escala automático.

Campo de unión _target_value.

_target_value puede ser una de las siguientes opciones:

targetValue

number

Es el valor objetivo de la métrica.

SqlServerEntraIdConfig

Representación JSON
{
  "kind": string,
  "tenantId": string,
  "applicationId": string
}
Campos
kind

string

Solo salida. Siempre es sql#sqlServerEntraIdConfig

tenantId

string

Es opcional. Es el ID del arrendatario para la configuración de Entra ID.

applicationId

string

Es opcional. Es el ID de la aplicación para la configuración de Entra ID.

PerformanceCaptureConfig

Representación 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.
}
Campos

Campo de unión _enabled.

_enabled puede ser una de las siguientes opciones:

enabled

boolean

Es opcional. Habilita o inhabilita la función de captura de rendimiento.

Campo de unión _probing_interval_seconds.

_probing_interval_seconds puede ser una de las siguientes opciones:

probingIntervalSeconds

integer

Es opcional. Es el intervalo de tiempo en segundos entre dos sondeos cualesquiera.

Campo de unión _probe_threshold.

_probe_threshold puede ser una de las siguientes opciones:

probeThreshold

integer

Es opcional. Es la cantidad mínima de lecturas consecutivas por encima del umbral que activan la captura del estado de la instancia.

Campo de unión _running_threads_threshold.

_running_threads_threshold puede ser una de las siguientes opciones:

runningThreadsThreshold

integer

Es opcional. Es la cantidad mínima de subprocesos del servidor que se ejecutan para activar la captura en el servidor principal.

Campo de unión _seconds_behind_source_threshold.

_seconds_behind_source_threshold puede ser una de las siguientes opciones:

secondsBehindSourceThreshold

integer

Es opcional. Es la cantidad mínima de segundos que la réplica debe retrasarse con respecto a la instancia principal para activar la captura en la réplica.

Campo de unión _transaction_duration_threshold.

_transaction_duration_threshold puede ser una de las siguientes opciones:

transactionDurationThreshold

integer

Es opcional. Es la cantidad de tiempo en segundos que debe haber estado abierta una transacción antes de que el observador comience a registrarla.

SqlFailoverReplica

Representación JSON
{
  "name": string,
  "available": boolean
}
Campos
name

string

Es el nombre de la réplica de conmutación por error. Si se especifica durante la creación de la instancia, se crea una réplica de conmutación por error para la instancia. El nombre no incluye el ID del proyecto.

available

boolean

Es el estado de disponibilidad de la réplica de conmutación por error. Un estado falso indica que la réplica de conmutación por error no está sincronizada. La instancia principal solo puede conmutar por error a la réplica de conmutación por error cuando el estado es verdadero.

IpMapping

Representación JSON
{
  "type": enum (SqlIpAddressType),
  "ipAddress": string,
  "timeToRetire": string
}
Campos
type

enum (SqlIpAddressType)

Es el tipo de esta dirección IP. Una dirección PRIMARY es una dirección pública que puede aceptar conexiones entrantes. Una dirección PRIVATE es una dirección privada que puede aceptar conexiones entrantes. Una dirección OUTGOING es la dirección de origen de las conexiones que se originan en la instancia, si se admite.

ipAddress

string

Es la dirección IP asignada.

timeToRetire

string (Timestamp format)

Hora de vencimiento de esta IP en formato RFC 3339, por ejemplo, 2012-11-15T16:19:00.094Z. Este campo solo está disponible cuando se programa la baja de la IP.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

SslCert

Representación JSON
{
  "kind": string,
  "certSerialNumber": string,
  "cert": string,
  "createTime": string,
  "commonName": string,
  "expirationTime": string,
  "sha1Fingerprint": string,
  "instance": string,
  "selfLink": string
}
Campos
kind

string

Siempre es sql#sslCert.

certSerialNumber

string

Número de serie, tal como se extrajo del certificado.

cert

string

Representación PEM.

createTime

string (Timestamp format)

Fecha y hora en que se creó el certificado en formato RFC 3339, por ejemplo, 2012-11-15T16:19:00.094Z

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

commonName

string

Es el nombre proporcionado por el usuario. Se limita a [a-zA-Z.-_ ]+.

expirationTime

string (Timestamp format)

Fecha y hora de vencimiento del certificado en formato RFC 3339, por ejemplo, 2012-11-15T16:19:00.094Z.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

sha1Fingerprint

string

Huella digital Sha1.

instance

string

Es el nombre de la instancia de la base de datos.

selfLink

string

Es el URI de este recurso.

OnPremisesConfiguration

Representación 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)
}
Campos
hostPort

string

El host y el puerto de la instancia local en formato host:port

kind

string

Siempre es sql#onPremisesConfiguration.

username

string

Nombre de usuario para conectarse a la instancia local.

password

string

Contraseña para conectarse a la instancia local.

caCertificate

string

Representación PEM del certificado x509 de CA de confianza.

clientCertificate

string

Representación PEM del certificado x509 de la réplica.

clientKey

string

Representación PEM de la clave privada de la réplica. La clave pública correspondiente está codificada en el certificado del cliente.

dumpFilePath

string

Es el archivo de volcado para crear la réplica de Cloud SQL.

sourceInstance

object (InstanceReference)

Es la referencia a la instancia de Cloud SQL si la fuente es Cloud SQL.

selectedObjects[]

object (SelectedObjects)

Es opcional. Es una lista de objetos que el usuario selecciona para la replicación desde una instancia de fuente externa.

sslOption

enum (SslOption)

Es opcional. Opción de SSL para la conexión de la réplica a la fuente local.

InstanceReference

Representación JSON
{
  "name": string,
  "region": string,
  "project": string
}
Campos
name

string

Es el nombre de la instancia de Cloud SQL a la que se hace referencia. Esto no incluye el ID del proyecto.

region

string

Es la región de la instancia de Cloud SQL a la que se hace referencia.

project

string

Es el ID del proyecto de la instancia de Cloud SQL a la que se hace referencia. El valor predeterminado es el mismo ID del proyecto al que hace referencia la instancia.

SelectedObjects

Representación JSON
{
  "database": string
}
Campos
database

string

Obligatorio. Es el nombre de la base de datos que se migrará.

ReplicaConfiguration

Representación JSON
{
  "kind": string,
  "mysqlReplicaConfiguration": {
    object (MySqlReplicaConfiguration)
  },
  "failoverTarget": boolean,
  "cascadableReplica": boolean
}
Campos
kind

string

Siempre es sql#replicaConfiguration.

mysqlReplicaConfiguration

object (MySqlReplicaConfiguration)

Es la configuración específica de MySQL cuando se replica desde una instancia principal local de MySQL. La información de configuración de la replicación, como el nombre de usuario, la contraseña, los certificados y las claves, no se almacena en los metadatos de la instancia. La información de configuración solo se usa para establecer la conexión de replicación y MySQL la almacena en un archivo llamado master.info en el directorio de datos.

failoverTarget

boolean

Especifica si la réplica es el destino de conmutación por error. Si el campo se establece en true, la réplica se designará como réplica de conmutación por error. En caso de que falle la instancia principal, la instancia de réplica se promoverá como la nueva instancia principal. Solo se puede especificar una réplica como destino de conmutación por error, y la réplica debe estar en una zona diferente a la de la instancia principal.

cascadableReplica

boolean

Es opcional. Especifica si una réplica de SQL Server es una réplica que se puede aplicar en cascada. Una réplica que se puede aplicar en cascada es una réplica entre regiones de SQL Server que admite réplicas debajo de ella.

MySqlReplicaConfiguration

Representación JSON
{
  "dumpFilePath": string,
  "username": string,
  "password": string,
  "connectRetryInterval": integer,
  "masterHeartbeatPeriod": string,
  "caCertificate": string,
  "clientCertificate": string,
  "clientKey": string,
  "sslCipher": string,
  "verifyServerCertificate": boolean,
  "kind": string
}
Campos
dumpFilePath

string

Es la ruta de acceso a un archivo de volcado de SQL en Google Cloud Storage desde el que se creará la instancia de réplica. El URI tiene el formato gs://bucketName/fileName. También se admiten archivos gzip comprimidos (.gz). Los volcados tienen las coordenadas del registro binario desde el que comienza la replicación. Para ello, configura --master-data en 1 cuando uses mysqldump.

username

string

Es el nombre de usuario para la conexión de replicación.

password

string

Es la contraseña de la conexión de replicación.

connectRetryInterval

integer

Cantidad de segundos que se deben esperar entre los reintentos de conexión. El valor predeterminado de MySQL es de 60 segundos.

masterHeartbeatPeriod

string (Int64Value format)

Es el intervalo en milisegundos entre los latidos de replicación.

caCertificate

string

Representación PEM del certificado x509 de CA de confianza.

clientCertificate

string

Representación PEM del certificado x509 de la réplica.

clientKey

string

Representación PEM de la clave privada de la réplica. La clave pública correspondiente está codificada en el certificado del cliente.

sslCipher

string

Es una lista de algoritmos de cifrado permitidos para la encriptación SSL.

verifyServerCertificate

boolean

Indica si se debe verificar el valor del nombre común de la instancia principal en el certificado que envía durante el protocolo de enlace de SSL.

kind

string

Siempre es sql#mysqlReplicaConfiguration.

DiskEncryptionConfiguration

Representación JSON
{
  "kmsKeyName": string,
  "kind": string
}
Campos
kmsKeyName

string

Nombre del recurso de la clave KMS para la encriptación del disco.

kind

string

Siempre es sql#diskEncryptionConfiguration.

DiskEncryptionStatus

Representación JSON
{
  "kmsKeyVersionName": string,
  "kind": string
}
Campos
kmsKeyVersionName

string

Versión de la clave de KMS que se usó para encriptar el recurso de la instancia de Cloud SQL

kind

string

Siempre es sql#diskEncryptionStatus.

SqlScheduledMaintenance

Representación 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.
}
Campos
startTime

string (Timestamp format)

Es la hora de inicio de cualquier mantenimiento programado próximo para esta instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "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 si se puede reprogramar el mantenimiento programado.

Campo de unión _schedule_deadline_time.

_schedule_deadline_time puede ser una de las siguientes opciones:

scheduleDeadlineTime

string (Timestamp format)

El mantenimiento no se puede reprogramar para que comience después de esta fecha límite.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

SqlOutOfDiskReport

Representación 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.
}
Campos

Campo de unión _sql_out_of_disk_state.

_sql_out_of_disk_state puede ser una de las siguientes opciones:

sqlOutOfDiskState

enum (SqlOutOfDiskState)

Este campo representa el estado generado por el trabajo de mantenimiento proactivo de la base de datos para los problemas de OutOfDisk. * Escritores: * El trabajo proactivo de estado de la base de datos para OOD. * Lectores: * El trabajo proactivo de estado de la base de datos

Campo de unión _sql_min_recommended_increase_size_gb.

_sql_min_recommended_increase_size_gb puede ser una de las siguientes opciones:

sqlMinRecommendedIncreaseSizeGb

integer

Tamaño de aumento mínimo recomendado en gigabytes. El frontend y el trabajo proactivo de estado de la base de datos para OOD consumen este campo. * Lectores:

AvailableDatabaseVersion

Representación 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.
}
Campos

Campo de unión _major_version.

_major_version puede ser una de las siguientes opciones:

majorVersion

string

Es el nombre de la versión principal de la versión.

Campo de unión _name.

_name puede ser una de las siguientes opciones:

name

string

Es el nombre de la versión de la base de datos. Para MySQL 8.0, esta cadena proporciona la versión principal y secundaria de la base de datos.

Campo de unión _display_name.

_display_name puede ser una de las siguientes opciones:

displayName

string

Es el nombre visible de la versión de la base de datos.

ReplicationCluster

Representación JSON
{
  "psaWriteEndpoint": string,
  "failoverDrReplicaName": string,
  "drReplica": boolean
}
Campos
psaWriteEndpoint

string

Solo salida. Si se configura, este campo indica que esta instancia tiene un extremo de DNS de acceso a servicios privados (PSA) que apunta a la instancia principal del clúster. Si esta instancia es la principal, el extremo de DNS apunta a ella. Después de una operación de cambio o conmutación por error de réplica, este extremo de DNS apunta a la instancia promovida. Este es un campo de solo lectura que se devuelve al usuario como información. Este campo puede existir incluso si una instancia independiente aún no tiene una réplica de DR o si se borró la réplica de DR.

failoverDrReplicaName

string

Es opcional. Si la instancia es principal, este campo identifica la réplica de recuperación ante desastres (DR). Una réplica de DR es una configuración opcional para las instancias de la edición Enterprise Plus. Si la instancia es una réplica de lectura, el campo no se establece. Establece este campo en un nombre de réplica para designar una réplica de DR para una instancia principal. Quita el nombre de la réplica para quitar la designación de réplica de DR.

drReplica

boolean

Solo salida. Es un campo de solo lectura que indica si la réplica es una réplica de DR. Este campo no se establece si la instancia es principal.

GeminiInstanceConfig

Representación 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.
}
Campos

Campo de unión _entitled.

_entitled puede ser una de las siguientes opciones:

entitled

boolean

Solo salida. Indica si Gemini está habilitado.

Campo de unión _google_vacuum_mgmt_enabled.

_google_vacuum_mgmt_enabled puede ser una de las siguientes opciones:

googleVacuumMgmtEnabled

boolean

Solo salida. Indica si la administración de la aspiradora está habilitada.

Campo de unión _oom_session_cancel_enabled.

_oom_session_cancel_enabled puede ser una de las siguientes opciones:

oomSessionCancelEnabled

boolean

Solo salida. Indica si está habilitada la cancelación de la sesión de memoria insuficiente (OOM).

Campo de unión _active_query_enabled.

_active_query_enabled puede ser una de las siguientes opciones:

activeQueryEnabled

boolean

Solo salida. Indica si la búsqueda activa está habilitada.

Campo de unión _index_advisor_enabled.

_index_advisor_enabled puede ser una de las siguientes opciones:

indexAdvisorEnabled

boolean

Solo salida. Indica si el asesor de índices está habilitado.

Campo de unión _flag_recommender_enabled.

_flag_recommender_enabled puede ser una de las siguientes opciones:

flagRecommenderEnabled

boolean

Solo salida. Indica si el recomendador de marcas está habilitado.

TagsEntry

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

PoolNodeConfig

Representación 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.
}
Campos
ipAddresses[]

object (IpMapping)

Solo salida. Son asignaciones que contienen direcciones IP que se pueden usar para conectarse al nodo del grupo de lectura.

dnsNames[]

object (DnsNameMapping)

Solo salida. Es la lista de nombres de DNS que usa este nodo del grupo de lectura.

pscAutoConnections[]

object (PscAutoConnectionConfig)

Solo salida. Es la lista de parámetros de configuración para los extremos de consumidor de Private Service Connect (PSC) solicitados y configurados automáticamente que se pueden usar para conectarse a este nodo de grupo de lectura.

Campo de unión _name.

_name puede ser una de las siguientes opciones:

name

string

Solo salida. Nombre del nodo del grupo de lectura, que se usará para recuperar métricas y registros.

Campo de unión _gce_zone.

_gce_zone puede ser una de las siguientes opciones:

gceZone

string

Solo salida. Es la zona del nodo del grupo de lectura.

Campo de unión _dns_name.

_dns_name puede ser una de las siguientes opciones:

dnsName

string

Solo salida. Es el nombre de DNS del nodo del grupo de lectura.

Campo de unión _state.

_state puede ser una de las siguientes opciones:

state

enum (SqlInstanceState)

Solo salida. Es el estado actual del nodo del grupo de lectura.

Campo de unión _psc_service_attachment_link.

_psc_service_attachment_link puede ser una de las siguientes opciones:

pscServiceAttachmentLink

string

Solo salida. Es el adjunto del servicio de Private Service Connect (PSC) del nodo del grupo de lectura.

DnsNameMapping

Representación JSON
{
  "name": string,
  "connectionType": enum (ConnectionType),
  "dnsScope": enum (DnsScope),
  "recordManager": enum (RecordManager)
}
Campos
name

string

Solo salida. Es el nombre de DNS.

connectionType

enum (ConnectionType)

Solo salida. Es el tipo de conexión del nombre de DNS.

dnsScope

enum (DnsScope)

Solo salida. Es el alcance al que se aplica el nombre de DNS.

recordManager

enum (RecordManager)

Solo salida. Es el administrador de este registro DNS.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌