gcp_sql_database_instance
ancestors
Type : UNORDERED_LIST_STRING
available_maintenance_versions
Type : UNORDERED_LIST_STRING
Nom fournisseur : availableMaintenanceVersions
Description : Sortie uniquement. Liste de toutes les versions de maintenance applicables sur l’instance
backend_type
Type : STRING
Nom fournisseur : backendType
Description : Le type de backend. SECOND_GEN
: Instance de base de données Cloud SQL. EXTERNAL
: Un serveur de base de données non géré par Google. Cette propriété est en lecture seule ; utilisez la propriété tier
dans l’objet settings
pour déterminer le type de base de données.
Valeurs autorisées :
SQL_BACKEND_TYPE_UNSPECIFIED
- Type de backend inconnu pour l’instance.
FIRST_GEN
- Instance Speckle v1.
SECOND_GEN
- Instance Speckle v2.
EXTERNAL
- Instance sur site.
connection_name
Type : STRING
Nom fournisseur : connectionName
Description : Nom de connexion de l’instance Cloud SQL utilisé dans les chaînes de connexion.
create_time
Type : TIMESTAMP
Nom fournisseur : createTime
Description : Sortie uniquement. La date de création de l’instance au format RFC 3339, par exemple : 2012-11-15T16:19:00.094Z
.
current_disk_size
Type : INT64
Nom fournisseur : currentDiskSize
Description : L’utilisation actuelle du disque par l’instance en octets. Cette propriété est désormais obsolète. Utilisez la métrique cloudsql.googleapis.com/database/disk/bytes_used dans l’API Cloud Monitoring à la place. Consultez cette annonce pour en savoir plus.
database_installed_version
Type : STRING
Nom fournisseur : databaseInstalledVersion
Description : Sortie uniquement. Enregistre la version de la base de données actuellement exécutée sur l’instance, y compris la version mineure. Exemple : MYSQL_8_0_18
.
database_version
Type : STRING
Nom fournisseur : databaseVersion
Description : Type et version du moteur de base de données. Le champ databaseVersion
ne peut pas être modifié après la création de l’instance.
Valeurs autorisées :
SQL_DATABASE_VERSION_UNSPECIFIED
- Version de la base de données inconnue.
MYSQL_5_1
- La version de la base de données est MySQL 5.1.
MYSQL_5_5
- La version de la base de données est MySQL 5.5.
MYSQL_5_6
- La version de la base de données est MySQL 5.6.
MYSQL_5_7
- La version de la base de données est MySQL 5.7.
SQLSERVER_2017_STANDARD
- La version de la base de données est SQL Server 2017 Standard.
SQLSERVER_2017_ENTERPRISE
- La version de la base de données est SQL Server 2017 Enterprise.
SQLSERVER_2017_EXPRESS
- La version de la base de données est SQL Server 2017 Express.
SQLSERVER_2017_WEB
- La version de la base de données est SQL Server 2017 Web.
POSTGRES_9_6
- La version de la base de données est PostgreSQL 9.6.
POSTGRES_10
- La version de la base de données est PostgreSQL 10.
POSTGRES_11
- La version de la base de données est PostgreSQL 11.
POSTGRES_12
- La version de la base de données est PostgreSQL 12.
POSTGRES_13
- La version de la base de données est PostgreSQL 13.
POSTGRES_14
- La version de la base de données est PostgreSQL 14.
MYSQL_8_0
- La version de la base de données est MySQL 8.
MYSQL_8_0_18
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 18.
MYSQL_8_0_26
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 26.
MYSQL_8_0_27
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 27.
MYSQL_8_0_28
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 28.
MYSQL_8_0_29
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 29.
MYSQL_8_0_30
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 30.
MYSQL_8_0_31
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 31.
MYSQL_8_0_32
- La version majeure de la base de données est MySQL 8.0 et la version mineure est 32.
SQLSERVER_2019_STANDARD
- La version de la base de données est SQL Server 2019 Standard.
SQLSERVER_2019_ENTERPRISE
- La version de la base de données est SQL Server 2019 Enterprise.
SQLSERVER_2019_EXPRESS
- La version de la base de données est SQL Server 2019 Express.
SQLSERVER_2019_WEB
- La version de la base de données est SQL Server 2019 Web.
disk_encryption_configuration
Type : STRUCT
Nom fournisseur : diskEncryptionConfiguration
Description : La configuration du chiffrement du disque pour une instance spécifique.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#diskEncryptionConfiguration
.
kms_key_name
Type : STRING
Nom fournisseur : kmsKeyName
Description : Nom de ressource de la clé KMS pour le chiffrement du disque
disk_encryption_status
Type : STRUCT
Nom fournisseur : diskEncryptionStatus
Description : Le statut du chiffrement du disque pour une instance spécifique.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#diskEncryptionStatus
.
kms_key_version_name
Type : STRING
Nom fournisseur : kmsKeyVersionName
Description : Version de la clé KMS utilisée pour chiffrer la ressource de l’instance Cloud SQL
etag
Type : STRING
Nom fournisseur : etag
Description : Ce champ est obsolète et sera supprimé dans une prochaine version de l’API. Utilisez le champ settings.settingsVersion
à la place.
failover_replica
Type : STRUCT
Nom fournisseur : failoverReplica
Description : Le nom et le statut du réplica de failover.
available
Type : BOOLEAN
Nom fournisseur : available
Description : Le statut de disponibilité du réplica de failover. Un statut false indique que le réplica de failover est désynchronisé. Pour que le basculement de l’instance principale vers le réplica de failover soit possible, le statut doit correspondre à true.
name
Type : STRING
Nom fournisseur : name
Description : Le nom du réplica de failover. Si cette propriété est spécifiée à la création de l’instance, un réplica de failover est créé pour l’instance. Le nom n’inclut pas l’ID de projet.
gce_zone
Type : STRING
Nom fournisseur : gceZone
Description : La zone Compute Engine qui héberge actuellement l’instance. Cette valeur peut être différente de la zone spécifiée lors de la création de l’instance en cas de failover de l’instance vers sa zone secondaire. AVERTISSEMENT : La modification de cette valeur peut entraîner le redémarrage de l’instance.
instance_type
Type : STRING
Nom fournisseur : instanceType
Description : Le type d’instance.
Valeurs autorisées :
SQL_INSTANCE_TYPE_UNSPECIFIED
- Le type d’instance Cloud SQL est inconnu.
CLOUD_SQL_INSTANCE
- Une instance Cloud SQL standard sans réplication à partir d’une instance principale.
ON_PREMISES_INSTANCE
- Une instance exécutée sur le site du client qui n’est pas générée par Cloud SQL.
READ_REPLICA_INSTANCE
- Une instance Cloud SQL utilisée comme réplica avec accès en lecture.
ip_addresses
Type : UNORDERED_LIST_STRUCT
Nom fournisseur : ipAddresses
Description : Les adresses IP affectées à l’instance.
ip_address
Type : STRING
Nom fournisseur : ipAddress
Description : L’adresse IP affectée.
time_to_retire
Type : TIMESTAMP
Nom fournisseur : timeToRetire
Description : La date à laquelle cette IP doit être retirée, au format RFC 3339. Exemple : 2012-11-15T16:19:00.094Z
. Ce champ est uniquement disponible lorsque l’IP est programmée pour être retirée.
type
Type : STRING
Nom fournisseur : type
Description : Le type d’adresse IP. Une adresse PRIMARY
est une adresse publique qui peut accepter les connexions entrantes. Une adresse PRIVATE
est une adresse privée qui peut accepter les connexions entrantes. Une adresse OUTGOING
est l’adresse source des connexions en provenance de l’instance, si ce type est pris en charge.
Valeurs autorisées :
SQL_IP_ADDRESS_TYPE_UNSPECIFIED
- Le type d’adresse IP est inconnu.
PRIMARY
- Adresse IP à laquelle le client est censé se connecter. Il s’agit généralement de l’adresse IP de l’équilibreur de charge.
OUTGOING
- Adresse IP source de la connexion qu’un réplica avec accès en lecture établit avec son instance principale externe. Cette adresse IP peut être ajoutée à une liste d’autorisations par le client s’il utilise un pare-feu pour filtrer les connexions entrantes vers son instance principale sur site.
PRIVATE
- Adresse IP privée utilisée lorsque les IP privées et le peering réseau sont activés.
MIGRATED_1ST_GEN
- Adresse IP v1 d’une instance migrée. L’utilisateur est censé retirer cette IP dès que la migration est terminée. Remarque : les instances v1 avec des adresses IP v1 seront considérées comme des adresses PRIMARY.
ipv6_address
Type : STRING
Nom fournisseur : ipv6Address
Description : L’adresse IPv6 allouée à l’instance. (Obsolète) Cette propriété était uniquement applicable aux instances de première génération.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#instance
.
labels
Type : UNORDERED_LIST_STRING
maintenance_version
Type : STRING
Nom fournisseur : maintenanceVersion
Description : La version logicielle actuelle de l’instance.
master_instance_name
Type : STRING
Nom fournisseur : masterInstanceName
Description : Le nom de l’instance utilisée comme instance principale dans le système de réplication.
max_disk_size
Type : INT64
Nom fournisseur : maxDiskSize
Description : Le volume disque maximum que l’instance peut occuper en octets.
name
Type : STRING
Nom fournisseur : name
Description : Nom de l’instance Cloud SQL. Cette propriété n’inclut pas l’ID de projet.
on_premises_configuration
Type : STRUCT
Nom fournisseur : onPremisesConfiguration
Description : Configuration spécifique aux instances sur site.
ca_certificate
Type : STRING
Nom fournisseur : caCertificate
Description : Représentation PEM du certificat x509 de l’autorité de certification de confiance.
client_certificate
Type : STRING
Nom fournisseur : clientCertificate
Description : Représentation PEM du certificat x509 du réplica.
client_key
Type : STRING
Nom fournisseur : clientKey
Description : Représentation PEM de la clé privée du réplica. La clé publique correspondante est encodée dans le certificat du client.
dump_file_path
Type : STRING
Nom fournisseur : dumpFilePath
Description : Le fichier dump utilisé pour créer le réplica Cloud SQL.
host_port
Type : STRING
Nom fournisseur : hostPort
Description : Host et port de l’instance sur site, au format host:port.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#onPremisesConfiguration
.
password
Type : STRING
Nom fournisseur : password
Description : Le mot de passe pour se connecter à l’instance sur site.
source_instance
Type : STRUCT
Nom fournisseur : sourceInstance
Description : La référence à l’instance Cloud SQL si la source est Cloud SQL.
name
Type : STRING
Nom fournisseur : name
Description : Le nom de l’instance Cloud SQL référencée. Cette propriété n’inclut pas l’ID de projet.
project
Type : STRING
Nom fournisseur : project
Description : L’ID de projet de l’instance Cloud SQL référencée. La valeur par défaut correspond à l’ID de projet tel que référencé par l’instance.
region
Type : STRING
Nom fournisseur : region
Description : La région de l’instance Cloud SQL référencée.
username
Type : STRING
Nom fournisseur : username
Description : Le nom d’utilisateur pour se connecter à l’instance sur site.
organization_id
Type : STRING
out_of_disk_report
Type : STRUCT
Nom fournisseur : outOfDiskReport
Description : Ce champ correspond au rapport généré par la tâche de contrôle d’intégrité proactif de la base de données pour les problèmes de type OutOfDisk. * Écriture : * La tâche de contrôle d’intégrité proactif de la base de données pour OOD. * Lecture : * La tâche de contrôle d’intégrité proactif de la base de données.
sql_min_recommended_increase_size_gb
Type : INT32
Nom fournisseur : sqlMinRecommendedIncreaseSizeGb
Description : L’augmentation minimum recommandée du volume en gigaoctets Ce champ est consommé par le frontend. * Écriture : * La tâche de contrôle d’intégrité proactif de la base de données pour OOD. * Lecture :
sql_out_of_disk_state
Type : STRING
Nom fournisseur : sqlOutOfDiskState
Description : Ce champ correspond à l’état généré par la tâche de contrôle d’intégrité proactif de la base de données pour les problèmes de type OutOfDisk. * Écriture : * La tâche de contrôle d’intégrité proactif de la base de données pour OOD. * Lecture : * La tâche de contrôle d’intégrité proactif de la base de données.
Valeurs autorisées :
SQL_OUT_OF_DISK_STATE_UNSPECIFIED
- État non spécifié.
NORMAL
- L’instance a suffisamment d’espace libre sur le disque de données.
SOFT_SHUTDOWN
- Le disque de données est presque saturé. Un arrêt est effectué pour empêcher toute corruption des données.
parent
Type : STRING
project
Type : STRING
Nom fournisseur : project
Description : L’ID de projet contenant l’instance Cloud SQL. Le domaine Google Apps est ajouté en préfixe le cas échéant.
project_id
Type : STRING
project_number
Type : STRING
region
Type : STRING
Nom fournisseur : region
Description : La région géographique. Valeurs autorisées : * us-central
(instances FIRST_GEN
uniquement), * us-central1
(instances SECOND_GEN
uniquement), * asia-east1
ou europe-west1
. Par défaut, cette propriété est définie sur us-central
ou us-central1
en fonction du type d’instance. La région ne peut pas être modifiée une fois l’instance créée.
replica_configuration
Type : STRUCT
Nom fournisseur : replicaConfiguration
Description : Configuration spécifique aux réplicas de failover et aux réplicas avec accès en lecture.
failover_target
Type : BOOLEAN
Nom fournisseur : failoverTarget
Description : Spécifie si le réplica est la cible de failover. Si le champ est défini sur true
, le réplica est désigné comme réplica de failover. En cas de défaillance de l’instance principale, le réplica devient la nouvelle instance principale. Un seul réplica peut être spécifié comme cible de failover, et il doit être situé dans une zone différente de celle de l’instance principale.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#replicaConfiguration
.
mysql_replica_configuration
Type : STRUCT
Nom fournisseur : mysqlReplicaConfiguration
Description : Configuration spécifique à MySQL en cas de réplication à partir d’une instance principale MySQL sur site. Les informations de configuration de la réplication, telles que le nom d’utilisateur, le mot de passe, les certificats et les clés ne sont pas stockées dans les métadonnées de l’instance. Les informations de configuration sont uniquement utilisées pour établir la connexion de réplication et sont stockées par MySQL dans un fichier nommé master.info
dans le répertoire de données.
ca_certificate
Type : STRING
Nom fournisseur : caCertificate
Description : Représentation PEM du certificat x509 de l’autorité de certification de confiance.
client_certificate
Type : STRING
Nom fournisseur : clientCertificate
Description : Représentation PEM du certificat x509 du réplica.
client_key
Type : STRING
Nom fournisseur : clientKey
Description : Représentation PEM de la clé privée du réplica. La clé publique correspondante est encodée dans le certificat du client.
connect_retry_interval
Type : INT32
Nom fournisseur : connectRetryInterval
Description : Temps d’attente en secondes entre les tentatives de connexion. La valeur par défaut de MySQL est de 60 secondes.
dump_file_path
Type : STRING
Nom fournisseur : dumpFilePath
Description : Chemin vers le fichier dump SQL dans Google Cloud Storage à partir duquel le réplica doit être créé. L’URI est au format gs://nomBucket/nomFichier. Les fichiers gzip compressés (.gz) sont également pris en charge. Les dumps contiennent les coordonnées des logs binaires utilisées pour lancer la réplication. Pour ce faire, définissez –master-data sur 1 lorsque vous utilisez mysqldump.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#mysqlReplicaConfiguration
.
master_heartbeat_period
Type : INT64
Nom fournisseur : masterHeartbeatPeriod
Description : Intervalle en millisecondes entre les heartbeats de réplication.
password
Type : STRING
Nom fournisseur : password
Description : Le mot de passe pour la connexion de réplication.
ssl_cipher
Type : STRING
Nom fournisseur : sslCipher
Description : La liste des ciphers pouvant être utilisés pour le chiffrement SSL.
username
Type : STRING
Nom fournisseur : username
Description : Le nom d’utilisateur pour la connexion de réplication.
verify_server_certificate
Type : BOOLEAN
Nom fournisseur : verifyServerCertificate
Description : Détermine si la valeur Common Name de l’instance principale doit être vérifiée dans le certificat envoyé lors de la liaison SSL.
replica_names
Type : UNORDERED_LIST_STRING
Nom fournisseur : replicaNames
Description : Les réplicas de l’instance.
resource_name
Type : STRING
root_password
Type : STRING
Nom fournisseur : rootPassword
Description : Mot de passe root initial. À utiliser uniquement lors de la création. Vous devez définir les mots de passe root pour être en mesure de vous connecter aux instances PostgreSQL.
satisfies_pzs
Type : BOOLEAN
Nom fournisseur : satisfiesPzs
Description : Statut indiquant si l’instance est conforme à Pzs. Réservé pour une utilisation future.
scheduled_maintenance
Type : STRUCT
Nom fournisseur : scheduledMaintenance
Description : La date de début d’une prochaine maintenance prévue pour cette instance.
can_defer
Type : BOOLEAN
Nom fournisseur : canDefer
can_reschedule
Type : BOOLEAN
Nom fournisseur : canReschedule
Description : Détermine si la maintenance prévue doit être reprogrammée.
schedule_deadline_time
Type : TIMESTAMP
Nom fournisseur : scheduleDeadlineTime
Description : La maintenance ne peut pas être reprogrammée au-delà de cette date limite.
start_time
Type : TIMESTAMP
Nom fournisseur : startTime
Description : La date de début d’une prochaine maintenance prévue pour cette instance.
secondary_gce_zone
Type : STRING
Nom fournisseur : secondaryGceZone
Description : La zone Compute Engine qui héberge actuellement l’instance de failover pour une instance régionale. Cette valeur peut être différente de la zone spécifiée lors de la création de l’instance en cas de failover de l’instance vers sa zone secondaire/de failover.
self_link
Type : STRING
Nom fournisseur : selfLink
Description : L’URI de cette ressource.
server_ca_cert
Type : STRUCT
Nom fournisseur : serverCaCert
Description : Configuration SSL.
cert
Type : STRING
Nom fournisseur : cert
Description : Représentation PEM.
cert_serial_number
Type : STRING
Nom fournisseur : certSerialNumber
Description : Numéro de série extrait du certificat.
common_name
Type : STRING
Nom fournisseur : commonName
Description : Nom spécifié par l’utilisateur. Doit uniquement contenir les caractères [a-zA-Z.-_ ]+.
create_time
Type : TIMESTAMP
Nom fournisseur : createTime
Description : La date de création du certificat au format RFC 3339, par exemple : 2012-11-15T16:19:00.094Z
.
expiration_time
Type : TIMESTAMP
Nom fournisseur : expirationTime
Description : La date d’expiration du certificat au format RFC 3339, par exemple : 2012-11-15T16:19:00.094Z
.
instance
Type : STRING
Nom fournisseur : instance
Description : Nom de l’instance de base de données.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#sslCert
.
self_link
Type : STRING
Nom fournisseur : selfLink
Description : L’URI de cette ressource.
sha1_fingerprint
Type : STRING
Nom fournisseur : sha1Fingerprint
Description : Empreinte Sha1.
service_account_email_address
Type : STRING
Nom fournisseur : serviceAccountEmailAddress
Description : L’adresse e-mail du compte de service associée à l’instance. Cette propriété est en lecture seule.
settings
Type : STRUCT
Nom fournisseur : settings
Description : Les paramètres utilisateur.
activation_policy
Type : STRING
Nom fournisseur : activationPolicy
Description : La politique d’activation spécifie à quel moment l’instance est activée. Elle s’applique uniquement lorsque l’état de l’instance correspond à RUNNABLE. Valeurs autorisées : * ALWAYS
: L’instance est activée et doit rester activée même en cas d’absence de requêtes de connexion. * NEVER
: L’instance est désactivée et ne doit pas être activée, même en cas de réception d’une requête de connexion.
Valeurs autorisées :
SQL_ACTIVATION_POLICY_UNSPECIFIED
- Plan d’activation inconnu.
ALWAYS
- L’instance est toujours opérationnelle.
NEVER
- L’instance ne démarre jamais.
ON_DEMAND
- L’instance est activée dès qu’une requête est reçue.
active_directory_config
Type : STRUCT
Nom fournisseur : activeDirectoryConfig
Description : Configuration Active Directory, s’applique uniquement à Cloud SQL pour SQL Server.
domain
Type : STRING
Nom fournisseur : domain
Description : Le nom du domaine (par exemple, mondomaine.com).
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#activeDirectoryConfig.
advanced_machine_features
Type : STRUCT
Nom fournisseur : advancedMachineFeatures
Description : Spécifie la configuration de machine avancée pour l’instance. S’applique uniquement à SQL Server.
threads_per_core
Type : INT32
Nom fournisseur : threadsPerCore
Description : Le nombre de threads par cœur physique.
authorized_gae_applications
Type : UNORDERED_LIST_STRING
Nom fournisseur : authorizedGaeApplications
Description : Les ID des applications App Engine qui peuvent accéder à cette instance. (Obsolète) S’applique uniquement aux instances de première génération.
availability_type
Type : STRING
Nom fournisseur : availabilityType
Description : Type de disponibilité. Valeurs autorisées : * ZONAL
: L’instance distribue les données depuis une seule zone. En cas de panne dans cette zone, les données risquent de ne plus être accessibles. * REGIONAL
: L’instance peut distribuer les données depuis plusieurs zones dans une région (elle est hautement disponible). Pour en savoir plus, consultez la documentation Présentation de la configuration de la haute disponibilité.
Valeurs autorisées :
SQL_AVAILABILITY_TYPE_UNSPECIFIED
- Le type de disponibilité est inconnu.
ZONAL
- Instance avec disponibilité zonale.
REGIONAL
- Instance avec disponibilité régionale.
backup_configuration
Type : STRUCT
Nom fournisseur : backupConfiguration
Description : La configuration de la sauvegarde journalière pour l’instance.
backup_retention_settings
Type : STRUCT
Nom fournisseur : backupRetentionSettings
Description : Paramètres de rétention des sauvegardes.
retained_backups
Type : INT32
Nom fournisseur : retainedBackups
Description : En fonction de la valeur définie pour retention_unit, cette propriété détermine si une sauvegarde doit être supprimée. Si retention_unit est défini sur COUNT, le nombre correspondant de sauvegardes sera conservé.
retention_unit
Type : STRING
Nom fournisseur : retentionUnit
Description : L’unité représentée par retained_backups.
Valeurs autorisées :
RETENTION_UNIT_UNSPECIFIED
- L’unité de rétention des sauvegardes n’est pas spécifiée et sera considérée comme COUNT.
COUNT
- La rétention est définie par un nombre. Par exemple, « conserver les 7 dernières sauvegardes ».
binary_log_enabled
Type : BOOLEAN
Nom fournisseur : binaryLogEnabled
Description : (MySQL uniquement) Détermine si le log binaire est activé. Si la configuration des sauvegardes est désactivée, le log binaire doit également être désactivé.
enabled
Type : BOOLEAN
Nom fournisseur : enabled
Description : Détermine si cette configuration est activée.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#backupConfiguration
.
location
Type : STRING
Nom fournisseur : location
Description : Emplacement de la sauvegarde.
point_in_time_recovery_enabled
Type : BOOLEAN
Nom fournisseur : pointInTimeRecoveryEnabled
Description : (Postgres uniquement) Détermine si la restauration à un instant dans le passé est activée.
replication_log_archiving_enabled
Type : BOOLEAN
Nom fournisseur : replicationLogArchivingEnabled
Description : Réservé pour une utilisation future.
start_time
Type : STRING
Nom fournisseur : startTime
Description : Heure de début de la sauvegarde quotidienne au format UTC 24 heures. Exemple : HH:MM
.
transaction_log_retention_days
Type : INT32
Nom fournisseur : transactionLogRetentionDays
Description : Nombre de jours de logs de transaction à conserver pour la restauration à un instant dans le passé, de 1 à 7.
collation
Type : STRING
Nom fournisseur : collation
Description : Le nom de la collation de l’instance serveur.
connector_enforcement
Type : STRING
Nom fournisseur : connectorEnforcement
Description : Spécifie si les connexions doivent utiliser des connecteurs Cloud SQL. Valeurs autorisées : NOT_REQUIRED
(les instances Cloud SQL peuvent être connectées sans connecteurs Cloud SQL) et REQUIRED
(autoriser uniquement les connexions qui utilisent des connecteurs Cloud SQL). Notez que l’option REQUIRED entraîne la désactivation de tous les réseaux autorisés existants. Si ce champ n’est pas spécifié lors de la création d’une instance, la valeur NOT_REQUIRED est utilisée. Si ce champ n’est pas spécifié lors de la mise à jour ou de l’application d’un patch à une instance existante, la valeur reste inchangée.
Valeurs autorisées :
CONNECTOR_ENFORCEMENT_UNSPECIFIED
- Impossible de déterminer si des connecteurs Cloud SQL sont requis ou non.
NOT_REQUIRED
- Les connecteurs Cloud SQL ne sont pas requis.
REQUIRED
- Toutes les connexions doivent utiliser des connecteurs Cloud SQL, y compris le proxy d’authentification Cloud SQL et les connecteurs Java, Python et Go Cloud SQL. Remarque : si cette valeur est définie, tous les réseaux autorisés existants seront désactivés.
crash_safe_replication_enabled
Type : BOOLEAN
Nom fournisseur : crashSafeReplicationEnabled
Description : Configuration spécifique aux réplicas avec accès en lecture. Indique si les flags de base de données pour la réplication crash-safe sont activés. Cette propriété était uniquement applicable aux instances de première génération.
data_disk_size_gb
Type : INT64
Nom fournisseur : dataDiskSizeGb
Description : La taille du disque de données, en Go. Le taille minimum est de 10 Go.
data_disk_type
Type : STRING
Nom fournisseur : dataDiskType
Description : Le type de disque de données : PD_SSD
(par défaut) ou PD_HDD
. Non applicable aux instances de première génération.
Valeurs autorisées :
SQL_DATA_DISK_TYPE_UNSPECIFIED
- Le type de disque de données est inconnu.
PD_SSD
- Disque de données SSD.
PD_HDD
- Disque de données HDD.
OBSOLETE_LOCAL_SSD
- Ce champ est obsolète et sera supprimé dans une prochaine version de l’API.
database_flags
Type : UNORDERED_LIST_STRUCT
Nom fournisseur : databaseFlags
Description : Les flags de base de données passés à l’instance au démarrage.
name
Type : STRING
Nom fournisseur : name
Description : Le nom du flag. Ces flags sont passés au démarrage de l’instance, vous devez donc inclure les options serveur et les variables système. Les flags sont spécifiés avec des underscores et non des tirets. Pour en savoir plus, consultez Configurer les flags de base de données dans la documentation Cloud SQL.
value
Type : STRING
Nom fournisseur : value
Description : La valeur du flag. Les flags booléens sont définis sur on
pour true et off
pour false. Ce champ doit être omis si le flag n’accepte pas de valeur.
database_replication_enabled
Type : BOOLEAN
Nom fournisseur : databaseReplicationEnabled
Description : Configuration spécifique aux réplicas avec accès en lecture. Détermine si la réplication est activée ou non. AVERTISSEMENT : La modification de cette propriété entraînera le redémarrage de l’instance.
deletion_protection_enabled
Type : BOOLEAN
Nom fournisseur : deletionProtectionEnabled
Description : Configuration pour empêcher la suppression accidentelle d’une instance.
deny_maintenance_periods
Type : UNORDERED_LIST_STRUCT
Nom fournisseur : denyMaintenancePeriods
Description : Périodes de refus des maintenances.
end_date
Type : STRING
Nom fournisseur : endDate
Description : La date de fin de la période de refus des maintenances. Si l’année de la date de fin est vide, l’année de la date de début doit l’être elle aussi. Si l’année est vide, la période de refus des maintenances s’appliquera chaque année. La date doit être au format aaaa-mm-jj (par exemple 2020-11-01) ou au format mm-jj (par exemple 11-01).
start_date
Type : STRING
Nom fournisseur : startDate
Description : La date de début de la période de refus des maintenances. Si l’année de la date de début est vide, l’année de la date de fin doit l’être elle aussi. Si l’année est vide, la période de refus des maintenances s’appliquera chaque année. La date doit être au format aaaa-mm-jj (par exemple 2020-11-01) ou au format mm-jj (par exemple 11-01).
time
Type : STRING
Nom fournisseur : time
Description : Heure au fuseau horaire UTC à laquelle la période de refus des maintenances commence à la start_date spécifiée et se termine à la end_date spécifiée. L’heure doit être au format HH:mm:SS. Exemple : 00:00:00.
insights_config
Type : STRUCT
Nom fournisseur : insightsConfig
Description : Configuration des insights. Concerne uniquement Postgres pour le moment.
query_insights_enabled
Type : BOOLEAN
Nom fournisseur : queryInsightsEnabled
Description : Détermine si la fonctionnalité Insights sur les requêtes est activée ou non.
query_plans_per_minute
Type : INT32
Nom fournisseur : queryPlansPerMinute
Description : Nombre de plans d’exécution de requête capturés par Insights par minute pour toutes les requêtes combinées. Valeur par défaut : 5.
query_string_length
Type : INT32
Nom fournisseur : queryStringLength
Description : Longueur maximale des requêtes en octets. Valeur par défaut : 1024 octets. Plage : 256-4500 octets. Si la longueur d’une requête dépasse la valeur de ce champ, elle est alors tronquée à la valeur spécifiée. Si cette propriété n’est pas définie, la valeur par défaut est utilisée. La modification de la longueur de requête entraînera le redémarrage de la base de données.
record_application_tags
Type : BOOLEAN
Nom fournisseur : recordApplicationTags
Description : Détermine si la fonctionnalité Insights sur les requêtes doit enregistrer les tags d’application à partir de la requête.
record_client_address
Type : BOOLEAN
Nom fournisseur : recordClientAddress
Description : Détermine si la fonctionnalité Insights sur les requêtes doit enregistrer l’adresse du client.
ip_configuration
Type : STRUCT
Nom fournisseur : ipConfiguration
Description : Les paramètres de gestion de l’IP. Permet d’activer ou de désactiver l’IP de l’instance et de gérer les réseaux externes autorisés à se connecter à l’instance. L’adresse IPv4 ne peut pas être désactivée pour les instances de deuxième génération.
allocated_ip_range
Type : STRING
Nom fournisseur : allocatedIpRange
Description : Le nom de la plage d’IP allouée pour l’instance Cloud SQL à IP privée. Exemple : google-managed-services-default. Si cette propriété est définie, l’IP de l’instance sera créée dans la plage allouée. Le nom de la plage doit répondre aux critères RFC 1035 Plus précisément, le nom doit comporter entre 1 et 63 caractères et respecter l’expression régulière [a-z]([-a-z0-9]*[a-z0-9])?.
authorized_networks
Type : UNORDERED_LIST_STRUCT
Nom fournisseur : authorizedNetworks
Description : La liste des réseaux externes autorisés à se connecter à l’instance via l’IP. La syntaxe CIDR (avec barre oblique) doit être utilisée. Exemple : 157.197.200.0/24
.
expiration_time
Type : TIMESTAMP
Nom fournisseur : expirationTime
Description : La date d’expiration de cette entrée du contrôle des accès au format RFC 3339, par exemple : 2012-11-15T16:19:00.094Z
.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#aclEntry
.
name
Type : STRING
Nom fournisseur : name
Description : Facultatif. Une étiquette utilisée pour identifier cette entrée.
value
Type : STRING
Nom fournisseur : value
Description : La valeur mise sur liste d’autorisation pour le contrôle des accès.
enable_private_path_for_google_cloud_services
Type : BOOLEAN
Nom fournisseur : enablePrivatePathForGoogleCloudServices
Description : Permet de contrôler la connectivité aux instances à IP privée des services Google, tels que BigQuery.
ipv4_enabled
Type : BOOLEAN
Nom fournisseur : ipv4Enabled
Description : Détermine si une adresse IP publique est allouée à l’instance ou non.
private_network
Type : STRING
Nom fournisseur : privateNetwork
Description : Le lien de ressource pour le réseau VPC à partir duquel l’instance Cloud SQL est accessible pour l’IP privée. Exemple : /projects/myProject/global/networks/default
. Ce paramètre peut être mis à jour, mais il ne peut pas être supprimé une fois défini.
require_ssl
Type : BOOLEAN
Nom fournisseur : requireSsl
Description : Détermine si le chiffrement SSL doit être exigé sur l’IP ou non.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#settings
.
location_preference
Type : STRUCT
Nom fournisseur : locationPreference
Description : Préférences relatives aux emplacements. Permet à l’instance d’être située le plus près possible d’une application App Engine ou d’une zone Compute Engine pour des performances optimales. Le placement au même endroit que l’application App Engine était uniquement applicable aux instances de première génération.
follow_gae_application
Type : STRING
Nom fournisseur : followGaeApplication
Description : L’application App Engine à suivre. Doit être dans la même région que l’instance Cloud SQL. AVERTISSEMENT : La modification de cette propriété entraînera le redémarrage de l’instance.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#locationPreference
.
secondary_zone
Type : STRING
Nom fournisseur : secondaryZone
Description : La zone Compute Engine à utiliser de préférence comme zone secondaire/de failover (exemple : us-central1-a, us-central1-b, etc.).
zone
Type : STRING
Nom fournisseur : zone
Description : La zone Compute Engine à utiliser de préférence (exemple : us-central1-a, us-central1-b, etc.). AVERTISSEMENT : La modification de ce paramètre peut entraîner le redémarrage de l’instance.
maintenance_window
Type : STRUCT
Nom fournisseur : maintenanceWindow
Description : La fenêtre de maintenance pour cette instance. Indique à quel moment l’instance peut être redémarrée à des fins de maintenance.
day
Type : INT32
Nom fournisseur : day
Description : Jour de la semaine (de 1 à 7), le premier jour étant le lundi.
hour
Type : INT32
Nom fournisseur : hour
Description : Heure de la journée, de 0 à 23.
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#maintenanceWindow
.
update_track
Type : STRING
Nom fournisseur : updateTrack
Description : Paramètre de planification des maintenances : canary
(à l’avance) ou stable
(plus tard). En savoir plus.
Valeurs autorisées :
SQL_UPDATE_TRACK_UNSPECIFIED
- Le paramètre de planification des maintenances est inconnu.
canary
- Pour les mises à jour de l’instance qui nécessitent un redémarrage, cette option indique qu’il est préférable de redémarrer l’instance au début de la fenêtre de maintenance afin de passer à la nouvelle version.
stable
- Pour les mises à jour de l’instance qui nécessitent un redémarrage, cette option indique qu’il est préférable de laisser Cloud SQL choisir quand procéder au redémarrage (dans la fenêtre de maintenance définie, le cas échéant).
password_validation_policy
Type : STRUCT
Nom fournisseur : passwordValidationPolicy
Description : La politique de validation du mot de passe de l’utilisateur local de l’instance.
complexity
Type : STRING
Nom fournisseur : complexity
Description : La complexité du mot de passe.
Valeurs autorisées :
COMPLEXITY_UNSPECIFIED
- Aucune vérification de la complexité n’est spécifiée.
COMPLEXITY_DEFAULT
- Une combinaison de caractères minuscules, majuscules, numériques et non alphanumériques.
disallow_username_substring
Type : BOOLEAN
Nom fournisseur : disallowUsernameSubstring
Description : Permet d’empêcher le mot de passe de contenir le nom d’utilisateur.
enable_password_policy
Type : BOOLEAN
Nom fournisseur : enablePasswordPolicy
Description : Détermine si la politique relative aux mots de passe est activée ou non.
min_length
Type : INT32
Nom fournisseur : minLength
Description : Le nombre minimum de caractères autorisés.
password_change_interval
Type : STRING
Nom fournisseur : passwordChangeInterval
Description : Intervalle minimum après lequel le mot de passe peut être modifié. Ce flag est uniquement compatible avec PostgreSQL.
reuse_interval
Type : INT32
Nom fournisseur : reuseInterval
Description : Nombre de mots de passe précédents ne pouvant pas être réutilisés.
pricing_plan
Type : STRING
Nom fournisseur : pricingPlan
Description : Le mode de facturation pour cette instance. Peut être défini sur PER_USE
ou PACKAGE
. Seule l’option PER_USE
est prise en charge pour les instances de deuxième génération.
Valeurs autorisées :
SQL_PRICING_PLAN_UNSPECIFIED
- Mode de facturation inconnu pour cette instance.
PACKAGE
- L’instance est facturée à un tarif fixe mensuel.
PER_USE
- L’instance est facturée par nombre d’utilisations.
replication_type
Type : STRING
Nom fournisseur : replicationType
Description : Le type de réplication utilisé par cette. Peut être défini sur ASYNCHRONOUS
ou SYNCHRONOUS
. (Obsolète) Cette propriété était uniquement applicable aux instances de première génération.
Valeurs autorisées :
SQL_REPLICATION_TYPE_UNSPECIFIED
- Type de réplication inconnu pour une instance Cloud SQL.
SYNCHRONOUS
- Mode de réplication synchrone pour les instances de première génération. Il s’agit de la valeur par défaut.
ASYNCHRONOUS
- Mode de réplication asynchrone pour les instances de première génération. Offre un léger gain de performance, mais en cas de défaillance alors que cette option est définie sur asynchrone, vous risquez de perdre plusieurs secondes de mise à jour de vos données.
settings_version
Type : INT64
Nom fournisseur : settingsVersion
Description : La version des paramètres de l’instance. Ce champ est obligatoire s’assurer que les mises à jour simultanées sont traitées correctement. Pendant une mise à jour, utilisez la valeur settingsVersion la plus récente pour cette instance et n’essayez pas de mettre à jour cette valeur.
sql_server_audit_config
Type : STRUCT
Nom fournisseur : sqlServerAuditConfig
Description : Configuration d’audit spécifique à SQL Server.
bucket
Type : STRING
Nom fournisseur : bucket
Description : Le nom du bucket de destination (exemple : gs://monbucket).
kind
Type : STRING
Nom fournisseur : kind
Description : Correspond toujours à sql#sqlServerAuditConfig
retention_interval
Type : STRING
Nom fournisseur : retentionInterval
Description : Durée pendant laquelle les fichiers d’audit générés doivent être conservés.
upload_interval
Type : STRING
Nom fournisseur : uploadInterval
Description : Fréquence de transmission des fichiers d’audit générés.
storage_auto_resize
Type : BOOLEAN
Nom fournisseur : storageAutoResize
Description : Permet d’activer ou de désactiver l’augmentation automatique de la taille du stockage. Valeur par défaut : true.
storage_auto_resize_limit
Type : INT64
Nom fournisseur : storageAutoResizeLimit
Description : La taille maximale jusqu’à laquelle la capacité de stockage peut être automatiquement augmentée. La valeur par défaut 0, ce qui correspond à aucune limite.
tier
Type : STRING
Nom fournisseur : tier
Description : Le niveau (ou type de machine) pour cette instance, par exemple : db-custom-1-3840
. AVERTISSEMENT : La modification de cette propriété entraînera le redémarrage de l’instance.
time_zone
Type : STRING
Nom fournisseur : timeZone
Description : Fuseau horaire du serveur, s’applique uniquement à Cloud SQL pour SQL Server.
user_labels
Type : UNORDERED_LIST_STRING
Nom fournisseur : userLabels
Description : Étiquettes spécifiées par l’utilisateur, représentées sous la forme d’un dictionnaire où chaque étiquette est une paire key/value unique.
state
Type : STRING
Nom fournisseur : state
Description : L’état actuel de l’instance Cloud SQL.
Valeurs autorisées :
SQL_INSTANCE_STATE_UNSPECIFIED
- L’état de l’instance est inconnu.
RUNNABLE
- L’instance est en cours d’exécution ou a été arrêtée par son propriétaire.
SUSPENDED
- L’instance est indisponible, par exemple en raison d’un problème de facturation.
PENDING_DELETE
- L’instance est en cours de suppression.
PENDING_CREATE
- L’instance est en cours de création.
MAINTENANCE
- L’instance est indisponible pour cause de maintenance.
FAILED
- La création de l’instance a échoué, ou une erreur fatale s’est produite pendant la maintenance.
ONLINE_MAINTENANCE
- Obsolète
suspension_reason
Type : UNORDERED_LIST_STRING
Nom fournisseur : suspensionReason
Description : Si l’état de l’instance est SUSPENDED, indique le motif de la suspension.
Type : UNORDERED_LIST_STRING