Strumento: get_instance
Recupera i dettagli di un'istanza Cloud SQL.
Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_instance.
| Curl Request |
|---|
curl --location 'https://sqladmin.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_instance", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Schema di input
Richiesta di recupero dell'istanza.
SqlInstancesGetRequest
| Rappresentazione JSON |
|---|
{ "instance": string, "project": string } |
| Campi | |
|---|---|
instance |
Obbligatorio. ID istanza database. L'ID progetto non è incluso. |
project |
Obbligatorio. ID progetto del progetto che contiene l'istanza. |
Schema di output
Una risorsa istanza Cloud SQL.
DatabaseInstance
| Rappresentazione JSON |
|---|
{ "kind": string, "state": enum ( |
| Campi | |
|---|---|
kind |
Questo valore è sempre |
state |
Lo stato di pubblicazione attuale dell'istanza Cloud SQL. |
databaseVersion |
Il tipo e la versione del motore del database. Il campo |
settings |
Le impostazioni utente. |
etag |
Questo campo è deprecato e verrà rimosso da una versione futura dell'API. Utilizza invece il campo |
failoverReplica |
Il nome e lo stato della replica di failover. |
masterInstanceName |
Il nome dell'istanza che fungerà da principale nella configurazione della replica. |
replicaNames[] |
Le repliche dell'istanza. |
maxDiskSize |
La dimensione massima del disco dell'istanza in byte. |
currentDiskSize |
L'utilizzo attuale del disco dell'istanza in byte. Questa proprietà è stata ritirata. Utilizza invece la metrica "cloudsql.googleapis.com/database/disk/bytes_used" nell'API Cloud Monitoring. Per i dettagli, consulta questo annuncio. |
ipAddresses[] |
Gli indirizzi IP assegnati all'istanza. |
serverCaCert |
Configurazione SSL. |
instanceType |
Il tipo di istanza. |
project |
L'ID progetto del progetto contenente l'istanza Cloud SQL. Il dominio delle app Google ha un prefisso, se applicabile. |
ipv6Address |
L'indirizzo IPv6 assegnato all'istanza. (Obsoleto) Questa proprietà era applicabile solo alle istanze di prima generazione. |
serviceAccountEmailAddress |
L'indirizzo email del account di servizio assegnato all'istanza. Questa proprietà è di sola lettura. |
onPremisesConfiguration |
Configurazione specifica per le istanze on-premise. |
replicaConfiguration |
Configurazione specifica per le repliche di failover e le repliche di lettura. |
backendType |
Il tipo di backend. Questa proprietà è di sola lettura; utilizza la proprietà |
selfLink |
L'URI di questa risorsa. |
suspensionReason[] |
Se lo stato dell'istanza è SUSPENDED, il motivo della sospensione. |
connectionName |
Nome della connessione dell'istanza Cloud SQL utilizzata nelle stringhe di connessione. |
name |
Nome dell'istanza Cloud SQL. L'ID progetto non è incluso. |
region |
La regione geografica dell'istanza Cloud SQL. Può essere una delle regioni in cui opera Cloud SQL: Ad esempio, |
gceZone |
La zona Compute Engine da cui viene attualmente gestita l'istanza. Questo valore potrebbe essere diverso dalla zona specificata al momento della creazione dell'istanza se l'istanza ha eseguito il failover nella zona secondaria. AVVISO: la modifica di questa impostazione potrebbe riavviare l'istanza. |
secondaryGceZone |
La zona Compute Engine da cui l'istanza di failover sta attualmente eseguendo il servizio per un'istanza regionale. Questo valore potrebbe essere diverso dalla zona specificata al momento della creazione dell'istanza se l'istanza ha eseguito il failover nella zona secondaria/di failover. |
diskEncryptionConfiguration |
Configurazione della crittografia del disco specifica per un'istanza. |
diskEncryptionStatus |
Stato della crittografia del disco specifico per un'istanza. |
rootPassword |
Password root iniziale. Utilizzare solo al momento della creazione. Devi impostare le password di root prima di poterti connettere alle istanze PostgreSQL. |
scheduledMaintenance |
L'ora di inizio di qualsiasi manutenzione pianificata imminente per questa istanza. |
satisfiesPzs |
Questo stato indica se l'istanza soddisfa PZS. Lo stato è riservato per un uso futuro. |
databaseInstalledVersion |
Solo output. Memorizza la versione corrente del database in esecuzione sull'istanza, inclusa la versione secondaria, ad esempio |
createTime |
Solo output. L'ora in cui è stata creata l'istanza nel formato RFC 3339, ad esempio Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
availableMaintenanceVersions[] |
Solo output. Elenca tutte le versioni di manutenzione applicabili all'istanza |
maintenanceVersion |
La versione software attuale sull'istanza. |
upgradableDatabaseVersions[] |
Solo output. Tutte le versioni del database disponibili per l'upgrade. |
replicationCluster |
Facoltativo. Una coppia di istanze principali e repliche per il ripristino di emergenza (RE). Una replica di RE è una replica tra regioni che designi per il failover nel caso in cui l'istanza principale subisca un errore regionale. Valido per MySQL e PostgreSQL. |
satisfiesPzi |
Solo output. Questo stato indica se l'istanza soddisfa PZI. Lo stato è riservato per un uso futuro. |
tags |
Facoltativo. Solo input. Immutabile. Chiavi e valori dei tag associati a questa istanza. Devi rappresentare ogni elemento nella mappa come: Ad esempio, una singola risorsa può avere i seguenti tag: Per saperne di più sulla creazione e sulla gestione dei tag, visita la pagina https://cloud.google.com/resource-manager/docs/tags/tags-overview. Un oggetto contenente un elenco di coppie |
nodes[] |
Solo output. Voci contenenti informazioni su ogni nodo del pool di lettura. |
dnsNames[] |
Solo output. L'elenco dei nomi DNS utilizzati da questa istanza. |
Campo unione
|
|
outOfDiskReport |
Questo campo rappresenta il report generato dal job di controllo proattivo del database per i problemi di spazio su disco insufficiente. * Scrittori: * il job proattivo di integrità del database per OOD. * Lettori: * il job proattivo di integrità del database |
Campo unione
|
|
sqlNetworkArchitecture |
|
Campo unione
|
|
pscServiceAttachmentLink |
Solo output. Il link al collegamento del servizio dell'istanza PSC. |
Campo unione
|
|
dnsName |
Solo output. Il nome DNS dell'istanza. |
Campo unione
|
|
primaryDnsName |
Solo output. DEPRECATO: utilizza write_endpoint. |
Campo unione
|
|
writeEndpoint |
Solo output. Il nome DNS dell'istanza principale in un gruppo di replica. |
Campo unione
|
|
geminiConfig |
Configurazione dell'istanza Gemini. |
Campo unione
|
|
switchTransactionLogsToCloudStorageEnabled |
Solo input. Indica se Cloud SQL è abilitato per passare dall'archiviazione dei file di log di recupero point-in-time da un disco dati a Cloud Storage. |
Campo unione
|
|
includeReplicasForMajorVersionUpgrade |
Solo input. Determina se viene eseguito un upgrade in loco della versione principale delle repliche quando viene avviato un upgrade in loco della versione principale di un'istanza primaria. |
Campo unione
|
|
nodeCount |
Il numero di nodi del pool di lettura in un pool di lettura. |
Impostazioni
| Rappresentazione JSON |
|---|
{ "settingsVersion": string, "authorizedGaeApplications": [ string ], "tier": string, "kind": string, "userLabels": { string: string, ... }, "availabilityType": enum ( |
| Campi | |
|---|---|
settingsVersion |
La versione delle impostazioni dell'istanza. Questo è un campo obbligatorio per il metodo di aggiornamento per garantire che gli aggiornamenti simultanei vengano gestiti correttamente. Durante l'aggiornamento, utilizza il valore settingsVersion più recente per questa istanza e non tentare di aggiornarlo. |
authorizedGaeApplications[] |
Gli ID app App Engine che possono accedere a questa istanza. (Ritirato) Applicato solo alle istanze di prima generazione. |
tier |
Il livello (o tipo di macchina) per questa istanza, ad esempio |
kind |
Questo valore è sempre |
userLabels |
Etichette fornite dall'utente, rappresentate come un dizionario in cui ogni etichetta è una singola coppia chiave-valore. Un oggetto contenente un elenco di coppie |
availabilityType |
Tipo di disponibilità. Valori potenziali: * Per saperne di più, consulta la panoramica della configurazione ad alta disponibilità. |
pricingPlan |
Il piano tariffario per questa istanza. Può essere |
replicationType |
Il tipo di replica utilizzato da questa istanza. Può essere |
storageAutoResizeLimit |
La dimensione massima a cui la capacità di archiviazione può essere aumentata automaticamente. Il valore predefinito è 0, il che significa che non esiste un limite. |
activationPolicy |
Il criterio di attivazione specifica quando l'istanza viene attivata ed è applicabile solo quando lo stato dell'istanza è RUNNABLE. Valori validi: * |
ipConfiguration |
Le impostazioni per la gestione IP. Ciò consente di attivare o disattivare l'IP dell'istanza e di gestire le reti esterne che possono connettersi all'istanza. L'indirizzo IPv4 non può essere disattivato per le istanze di seconda generazione. |
storageAutoResize |
Configurazione per aumentare automaticamente le dimensioni dello spazio di archiviazione. Il valore predefinito è true. |
locationPreference |
Le impostazioni delle preferenze relative alla posizione. In questo modo, l'istanza può essere posizionata il più vicino possibile a un'app App Engine o a una zona Compute Engine per ottenere prestazioni migliori. La collocazione di App Engine era applicabile solo alle istanze di prima generazione. |
databaseFlags[] |
I flag di database passati all'istanza all'avvio. |
dataDiskType |
Il tipo di disco dati: |
maintenanceWindow |
Il periodo di manutenzione per questa istanza. Specifica quando l'istanza può essere riavviata per scopi di manutenzione. |
backupConfiguration |
La configurazione del backup giornaliero per l'istanza. |
databaseReplicationEnabled |
Configurazione specifica per le istanze di replica di lettura. Indica se la replica è attivata o meno. AVVISO: la modifica di questa impostazione riavvia l'istanza. |
crashSafeReplicationEnabled |
Configurazione specifica per le istanze di replica di lettura. Indica se sono attivati i flag del database per la replica a prova di arresto anomalo. Questa proprietà era applicabile solo alle istanze di prima generazione. |
dataDiskSizeGb |
Le dimensioni del disco dati, in GB. La dimensione minima del disco dati è 10 GB. |
activeDirectoryConfig |
Configurazione di Active Directory, pertinente solo per Cloud SQL per SQL Server. |
collation |
Il nome delle regole di confronto dell'istanza del server. |
denyMaintenancePeriods[] |
Periodi in cui evitare la manutenzione |
insightsConfig |
Configurazione degli approfondimenti, per ora pertinente solo per Postgres. |
passwordValidationPolicy |
I criteri di convalida della password utente locale dell'istanza. |
sqlServerAuditConfig |
Configurazione di audit specifica di SQL Server. |
edition |
Facoltativo. L'edizione dell'istanza. |
connectorEnforcement |
Specifica se le connessioni devono utilizzare i connettori Cloud SQL. I valori delle opzioni includono: Tieni presente che l'utilizzo di REQUIRED disattiva tutte le reti autorizzate esistenti. Se questo campo non viene specificato durante la creazione di una nuova istanza, viene utilizzato NOT_REQUIRED. Se questo campo non viene specificato durante l'applicazione di patch o l'aggiornamento di un'istanza esistente, rimane invariato nell'istanza. |
deletionProtectionEnabled |
Configurazione per proteggerti dall'eliminazione accidentale delle istanze. |
timeZone |
Fuso orario del server, pertinente solo per Cloud SQL per SQL Server. |
advancedMachineFeatures |
Specifica la configurazione avanzata della macchina per le istanze pertinenti solo per SQL Server. |
dataCacheConfig |
Configurazione per la cache dei dati. |
replicationLagMaxSeconds |
Facoltativo. Valore di configurazione per la ricreazione della replica dopo un determinato ritardo di replica |
enableGoogleMlIntegration |
Facoltativo. Quando questo parametro è impostato su true, le istanze Cloud SQL possono connettersi a Vertex AI per inoltrare richieste di previsioni e insight in tempo reale all'AI. Il valore predefinito è false. Questo vale solo per le istanze Cloud SQL per MySQL e Cloud SQL per PostgreSQL. |
enableDataplexIntegration |
Facoltativo. Per impostazione predefinita, le istanze Cloud SQL hanno l'estrazione dello schema disattivata per Dataplex. Se questo parametro è impostato su true, l'estrazione dello schema per Dataplex sulle istanze Cloud SQL viene attivata. |
retainBackupsOnDelete |
Facoltativo. Se questo parametro è impostato su true, Cloud SQL conserva i backup dell'istanza anche dopo l'eliminazione. Il backup ON_DEMAND verrà conservato finché il cliente non lo elimina o non elimina il progetto. Il backup AUTOMATICO verrà conservato in base all'impostazione di conservazione dei backup. |
entraidConfig |
Facoltativo. La configurazione di Microsoft Entra ID per l'istanza SQL Server. |
performanceCaptureConfig |
Facoltativo. Configurazione per l'acquisizione delle prestazioni, fornisce metriche diagnostiche in situazioni di carico elevato. |
Campo unione
|
|
dataDiskProvisionedIops |
Facoltativo. Numero di operazioni di I/O al secondo di cui è stato eseguito il provisioning per il disco dati. Questo campo viene utilizzato solo per i tipi di disco hyperdisk-balanced. |
Campo unione
|
|
dataDiskProvisionedThroughput |
Facoltativo. Throughput di cui è stato eseguito il provisioning misurato in MiB al secondo per il disco di dati. Questo campo viene utilizzato solo per i tipi di disco hyperdisk-balanced. |
Campo unione
|
|
connectionPoolConfig |
Facoltativo. La configurazione del pool di connessioni gestito per l'istanza. |
Campo unione
|
|
finalBackupConfig |
Facoltativo. La configurazione di backup finale per l'istanza. |
Campo unione
|
|
readPoolAutoScaleConfig |
Facoltativo. La configurazione della scalabilità automatica del pool di lettura per l'istanza. |
Campo unione
|
|
autoUpgradeEnabled |
Facoltativo. Configurazione dell'upgrade automatico di Cloud SQL per MySQL. Se questo parametro è impostato su true, l'upgrade automatico è abilitato per le versioni secondarie di MySQL 8.0. La versione di MySQL deve essere 8.0.35 o successive. |
Campo unione
|
|
dataApiAccess |
Questo parametro controlla se consentire l'utilizzo dell'API ExecuteSql per connettersi all'istanza. Non consentito per impostazione predefinita. |
Int64Value
| Rappresentazione JSON |
|---|
{ "value": string } |
| Campi | |
|---|---|
value |
Il valore int64. |
UserLabelsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
IpConfiguration
| Rappresentazione JSON |
|---|
{ "ipv4Enabled": boolean, "privateNetwork": string, "requireSsl": boolean, "authorizedNetworks": [ { object ( |
| Campi | |
|---|---|
ipv4Enabled |
Indica se all'istanza è assegnato un indirizzo IP pubblico. |
privateNetwork |
Il link alla risorsa per la rete VPC da cui l'istanza Cloud SQL è accessibile per l'IP privato. Ad esempio, |
requireSsl |
Utilizza invece Se le connessioni SSL/TLS su IP sono applicate. Se impostato su false, consente connessioni non SSL/non TLS e SSL/TLS. Per le connessioni SSL/TLS, il certificato client non verrà verificato. Se impostato su true, consente solo connessioni criptate con SSL/TLS e con certificati client validi. Se vuoi applicare SSL/TLS senza applicare il requisito di certificati client validi, utilizza il flag |
authorizedNetworks[] |
L'elenco delle reti esterne autorizzate a connettersi all'istanza utilizzando l'IP. Nella notazione CIDR, nota anche come notazione con barra (ad esempio: |
allocatedIpRange |
Il nome dell'intervallo IP allocato per l'istanza Cloud SQL con IP privato. Ad esempio: "google-managed-services-default". Se impostato, l'IP dell'istanza verrà creato nell'intervallo allocato. Il nome dell'intervallo deve essere conforme a RFC 1035. Nello specifico, il nome deve avere una lunghezza compresa tra 1 e 63 caratteri e corrispondere all'espressione regolare |
enablePrivatePathForGoogleCloudServices |
Controlla la connettività alle istanze con IP privato dai servizi Google, come BigQuery. |
sslMode |
Specifica come viene applicato SSL/TLS nelle connessioni al database. Se devi utilizzare il flag Per PostgreSQL e MySQL:
Per SQL Server:
Il valore di Ad esempio, per la coppia |
customSubjectAlternativeNames[] |
Facoltativo. Nomi alternativi del soggetto(SAN) personalizzati per un'istanza Cloud SQL. |
Campo unione
|
|
pscConfig |
Impostazioni PSC per questa istanza. |
Campo unione
|
|
serverCaMode |
Specifica il tipo di CA utilizzato per il certificato del server. |
Campo unione
|
|
serverCaPool |
Facoltativo. Il nome della risorsa del pool di CA server per un'istanza con |
Campo unione
|
|
serverCertificateRotationMode |
Facoltativo. Controlla la funzionalità di rotazione automatica dei certificati server. Questa funzione è disattivata per impostazione predefinita. Se abilitato, il certificato server verrà ruotato automaticamente durante la manutenzione pianificata di Cloud SQL o gli aggiornamenti della manutenzione self-service fino a sei mesi prima della scadenza. Questa impostazione può essere configurata solo se server_ca_mode è GOOGLE_MANAGED_CAS_CA o CUSTOMER_MANAGED_CAS_CA. |
BoolValue
| Rappresentazione JSON |
|---|
{ "value": boolean } |
| Campi | |
|---|---|
value |
Il valore booleano. |
AclEntry
| Rappresentazione JSON |
|---|
{ "value": string, "expirationTime": string, "name": string, "kind": string } |
| Campi | |
|---|---|
value |
Il valore consentito per l'elenco di controllo dell'accesso. |
expirationTime |
L'ora in cui questa voce di controllo dell'accesso scade nel formato RFC 3339, ad esempio Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
name |
Facoltativo. Un'etichetta per identificare questa voce. |
kind |
Questo valore è sempre |
Timestamp
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z). |
nanos |
Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi. |
PscConfig
| Rappresentazione JSON |
|---|
{ "allowedConsumerProjects": [ string ], "pscAutoConnections": [ { object ( |
| Campi | |
|---|---|
allowedConsumerProjects[] |
Facoltativo. L'elenco dei progetti consumer inclusi nella lista consentita per le connessioni PSC a questa istanza. È possibile connettersi a questa istanza con PSC da qualsiasi rete in questi progetti. Ogni progetto consumer in questo elenco può essere rappresentato da un numero di progetto (numerico) o da un ID progetto (alfanumerico). |
pscAutoConnections[] |
Facoltativo. L'elenco delle impostazioni per gli endpoint consumer Private Service Connect richiesti che possono essere utilizzati per connettersi a questa istanza Cloud SQL. |
networkAttachmentUri |
Facoltativo. Il collegamento di rete della rete consumer a cui l'istanza Cloud SQL abilitata per Private Service Connect è autorizzata a connettersi tramite l'interfaccia PSC. Formato: projects/PROJECT/regions/REGION/networkAttachments/ID |
Campo unione
|
|
pscEnabled |
Indica se la connettività PSC è abilitata per questa istanza. |
PscAutoConnectionConfig
| Rappresentazione JSON |
|---|
{ "consumerProject": string, "consumerNetwork": string, // Union field |
| Campi | |
|---|---|
consumerProject |
Facoltativo. Questo è l'ID progetto del progetto di servizio consumer di questo endpoint consumer. Facoltativo. Ciò è applicabile solo se consumer_network è una rete VPC condivisa. |
consumerNetwork |
Facoltativo. La rete consumer di questo endpoint consumer. Deve essere un percorso della risorsa che includa sia il progetto host sia il nome della rete. Ad esempio, Il progetto host consumer di questa rete potrebbe essere diverso dal progetto di servizio consumer. |
Campo unione
|
|
ipAddress |
L'indirizzo IP dell'endpoint consumer. |
Campo unione
|
|
status |
Lo stato della connessione dell'endpoint consumer. |
Campo unione
|
|
consumerNetworkStatus |
Lo stato delle norme di connessione della rete consumer. |
LocationPreference
| Rappresentazione JSON |
|---|
{ "followGaeApplication": string, "zone": string, "secondaryZone": string, "kind": string } |
| Campi | |
|---|---|
followGaeApplication |
L'applicazione App Engine da seguire, che deve trovarsi nella stessa regione dell'istanza Cloud SQL. AVVISO: la modifica di questa impostazione potrebbe riavviare l'istanza. |
zone |
La zona Compute Engine preferita (ad esempio: us-central1-a, us-central1-b e così via). AVVISO: la modifica di questa impostazione potrebbe riavviare l'istanza. |
secondaryZone |
La zona Compute Engine preferita per il secondario/failover (ad esempio: us-central1-a, us-central1-b e così via). Per disattivare questo campo, impostalo su "no_secondary_zone". |
kind |
Questo valore è sempre |
DatabaseFlags
| Rappresentazione JSON |
|---|
{ "name": string, "value": string } |
| Campi | |
|---|---|
name |
Il nome del flag. Questi flag vengono passati all'avvio dell'istanza, quindi includi sia le opzioni del server sia le variabili di sistema. I flag vengono specificati con trattini bassi, non trattini. Per saperne di più, consulta Configurazione dei flag di database nella documentazione di Cloud SQL. |
value |
Il valore del flag. I flag booleani sono impostati su |
MaintenanceWindow
| Rappresentazione JSON |
|---|
{
"hour": integer,
"day": integer,
"updateTrack": enum ( |
| Campi | |
|---|---|
hour |
Ora del giorno: da 0 a 23. Specifica il fuso orario UTC. |
day |
Giorno della settimana: |
updateTrack |
Impostazioni di tempistica per manutenzione: |
kind |
Questo valore è sempre |
Int32Value
| Rappresentazione JSON |
|---|
{ "value": integer } |
| Campi | |
|---|---|
value |
Il valore int32. |
BackupConfiguration
| Rappresentazione JSON |
|---|
{ "startTime": string, "enabled": boolean, "kind": string, "binaryLogEnabled": boolean, "replicationLogArchivingEnabled": boolean, "location": string, "pointInTimeRecoveryEnabled": boolean, "backupRetentionSettings": { object ( |
| Campi | |
|---|---|
startTime |
Ora di inizio per la configurazione del backup giornaliero nel fuso orario UTC in formato 24 ore: |
enabled |
Indica se questa configurazione è abilitata. |
kind |
Questo valore è sempre |
binaryLogEnabled |
(Solo MySQL) Indica se il log binario è abilitato. Se la configurazione del backup è disattivata, anche binarylog deve essere disattivato. |
replicationLogArchivingEnabled |
Riservato per l'uso futuro. |
location |
Posizione del backup |
pointInTimeRecoveryEnabled |
Indica se il recupero point-in-time è abilitato. |
backupRetentionSettings |
Impostazioni di conservazione dei backup. |
transactionLogRetentionDays |
Il numero di giorni di conservazione dei log delle transazioni per il ripristino point-in-time, da 1 a 7. |
Campo unione
|
|
transactionalLogStorageState |
Solo output. Questo valore contiene la posizione di archiviazione dei log transazionali utilizzati per eseguire il recupero point-in-time (PITR) per il database. |
Campo unione
|
|
backupTier |
Solo output. Livello di backup che gestisce i backup per l'istanza. |
BackupRetentionSettings
| Rappresentazione JSON |
|---|
{
"retentionUnit": enum ( |
| Campi | |
|---|---|
retentionUnit |
L'unità rappresentata da "retained_backups". |
retainedBackups |
A seconda del valore di retention_unit, questo valore viene utilizzato per determinare se è necessario eliminare un backup. Se retention_unit è "COUNT", verranno conservati questo numero di backup. |
SqlActiveDirectoryConfig
| Rappresentazione JSON |
|---|
{
"kind": string,
"domain": string,
"mode": enum ( |
| Campi | |
|---|---|
kind |
Questo valore è sempre sql#activeDirectoryConfig. |
domain |
Il nome del dominio (ad es. mydomain.com). |
mode |
Facoltativo. La modalità di configurazione di Active Directory. |
dnsServers[] |
Facoltativo. Indirizzi IPv4 del domain controller utilizzati per il bootstrap di Active Directory. |
adminCredentialSecretName |
Facoltativo. La chiave di Secret Manager che archivia le credenziali di amministratore. ad esempio projects/{project}/secrets/{secret}. |
organizationalUnit |
Facoltativo. Il nome distinto dell'unità organizzativa. Questo è il percorso gerarchico completo all'unità organizzativa. |
DenyMaintenancePeriod
| Rappresentazione JSON |
|---|
{ "startDate": string, "endDate": string, "time": string } |
| Campi | |
|---|---|
startDate |
Data di inizio del "periodo in cui evitare la manutenzione". Se l'anno della data di inizio è vuoto, anche l'anno della data di fine deve essere vuoto. In questo caso, significa che il periodo in cui evitare la manutenzione si ripete ogni anno. La data è nel formato aaaa-mm-gg, ad esempio 2020-11-01 o gg-mm, ad esempio 11-01 |
endDate |
Data di fine del "periodo in cui evitare la manutenzione". Se l'anno della data di fine è vuoto, anche l'anno della data di inizio deve essere vuoto. In questo caso, significa che l'intervallo di assenza di manutenzione si ripete ogni anno. La data è nel formato aaaa-mm-gg, ad esempio 2020-11-01 o gg-mm, ad esempio 11-01 |
time |
Ora in formato UTC in cui inizia il "periodo in cui evitare la manutenzione" nella data di inizio e termina nella data di fine. L'ora è nel formato HH:mm:SS, ad esempio 00:00:00 |
InsightsConfig
| Rappresentazione JSON |
|---|
{ "queryInsightsEnabled": boolean, "recordClientAddress": boolean, "recordApplicationTags": boolean, "queryStringLength": integer, "queryPlansPerMinute": integer, "enhancedQueryInsightsEnabled": boolean } |
| Campi | |
|---|---|
queryInsightsEnabled |
Indica se la funzionalità Query Insights è abilitata. |
recordClientAddress |
Indica se Query Insights registra l'indirizzo client quando è attivato. |
recordApplicationTags |
Indica se Query Insights registra i tag delle applicazioni dalla query quando è abilitato. |
queryStringLength |
Lunghezza massima della query memorizzata in byte. Valore predefinito: 1024 byte. Intervallo: 256-4500 byte. Le lunghezze delle query superiori al valore di questo campo verranno troncate a questo valore. Se non viene impostata, la lunghezza della query sarà il valore predefinito. La modifica della lunghezza delle query riavvierà il database. |
queryPlansPerMinute |
Numero di piani di esecuzione delle query acquisiti da Insights al minuto per tutte le query combinate. Il valore predefinito è 5. |
enhancedQueryInsightsEnabled |
Facoltativo. Indica se la funzionalità Query Insights avanzato è abilitata. |
PasswordValidationPolicy
| Rappresentazione JSON |
|---|
{
"minLength": integer,
"complexity": enum ( |
| Campi | |
|---|---|
minLength |
Numero minimo di caratteri consentiti. |
complexity |
La complessità della password. |
reuseInterval |
Numero di password precedenti che non possono essere riutilizzate. |
disallowUsernameSubstring |
Non consentire il nome utente come parte della password. |
passwordChangeInterval |
Intervallo minimo dopo il quale è possibile modificare la password. Questo flag è supportato solo per PostgreSQL. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
enablePasswordPolicy |
Indica se attivare o meno la policy per le password. Se abilitate, le password devono soddisfare i requisiti di complessità. Mantieni attivato questo criterio per impedire accessi non autorizzati. Se disattivi questo criterio, vengono consentite password inefficaci. |
disallowCompromisedCredentials |
Questo campo è deprecato e verrà rimosso in una versione futura dell'API. |
Durata
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati in base a: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni |
nanos |
Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo |
SqlServerAuditConfig
| Rappresentazione JSON |
|---|
{ "kind": string, "bucket": string, "retentionInterval": string, "uploadInterval": string } |
| Campi | |
|---|---|
kind |
Questo valore è sempre sql#sqlServerAuditConfig |
bucket |
Il nome del bucket di destinazione (ad es. gs://mybucket). |
retentionInterval |
Per quanto tempo conservare i file di controllo generati. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
uploadInterval |
La frequenza di caricamento dei file di controllo generati. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
AdvancedMachineFeatures
| Rappresentazione JSON |
|---|
{ "threadsPerCore": integer } |
| Campi | |
|---|---|
threadsPerCore |
Il numero di thread per core fisico. |
DataCacheConfig
| Rappresentazione JSON |
|---|
{ "dataCacheEnabled": boolean } |
| Campi | |
|---|---|
dataCacheEnabled |
Indica se la cache dei dati è abilitata per l'istanza. |
ConnectionPoolConfig
| Rappresentazione JSON |
|---|
{ "flags": [ { object ( |
| Campi | |
|---|---|
flags[] |
Facoltativo. Elenco dei flag di configurazione del pool di connessioni. |
Campo unione
|
|
connectionPoolingEnabled |
Indica se il pool di connessioni gestito è abilitato. |
Campo unione
|
|
poolerCount |
Solo output. Numero di pool di connessioni. |
ConnectionPoolFlags
| Rappresentazione JSON |
|---|
{ "name": string, "value": string } |
| Campi | |
|---|---|
name |
Obbligatorio. Il nome del flag. |
value |
Obbligatorio. Il valore del flag. I flag booleani sono impostati su |
FinalBackupConfig
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
enabled |
Se il backup finale è abilitato per l'istanza. |
Campo unione
|
|
retentionDays |
Il numero di giorni per conservare il backup finale dopo l'eliminazione dell'istanza. Il backup finale verrà eliminato definitivamente il giorno (time_of_instance_deletion + retention_days). |
ReadPoolAutoScaleConfig
| Rappresentazione JSON |
|---|
{ "targetMetrics": [ { object ( |
| Campi | |
|---|---|
targetMetrics[] |
Facoltativo. Metriche target per la scalabilità automatica del pool di lettura. |
Campo unione
|
|
enabled |
Indica se la scalabilità automatica del pool di lettura è abilitata. |
Campo unione
|
|
minNodeCount |
Il numero minimo di nodi del pool di lettura da mantenere. |
Campo unione
|
|
maxNodeCount |
Il numero massimo di nodi del pool di lettura da mantenere. |
Campo unione
|
|
disableScaleIn |
Indica se la scalabilità automatica del pool di lettura supporta le operazioni di fare lo scale in (rimozione dei nodi). |
Campo unione
|
|
scaleInCooldownSeconds |
Il periodo di raffreddamento per le operazioni di scale-in. |
Campo unione
|
|
scaleOutCooldownSeconds |
Il periodo di raffreddamento per le operazioni di scale out. |
TargetMetric
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
metric |
Il nome della metrica da utilizzare per la scalabilità automatica. |
Campo unione
|
|
targetValue |
Il valore target per la metrica. |
SqlServerEntraIdConfig
| Rappresentazione JSON |
|---|
{ "kind": string, "tenantId": string, "applicationId": string } |
| Campi | |
|---|---|
kind |
Solo output. Questo valore è sempre sql#sqlServerEntraIdConfig |
tenantId |
Facoltativo. L'ID tenant per la configurazione di Entra ID. |
applicationId |
Facoltativo. L'ID applicazione per la configurazione di Entra ID. |
PerformanceCaptureConfig
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
enabled |
Facoltativo. Attiva o disattiva la funzionalità di acquisizione delle prestazioni. |
Campo unione
|
|
probingIntervalSeconds |
Facoltativo. L'intervallo di tempo in secondi tra due probe. |
Campo unione
|
|
probeThreshold |
Facoltativo. Il numero minimo di letture consecutive sopra la soglia che attiva l'acquisizione dello stato dell'istanza. |
Campo unione
|
|
runningThreadsThreshold |
Facoltativo. Il numero minimo di thread del server in esecuzione per attivare l'acquisizione sul server primario. |
Campo unione
|
|
secondsBehindSourceThreshold |
Facoltativo. Il numero minimo di secondi di ritardo della replica rispetto al primario per attivare l'acquisizione sulla replica. |
Campo unione
|
|
transactionDurationThreshold |
Facoltativo. Il tempo in secondi per cui una transazione deve essere aperta prima che il watcher inizi a registrarla. |
SqlFailoverReplica
| Rappresentazione JSON |
|---|
{ "name": string, "available": boolean } |
| Campi | |
|---|---|
name |
Il nome della replica di failover. Se specificata al momento della creazione dell'istanza, viene creata una replica di failover per l'istanza. Il nome non include l'ID progetto. |
available |
Lo stato di disponibilità della replica di failover. Uno stato falso indica che la replica di failover non è sincronizzata. Il failover dell'istanza principale può essere eseguito sulla replica di failover solo quando lo stato è true. |
IpMapping
| Rappresentazione JSON |
|---|
{
"type": enum ( |
| Campi | |
|---|---|
type |
Il tipo di questo indirizzo IP. Un indirizzo |
ipAddress |
L'indirizzo IP assegnato. |
timeToRetire |
L'ora di ritiro di questo IP nel formato RFC 3339, ad esempio Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
SslCert
| Rappresentazione JSON |
|---|
{ "kind": string, "certSerialNumber": string, "cert": string, "createTime": string, "commonName": string, "expirationTime": string, "sha1Fingerprint": string, "instance": string, "selfLink": string } |
| Campi | |
|---|---|
kind |
Questo valore è sempre |
certSerialNumber |
Numero di serie, estratto dal certificato. |
cert |
Rappresentazione PEM. |
createTime |
L'ora in cui è stato creato il certificato nel formato RFC 3339, ad esempio Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
commonName |
Nome fornito dall'utente. Limitato a [a-zA-Z.-_ ]+. |
expirationTime |
L'ora in cui il certificato scade nel formato RFC 3339, ad esempio Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
sha1Fingerprint |
Impronta SHA1. |
instance |
Nome dell'istanza del database. |
selfLink |
L'URI di questa risorsa. |
OnPremisesConfiguration
| Rappresentazione JSON |
|---|
{ "hostPort": string, "kind": string, "username": string, "password": string, "caCertificate": string, "clientCertificate": string, "clientKey": string, "dumpFilePath": string, "sourceInstance": { object ( |
| Campi | |
|---|---|
hostPort |
L'host e la porta dell'istanza on-premise nel formato host:porta |
kind |
Questo valore è sempre |
username |
Il nome utente per la connessione all'istanza on-premise. |
password |
La password per la connessione all'istanza on-premise. |
caCertificate |
Rappresentazione PEM del certificato x509 della CA attendibile. |
clientCertificate |
Rappresentazione PEM del certificato x509 della replica. |
clientKey |
Rappresentazione PEM della chiave privata della replica. La chiave pubblica corrispondente è codificata nel certificato del client. |
dumpFilePath |
Il file di dump per creare la replica Cloud SQL. |
sourceInstance |
Il riferimento all'istanza Cloud SQL se l'origine è Cloud SQL. |
selectedObjects[] |
Facoltativo. Un elenco di oggetti che l'utente seleziona per la replica da un'istanza di origine esterna. |
sslOption |
Facoltativo. Opzione SSL per la connessione di replica all'origine on-premise. |
InstanceReference
| Rappresentazione JSON |
|---|
{ "name": string, "region": string, "project": string } |
| Campi | |
|---|---|
name |
Il nome dell'istanza Cloud SQL a cui viene fatto riferimento. L'ID progetto non è incluso. |
region |
La regione dell'istanza Cloud SQL a cui viene fatto riferimento. |
project |
L'ID progetto dell'istanza Cloud SQL a cui viene fatto riferimento. Il valore predefinito è lo stesso ID progetto a cui fa riferimento l'istanza. |
SelectedObjects
| Rappresentazione JSON |
|---|
{ "database": string } |
| Campi | |
|---|---|
database |
Obbligatorio. Il nome del database di cui eseguire la migrazione. |
ReplicaConfiguration
| Rappresentazione JSON |
|---|
{
"kind": string,
"mysqlReplicaConfiguration": {
object ( |
| Campi | |
|---|---|
kind |
Questo valore è sempre |
mysqlReplicaConfiguration |
Configurazione specifica di MySQL durante la replica da un'istanza principale MySQL on-premise. Le informazioni di configurazione della replica, come nome utente, password, certificati e chiavi, non vengono memorizzate nei metadati dell'istanza. Le informazioni di configurazione vengono utilizzate solo per configurare la connessione di replica e vengono archiviate da MySQL in un file denominato |
failoverTarget |
Specifica se la replica è il target di failover. Se il campo è impostato su |
cascadableReplica |
Facoltativo. Specifica se una replica di SQL Server è una replica a cascata. Una replica a cascata è una replica cross-regione di SQL Server che supporta una o più repliche al suo interno. |
MySqlReplicaConfiguration
| Rappresentazione JSON |
|---|
{ "dumpFilePath": string, "username": string, "password": string, "connectRetryInterval": integer, "masterHeartbeatPeriod": string, "caCertificate": string, "clientCertificate": string, "clientKey": string, "sslCipher": string, "verifyServerCertificate": boolean, "kind": string } |
| Campi | |
|---|---|
dumpFilePath |
Percorso di un file di dump SQL in Google Cloud Storage da cui creare l'istanza di replica. L'URI è nel formato gs://bucketName/fileName. Sono supportati anche i file gzip compressi (.gz). I dump contengono le coordinate binlog da cui inizia la replica. A questo scopo, imposta --master-data su 1 quando utilizzi mysqldump. |
username |
Il nome utente per la connessione di replica. |
password |
La password per la connessione di replica. |
connectRetryInterval |
Secondi di attesa tra i tentativi di connessione. Il valore predefinito di MySQL è 60 secondi. |
masterHeartbeatPeriod |
Intervallo in millisecondi tra i battiti di replica. |
caCertificate |
Rappresentazione PEM del certificato x509 della CA attendibile. |
clientCertificate |
Rappresentazione PEM del certificato x509 della replica. |
clientKey |
Rappresentazione PEM della chiave privata della replica. La chiave pubblica corrispondente è codificata nel certificato del client. |
sslCipher |
Un elenco di algoritmi di crittografia consentiti da utilizzare per la crittografia SSL. |
verifyServerCertificate |
Indica se controllare o meno il valore del nome comune dell'istanza principale nel certificato che invia durante l'handshake SSL. |
kind |
Questo valore è sempre |
DiskEncryptionConfiguration
| Rappresentazione JSON |
|---|
{ "kmsKeyName": string, "kind": string } |
| Campi | |
|---|---|
kmsKeyName |
Nome risorsa della chiave KMS per la crittografia del disco |
kind |
Questo valore è sempre |
DiskEncryptionStatus
| Rappresentazione JSON |
|---|
{ "kmsKeyVersionName": string, "kind": string } |
| Campi | |
|---|---|
kmsKeyVersionName |
Versione della chiave KMS utilizzata per criptare la risorsa istanza Cloud SQL |
kind |
Questo valore è sempre |
SqlScheduledMaintenance
| Rappresentazione JSON |
|---|
{ "startTime": string, "canDefer": boolean, "canReschedule": boolean, // Union field |
| Campi | |
|---|---|
startTime |
L'ora di inizio di qualsiasi manutenzione pianificata imminente per questa istanza. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
canDefer |
|
canReschedule |
Indica se è possibile riprogrammare la manutenzione pianificata. |
Campo unione
|
|
scheduleDeadlineTime |
La manutenzione non può essere riprogrammata per iniziare dopo questa scadenza. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
SqlOutOfDiskReport
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
sqlOutOfDiskState |
Questo campo rappresenta lo stato generato dal job di controllo proattivo dell'integrità del database per i problemi di spazio su disco insufficiente. * Scrittori: * il job proattivo di integrità del database per OOD. * Lettori: * il job proattivo di integrità del database |
Campo unione
|
|
sqlMinRecommendedIncreaseSizeGb |
Le dimensioni minime consigliate per l'aumento in gigabyte. Questo campo viene utilizzato dal frontend * Scrittori: * il job proattivo di integrità del database per OOD. * Lettori: |
AvailableDatabaseVersion
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
majorVersion |
Il nome della versione principale della versione. |
Campo unione
|
|
name |
Il nome della versione del database. Per MySQL 8.0, questa stringa fornisce la versione principale e secondaria del database. |
Campo unione
|
|
displayName |
Il nome visualizzato della versione del database. |
ReplicationCluster
| Rappresentazione JSON |
|---|
{ "psaWriteEndpoint": string, "failoverDrReplicaName": string, "drReplica": boolean } |
| Campi | |
|---|---|
psaWriteEndpoint |
Solo output. Se impostato, questo campo indica che questa istanza ha un endpoint DNS di accesso al servizio privato (PSA) che punta all'istanza principale del cluster. Se questa istanza è quella principale, l'endpoint DNS punta a questa istanza. Dopo un'operazione di switchover o di failover della replica, questo endpoint DNS punta all'istanza promossa. Questo è un campo di sola lettura, restituito all'utente come informazione. Questo campo può esistere anche se un'istanza autonoma non ha ancora una replica di RE o se la replica di RE viene eliminata. |
failoverDrReplicaName |
Facoltativo. Se l'istanza è un'istanza principale, questo campo identifica la replica di ripristino di emergenza (RE). Una replica di RE è una configurazione facoltativa per le istanze della versione Enterprise Plus. Se l'istanza è una replica di lettura, il campo non è impostato. Imposta questo campo sul nome di una replica per designare una replica di RE per un'istanza primaria. Rimuovi il nome della replica per rimuovere la designazione di replica di RE. |
drReplica |
Solo output. Campo di sola lettura che indica se la replica è una replica RE. Questo campo non è impostato se l'istanza è un'istanza principale. |
GeminiInstanceConfig
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
entitled |
Solo output. Indica se Gemini è abilitato. |
Campo unione
|
|
googleVacuumMgmtEnabled |
Solo output. Indica se la gestione dell'aspirapolvere è attiva. |
Campo unione
|
|
oomSessionCancelEnabled |
Solo output. Indica se l'annullamento della sessione di esaurimento della memoria (OOM) è abilitato. |
Campo unione
|
|
activeQueryEnabled |
Solo output. Indica se la query attiva è abilitata. |
Campo unione
|
|
indexAdvisorEnabled |
Solo output. Indica se i suggerimenti sull'indicizzazione sono abilitati. |
Campo unione
|
|
flagRecommenderEnabled |
Solo output. Indica se il sistema di suggerimento dei flag è abilitato. |
TagsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
PoolNodeConfig
| Rappresentazione JSON |
|---|
{ "ipAddresses": [ { object ( |
| Campi | |
|---|---|
ipAddresses[] |
Solo output. Mapping contenenti indirizzi IP che possono essere utilizzati per connettersi al nodo del pool di lettura. |
dnsNames[] |
Solo output. L'elenco dei nomi DNS utilizzati da questo nodo del pool di lettura. |
pscAutoConnections[] |
Solo output. L'elenco delle impostazioni per gli endpoint consumer di Private Service Connect (PSC) configurati automaticamente richiesti che possono essere utilizzati per connettersi a questo nodo del pool di lettura. |
Campo unione
|
|
name |
Solo output. Il nome del nodo del pool di lettura, da utilizzare per recuperare metriche e log. |
Campo unione
|
|
gceZone |
Solo output. La zona del nodo del pool di lettura. |
Campo unione
|
|
dnsName |
Solo output. Il nome DNS del nodo del pool di lettura. |
Campo unione
|
|
state |
Solo output. Lo stato attuale del nodo del pool di lettura. |
Campo unione
|
|
pscServiceAttachmentLink |
Solo output. Il collegamento del servizio Private Service Connect (PSC) del nodo del pool di lettura. |
DnsNameMapping
| Rappresentazione JSON |
|---|
{ "name": string, "connectionType": enum ( |
| Campi | |
|---|---|
name |
Solo output. Il nome DNS. |
connectionType |
Solo output. Il tipo di connessione del nome DNS. |
dnsScope |
Solo output. L'ambito a cui si applica il nome DNS. |
recordManager |
Solo output. Il gestore di questo record DNS. |
Annotazioni dello strumento
Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌