1. Packages
  2. Ionoscloud Provider
  3. API Docs
  4. MariadbCluster
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionoscloud.MariadbCluster

Explore with Pulumi AI

ionoscloud logo
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

    Create MariadbCluster Resource

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

    Constructor syntax

    new MariadbCluster(name: string, args: MariadbClusterArgs, opts?: CustomResourceOptions);
    @overload
    def MariadbCluster(resource_name: str,
                       args: MariadbClusterArgs,
                       opts: Optional[ResourceOptions] = None)
    
    @overload
    def MariadbCluster(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       connections: Optional[MariadbClusterConnectionsArgs] = None,
                       cores: Optional[float] = None,
                       credentials: Optional[MariadbClusterCredentialsArgs] = None,
                       display_name: Optional[str] = None,
                       instances: Optional[float] = None,
                       mariadb_version: Optional[str] = None,
                       ram: Optional[float] = None,
                       storage_size: Optional[float] = None,
                       location: Optional[str] = None,
                       maintenance_window: Optional[MariadbClusterMaintenanceWindowArgs] = None,
                       mariadb_cluster_id: Optional[str] = None,
                       timeouts: Optional[MariadbClusterTimeoutsArgs] = None)
    func NewMariadbCluster(ctx *Context, name string, args MariadbClusterArgs, opts ...ResourceOption) (*MariadbCluster, error)
    public MariadbCluster(string name, MariadbClusterArgs args, CustomResourceOptions? opts = null)
    public MariadbCluster(String name, MariadbClusterArgs args)
    public MariadbCluster(String name, MariadbClusterArgs args, CustomResourceOptions options)
    
    type: ionoscloud:MariadbCluster
    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 MariadbClusterArgs
    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 MariadbClusterArgs
    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 MariadbClusterArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MariadbClusterArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MariadbClusterArgs
    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 mariadbClusterResource = new Ionoscloud.MariadbCluster("mariadbClusterResource", new()
    {
        Connections = new Ionoscloud.Inputs.MariadbClusterConnectionsArgs
        {
            Cidr = "string",
            DatacenterId = "string",
            LanId = "string",
        },
        Cores = 0,
        Credentials = new Ionoscloud.Inputs.MariadbClusterCredentialsArgs
        {
            Password = "string",
            Username = "string",
        },
        DisplayName = "string",
        Instances = 0,
        MariadbVersion = "string",
        Ram = 0,
        StorageSize = 0,
        Location = "string",
        MaintenanceWindow = new Ionoscloud.Inputs.MariadbClusterMaintenanceWindowArgs
        {
            DayOfTheWeek = "string",
            Time = "string",
        },
        MariadbClusterId = "string",
        Timeouts = new Ionoscloud.Inputs.MariadbClusterTimeoutsArgs
        {
            Create = "string",
            Default = "string",
            Delete = "string",
            Update = "string",
        },
    });
    
    example, err := ionoscloud.NewMariadbCluster(ctx, "mariadbClusterResource", &ionoscloud.MariadbClusterArgs{
    	Connections: &ionoscloud.MariadbClusterConnectionsArgs{
    		Cidr:         pulumi.String("string"),
    		DatacenterId: pulumi.String("string"),
    		LanId:        pulumi.String("string"),
    	},
    	Cores: pulumi.Float64(0),
    	Credentials: &ionoscloud.MariadbClusterCredentialsArgs{
    		Password: pulumi.String("string"),
    		Username: pulumi.String("string"),
    	},
    	DisplayName:    pulumi.String("string"),
    	Instances:      pulumi.Float64(0),
    	MariadbVersion: pulumi.String("string"),
    	Ram:            pulumi.Float64(0),
    	StorageSize:    pulumi.Float64(0),
    	Location:       pulumi.String("string"),
    	MaintenanceWindow: &ionoscloud.MariadbClusterMaintenanceWindowArgs{
    		DayOfTheWeek: pulumi.String("string"),
    		Time:         pulumi.String("string"),
    	},
    	MariadbClusterId: pulumi.String("string"),
    	Timeouts: &ionoscloud.MariadbClusterTimeoutsArgs{
    		Create:  pulumi.String("string"),
    		Default: pulumi.String("string"),
    		Delete:  pulumi.String("string"),
    		Update:  pulumi.String("string"),
    	},
    })
    
    var mariadbClusterResource = new MariadbCluster("mariadbClusterResource", MariadbClusterArgs.builder()
        .connections(MariadbClusterConnectionsArgs.builder()
            .cidr("string")
            .datacenterId("string")
            .lanId("string")
            .build())
        .cores(0)
        .credentials(MariadbClusterCredentialsArgs.builder()
            .password("string")
            .username("string")
            .build())
        .displayName("string")
        .instances(0)
        .mariadbVersion("string")
        .ram(0)
        .storageSize(0)
        .location("string")
        .maintenanceWindow(MariadbClusterMaintenanceWindowArgs.builder()
            .dayOfTheWeek("string")
            .time("string")
            .build())
        .mariadbClusterId("string")
        .timeouts(MariadbClusterTimeoutsArgs.builder()
            .create("string")
            .default_("string")
            .delete("string")
            .update("string")
            .build())
        .build());
    
    mariadb_cluster_resource = ionoscloud.MariadbCluster("mariadbClusterResource",
        connections={
            "cidr": "string",
            "datacenter_id": "string",
            "lan_id": "string",
        },
        cores=0,
        credentials={
            "password": "string",
            "username": "string",
        },
        display_name="string",
        instances=0,
        mariadb_version="string",
        ram=0,
        storage_size=0,
        location="string",
        maintenance_window={
            "day_of_the_week": "string",
            "time": "string",
        },
        mariadb_cluster_id="string",
        timeouts={
            "create": "string",
            "default": "string",
            "delete": "string",
            "update": "string",
        })
    
    const mariadbClusterResource = new ionoscloud.MariadbCluster("mariadbClusterResource", {
        connections: {
            cidr: "string",
            datacenterId: "string",
            lanId: "string",
        },
        cores: 0,
        credentials: {
            password: "string",
            username: "string",
        },
        displayName: "string",
        instances: 0,
        mariadbVersion: "string",
        ram: 0,
        storageSize: 0,
        location: "string",
        maintenanceWindow: {
            dayOfTheWeek: "string",
            time: "string",
        },
        mariadbClusterId: "string",
        timeouts: {
            create: "string",
            "default": "string",
            "delete": "string",
            update: "string",
        },
    });
    
    type: ionoscloud:MariadbCluster
    properties:
        connections:
            cidr: string
            datacenterId: string
            lanId: string
        cores: 0
        credentials:
            password: string
            username: string
        displayName: string
        instances: 0
        location: string
        maintenanceWindow:
            dayOfTheWeek: string
            time: string
        mariadbClusterId: string
        mariadbVersion: string
        ram: 0
        storageSize: 0
        timeouts:
            create: string
            default: string
            delete: string
            update: string
    

    MariadbCluster 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 MariadbCluster resource accepts the following input properties:

    Connections MariadbClusterConnections
    The network connection for your cluster. Only one connection is allowed.
    Cores double
    The number of CPU cores per instance.
    Credentials MariadbClusterCredentials
    Credentials for the database user to be created.
    DisplayName string
    The friendly name of your cluster.
    Instances double
    The total number of instances in the cluster (one primary and n-1 secondary).
    MariadbVersion string
    The MariaDB version of your cluster. Cannot be downgraded.
    Ram double
    The amount of memory per instance in gigabytes (GB).
    StorageSize double
    The amount of storage per instance in gigabytes (GB).
    Location string
    The cluster location
    MaintenanceWindow MariadbClusterMaintenanceWindow
    A weekly 4 hour-long window, during which maintenance might occur.
    MariadbClusterId string
    Timeouts MariadbClusterTimeouts
    Connections MariadbClusterConnectionsArgs
    The network connection for your cluster. Only one connection is allowed.
    Cores float64
    The number of CPU cores per instance.
    Credentials MariadbClusterCredentialsArgs
    Credentials for the database user to be created.
    DisplayName string
    The friendly name of your cluster.
    Instances float64
    The total number of instances in the cluster (one primary and n-1 secondary).
    MariadbVersion string
    The MariaDB version of your cluster. Cannot be downgraded.
    Ram float64
    The amount of memory per instance in gigabytes (GB).
    StorageSize float64
    The amount of storage per instance in gigabytes (GB).
    Location string
    The cluster location
    MaintenanceWindow MariadbClusterMaintenanceWindowArgs
    A weekly 4 hour-long window, during which maintenance might occur.
    MariadbClusterId string
    Timeouts MariadbClusterTimeoutsArgs
    connections MariadbClusterConnections
    The network connection for your cluster. Only one connection is allowed.
    cores Double
    The number of CPU cores per instance.
    credentials MariadbClusterCredentials
    Credentials for the database user to be created.
    displayName String
    The friendly name of your cluster.
    instances Double
    The total number of instances in the cluster (one primary and n-1 secondary).
    mariadbVersion String
    The MariaDB version of your cluster. Cannot be downgraded.
    ram Double
    The amount of memory per instance in gigabytes (GB).
    storageSize Double
    The amount of storage per instance in gigabytes (GB).
    location String
    The cluster location
    maintenanceWindow MariadbClusterMaintenanceWindow
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadbClusterId String
    timeouts MariadbClusterTimeouts
    connections MariadbClusterConnections
    The network connection for your cluster. Only one connection is allowed.
    cores number
    The number of CPU cores per instance.
    credentials MariadbClusterCredentials
    Credentials for the database user to be created.
    displayName string
    The friendly name of your cluster.
    instances number
    The total number of instances in the cluster (one primary and n-1 secondary).
    mariadbVersion string
    The MariaDB version of your cluster. Cannot be downgraded.
    ram number
    The amount of memory per instance in gigabytes (GB).
    storageSize number
    The amount of storage per instance in gigabytes (GB).
    location string
    The cluster location
    maintenanceWindow MariadbClusterMaintenanceWindow
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadbClusterId string
    timeouts MariadbClusterTimeouts
    connections MariadbClusterConnectionsArgs
    The network connection for your cluster. Only one connection is allowed.
    cores float
    The number of CPU cores per instance.
    credentials MariadbClusterCredentialsArgs
    Credentials for the database user to be created.
    display_name str
    The friendly name of your cluster.
    instances float
    The total number of instances in the cluster (one primary and n-1 secondary).
    mariadb_version str
    The MariaDB version of your cluster. Cannot be downgraded.
    ram float
    The amount of memory per instance in gigabytes (GB).
    storage_size float
    The amount of storage per instance in gigabytes (GB).
    location str
    The cluster location
    maintenance_window MariadbClusterMaintenanceWindowArgs
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadb_cluster_id str
    timeouts MariadbClusterTimeoutsArgs
    connections Property Map
    The network connection for your cluster. Only one connection is allowed.
    cores Number
    The number of CPU cores per instance.
    credentials Property Map
    Credentials for the database user to be created.
    displayName String
    The friendly name of your cluster.
    instances Number
    The total number of instances in the cluster (one primary and n-1 secondary).
    mariadbVersion String
    The MariaDB version of your cluster. Cannot be downgraded.
    ram Number
    The amount of memory per instance in gigabytes (GB).
    storageSize Number
    The amount of storage per instance in gigabytes (GB).
    location String
    The cluster location
    maintenanceWindow Property Map
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadbClusterId String
    timeouts Property Map

    Outputs

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

    DnsName string
    The DNS name pointing to your cluster.
    Id string
    The provider-assigned unique ID for this managed resource.
    DnsName string
    The DNS name pointing to your cluster.
    Id string
    The provider-assigned unique ID for this managed resource.
    dnsName String
    The DNS name pointing to your cluster.
    id String
    The provider-assigned unique ID for this managed resource.
    dnsName string
    The DNS name pointing to your cluster.
    id string
    The provider-assigned unique ID for this managed resource.
    dns_name str
    The DNS name pointing to your cluster.
    id str
    The provider-assigned unique ID for this managed resource.
    dnsName String
    The DNS name pointing to your cluster.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing MariadbCluster Resource

    Get an existing MariadbCluster 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?: MariadbClusterState, opts?: CustomResourceOptions): MariadbCluster
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            connections: Optional[MariadbClusterConnectionsArgs] = None,
            cores: Optional[float] = None,
            credentials: Optional[MariadbClusterCredentialsArgs] = None,
            display_name: Optional[str] = None,
            dns_name: Optional[str] = None,
            instances: Optional[float] = None,
            location: Optional[str] = None,
            maintenance_window: Optional[MariadbClusterMaintenanceWindowArgs] = None,
            mariadb_cluster_id: Optional[str] = None,
            mariadb_version: Optional[str] = None,
            ram: Optional[float] = None,
            storage_size: Optional[float] = None,
            timeouts: Optional[MariadbClusterTimeoutsArgs] = None) -> MariadbCluster
    func GetMariadbCluster(ctx *Context, name string, id IDInput, state *MariadbClusterState, opts ...ResourceOption) (*MariadbCluster, error)
    public static MariadbCluster Get(string name, Input<string> id, MariadbClusterState? state, CustomResourceOptions? opts = null)
    public static MariadbCluster get(String name, Output<String> id, MariadbClusterState state, CustomResourceOptions options)
    resources:  _:    type: ionoscloud:MariadbCluster    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:
    Connections MariadbClusterConnections
    The network connection for your cluster. Only one connection is allowed.
    Cores double
    The number of CPU cores per instance.
    Credentials MariadbClusterCredentials
    Credentials for the database user to be created.
    DisplayName string
    The friendly name of your cluster.
    DnsName string
    The DNS name pointing to your cluster.
    Instances double
    The total number of instances in the cluster (one primary and n-1 secondary).
    Location string
    The cluster location
    MaintenanceWindow MariadbClusterMaintenanceWindow
    A weekly 4 hour-long window, during which maintenance might occur.
    MariadbClusterId string
    MariadbVersion string
    The MariaDB version of your cluster. Cannot be downgraded.
    Ram double
    The amount of memory per instance in gigabytes (GB).
    StorageSize double
    The amount of storage per instance in gigabytes (GB).
    Timeouts MariadbClusterTimeouts
    Connections MariadbClusterConnectionsArgs
    The network connection for your cluster. Only one connection is allowed.
    Cores float64
    The number of CPU cores per instance.
    Credentials MariadbClusterCredentialsArgs
    Credentials for the database user to be created.
    DisplayName string
    The friendly name of your cluster.
    DnsName string
    The DNS name pointing to your cluster.
    Instances float64
    The total number of instances in the cluster (one primary and n-1 secondary).
    Location string
    The cluster location
    MaintenanceWindow MariadbClusterMaintenanceWindowArgs
    A weekly 4 hour-long window, during which maintenance might occur.
    MariadbClusterId string
    MariadbVersion string
    The MariaDB version of your cluster. Cannot be downgraded.
    Ram float64
    The amount of memory per instance in gigabytes (GB).
    StorageSize float64
    The amount of storage per instance in gigabytes (GB).
    Timeouts MariadbClusterTimeoutsArgs
    connections MariadbClusterConnections
    The network connection for your cluster. Only one connection is allowed.
    cores Double
    The number of CPU cores per instance.
    credentials MariadbClusterCredentials
    Credentials for the database user to be created.
    displayName String
    The friendly name of your cluster.
    dnsName String
    The DNS name pointing to your cluster.
    instances Double
    The total number of instances in the cluster (one primary and n-1 secondary).
    location String
    The cluster location
    maintenanceWindow MariadbClusterMaintenanceWindow
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadbClusterId String
    mariadbVersion String
    The MariaDB version of your cluster. Cannot be downgraded.
    ram Double
    The amount of memory per instance in gigabytes (GB).
    storageSize Double
    The amount of storage per instance in gigabytes (GB).
    timeouts MariadbClusterTimeouts
    connections MariadbClusterConnections
    The network connection for your cluster. Only one connection is allowed.
    cores number
    The number of CPU cores per instance.
    credentials MariadbClusterCredentials
    Credentials for the database user to be created.
    displayName string
    The friendly name of your cluster.
    dnsName string
    The DNS name pointing to your cluster.
    instances number
    The total number of instances in the cluster (one primary and n-1 secondary).
    location string
    The cluster location
    maintenanceWindow MariadbClusterMaintenanceWindow
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadbClusterId string
    mariadbVersion string
    The MariaDB version of your cluster. Cannot be downgraded.
    ram number
    The amount of memory per instance in gigabytes (GB).
    storageSize number
    The amount of storage per instance in gigabytes (GB).
    timeouts MariadbClusterTimeouts
    connections MariadbClusterConnectionsArgs
    The network connection for your cluster. Only one connection is allowed.
    cores float
    The number of CPU cores per instance.
    credentials MariadbClusterCredentialsArgs
    Credentials for the database user to be created.
    display_name str
    The friendly name of your cluster.
    dns_name str
    The DNS name pointing to your cluster.
    instances float
    The total number of instances in the cluster (one primary and n-1 secondary).
    location str
    The cluster location
    maintenance_window MariadbClusterMaintenanceWindowArgs
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadb_cluster_id str
    mariadb_version str
    The MariaDB version of your cluster. Cannot be downgraded.
    ram float
    The amount of memory per instance in gigabytes (GB).
    storage_size float
    The amount of storage per instance in gigabytes (GB).
    timeouts MariadbClusterTimeoutsArgs
    connections Property Map
    The network connection for your cluster. Only one connection is allowed.
    cores Number
    The number of CPU cores per instance.
    credentials Property Map
    Credentials for the database user to be created.
    displayName String
    The friendly name of your cluster.
    dnsName String
    The DNS name pointing to your cluster.
    instances Number
    The total number of instances in the cluster (one primary and n-1 secondary).
    location String
    The cluster location
    maintenanceWindow Property Map
    A weekly 4 hour-long window, during which maintenance might occur.
    mariadbClusterId String
    mariadbVersion String
    The MariaDB version of your cluster. Cannot be downgraded.
    ram Number
    The amount of memory per instance in gigabytes (GB).
    storageSize Number
    The amount of storage per instance in gigabytes (GB).
    timeouts Property Map

    Supporting Types

    MariadbClusterConnections, MariadbClusterConnectionsArgs

    Cidr string
    The IP and subnet for your cluster.
    DatacenterId string
    The datacenter to connect your cluster to.
    LanId string
    The numeric LAN ID to connect your cluster to.
    Cidr string
    The IP and subnet for your cluster.
    DatacenterId string
    The datacenter to connect your cluster to.
    LanId string
    The numeric LAN ID to connect your cluster to.
    cidr String
    The IP and subnet for your cluster.
    datacenterId String
    The datacenter to connect your cluster to.
    lanId String
    The numeric LAN ID to connect your cluster to.
    cidr string
    The IP and subnet for your cluster.
    datacenterId string
    The datacenter to connect your cluster to.
    lanId string
    The numeric LAN ID to connect your cluster to.
    cidr str
    The IP and subnet for your cluster.
    datacenter_id str
    The datacenter to connect your cluster to.
    lan_id str
    The numeric LAN ID to connect your cluster to.
    cidr String
    The IP and subnet for your cluster.
    datacenterId String
    The datacenter to connect your cluster to.
    lanId String
    The numeric LAN ID to connect your cluster to.

    MariadbClusterCredentials, MariadbClusterCredentialsArgs

    Password string
    The password for a MariaDB user.
    Username string
    The username for the initial MariaDB user. Some system usernames are restricted (e.g 'mariadb', 'admin', 'standby').
    Password string
    The password for a MariaDB user.
    Username string
    The username for the initial MariaDB user. Some system usernames are restricted (e.g 'mariadb', 'admin', 'standby').
    password String
    The password for a MariaDB user.
    username String
    The username for the initial MariaDB user. Some system usernames are restricted (e.g 'mariadb', 'admin', 'standby').
    password string
    The password for a MariaDB user.
    username string
    The username for the initial MariaDB user. Some system usernames are restricted (e.g 'mariadb', 'admin', 'standby').
    password str
    The password for a MariaDB user.
    username str
    The username for the initial MariaDB user. Some system usernames are restricted (e.g 'mariadb', 'admin', 'standby').
    password String
    The password for a MariaDB user.
    username String
    The username for the initial MariaDB user. Some system usernames are restricted (e.g 'mariadb', 'admin', 'standby').

    MariadbClusterMaintenanceWindow, MariadbClusterMaintenanceWindowArgs

    DayOfTheWeek string
    The name of the week day.
    Time string
    Start of the maintenance window in UTC time.
    DayOfTheWeek string
    The name of the week day.
    Time string
    Start of the maintenance window in UTC time.
    dayOfTheWeek String
    The name of the week day.
    time String
    Start of the maintenance window in UTC time.
    dayOfTheWeek string
    The name of the week day.
    time string
    Start of the maintenance window in UTC time.
    day_of_the_week str
    The name of the week day.
    time str
    Start of the maintenance window in UTC time.
    dayOfTheWeek String
    The name of the week day.
    time String
    Start of the maintenance window in UTC time.

    MariadbClusterTimeouts, MariadbClusterTimeoutsArgs

    Create string
    Default string
    Delete string
    Update string
    Create string
    Default string
    Delete string
    Update string
    create String
    default_ String
    delete String
    update String
    create string
    default string
    delete string
    update string
    create String
    default String
    delete String
    update String

    Package Details

    Repository
    ionoscloud ionos-cloud/terraform-provider-ionoscloud
    License
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud