terraform-provider-stackitp.../docs/resources/sqlserverflexbeta_instance.md
Marcel S. Henselin 581e45eb9c
Some checks failed
Publish / Check GoReleaser config (push) Successful in 5s
Publish / Publish provider (push) Failing after 4m6s
feat: SQL server beta and templates refactoring (#32)
## Description

<!-- **Please link some issue here describing what you are trying to achieve.**

In case there is no issue present for your PR, please consider creating one.
At least please give us some description what you are trying to achieve and why your change is needed. -->

relates to #1234

## Checklist

- [ ] Issue was linked above
- [ ] Code format was applied: `make fmt`
- [ ] Examples were added / adjusted (see `examples/` directory)
- [x] Docs are up-to-date: `make generate-docs` (will be checked by CI)
- [ ] Unit tests got implemented or updated
- [ ] Acceptance tests got implemented or updated (see e.g. [here](f5f99d1709/stackit/internal/services/dns/dns_acc_test.go))
- [x] Unit tests are passing: `make test` (will be checked by CI)
- [x] No linter issues: `make lint` (will be checked by CI)

Reviewed-on: #32
Reviewed-by: Andre_Harms <andre.harms@stackit.cloud>
Co-authored-by: Marcel S. Henselin <marcel.henselin@stackit.cloud>
Co-committed-by: Marcel S. Henselin <marcel.henselin@stackit.cloud>
2026-02-05 09:55:32 +00:00

4.5 KiB

page_title subcategory description
stackitprivatepreview_sqlserverflexbeta_instance Resource - stackitprivatepreview

stackitprivatepreview_sqlserverflexbeta_instance (Resource)

Example Usage

# without encryption and SNA
resource "stackitprivatepreview_sqlserverflexbeta_instance" "instance" {
  project_id      = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name            = "example-instance"
  backup_schedule = "0 3 * * *"
  retention_days  = 31
  flavor_id       = "flavor_id"
  storage = {
    class = "premium-perf2-stackit"
    size  = 50
  }
  version = 2022
  network = {
    acl          = ["XXX.XXX.XXX.X/XX", "XX.XXX.XX.X/XX"]
    access_scope = "SNA"
  }
}

# without encryption and PUBLIC
resource "stackitprivatepreview_sqlserverflexbeta_instance" "instance" {
  project_id      = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name            = "example-instance"
  backup_schedule = "0 3 * * *"
  retention_days  = 31
  flavor_id       = "flavor_id"
  storage = {
    class = "premium-perf2-stackit"
    size  = 50
  }
  version = 2022
  network = {
    acl          = ["XXX.XXX.XXX.X/XX", "XX.XXX.XX.X/XX"]
    access_scope = "PUBLIC"
  }
}

# with encryption and SNA
resource "stackitprivatepreview_sqlserverflexbeta_instance" "instance" {
  project_id      = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name            = "example-instance"
  backup_schedule = "0 3 * * *"
  retention_days  = 31
  flavor_id       = "flavor_id"
  storage = {
    class = "premium-perf2-stackit"
    size  = 50
  }
  version = 2022
  encryption = {
    kek_key_id      = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    kek_key_ring_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    kek_key_version = 1
    service_account = "service_account@email"
  }
  network = {
    acl          = ["XXX.XXX.XXX.X/XX", "XX.XXX.XX.X/XX"]
    access_scope = "SNA"
  }
}


# Only use the import statement, if you want to import an existing sqlserverflex instance
import {
  to = stackitprivatepreview_sqlserverflexalpha_instance.import-example
  id = "${var.project_id},${var.region},${var.sql_instance_id}"
}

# import with identity
import {
  to = stackitprivatepreview_sqlserverflexalpha_instance.import-example
  identity = {
    project_id  = var.project_id
    region      = var.region
    instance_id = var.sql_instance_id
  }
}

Schema

Required

  • backup_schedule (String) The schedule for on what time and how often the database backup will be created. The schedule is written as a cron schedule.
  • flavor_id (String) The id of the instance flavor.
  • name (String) The name of the instance.
  • network (Attributes) the network configuration of the instance. (see below for nested schema)
  • retention_days (Number) The days for how long the backup files should be stored before cleaned up. 30 to 365
  • storage (Attributes) The object containing information about the storage size and class. (see below for nested schema)
  • version (String) The sqlserver version used for the instance.

Optional

  • encryption (Attributes) this defines which key to use for storage encryption (see below for nested schema)
  • instance_id (String) The ID of the instance.
  • project_id (String) The STACKIT project ID.
  • region (String) The region which should be addressed

Read-Only

  • edition (String) Edition of the MSSQL server instance
  • id (String) The ID of the instance.
  • is_deletable (Boolean) Whether the instance can be deleted or not.
  • replicas (Number) How many replicas the instance should have.
  • status (String)

Nested Schema for network

Required:

  • acl (List of String) List of IPV4 cidr.

Optional:

  • access_scope (String) The network access scope of the instance

⚠️ Note: This feature is in private preview. Supplying this object is only permitted for enabled accounts. If your account does not have access, the request will be rejected.

Read-Only:

  • instance_address (String)
  • router_address (String)

Nested Schema for storage

Required:

  • class (String) The storage class for the storage.
  • size (Number) The storage size in Gigabytes.

Nested Schema for encryption

Required:

  • kek_key_id (String) The key identifier
  • kek_key_ring_id (String) The keyring identifier
  • kek_key_version (String) The key version
  • service_account (String)