Initiates the creation of a Cloud SQL instance.
* The tool returns a long-running operation. Use the `get_operation` tool to poll its status
until the operation completes.
* The instance creation operation can take several minutes. Use a command line tool to pause
for 30 seconds before rechecking the status.
* After you use the `create_instance` tool to create an instance,
you can use the `create_user` tool to create an
IAM user account for the user currently logged in to the project.
* IMPORTANT: Set `ipv4_enabled` to 'false' if creating a Private Service Connect
or a Private Service Access instance.
* Set `free_trial` to 'true' to create a free trial instance. Free trial instances
let you test majority of Cloud SQL features for up to 30 days without financial
commitment. Subject to eligibility and availability.
* The value of `data_api_access` is set to `ALLOW_DATA_API` by default. This setting
lets you execute SQL statements using the `execute_sql` tool and the `executeSql` API.
Unless otherwise specified, a newly created instance uses the default
instance configuration of a development environment.
The following is the default configuration for an instance in a
development environment:
```
{
"tier": "db-perf-optimized-N-2",
"data_disk_size_gb": 100,
"region": "us-central1",
"database_version": "POSTGRES_18",
"edition": "ENTERPRISE_PLUS",
"availability_type": "ZONAL",
"tags": [{"environment": "dev"}]
}
```
The following configuration is recommended for an instance in a
production environment:
```
{
"tier": "db-perf-optimized-N-8",
"data_disk_size_gb": 250,
"region": "us-central1",
"database_version": "POSTGRES_18",
"edition": "ENTERPRISE_PLUS",
"availability_type": "REGIONAL",
"tags": [{"environment": "prod"}]
}
```
The following instance configuration is recommended for SQL Server:
```
{
"tier": "db-perf-optimized-N-8",
"data_disk_size_gb": 250,
"region": "us-central1",
"database_version": "SQLSERVER_2022_STANDARD",
"edition": "ENTERPRISE",
"availability_type": "REGIONAL",
"tags": [{"environment": "prod"}]
}
```