Files
genai-toolbox/docs/en/resources/tools/cloudsql/cloudsqlmssqlcreateinstance.md
prernakakkar-google b17652309d feat(prebuilt/cloud-sql-mssql): add create instance tool for mssql (#1440)
## Description

---
This pull request introduces a new tool,
cloud-sql-mssql-create-instance, which allows users to create Cloud SQL
PG instances directly from the toolbox. The tool is designed to simplify
the instance creation process by providing sensible defaults while still
offering flexibility for advanced configurations.

Key Features of the New Tool:

Simplified Instance Creation: The tool introduces an editionPreset
parameter that can be set to either "Production" or "Development". This
allows users to easily create instances with appropriate settings for
their environment without needing to specify low-level configuration
details.

Production Preset: Configures a high-availability, performance-optimized
instance.
Development Preset: Configures a cost-effective, general-purpose
instance suitable for testing and development.

## PR Checklist

---
> Thank you for opening a Pull Request! Before submitting your PR, there
are a
> few things you can do to make sure it goes smoothly:

- [ ] Make sure you reviewed

[CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md)
- [ ] Make sure to open an issue as a

[bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose)
before writing your code! That way we can discuss the change, evaluate
  designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
- [ ] Make sure to add `!` if this involve a breaking change

🛠️ Fixes #<issue_number_goes_here>
2025-09-16 13:38:30 +05:30

2.9 KiB

title, type, weight, description
title type weight description
cloud-sql-mssql-create-instance docs 10 Create a Cloud SQL for SQL Server instance.

The cloud-sql-mssql-create-instance tool creates a Cloud SQL for SQL Server instance using the Cloud SQL Admin API.

{{< notice info dd>}} This tool uses a source of kind cloud-sql-admin. {{< /notice >}}

Example

tools:
  create-sql-instance:
    kind: cloud-sql-mssql-create-instance
    source: cloud-sql-admin-source
    description: "Creates a SQL Server instance using `Production` and `Development` presets. For the `Development` template, it chooses a 2 vCPU, 8 GiB RAM (`db-custom-2-8192`) configuration with Non-HA/zonal availability. For the `Production` template, it chooses a 4 vCPU, 26 GiB RAM (`db-custom-4-26624`) configuration with HA/regional availability. The Enterprise edition is used in both cases. The default database version is `SQLSERVER_2022_STANDARD`. The agent should ask the user if they want to use a different version."

Reference

Tool Configuration

field type required description
kind string true Must be "cloud-sql-mssql-create-instance".
source string true The name of the cloud-sql-admin source to use.
description string false A description of the tool.

Tool Inputs

parameter type required description
project string true The project ID.
name string true The name of the instance.
databaseVersion string false The database version for SQL Server. If not specified, defaults to the latest available version (e.g., SQLSERVER_2022_STANDARD).
rootPassword string true The root password for the instance.
editionPreset string false The edition of the instance. Can be Production or Development. This determines the default machine type and availability. Defaults to Development.