1. Packages
  2. stackit
  3. API Docs
  4. MariadbInstance
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud
stackit logo
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud

    MariaDB instance resource schema. Must have a region specified in the provider configuration.

    Example Usage

    resource "stackit_mariadb_instance" "example" {
      project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      name       = "example-instance"
      version    = "10.11"
      plan_name  = "stackit-mariadb-1.2.10-replica"
      parameters = {
        sgw_acl = "193.148.160.0/19,45.129.40.0/21,45.135.244.0/22"
      }
    }
    
    # Only use the import statement, if you want to import an existing mariadb instance
    import {
      to = stackit_mariadb_instance.import-example
      id = "${var.project_id},${var.mariadb_instance_id}"
    }
    

    Create MariadbInstance Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new MariadbInstance(name: string, args: MariadbInstanceArgs, opts?: CustomResourceOptions);
    @overload
    def MariadbInstance(resource_name: str,
                        args: MariadbInstanceArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def MariadbInstance(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        plan_name: Optional[str] = None,
                        project_id: Optional[str] = None,
                        version: Optional[str] = None,
                        name: Optional[str] = None,
                        parameters: Optional[MariadbInstanceParametersArgs] = None)
    func NewMariadbInstance(ctx *Context, name string, args MariadbInstanceArgs, opts ...ResourceOption) (*MariadbInstance, error)
    public MariadbInstance(string name, MariadbInstanceArgs args, CustomResourceOptions? opts = null)
    public MariadbInstance(String name, MariadbInstanceArgs args)
    public MariadbInstance(String name, MariadbInstanceArgs args, CustomResourceOptions options)
    
    type: stackit:MariadbInstance
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args MariadbInstanceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args MariadbInstanceArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args MariadbInstanceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MariadbInstanceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MariadbInstanceArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var mariadbInstanceResource = new Stackit.MariadbInstance("mariadbInstanceResource", new()
    {
        PlanName = "string",
        ProjectId = "string",
        Version = "string",
        Name = "string",
        Parameters = new Stackit.Inputs.MariadbInstanceParametersArgs
        {
            EnableMonitoring = false,
            Graphite = "string",
            MaxDiskThreshold = 0,
            MetricsFrequency = 0,
            MetricsPrefix = "string",
            MonitoringInstanceId = "string",
            SgwAcl = "string",
            Syslogs = new[]
            {
                "string",
            },
        },
    });
    
    example, err := stackit.NewMariadbInstance(ctx, "mariadbInstanceResource", &stackit.MariadbInstanceArgs{
    	PlanName:  pulumi.String("string"),
    	ProjectId: pulumi.String("string"),
    	Version:   pulumi.String("string"),
    	Name:      pulumi.String("string"),
    	Parameters: &stackit.MariadbInstanceParametersArgs{
    		EnableMonitoring:     pulumi.Bool(false),
    		Graphite:             pulumi.String("string"),
    		MaxDiskThreshold:     pulumi.Int(0),
    		MetricsFrequency:     pulumi.Int(0),
    		MetricsPrefix:        pulumi.String("string"),
    		MonitoringInstanceId: pulumi.String("string"),
    		SgwAcl:               pulumi.String("string"),
    		Syslogs: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    	},
    })
    
    var mariadbInstanceResource = new MariadbInstance("mariadbInstanceResource", MariadbInstanceArgs.builder()
        .planName("string")
        .projectId("string")
        .version("string")
        .name("string")
        .parameters(MariadbInstanceParametersArgs.builder()
            .enableMonitoring(false)
            .graphite("string")
            .maxDiskThreshold(0)
            .metricsFrequency(0)
            .metricsPrefix("string")
            .monitoringInstanceId("string")
            .sgwAcl("string")
            .syslogs("string")
            .build())
        .build());
    
    mariadb_instance_resource = stackit.MariadbInstance("mariadbInstanceResource",
        plan_name="string",
        project_id="string",
        version="string",
        name="string",
        parameters={
            "enable_monitoring": False,
            "graphite": "string",
            "max_disk_threshold": 0,
            "metrics_frequency": 0,
            "metrics_prefix": "string",
            "monitoring_instance_id": "string",
            "sgw_acl": "string",
            "syslogs": ["string"],
        })
    
    const mariadbInstanceResource = new stackit.MariadbInstance("mariadbInstanceResource", {
        planName: "string",
        projectId: "string",
        version: "string",
        name: "string",
        parameters: {
            enableMonitoring: false,
            graphite: "string",
            maxDiskThreshold: 0,
            metricsFrequency: 0,
            metricsPrefix: "string",
            monitoringInstanceId: "string",
            sgwAcl: "string",
            syslogs: ["string"],
        },
    });
    
    type: stackit:MariadbInstance
    properties:
        name: string
        parameters:
            enableMonitoring: false
            graphite: string
            maxDiskThreshold: 0
            metricsFrequency: 0
            metricsPrefix: string
            monitoringInstanceId: string
            sgwAcl: string
            syslogs:
                - string
        planName: string
        projectId: string
        version: string
    

    MariadbInstance Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The MariadbInstance resource accepts the following input properties:

    PlanName string
    The selected plan name.
    ProjectId string
    STACKIT project ID to which the instance is associated.
    Version string
    The service version.
    Name string
    Instance name.
    Parameters MariadbInstanceParameters
    PlanName string
    The selected plan name.
    ProjectId string
    STACKIT project ID to which the instance is associated.
    Version string
    The service version.
    Name string
    Instance name.
    Parameters MariadbInstanceParametersArgs
    planName String
    The selected plan name.
    projectId String
    STACKIT project ID to which the instance is associated.
    version String
    The service version.
    name String
    Instance name.
    parameters MariadbInstanceParameters
    planName string
    The selected plan name.
    projectId string
    STACKIT project ID to which the instance is associated.
    version string
    The service version.
    name string
    Instance name.
    parameters MariadbInstanceParameters
    plan_name str
    The selected plan name.
    project_id str
    STACKIT project ID to which the instance is associated.
    version str
    The service version.
    name str
    Instance name.
    parameters MariadbInstanceParametersArgs
    planName String
    The selected plan name.
    projectId String
    STACKIT project ID to which the instance is associated.
    version String
    The service version.
    name String
    Instance name.
    parameters Property Map

    Outputs

    All input properties are implicitly available as output properties. Additionally, the MariadbInstance resource produces the following output properties:

    CfGuid string
    CfOrganizationGuid string
    CfSpaceGuid string
    DashboardUrl string
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageUrl string
    InstanceId string
    ID of the MariaDB instance.
    PlanId string
    The selected plan ID.
    CfGuid string
    CfOrganizationGuid string
    CfSpaceGuid string
    DashboardUrl string
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageUrl string
    InstanceId string
    ID of the MariaDB instance.
    PlanId string
    The selected plan ID.
    cfGuid String
    cfOrganizationGuid String
    cfSpaceGuid String
    dashboardUrl String
    id String
    The provider-assigned unique ID for this managed resource.
    imageUrl String
    instanceId String
    ID of the MariaDB instance.
    planId String
    The selected plan ID.
    cfGuid string
    cfOrganizationGuid string
    cfSpaceGuid string
    dashboardUrl string
    id string
    The provider-assigned unique ID for this managed resource.
    imageUrl string
    instanceId string
    ID of the MariaDB instance.
    planId string
    The selected plan ID.
    cf_guid str
    cf_organization_guid str
    cf_space_guid str
    dashboard_url str
    id str
    The provider-assigned unique ID for this managed resource.
    image_url str
    instance_id str
    ID of the MariaDB instance.
    plan_id str
    The selected plan ID.
    cfGuid String
    cfOrganizationGuid String
    cfSpaceGuid String
    dashboardUrl String
    id String
    The provider-assigned unique ID for this managed resource.
    imageUrl String
    instanceId String
    ID of the MariaDB instance.
    planId String
    The selected plan ID.

    Look up Existing MariadbInstance Resource

    Get an existing MariadbInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: MariadbInstanceState, opts?: CustomResourceOptions): MariadbInstance
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            cf_guid: Optional[str] = None,
            cf_organization_guid: Optional[str] = None,
            cf_space_guid: Optional[str] = None,
            dashboard_url: Optional[str] = None,
            image_url: Optional[str] = None,
            instance_id: Optional[str] = None,
            name: Optional[str] = None,
            parameters: Optional[MariadbInstanceParametersArgs] = None,
            plan_id: Optional[str] = None,
            plan_name: Optional[str] = None,
            project_id: Optional[str] = None,
            version: Optional[str] = None) -> MariadbInstance
    func GetMariadbInstance(ctx *Context, name string, id IDInput, state *MariadbInstanceState, opts ...ResourceOption) (*MariadbInstance, error)
    public static MariadbInstance Get(string name, Input<string> id, MariadbInstanceState? state, CustomResourceOptions? opts = null)
    public static MariadbInstance get(String name, Output<String> id, MariadbInstanceState state, CustomResourceOptions options)
    resources:  _:    type: stackit:MariadbInstance    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    CfGuid string
    CfOrganizationGuid string
    CfSpaceGuid string
    DashboardUrl string
    ImageUrl string
    InstanceId string
    ID of the MariaDB instance.
    Name string
    Instance name.
    Parameters MariadbInstanceParameters
    PlanId string
    The selected plan ID.
    PlanName string
    The selected plan name.
    ProjectId string
    STACKIT project ID to which the instance is associated.
    Version string
    The service version.
    CfGuid string
    CfOrganizationGuid string
    CfSpaceGuid string
    DashboardUrl string
    ImageUrl string
    InstanceId string
    ID of the MariaDB instance.
    Name string
    Instance name.
    Parameters MariadbInstanceParametersArgs
    PlanId string
    The selected plan ID.
    PlanName string
    The selected plan name.
    ProjectId string
    STACKIT project ID to which the instance is associated.
    Version string
    The service version.
    cfGuid String
    cfOrganizationGuid String
    cfSpaceGuid String
    dashboardUrl String
    imageUrl String
    instanceId String
    ID of the MariaDB instance.
    name String
    Instance name.
    parameters MariadbInstanceParameters
    planId String
    The selected plan ID.
    planName String
    The selected plan name.
    projectId String
    STACKIT project ID to which the instance is associated.
    version String
    The service version.
    cfGuid string
    cfOrganizationGuid string
    cfSpaceGuid string
    dashboardUrl string
    imageUrl string
    instanceId string
    ID of the MariaDB instance.
    name string
    Instance name.
    parameters MariadbInstanceParameters
    planId string
    The selected plan ID.
    planName string
    The selected plan name.
    projectId string
    STACKIT project ID to which the instance is associated.
    version string
    The service version.
    cf_guid str
    cf_organization_guid str
    cf_space_guid str
    dashboard_url str
    image_url str
    instance_id str
    ID of the MariaDB instance.
    name str
    Instance name.
    parameters MariadbInstanceParametersArgs
    plan_id str
    The selected plan ID.
    plan_name str
    The selected plan name.
    project_id str
    STACKIT project ID to which the instance is associated.
    version str
    The service version.
    cfGuid String
    cfOrganizationGuid String
    cfSpaceGuid String
    dashboardUrl String
    imageUrl String
    instanceId String
    ID of the MariaDB instance.
    name String
    Instance name.
    parameters Property Map
    planId String
    The selected plan ID.
    planName String
    The selected plan name.
    projectId String
    STACKIT project ID to which the instance is associated.
    version String
    The service version.

    Supporting Types

    MariadbInstanceParameters, MariadbInstanceParametersArgs

    EnableMonitoring bool
    Enable monitoring.
    Graphite string
    Graphite server URL (host and port). If set, monitoring with Graphite will be enabled.
    MaxDiskThreshold int
    The maximum disk threshold in MB. If the disk usage exceeds this threshold, the instance will be stopped.
    MetricsFrequency int
    The frequency in seconds at which metrics are emitted.
    MetricsPrefix string
    The prefix for the metrics. Could be useful when using Graphite monitoring to prefix the metrics with a certain value, like an API key
    MonitoringInstanceId string
    The ID of the STACKIT monitoring instance. Monitoring instances with the plan "Observability-Monitoring-Starter" are not supported.
    SgwAcl string
    Comma separated list of IP networks in CIDR notation which are allowed to access this instance.
    Syslogs List<string>
    List of syslog servers to send logs to.
    EnableMonitoring bool
    Enable monitoring.
    Graphite string
    Graphite server URL (host and port). If set, monitoring with Graphite will be enabled.
    MaxDiskThreshold int
    The maximum disk threshold in MB. If the disk usage exceeds this threshold, the instance will be stopped.
    MetricsFrequency int
    The frequency in seconds at which metrics are emitted.
    MetricsPrefix string
    The prefix for the metrics. Could be useful when using Graphite monitoring to prefix the metrics with a certain value, like an API key
    MonitoringInstanceId string
    The ID of the STACKIT monitoring instance. Monitoring instances with the plan "Observability-Monitoring-Starter" are not supported.
    SgwAcl string
    Comma separated list of IP networks in CIDR notation which are allowed to access this instance.
    Syslogs []string
    List of syslog servers to send logs to.
    enableMonitoring Boolean
    Enable monitoring.
    graphite String
    Graphite server URL (host and port). If set, monitoring with Graphite will be enabled.
    maxDiskThreshold Integer
    The maximum disk threshold in MB. If the disk usage exceeds this threshold, the instance will be stopped.
    metricsFrequency Integer
    The frequency in seconds at which metrics are emitted.
    metricsPrefix String
    The prefix for the metrics. Could be useful when using Graphite monitoring to prefix the metrics with a certain value, like an API key
    monitoringInstanceId String
    The ID of the STACKIT monitoring instance. Monitoring instances with the plan "Observability-Monitoring-Starter" are not supported.
    sgwAcl String
    Comma separated list of IP networks in CIDR notation which are allowed to access this instance.
    syslogs List<String>
    List of syslog servers to send logs to.
    enableMonitoring boolean
    Enable monitoring.
    graphite string
    Graphite server URL (host and port). If set, monitoring with Graphite will be enabled.
    maxDiskThreshold number
    The maximum disk threshold in MB. If the disk usage exceeds this threshold, the instance will be stopped.
    metricsFrequency number
    The frequency in seconds at which metrics are emitted.
    metricsPrefix string
    The prefix for the metrics. Could be useful when using Graphite monitoring to prefix the metrics with a certain value, like an API key
    monitoringInstanceId string
    The ID of the STACKIT monitoring instance. Monitoring instances with the plan "Observability-Monitoring-Starter" are not supported.
    sgwAcl string
    Comma separated list of IP networks in CIDR notation which are allowed to access this instance.
    syslogs string[]
    List of syslog servers to send logs to.
    enable_monitoring bool
    Enable monitoring.
    graphite str
    Graphite server URL (host and port). If set, monitoring with Graphite will be enabled.
    max_disk_threshold int
    The maximum disk threshold in MB. If the disk usage exceeds this threshold, the instance will be stopped.
    metrics_frequency int
    The frequency in seconds at which metrics are emitted.
    metrics_prefix str
    The prefix for the metrics. Could be useful when using Graphite monitoring to prefix the metrics with a certain value, like an API key
    monitoring_instance_id str
    The ID of the STACKIT monitoring instance. Monitoring instances with the plan "Observability-Monitoring-Starter" are not supported.
    sgw_acl str
    Comma separated list of IP networks in CIDR notation which are allowed to access this instance.
    syslogs Sequence[str]
    List of syslog servers to send logs to.
    enableMonitoring Boolean
    Enable monitoring.
    graphite String
    Graphite server URL (host and port). If set, monitoring with Graphite will be enabled.
    maxDiskThreshold Number
    The maximum disk threshold in MB. If the disk usage exceeds this threshold, the instance will be stopped.
    metricsFrequency Number
    The frequency in seconds at which metrics are emitted.
    metricsPrefix String
    The prefix for the metrics. Could be useful when using Graphite monitoring to prefix the metrics with a certain value, like an API key
    monitoringInstanceId String
    The ID of the STACKIT monitoring instance. Monitoring instances with the plan "Observability-Monitoring-Starter" are not supported.
    sgwAcl String
    Comma separated list of IP networks in CIDR notation which are allowed to access this instance.
    syslogs List<String>
    List of syslog servers to send logs to.

    Package Details

    Repository
    stackit stackitcloud/pulumi-stackit
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the stackit Terraform Provider.
    stackit logo
    Viewing docs for stackit v0.0.4
    published on Friday, Feb 20, 2026 by stackitcloud
      Try Pulumi Cloud free. Your team will thank you.