MCP Tools Reference: cloud-sql

도구: get_instance

Cloud SQL 인스턴스의 세부정보를 가져옵니다.

다음 샘플은 curl를 사용하여 get_instance MCP 도구를 호출하는 방법을 보여줍니다.

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

입력 스키마

인스턴스 가져오기 요청입니다.

SqlInstancesGetRequest

JSON 표현 
{
  "instance": string,
  "project": string
}
필드
instance

string

필수 항목입니다. 데이터베이스 인스턴스 ID입니다. 여기에는 프로젝트 ID가 포함되지 않습니다.
project

string

필수 항목입니다. 인스턴스가 포함된 프로젝트의 프로젝트 ID입니다.

출력 스키마

Cloud SQL 인스턴스 리소스

DatabaseInstance

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.
}
필드
kind

string

항상 sql#instance입니다.
state

enum (SqlInstanceState)

Cloud SQL 인스턴스의 현재 제공 상태.
databaseVersion

enum (SqlDatabaseVersion)

데이터베이스 엔진 유형 및 버전. databaseVersion 필드는 인스턴스를 만든 후에는 변경할 수 없습니다.
settings

object (Settings)

사용자 설정입니다.
etag

string

이 필드는 지원 중단되었으며 이후 버전의 API에서 제거됩니다. 대신 settings.settingsVersion 필드를 사용하세요.
failoverReplica

object (SqlFailoverReplica)

장애 조치 복제본의 이름과 상태입니다.
masterInstanceName

string

복제본 설정에서 기본 역할을 할 인스턴스의 이름입니다.
replicaNames[]

string

인스턴스의 복제본입니다.
maxDiskSize
(deprecated)

string (Int64Value format)

인스턴스의 최대 디스크 크기(바이트)입니다.
currentDiskSize
(deprecated)

string (Int64Value format)

인스턴스의 현재 디스크 사용량(바이트)입니다. 이 속성은 지원 중단되었습니다. 대신 Cloud Monitoring API에서 'cloudsql.googleapis.com/database/disk/bytes_used' 측정항목을 사용하세요. 자세한 내용은 공지 사항을 참조하세요.
ipAddresses[]

object (IpMapping)

인스턴스에 할당된 IP 주소입니다.
serverCaCert

object (SslCert)

SSL 구성
instanceType

enum (SqlInstanceType)

인스턴스 유형입니다.
project

string

Cloud SQL 인스턴스가 포함된 프로젝트의 프로젝트 ID입니다. 해당하는 경우 Google 앱 도메인이 프리픽스로 지정됩니다.
ipv6Address
(deprecated)

string

인스턴스에 할당된 IPv6 주소입니다. (지원 중단됨) 이 속성은 1세대 인스턴스에만 적용되었습니다.
serviceAccountEmailAddress

string

인스턴스에 할당된 서비스 계정 이메일 주소입니다.\이 속성은 읽기 전용입니다.
onPremisesConfiguration

object (OnPremisesConfiguration)

온프레미스 인스턴스와 관련된 구성입니다.
replicaConfiguration

object (ReplicaConfiguration)

장애 조치 복제본 및 읽기 복제본과 관련된 구성입니다.
backendType

enum (SqlBackendType)

백엔드 유형입니다. SECOND_GEN: Cloud SQL 데이터베이스 인스턴스입니다. EXTERNAL: Google에서 관리하지 않는 데이터베이스 서버입니다.

이 속성은 읽기 전용입니다. settings 객체의 tier 속성을 사용하여 데이터베이스 유형을 확인하세요.
selfLink

string

이 리소스의 URI입니다.
suspensionReason[]

enum (SqlSuspensionReason)

인스턴스 상태가 SUSPENDED인 경우 정지 이유입니다.
connectionName

string

연결 문자열에 사용된 Cloud SQL 인스턴스의 연결 이름입니다.
name

string

Cloud SQL 인스턴스의 이름입니다. 여기에는 프로젝트 ID가 포함되지 않습니다.
region

string

Cloud SQL 인스턴스의 지리적 리전입니다.

Cloud SQL이 운영되는 리전 중 하나일 수 있습니다.

예를 들면 asia-east1, europe-west1, us-central1입니다. 기본값은 us-central1입니다.
gceZone

string

인스턴스가 현재 제공되고 있는 Compute Engine 영역입니다. 이 값은 인스턴스가 보조 영역으로 장애 조치된 경우 인스턴스를 만들 때 지정된 영역과 다를 수 있습니다. 경고: 이 값을 변경하면 인스턴스가 다시 시작될 수 있습니다.
secondaryGceZone

string

장애 조치 인스턴스가 현재 제공되고 있는 Compute Engine 영역입니다(리전 인스턴스의 경우). 이 값은 인스턴스가 보조/장애 조치 영역으로 장애 조치된 경우 인스턴스를 만들 때 지정된 영역과 다를 수 있습니다.
diskEncryptionConfiguration

object (DiskEncryptionConfiguration)

인스턴스의 디스크 암호화 구성입니다.
diskEncryptionStatus

object (DiskEncryptionStatus)

인스턴스의 디스크 암호화 상태입니다.
rootPassword

string

초기 루트 비밀번호입니다. 생성 시에만 사용됩니다. PostgreSQL 인스턴스에 연결하려면 먼저 루트 비밀번호를 설정해야 합니다.
scheduledMaintenance

object (SqlScheduledMaintenance)

이 인스턴스에 예정된 유지보수의 시작 시간입니다.
satisfiesPzs

boolean

이 상태는 인스턴스가 PZS를 충족하는지 여부를 나타냅니다.

이 상태는 나중에 사용하도록 예약되어 있습니다.
databaseInstalledVersion

string

출력 전용입니다. MYSQL_8_0_18과 같은 부 버전을 포함하여 인스턴스에서 실행 중인 현재 데이터베이스 버전을 저장합니다.
createTime

string (Timestamp format)

출력 전용입니다. 인스턴스가 생성된 시간입니다(RFC 3339 형식, 예: 2012-11-15T16:19:00.094Z).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
availableMaintenanceVersions[]

string

출력 전용입니다. 인스턴스에 적용할 수 있는 모든 유지보수 버전 나열
maintenanceVersion

string

인스턴스의 현재 소프트웨어 버전입니다.
upgradableDatabaseVersions[]

object (AvailableDatabaseVersion)

출력 전용입니다. 업그레이드할 수 있는 모든 데이터베이스 버전입니다.
replicationCluster

object (ReplicationCluster)

선택사항입니다. 기본 인스턴스와 재해 복구 (DR) 복제본 쌍입니다. DR 복제본은 기본 인스턴스에 리전 장애가 발생하는 경우 장애 조치를 위해 지정하는 리전 간 복제본입니다. MySQL 및 PostgreSQL에 적용됩니다.
satisfiesPzi

boolean

출력 전용입니다. 이 상태는 인스턴스가 PZI를 충족하는지 여부를 나타냅니다.

이 상태는 나중에 사용하도록 예약되어 있습니다.
tags

map (key: string, value: string)

선택사항입니다. 입력 전용입니다. 변경할 수 없습니다. 이 인스턴스에 바인딩된 태그 키와 태그 값입니다. 지도에 있는 각 항목을 "<tag-key-namespaced-name>" : "<tag-value-short-name>"로 나타내야 합니다.

예를 들어 단일 리소스에 다음 태그가 있을 수 있습니다.

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

태그 생성 및 관리에 대한 자세한 내용은 https://cloud.google.com/resource-manager/docs/tags/tags-overview를 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
nodes[]

object (PoolNodeConfig)

출력 전용입니다. 읽기 풀의 각 읽기 풀 노드에 관한 정보가 포함된 항목입니다.
dnsNames[]

object (DnsNameMapping)

출력 전용입니다. 이 인스턴스에서 사용되는 DNS 이름 목록입니다.

통합 필드 _out_of_disk_report.

_out_of_disk_report는 다음 중 하나여야 합니다.
outOfDiskReport

object (SqlOutOfDiskReport)

이 필드는 디스크 부족 문제에 대한 사전 데이터베이스 웰니스 작업에서 생성된 보고서를 나타냅니다. * 작성자: * OOD의 사전 데이터베이스 웰니스 작업 * 리더: * 사전 대응 데이터베이스 웰니스 작업

통합 필드 _sql_network_architecture.

_sql_network_architecture는 다음 중 하나여야 합니다.
sqlNetworkArchitecture

enum (SqlNetworkArchitecture)

통합 필드 _psc_service_attachment_link.

_psc_service_attachment_link는 다음 중 하나여야 합니다.
pscServiceAttachmentLink

string

출력 전용입니다. PSC 인스턴스의 서비스 연결 링크입니다.

통합 필드 _dns_name.

_dns_name는 다음 중 하나여야 합니다.
dnsName

string

출력 전용입니다. 인스턴스의 DNS 이름입니다.

통합 필드 _primary_dns_name.

_primary_dns_name는 다음 중 하나여야 합니다.
primaryDnsName
(deprecated)

string

출력 전용입니다. 지원 중단되었습니다. 대신 write_endpoint를 사용하세요.

통합 필드 _write_endpoint.

_write_endpoint는 다음 중 하나여야 합니다.
writeEndpoint

string

출력 전용입니다. 복제 그룹의 기본 인스턴스의 DNS 이름입니다.

통합 필드 _gemini_config.

_gemini_config는 다음 중 하나여야 합니다.
geminiConfig

object (GeminiInstanceConfig)

Gemini 인스턴스 구성입니다.

통합 필드 _switch_transaction_logs_to_cloud_storage_enabled.

_switch_transaction_logs_to_cloud_storage_enabled는 다음 중 하나여야 합니다.
switchTransactionLogsToCloudStorageEnabled

boolean

입력 전용입니다. Cloud SQL이 데이터 디스크에서 Cloud Storage로 특정 시점 복구 로그 파일의 저장소를 전환하도록 사용 설정되어 있는지 여부입니다.

통합 필드 _include_replicas_for_major_version_upgrade.

_include_replicas_for_major_version_upgrade는 다음 중 하나여야 합니다.
includeReplicasForMajorVersionUpgrade

boolean

입력 전용입니다. 기본 인스턴스의 인플레이스 메이저 버전 업그레이드가 시작될 때 복제본의 인플레이스 메이저 버전 업그레이드가 발생하는지 여부를 결정합니다.

통합 필드 _node_count.

_node_count는 다음 중 하나여야 합니다.
nodeCount

integer

읽기 풀의 읽기 풀 노드 수입니다.

설정

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.
}
필드
settingsVersion

string (Int64Value format)

인스턴스 설정의 버전입니다. 동시 업데이트가 올바르게 처리되도록 업데이트 메서드에 필요한 필드입니다. 업데이트 중에 이 인스턴스의 가장 최근 settingsVersion 값을 사용하고 이 값을 업데이트하려고 하지 마세요.
authorizedGaeApplications[]
(deprecated)

string

이 인스턴스에 액세스할 수 있는 App Engine 앱 ID입니다. (지원 중단됨) 1세대 인스턴스에만 적용됩니다.
tier

string

이 인스턴스의 등급 또는 머신 유형입니다 (예: db-custom-1-3840). 경고: 이 값을 변경하면 인스턴스가 다시 시작됩니다.
kind

string

항상 sql#settings입니다.
userLabels

map (key: string, value: string)

각 라벨이 단일 키-값 쌍인 사전으로 표시된 사용자 제공 라벨입니다.

"key": value 쌍 목록이 포함된 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
availabilityType

enum (SqlAvailabilityType)

가용성 유형입니다. 가능한 값: * ZONAL: 인스턴스가 하나의 영역에서만 데이터를 제공합니다. 해당 영역의 서비스 중단은 데이터 액세스 가능성에 영향을 미칩니다. * REGIONAL: 인스턴스가 리전의 두 개 이상의 영역에서 데이터를 제공할 수 있습니다 (고가용성).

자세한 내용은 고가용성 구성 개요를 참고하세요.
pricingPlan

enum (SqlPricingPlan)

이 인스턴스의 요금제입니다. PER_USE 또는 PACKAGE일 수 있습니다. 2세대 인스턴스에는 PER_USE만 지원됩니다.
replicationType
(deprecated)

enum (SqlReplicationType)

이 인스턴스에서 사용하는 복제 유형입니다. ASYNCHRONOUS 또는 SYNCHRONOUS일 수 있습니다. (지원 중단됨) 이 속성은 1세대 인스턴스에만 적용되었습니다.
storageAutoResizeLimit

string (Int64Value format)

스토리지 용량이 자동으로 증가할 수 있는 최대 크기입니다. 기본값은 0이며, 이는 한도가 없음을 나타냅니다.
activationPolicy

enum (SqlActivationPolicy)

활성화 정책은 인스턴스가 활성화되는 시점을 지정합니다. 인스턴스 상태가 RUNNABLE인 경우에만 적용됩니다. 유효한 값: * ALWAYS: 인스턴스가 활성 상태이며 연결 요청이 없어도 계속 유지됩니다. * NEVER: 인스턴스가 비활성 상태이며 연결 요청이 전송되어도 활성화되지 않습니다.
ipConfiguration

object (IpConfiguration)

IP 관리 설정입니다. 이를 통해 인스턴스 IP를 사용 설정 또는 중지하고 인스턴스에 연결할 수 있는 외부 네트워크를 관리할 수 있습니다. 2세대 인스턴스의 경우 IPv4 주소를 사용 중지할 수 없습니다.
storageAutoResize

boolean

스토리지 크기를 자동으로 늘리기 위한 구성입니다. 기본값은 true입니다.
locationPreference

object (LocationPreference)

위치 환경설정입니다. 이 설정을 통해 인스턴스를 App Engine 앱 또는 Compute Engine 영역에 최대한 가깝게 배치하여 성능을 높일 수 있습니다. App Engine 코로케이션은 1세대 인스턴스에만 적용되었습니다.
databaseFlags[]

object (DatabaseFlags)

시작 시 인스턴스에 전달되는 데이터베이스 플래그입니다.
dataDiskType

enum (SqlDataDiskType)

데이터 디스크 유형: PD_SSD (기본값) 또는 PD_HDD입니다. 1세대 인스턴스에는 사용되지 않습니다.
maintenanceWindow

object (MaintenanceWindow)

이 인스턴스의 유지보수 기간입니다. 유지보수를 위해 인스턴스를 다시 시작할 수 있는 시기를 지정합니다.
backupConfiguration

object (BackupConfiguration)

인스턴스의 일일 백업 구성입니다.
databaseReplicationEnabled

boolean

복제본 인스턴스를 읽기 위한 특정 구성입니다. 복제 사용 설정 여부를 나타냅니다. 경고: 이 값을 변경하면 인스턴스가 다시 시작됩니다.
crashSafeReplicationEnabled
(deprecated)

boolean

복제본 인스턴스를 읽기 위한 특정 구성입니다. 비정상 종료 방지 복제를 위한 데이터베이스 플래그가 사용 설정되어 있는지 나타냅니다. 이 속성은 1세대 인스턴스에만 적용되었습니다.
dataDiskSizeGb

string (Int64Value format)

데이터 디스크의 크기(GB)입니다. 데이터 디스크 크기 최소값은 10GB입니다.
activeDirectoryConfig

object (SqlActiveDirectoryConfig)

Active Directory 구성입니다. SQL Server용 Cloud SQL에만 관련이 있습니다.
collation

string

서버 인스턴스 데이터 정렬의 이름입니다.
denyMaintenancePeriods[]

object (DenyMaintenancePeriod)

유지보수 거부 기간
insightsConfig

object (InsightsConfig)

통계 구성(현재는 Postgres에만 관련됨)
passwordValidationPolicy

object (PasswordValidationPolicy)

인스턴스의 로컬 사용자 비밀번호 유효성 검사 정책입니다.
sqlServerAuditConfig

object (SqlServerAuditConfig)

SQL Server 관련 감사 구성입니다.
edition

enum (Edition)

선택사항입니다. 인스턴스의 버전입니다.
connectorEnforcement

enum (ConnectorEnforcement)

연결에서 Cloud SQL 커넥터를 사용해야 하는지 여부를 지정합니다. 옵션 값에는 NOT_REQUIRED (Cloud SQL 커넥터 없이 Cloud SQL 인스턴스에 연결할 수 있음) 및 REQUIRED (Cloud SQL 커넥터를 사용하는 연결만 허용)이 포함됩니다.

REQUIRED를 사용하면 기존의 모든 승인된 네트워크가 사용 중지됩니다. 새 인스턴스를 만들 때 이 필드를 지정하지 않으면 NOT_REQUIRED가 사용됩니다. 기존 인스턴스를 패치하거나 업데이트할 때 이 필드를 지정하지 않으면 인스턴스에서 변경되지 않습니다.
deletionProtectionEnabled

boolean

실수로 인한 인스턴스 삭제를 방지하기 위한 구성입니다.
timeZone

string

서버 시간대입니다. SQL Server용 Cloud SQL에만 관련이 있습니다.
advancedMachineFeatures

object (AdvancedMachineFeatures)

SQL Server에만 관련된 인스턴스의 고급 머신 구성을 지정합니다.
dataCacheConfig

object (DataCacheConfig)

데이터 캐시 구성입니다.
replicationLagMaxSeconds

integer

선택사항입니다. 특정 복제 지연 후 복제본 재생성을 위한 구성 값
enableGoogleMlIntegration

boolean

선택사항입니다. 이 매개변수가 true로 설정되면 Cloud SQL 인스턴스가 Vertex AI에 연결하여 실시간 예측 및 통계 요청을 AI에 전달할 수 있습니다. 기본값은 false입니다. MySQL용 Cloud SQL 및 PostgreSQL용 Cloud SQL 인스턴스에만 적용됩니다.
enableDataplexIntegration

boolean

선택사항입니다. 기본적으로 Cloud SQL 인스턴스에서는 Dataplex의 스키마 추출이 사용 중지되어 있습니다. 이 매개변수가 true로 설정되면 Cloud SQL 인스턴스에서 Dataplex의 스키마 추출이 활성화됩니다.
retainBackupsOnDelete

boolean

선택사항입니다. 이 매개변수가 true로 설정되면 인스턴스가 삭제된 후에도 Cloud SQL에서 인스턴스의 백업을 보관합니다. ON_DEMAND 백업은 고객이 백업 또는 프로젝트를 삭제할 때까지 유지됩니다. 자동 백업은 백업 보관 설정에 따라 보관됩니다.
entraidConfig

object (SqlServerEntraIdConfig)

선택사항입니다. SQL Server 인스턴스의 Microsoft Entra ID 구성입니다.
performanceCaptureConfig

object (PerformanceCaptureConfig)

선택사항입니다. 성능 캡처 구성으로, 부하가 높은 상황에서 진단 측정항목을 제공합니다.

통합 필드 _data_disk_provisioned_iops.

_data_disk_provisioned_iops는 다음 중 하나여야 합니다.
dataDiskProvisionedIops

string (int64 format)

선택사항입니다. 데이터 디스크에 프로비저닝된 초당 I/O 작업 수입니다. 이 필드는 hyperdisk-balanced 디스크 유형에만 사용됩니다.

통합 필드 _data_disk_provisioned_throughput.

_data_disk_provisioned_throughput는 다음 중 하나여야 합니다.
dataDiskProvisionedThroughput

string (int64 format)

선택사항입니다. 데이터 디스크에 대해 프로비저닝된 처리량(MiB/s)입니다. 이 필드는 hyperdisk-balanced 디스크 유형에만 사용됩니다.

통합 필드 _connection_pool_config.

_connection_pool_config는 다음 중 하나여야 합니다.
connectionPoolConfig

object (ConnectionPoolConfig)

선택사항입니다. 인스턴스의 관리형 연결 풀링 구성입니다.

통합 필드 _final_backup_config.

_final_backup_config는 다음 중 하나여야 합니다.
finalBackupConfig

object (FinalBackupConfig)

선택사항입니다. 인스턴스의 최종 백업 구성입니다.

통합 필드 _read_pool_auto_scale_config.

_read_pool_auto_scale_config는 다음 중 하나여야 합니다.
readPoolAutoScaleConfig

object (ReadPoolAutoScaleConfig)

선택사항입니다. 인스턴스의 읽기 풀 자동 확장 구성입니다.

통합 필드 _auto_upgrade_enabled.

_auto_upgrade_enabled는 다음 중 하나여야 합니다.
autoUpgradeEnabled

boolean

선택사항입니다. MySQL용 Cloud SQL 자동 업그레이드 구성입니다. 이 매개변수가 true로 설정되면 MySQL 8.0 부 버전의 자동 업그레이드가 사용 설정됩니다. MySQL 버전은 8.0.35 이상이어야 합니다.

통합 필드 _data_api_access.

_data_api_access는 다음 중 하나여야 합니다.
dataApiAccess

enum (DataApiAccess)

이 매개변수는 ExecuteSql API를 사용하여 인스턴스에 연결하도록 허용할지 여부를 제어합니다. 기본적으로 허용되지 않습니다.

Int64Value

JSON 표현 
{
  "value": string
}
필드
value

string (int64 format)

int64 값입니다.

UserLabelsEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

IpConfiguration

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.
}
필드
ipv4Enabled

boolean

인스턴스에 공개 IP 주소가 할당되었는지 여부입니다.
privateNetwork

string

비공개 IP에서 Cloud SQL 인스턴스에 액세스할 수 있는 VPC 네트워크의 리소스 링크입니다. 예를 들면 /projects/myProject/global/networks/default입니다. 이 설정은 업데이트할 수 있지만 설정 후에는 삭제할 수 없습니다.
requireSsl

boolean

대신 ssl_mode를 사용하세요.

IP를 통한 SSL/TLS 연결의 적용 여부입니다. false로 설정하면 비SSL/비TLS 및 SSL/TLS 연결을 모두 허용합니다. SSL/TLS 연결의 경우 클라이언트 인증서가 확인되지 않습니다. true로 설정하면 SSL/TLS 및 유효한 클라이언트 인증서로 암호화된 연결만 허용합니다. 유효한 클라이언트 인증서 요구사항을 적용하지 않고 SSL/TLS를 적용하려면 require_ssl 플래그 대신 ssl_mode 플래그를 사용하세요.
authorizedNetworks[]

object (AclEntry)

IP를 사용하여 인스턴스에 연결할 수 있는 외부 네트워크의 목록입니다. 'CIDR' 표기법('슬래시' 표기법이라고도 함)(예: 157.197.200.0/24)
allocatedIpRange

string

비공개 IP Cloud SQL 인스턴스에 할당된 IP 범위의 이름입니다. 예: 'google-managed-services-default' 설정된 경우 인스턴스 IP가 할당된 범위에 생성됩니다. 범위 이름은 RFC 1035를 준수해야 합니다. 특히 이름은 1~63자(영문 기준)여야 하며 정규 표현식 [a-z]([-a-z0-9]*[a-z0-9])?.와 일치해야 합니다.
enablePrivatePathForGoogleCloudServices

boolean

BigQuery와 같은 Google 서비스에서 비공개 IP 인스턴스로의 연결을 제어합니다.
sslMode

enum (SslMode)

데이터베이스 연결에서 SSL/TLS가 적용되는 방식을 지정합니다. 이전 버전과의 호환성을 위해 require_ssl 플래그를 사용해야 하는 경우 다음 값 쌍만 유효합니다.

PostgreSQL 및 MySQL의 경우:

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

SQL Server의 경우:

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

ssl_mode 값이 require_ssl 값보다 우선합니다.

예를 들어 ssl_mode=ENCRYPTED_ONLY 및 require_ssl=false 쌍의 경우 ssl_mode=ENCRYPTED_ONLY는 SSL 연결만 허용한다는 의미이고 require_ssl=false는 비SSL 연결과 SSL 연결을 모두 허용한다는 의미입니다. 이 경우 MySQL 및 PostgreSQL 데이터베이스는 ssl_mode를 준수하고 SSL 연결만 허용합니다.
customSubjectAlternativeNames[]

string

선택사항입니다. Cloud SQL 인스턴스의 맞춤 주체 대체 이름(SAN)입니다.

통합 필드 _psc_config.

_psc_config는 다음 중 하나여야 합니다.
pscConfig

object (PscConfig)

이 인스턴스의 PSC 설정입니다.

통합 필드 _server_ca_mode.

_server_ca_mode는 다음 중 하나여야 합니다.
serverCaMode

enum (CaMode)

서버 인증서에 사용되는 CA 유형을 지정합니다.

통합 필드 _server_ca_pool.

_server_ca_pool는 다음 중 하나여야 합니다.
serverCaPool

string

선택사항입니다. CUSTOMER_MANAGED_CAS_CA이 server_ca_mode인 인스턴스의 서버 CA 풀 리소스 이름입니다. 형식: projects/{PROJECT}/locations/{REGION}/caPools/{CA_POOL_ID}

통합 필드 _server_certificate_rotation_mode.

_server_certificate_rotation_mode는 다음 중 하나여야 합니다.
serverCertificateRotationMode

enum (ServerCertificateRotationMode)

선택사항입니다. 자동 서버 인증서 순환 기능을 제어합니다. 이 기능은 기본적으로 사용 중지되어 있습니다. 사용 설정하면 서버 인증서가 만료되기 최대 6개월 전에 Cloud SQL 예약 유지보수 또는 셀프 서비스 유지보수 업데이트 중에 자동으로 순환됩니다. 이 설정은 server_ca_mode가 GOOGLE_MANAGED_CAS_CA 또는 CUSTOMER_MANAGED_CAS_CA인 경우에만 설정할 수 있습니다.

BoolValue

JSON 표현 
{
  "value": boolean
}
필드
value

boolean

불리언 값입니다.

AclEntry

JSON 표현 
{
  "value": string,
  "expirationTime": string,
  "name": string,
  "kind": string
}
필드
value

string

액세스 제어 목록에 허용된 값입니다.
expirationTime

string (Timestamp format)

이 액세스 제어 항목이 RFC 3339 형식으로 만료되는 시간입니다(예: 2012-11-15T16:19:00.094Z).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
name

string

선택사항입니다. 이 항목을 식별하는 라벨입니다.
kind

string

항상 sql#aclEntry입니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

PscConfig

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.
}
필드
allowedConsumerProjects[]

string

선택사항입니다. 이 인스턴스에 대한 PSC 연결에 대해 허용 목록에 추가된 소비자 프로젝트 목록입니다. 이 인스턴스는 이러한 프로젝트의 모든 네트워크에서 PSC를 사용하여 연결할 수 있습니다.

이 목록의 각 소비자 프로젝트는 프로젝트 번호 (숫자) 또는 프로젝트 ID (영숫자)로 표시될 수 있습니다.
pscAutoConnections[]

object (PscAutoConnectionConfig)

선택사항입니다. 이 Cloud SQL 인스턴스에 연결하는 데 사용할 수 있는 요청된 Private Service Connect 소비자 엔드포인트의 설정 목록입니다.
networkAttachmentUri

string

선택사항입니다. Private Service Connect 지원 Cloud SQL 인스턴스가 PSC 인터페이스를 통해 연결하도록 승인된 소비자 네트워크의 네트워크 연결입니다. 형식: projects/PROJECT/regions/REGION/networkAttachments/ID

통합 필드 _psc_enabled.

_psc_enabled는 다음 중 하나여야 합니다.
pscEnabled

boolean

이 인스턴스에 PSC 연결이 사용 설정되어 있는지 여부입니다.

PscAutoConnectionConfig

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.
}
필드
consumerProject

string

선택사항입니다. 이 소비자 엔드포인트의 소비자 서비스 프로젝트의 프로젝트 ID입니다.

선택사항입니다. 이는 consumer_network가 공유 VPC 네트워크인 경우에만 적용됩니다.
consumerNetwork

string

선택사항입니다. 이 소비자 엔드포인트의 소비자 네트워크입니다. 호스트 프로젝트와 네트워크 이름이 모두 포함된 리소스 경로여야 합니다.

예를 들면 projects/project1/global/networks/network1입니다.

이 네트워크의 소비자 호스트 프로젝트는 소비자 서비스 프로젝트와 다를 수 있습니다.

통합 필드 _ip_address.

_ip_address는 다음 중 하나여야 합니다.
ipAddress

string

소비자 엔드포인트의 IP 주소입니다.

통합 필드 _status.

_status는 다음 중 하나여야 합니다.
status

string

소비자 엔드포인트의 연결 상태입니다.

통합 필드 _consumer_network_status.

_consumer_network_status는 다음 중 하나여야 합니다.
consumerNetworkStatus

string

소비자 네트워크의 연결 정책 상태입니다.

LocationPreference

JSON 표현 
{
  "followGaeApplication": string,
  "zone": string,
  "secondaryZone": string,
  "kind": string
}
필드
followGaeApplication
(deprecated)

string

팔로우할 App Engine 애플리케이션은 Cloud SQL 인스턴스와 동일한 리전에 있어야 합니다. 경고: 이 값을 변경하면 인스턴스가 다시 시작될 수 있습니다.
zone

string

선호하는 Compute Engine 영역 (예: us-central1-a, us-central1-b 등) 경고: 이 값을 변경하면 인스턴스가 다시 시작될 수 있습니다.
secondaryZone

string

보조/장애 조치용으로 선호하는 Compute Engine 영역 (예: us-central1-a, us-central1-b 등) 이 필드를 사용 중지하려면 'no_secondary_zone'으로 설정하세요.
kind

string

항상 sql#locationPreference입니다.

DatabaseFlags

JSON 표현 
{
  "name": string,
  "value": string
}
필드
name

string

플래그의 이름입니다. 이러한 플래그는 인스턴스 시작 시 전달되므로 서버 옵션과 시스템 변수를 모두 포함하세요. 플래그는 하이픈이 아닌 밑줄로 지정됩니다. 자세한 내용은 Cloud SQL 문서의 데이터베이스 플래그 구성을 참고하세요.
value

string

플래그 값입니다. 불리언 플래그는 true의 경우 on, false의 경우 off로 설정됩니다. 플래그에 값이 사용되지 않는 경우 이 필드는 생략해야 합니다.

MaintenanceWindow

JSON 표현 
{
  "hour": integer,
  "day": integer,
  "updateTrack": enum (SqlUpdateTrack),
  "kind": string
}
필드
hour

integer

시간(0~23 사이) UTC 시간대로 지정합니다.
day

integer

요일 - MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY UTC 시간대로 지정합니다. 1이 월요일인 경우 1~7의 정수로 출력에 반환됩니다.
updateTrack

enum (SqlUpdateTrack)

유지보수 시점 설정: canary, stable 또는 week5 자세한 내용은 Cloud SQL 인스턴스의 유지보수 정보를 참고하세요.
kind

string

항상 sql#maintenanceWindow입니다.

Int32Value

JSON 표현 
{
  "value": integer
}
필드
value

integer

int32 값입니다.

BackupConfiguration

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.
}
필드
startTime

string

UTC 시간대의 일일 백업 구성 시작 시간(HH:MM)
enabled

boolean

이 구성이 사용 설정되었는지 여부입니다.
kind

string

항상 sql#backupConfiguration입니다.
binaryLogEnabled

boolean

(MySQL만 해당)바이너리 로그 사용 설정 여부입니다. 백업 구성이 사용 중지되면 바이너리 로그도 사용 중지되어야 합니다.
replicationLogArchivingEnabled

boolean

나중에 사용하기 위해 예약되어 있습니다.
location

string

백업 위치
pointInTimeRecoveryEnabled

boolean

point-in-time recovery가 사용 설정되어 있는지 여부입니다.
backupRetentionSettings

object (BackupRetentionSettings)

백업 보관 설정입니다.
transactionLogRetentionDays

integer

특정 시점 복원을 위해 보관하는 트랜잭션 로그의 일수입니다(1~7).

통합 필드 _transactional_log_storage_state.

_transactional_log_storage_state는 다음 중 하나여야 합니다.
transactionalLogStorageState

enum (TransactionalLogStorageState)

출력 전용입니다. 이 값에는 데이터베이스의 PITR (point-in-time recovery)을 실행하는 데 사용되는 트랜잭션 로그의 스토리지 위치가 포함됩니다.

통합 필드 _backup_tier.

_backup_tier는 다음 중 하나여야 합니다.
backupTier

enum (BackupTier)

출력 전용입니다. 인스턴스의 백업을 관리하는 백업 등급입니다.

BackupRetentionSettings

JSON 표현 
{
  "retentionUnit": enum (RetentionUnit),
  "retainedBackups": integer
}
필드
retentionUnit

enum (RetentionUnit)

'retained_backups'가 나타내는 단위입니다.
retainedBackups

integer

보관 기간 단위 값에 따라 백업을 삭제해야 하는지 여부를 결정하는 데 사용됩니다. retention_unit이 'COUNT'인 경우 이만큼의 백업이 보관됩니다.

SqlActiveDirectoryConfig

JSON 표현 
{
  "kind": string,
  "domain": string,
  "mode": enum (ActiveDirectoryMode),
  "dnsServers": [
    string
  ],
  "adminCredentialSecretName": string,
  "organizationalUnit": string
}
필드
kind

string

항상 sql#activeDirectoryConfig입니다.
domain

string

도메인 이름 (예: mydomain.com)
mode

enum (ActiveDirectoryMode)

선택사항입니다. Active Directory 구성 모드입니다.
dnsServers[]

string

선택사항입니다. Active Directory를 부트스트랩하는 데 사용되는 도메인 컨트롤러 IPv4 주소입니다.
adminCredentialSecretName

string

선택사항입니다. 관리자 사용자 인증 정보를 저장하는 보안 비밀 관리자 키입니다. (예: projects/{project}/secrets/{secret})
organizationalUnit

string

선택사항입니다. 조직 단위 고유 이름입니다. 조직 단위의 전체 계층 경로입니다.

DenyMaintenancePeriod

JSON 표현 
{
  "startDate": string,
  "endDate": string,
  "time": string
}
필드
startDate

string

'유지보수 거부 기간' 시작일입니다. 시작일의 연도가 비어 있으면 종료일의 연도도 비어 있어야 합니다. 이 경우 유지보수 거부 기간이 매년 반복된다는 의미입니다. 날짜는 yyyy-mm-dd 형식입니다. 2020-11-01 또는 mm-dd(예: 11-01
endDate

string

'유지보수 거부 기간' 종료일입니다. 종료일의 연도가 비어 있으면 시작일의 연도도 비어 있어야 합니다. 이 경우 유지보수 금지 간격이 매년 반복된다는 의미입니다. 날짜는 yyyy-mm-dd 형식입니다. 2020-11-01 또는 mm-dd(예: 11-01
time

string

start_date에 시작되고 end_date에 종료되는 '유지보수 거부 기간'의 시간(UTC)입니다. 시간은 HH:mm:SS 형식입니다. 즉, 00:00:00

InsightsConfig

JSON 표현 
{
  "queryInsightsEnabled": boolean,
  "recordClientAddress": boolean,
  "recordApplicationTags": boolean,
  "queryStringLength": integer,
  "queryPlansPerMinute": integer,
  "enhancedQueryInsightsEnabled": boolean
}
필드
queryInsightsEnabled

boolean

쿼리 통계 기능이 사용 설정되어 있는지 여부입니다.
recordClientAddress

boolean

사용 설정된 경우 쿼리 통계에서 클라이언트 주소를 기록할지 여부입니다.
recordApplicationTags

boolean

사용 설정된 경우 쿼리 통계가 쿼리에서 애플리케이션 태그를 기록할지 여부입니다.
queryStringLength

integer

저장된 최대 쿼리 길이(바이트)입니다. 기본값: 1,024바이트 범위: 256~4,500바이트 이 필드 값보다 큰 쿼리 길이는 이 값으로 잘립니다. 설정하지 않으면 쿼리 길이가 기본값이 됩니다. 쿼리 길이를 변경하면 데이터베이스가 다시 시작됩니다.
queryPlansPerMinute

integer

모든 쿼리 결합에 대해 통계에서 분당 캡처한 쿼리 실행 계획 수입니다. 기본값은 5입니다.
enhancedQueryInsightsEnabled

boolean

선택사항입니다. 향상된 쿼리 통계 기능이 사용 설정되어 있는지 여부입니다.

PasswordValidationPolicy

JSON 표현 
{
  "minLength": integer,
  "complexity": enum (Complexity),
  "reuseInterval": integer,
  "disallowUsernameSubstring": boolean,
  "passwordChangeInterval": string,
  "enablePasswordPolicy": boolean,
  "disallowCompromisedCredentials": boolean
}
필드
minLength

integer

허용되는 최소 문자 수입니다.
complexity

enum (Complexity)

비밀번호의 복잡성입니다.
reuseInterval

integer

재사용할 수 없는 이전 비밀번호의 수입니다.
disallowUsernameSubstring

boolean

비밀번호의 일부로 사용자 이름을 허용하지 않습니다.
passwordChangeInterval

string (Duration format)

비밀번호를 변경할 수 있는 최소 간격입니다. 이 플래그는 PostgreSQL에만 지원됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
enablePasswordPolicy

boolean

비밀번호 정책을 사용 설정할지 여부입니다. 사용 설정된 경우 비밀번호가 복잡성 요구사항을 충족해야 합니다. 무단 액세스를 방지하려면 이 정책을 사용 설정된 상태로 유지하세요. 이 정책을 사용 중지하면 취약한 비밀번호가 허용됩니다.
disallowCompromisedCredentials
(deprecated)

boolean

이 필드는 지원 중단되었으며 향후 버전의 API에서 삭제될 예정입니다.

기간

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

시간 범위의 부호가 있는 초입니다. -315,576,000,000~+315,576,000,000(포함) 사이여야 합니다. 참고: 이 범위는 60초/분 * 60분/시간 * 24시간/일 * 365.25일/년 * 10,000년에서 계산됩니다.
nanos

integer

시간 범위의 나노초 단위로 된 부호가 있는 초수입니다. 1초 미만의 기간은 0 seconds 필드와 양수 또는 음수 nanos 필드로 표현됩니다. 1초 이상의 기간의 경우 nanos 필드의 0이 아닌 값은 seconds 필드와 부호가 같아야 합니다. -999,999,999~+999,999,999(포함) 사이여야 합니다.

SqlServerAuditConfig

JSON 표현 
{
  "kind": string,
  "bucket": string,
  "retentionInterval": string,
  "uploadInterval": string
}
필드
kind

string

항상 sql#sqlServerAuditConfig입니다.
bucket

string

대상 버킷의 이름입니다 (예: gs://mybucket).
retentionInterval

string (Duration format)

생성된 감사 파일을 보관할 기간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
uploadInterval

string (Duration format)

생성된 감사 파일을 업로드할 빈도입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

AdvancedMachineFeatures

JSON 표현 
{
  "threadsPerCore": integer
}
필드
threadsPerCore

integer

물리적 코어당 스레드 수입니다.

DataCacheConfig

JSON 표현 
{
  "dataCacheEnabled": boolean
}
필드
dataCacheEnabled

boolean

인스턴스에 데이터 캐시가 사용 설정되어 있는지 여부입니다.

ConnectionPoolConfig

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.
}
필드
flags[]

object (ConnectionPoolFlags)

선택사항입니다. 연결 풀 구성 플래그 목록입니다.

통합 필드 _connection_pooling_enabled.

_connection_pooling_enabled는 다음 중 하나여야 합니다.
connectionPoolingEnabled

boolean

관리형 연결 풀링이 사용 설정되었는지 여부입니다.

통합 필드 _pooler_count.

_pooler_count는 다음 중 하나여야 합니다.
poolerCount

integer

출력 전용입니다. 연결 풀러 수입니다.

ConnectionPoolFlags

JSON 표현 
{
  "name": string,
  "value": string
}
필드
name

string

필수 항목입니다. 플래그의 이름입니다.
value

string

필수 항목입니다. 플래그 값입니다. 불리언 플래그는 true의 경우 on, false의 경우 off로 설정됩니다. 플래그에 값이 사용되지 않는 경우 이 필드는 생략해야 합니다.

FinalBackupConfig

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.
}
필드

통합 필드 _enabled.

_enabled는 다음 중 하나여야 합니다.
enabled

boolean

인스턴스에 최종 백업이 사용 설정되어 있는지 여부입니다.

통합 필드 _retention_days.

_retention_days는 다음 중 하나여야 합니다.
retentionDays

integer

인스턴스 삭제 후 최종 백업을 보관할 일수입니다. 최종 백업은 (인스턴스 삭제 시간 + 보관 기간)에 삭제됩니다.

ReadPoolAutoScaleConfig

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.
}
필드
targetMetrics[]

object (TargetMetric)

선택사항입니다. 읽기 풀 자동 확장의 타겟 측정항목입니다.

통합 필드 _enabled.

_enabled는 다음 중 하나여야 합니다.
enabled

boolean

읽기 풀 자동 확장 사용 설정 여부를 나타냅니다.

통합 필드 _min_node_count.

_min_node_count는 다음 중 하나여야 합니다.
minNodeCount

integer

유지할 최소 읽기 풀 노드 수입니다.

통합 필드 _max_node_count.

_max_node_count는 다음 중 하나여야 합니다.
maxNodeCount

integer

유지할 최대 읽기 풀 노드 수입니다.

통합 필드 _disable_scale_in.

_disable_scale_in는 다음 중 하나여야 합니다.
disableScaleIn

boolean

읽기 풀 자동 확장이 축소 작업 (노드 삭제)을 지원하는지 여부를 나타냅니다.

통합 필드 _scale_in_cooldown_seconds.

_scale_in_cooldown_seconds는 다음 중 하나여야 합니다.
scaleInCooldownSeconds

integer

스케일 인 작업의 대기 기간입니다.

통합 필드 _scale_out_cooldown_seconds.

_scale_out_cooldown_seconds는 다음 중 하나여야 합니다.
scaleOutCooldownSeconds

integer

스케일 아웃 작업의 쿨다운 기간입니다.

TargetMetric

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.
}
필드

통합 필드 _metric.

_metric는 다음 중 하나여야 합니다.
metric

string

자동 확장에 사용할 측정항목 이름입니다.

통합 필드 _target_value.

_target_value는 다음 중 하나여야 합니다.
targetValue

number

측정항목의 타겟 값입니다.

SqlServerEntraIdConfig

JSON 표현 
{
  "kind": string,
  "tenantId": string,
  "applicationId": string
}
필드
kind

string

출력 전용입니다. 항상 sql#sqlServerEntraIdConfig입니다.
tenantId

string

선택사항입니다. Entra ID 구성의 테넌트 ID입니다.
applicationId

string

선택사항입니다. Entra ID 구성의 애플리케이션 ID입니다.

PerformanceCaptureConfig

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.
}
필드

통합 필드 _enabled.

_enabled는 다음 중 하나여야 합니다.
enabled

boolean

선택사항입니다. 퍼포먼스 캡처 기능을 사용 설정 또는 사용 중지합니다.

통합 필드 _probing_interval_seconds.

_probing_interval_seconds는 다음 중 하나여야 합니다.
probingIntervalSeconds

integer

선택사항입니다. 두 프로브 사이의 시간 간격(초)입니다.

통합 필드 _probe_threshold.

_probe_threshold는 다음 중 하나여야 합니다.
probeThreshold

integer

선택사항입니다. 인스턴스 상태 캡처를 트리거하는 기준점 이상의 연속 판독값의 최소 개수입니다.

통합 필드 _running_threads_threshold.

_running_threads_threshold는 다음 중 하나여야 합니다.
runningThreadsThreshold

integer

선택사항입니다. 기본에서 캡처를 트리거하기 위해 실행되는 최소 서버 스레드 수입니다.

통합 필드 _seconds_behind_source_threshold.

_seconds_behind_source_threshold는 다음 중 하나여야 합니다.
secondsBehindSourceThreshold

integer

선택사항입니다. 복제본에서 캡처를 트리거하기 위해 복제본이 기본 인스턴스보다 지연되어야 하는 최소 시간(초)입니다.

통합 필드 _transaction_duration_threshold.

_transaction_duration_threshold는 다음 중 하나여야 합니다.
transactionDurationThreshold

integer

선택사항입니다. 트랜잭션이 열려 있어야 워처가 기록을 시작하는 데 필요한 시간(초)입니다.

SqlFailoverReplica

JSON 표현 
{
  "name": string,
  "available": boolean
}
필드
name

string

장애 조치 복제본의 이름입니다. 인스턴스 생성 시 지정하면 인스턴스에 장애 조치 복제본이 생성됩니다. 이름에는 프로젝트 ID가 포함되지 않습니다.
available

boolean

장애 조치 복제본의 가용성 상태입니다. false 상태는 장애 조치 복제본이 동기화되지 않았음을 나타냅니다. 기본 인스턴스는 상태가 true인 경우에만 장애 조치 복제본으로 장애 조치할 수 있습니다.

IpMapping

JSON 표현 
{
  "type": enum (SqlIpAddressType),
  "ipAddress": string,
  "timeToRetire": string
}
필드
type

enum (SqlIpAddressType)

이 IP 주소의 유형입니다. PRIMARY 주소는 수신 연결을 수락할 수 있는 공개 주소입니다. PRIVATE 주소는 수신 연결을 수락할 수 있는 비공개 주소입니다. OUTGOING 주소는 인스턴스에서 시작된 연결의 소스 주소입니다(지원되는 경우).
ipAddress

string

할당된 IP 주소입니다.
timeToRetire

string (Timestamp format)

이 IP가 RFC 3339 형식(예: 2012-11-15T16:19:00.094Z)으로 종료될 예정입니다. 이 필드는 IP가 폐기되도록 예약된 경우에만 사용할 수 있습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

SslCert

JSON 표현 
{
  "kind": string,
  "certSerialNumber": string,
  "cert": string,
  "createTime": string,
  "commonName": string,
  "expirationTime": string,
  "sha1Fingerprint": string,
  "instance": string,
  "selfLink": string
}
필드
kind

string

항상 sql#sslCert입니다.
certSerialNumber

string

인증서에서 추출한 일련번호입니다.
cert

string

PEM 표현입니다.
createTime

string (Timestamp format)

인증서가 RFC 3339 형식으로 생성된 시간입니다(예: 2012-11-15T16:19:00.094Z).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
commonName

string

사용자가 제공한 이름입니다. [a-zA-Z.-_ ]+로 제한됩니다.
expirationTime

string (Timestamp format)

인증서가 RFC 3339 형식으로 만료되는 시간입니다(예: 2012-11-15T16:19:00.094Z).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
sha1Fingerprint

string

Sha1 지문.
instance

string

데이터베이스 인스턴스의 이름입니다.
selfLink

string

이 리소스의 URI입니다.

OnPremisesConfiguration

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)
}
필드
hostPort

string

host:port 형식의 온프레미스 인스턴스의 호스트 및 포트
kind

string

항상 sql#onPremisesConfiguration입니다.
username

string

온프레미스 인스턴스에 연결하기 위한 사용자 이름입니다.
password

string

온프레미스 인스턴스에 연결하기 위한 비밀번호입니다.
caCertificate

string

신뢰할 수 있는 CA의 x509 인증서의 PEM 표현입니다.
clientCertificate

string

복제본의 x509 인증서의 PEM 표현입니다.
clientKey

string

복제본의 비공개 키의 PEM 표현입니다. 해당 공개 키는 클라이언트의 인증서로 인코딩됩니다.
dumpFilePath

string

Cloud SQL 복제본을 만들 덤프 파일입니다.
sourceInstance

object (InstanceReference)

소스가 Cloud SQL인 경우 Cloud SQL 인스턴스에 대한 참조입니다.
selectedObjects[]

object (SelectedObjects)

선택사항입니다. 사용자가 외부 소스 인스턴스에서 복제하도록 선택한 객체 목록입니다.
sslOption

enum (SslOption)

선택사항입니다. 온프레미스 소스에 대한 복제본 연결의 SSL 옵션입니다.

InstanceReference

JSON 표현 
{
  "name": string,
  "region": string,
  "project": string
}
필드
name

string

참조되는 Cloud SQL 인스턴스의 이름입니다. 여기에는 프로젝트 ID가 포함되지 않습니다.
region

string

참조되는 Cloud SQL 인스턴스의 리전입니다.
project

string

참조되는 Cloud SQL 인스턴스의 프로젝트 ID입니다. 기본값은 인스턴스가 참조하는 것과 동일한 프로젝트 ID입니다.

SelectedObjects

JSON 표현 
{
  "database": string
}
필드
database

string

필수 항목입니다. 마이그레이션할 데이터베이스의 이름입니다.

ReplicaConfiguration

JSON 표현 
{
  "kind": string,
  "mysqlReplicaConfiguration": {
    object (MySqlReplicaConfiguration)
  },
  "failoverTarget": boolean,
  "cascadableReplica": boolean
}
필드
kind

string

항상 sql#replicaConfiguration입니다.
mysqlReplicaConfiguration

object (MySqlReplicaConfiguration)

MySQL 온프레미스 기본 인스턴스에서 복제할 때 MySQL 관련 구성입니다. 사용자 이름, 비밀번호, 인증서, 키와 같은 복제 구성 정보는 인스턴스 메타데이터에 저장되지 않습니다. 구성 정보는 복제 연결을 설정하는 데만 사용되며 MySQL이 데이터 디렉터리의 master.info 파일에 저장합니다.
failoverTarget

boolean

복제본이 장애 조치 대상인지 여부를 지정합니다. 필드가 true로 설정되면 복제본이 장애 조치 복제본으로 지정됩니다. 기본 인스턴스에 장애가 발생하면 복제본 인스턴스가 새 기본 인스턴스로 승격됩니다. 복제본 하나만 장애 조치 대상으로 지정할 수 있으며 복제본은 기본 인스턴스와 다른 영역에 있어야 합니다.
cascadableReplica

boolean

선택사항입니다. SQL Server 복제본이 연쇄 가능한 복제본인지 지정합니다. 연쇄 가능한 복제본은 복제본을 지원하는 SQL Server 리전 간 복제본입니다.

MySqlReplicaConfiguration

JSON 표현 
{
  "dumpFilePath": string,
  "username": string,
  "password": string,
  "connectRetryInterval": integer,
  "masterHeartbeatPeriod": string,
  "caCertificate": string,
  "clientCertificate": string,
  "clientKey": string,
  "sslCipher": string,
  "verifyServerCertificate": boolean,
  "kind": string
}
필드
dumpFilePath

string

복제본 인스턴스를 만들 Google Cloud Storage의 SQL 덤프 파일 경로입니다. URI는 gs://bucketName/fileName 형식입니다. 압축된 gzip 파일 (.gz)도 지원됩니다. 덤프에는 복제가 시작되는 binlog 좌표가 있습니다. mysqldump를 사용할 때 --master-data를 1로 설정하면 됩니다.
username

string

복제 연결의 사용자 이름입니다.
password

string

복제 연결의 비밀번호입니다.
connectRetryInterval

integer

연결 재시도 사이의 대기 시간(초)입니다. MySQL의 기본값은 60초입니다.
masterHeartbeatPeriod

string (Int64Value format)

복제 하트비트 사이의 간격(밀리초)입니다.
caCertificate

string

신뢰할 수 있는 CA의 x509 인증서의 PEM 표현입니다.
clientCertificate

string

복제본의 x509 인증서의 PEM 표현입니다.
clientKey

string

복제본의 비공개 키의 PEM 표현입니다. 해당 공개 키는 클라이언트의 인증서로 인코딩됩니다.
sslCipher

string

SSL 암호화에 사용할 수 있는 암호화 목록입니다.
verifyServerCertificate

boolean

SSL 핸드셰이크 중에 보내는 인증서에서 기본 인스턴스의 일반 이름 값을 확인할지 여부입니다.
kind

string

항상 sql#mysqlReplicaConfiguration입니다.

DiskEncryptionConfiguration

JSON 표현 
{
  "kmsKeyName": string,
  "kind": string
}
필드
kmsKeyName

string

디스크 암호화를 위한 KMS 키의 리소스 이름
kind

string

항상 sql#diskEncryptionConfiguration입니다.

DiskEncryptionStatus

JSON 표현 
{
  "kmsKeyVersionName": string,
  "kind": string
}
필드
kmsKeyVersionName

string

Cloud SQL 인스턴스 리소스를 암호화하는 데 사용되는 KMS 키 버전
kind

string

항상 sql#diskEncryptionStatus입니다.

SqlScheduledMaintenance

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.
}
필드
startTime

string (Timestamp format)

이 인스턴스에 예정된 유지보수의 시작 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
canDefer
(deprecated)

boolean
canReschedule

boolean

예약된 유지보수 일정을 변경할 수 있는 경우

통합 필드 _schedule_deadline_time.

_schedule_deadline_time는 다음 중 하나여야 합니다.
scheduleDeadlineTime

string (Timestamp format)

이 기한 이후에 시작되도록 유지보수 일정을 변경할 수 없습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

SqlOutOfDiskReport

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.
}
필드

통합 필드 _sql_out_of_disk_state.

_sql_out_of_disk_state는 다음 중 하나여야 합니다.
sqlOutOfDiskState

enum (SqlOutOfDiskState)

이 필드는 디스크 부족 문제에 대한 사전 데이터베이스 웰니스 작업에서 생성된 상태를 나타냅니다. * 작성자: * OOD의 사전 데이터베이스 웰니스 작업 * 리더: * 사전 대응 데이터베이스 웰니스 작업

통합 필드 _sql_min_recommended_increase_size_gb.

_sql_min_recommended_increase_size_gb는 다음 중 하나여야 합니다.
sqlMinRecommendedIncreaseSizeGb

integer

권장되는 최소 증가 크기(GB)입니다. 이 필드는 프런트엔드에서 사용됩니다. * 작성자: * OOD의 사전 데이터베이스 웰니스 작업 * 독자:

AvailableDatabaseVersion

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.
}
필드

통합 필드 _major_version.

_major_version는 다음 중 하나여야 합니다.
majorVersion

string

버전의 주요 버전 이름입니다.

통합 필드 _name.

_name는 다음 중 하나여야 합니다.
name

string

데이터베이스 버전 이름입니다. MySQL 8.0의 경우 이 문자열은 데이터베이스 메이저 버전과 마이너 버전을 제공합니다.

통합 필드 _display_name.

_display_name는 다음 중 하나여야 합니다.
displayName

string

데이터베이스 버전의 표시 이름입니다.

ReplicationCluster

JSON 표현 
{
  "psaWriteEndpoint": string,
  "failoverDrReplicaName": string,
  "drReplica": boolean
}
필드
psaWriteEndpoint

string

출력 전용입니다. 설정된 경우 이 필드는 이 인스턴스에 클러스터의 기본 인스턴스를 가리키는 비공개 서비스 액세스 (PSA) DNS 엔드포인트가 있음을 나타냅니다. 이 인스턴스가 기본 인스턴스인 경우 DNS 엔드포인트가 이 인스턴스를 가리킵니다. 전환 또는 복제본 장애 조치 작업 후 이 DNS 엔드포인트는 승격된 인스턴스를 가리킵니다. 읽기 전용 필드로, 사용자에게 정보로 반환됩니다. 이 필드는 독립형 인스턴스에 아직 DR 복제본이 없거나 DR 복제본이 삭제된 경우에도 존재할 수 있습니다.
failoverDrReplicaName

string

선택사항입니다. 인스턴스가 기본 인스턴스인 경우 이 필드는 재해 복구 (DR) 복제본을 식별합니다. DR 복제본은 Enterprise Plus 버전 인스턴스의 선택적 구성입니다. 인스턴스가 읽기 복제본인 경우 필드가 설정되지 않습니다. 이 필드를 복제본 이름으로 설정하여 기본 인스턴스의 DR 복제본을 지정합니다. 복제본 이름을 삭제하여 DR 복제본 지정을 삭제합니다.
drReplica

boolean

출력 전용입니다. 복제본이 DR 복제본인지 여부를 나타내는 읽기 전용 필드입니다. 인스턴스가 기본 인스턴스인 경우 이 필드는 설정되지 않습니다.

GeminiInstanceConfig

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.
}
필드

통합 필드 _entitled.

_entitled는 다음 중 하나여야 합니다.
entitled

boolean

출력 전용입니다. Gemini가 사용 설정되어 있는지 여부입니다.

통합 필드 _google_vacuum_mgmt_enabled.

_google_vacuum_mgmt_enabled는 다음 중 하나여야 합니다.
googleVacuumMgmtEnabled

boolean

출력 전용입니다. 청소기 관리가 사용 설정되어 있는지 여부입니다.

통합 필드 _oom_session_cancel_enabled.

_oom_session_cancel_enabled는 다음 중 하나여야 합니다.
oomSessionCancelEnabled

boolean

출력 전용입니다. 메모리 부족 (OOM) 세션 취소가 사용 설정되어 있는지 여부입니다.

통합 필드 _active_query_enabled.

_active_query_enabled는 다음 중 하나여야 합니다.
activeQueryEnabled

boolean

출력 전용입니다. 활성 쿼리가 사용 설정되어 있는지 여부입니다.

통합 필드 _index_advisor_enabled.

_index_advisor_enabled는 다음 중 하나여야 합니다.
indexAdvisorEnabled

boolean

출력 전용입니다. 색인 도우미가 사용 설정되어 있는지 여부입니다.

통합 필드 _flag_recommender_enabled.

_flag_recommender_enabled는 다음 중 하나여야 합니다.
flagRecommenderEnabled

boolean

출력 전용입니다. 플래그 추천기가 사용 설정되어 있는지 여부입니다.

TagsEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

PoolNodeConfig

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.
}
필드
ipAddresses[]

object (IpMapping)

출력 전용입니다. 읽기 풀 노드에 연결하는 데 사용할 수 있는 IP 주소가 포함된 매핑입니다.
dnsNames[]

object (DnsNameMapping)

출력 전용입니다. 이 읽기 풀 노드에서 사용되는 DNS 이름 목록입니다.
pscAutoConnections[]

object (PscAutoConnectionConfig)

출력 전용입니다. 이 읽기 풀 노드에 연결하는 데 사용할 수 있는 요청된 자동 설정 Private Service Connect (PSC) 소비자 엔드포인트의 설정 목록입니다.

통합 필드 _name.

_name는 다음 중 하나여야 합니다.
name

string

출력 전용입니다. 측정항목과 로그를 가져오는 데 사용할 읽기 풀 노드의 이름입니다.

통합 필드 _gce_zone.

_gce_zone는 다음 중 하나여야 합니다.
gceZone

string

출력 전용입니다. 읽기 풀 노드의 영역입니다.

통합 필드 _dns_name.

_dns_name는 다음 중 하나여야 합니다.
dnsName

string

출력 전용입니다. 읽기 풀 노드의 DNS 이름입니다.

통합 필드 _state.

_state는 다음 중 하나여야 합니다.
state

enum (SqlInstanceState)

출력 전용입니다. 읽기 풀 노드의 현재 상태입니다.

통합 필드 _psc_service_attachment_link.

_psc_service_attachment_link는 다음 중 하나여야 합니다.
pscServiceAttachmentLink

string

출력 전용입니다. 읽기 풀 노드의 Private Service Connect (PSC) 서비스 연결입니다.

DnsNameMapping

JSON 표현 
{
  "name": string,
  "connectionType": enum (ConnectionType),
  "dnsScope": enum (DnsScope),
  "recordManager": enum (RecordManager)
}
필드
name

string

출력 전용입니다. DNS 이름입니다.
connectionType

enum (ConnectionType)

출력 전용입니다. DNS 이름의 연결 유형입니다.
dnsScope

enum (DnsScope)

출력 전용입니다. DNS 이름이 적용되는 범위입니다.
recordManager

enum (RecordManager)

출력 전용입니다. 이 DNS 레코드의 관리자입니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ❌ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌