All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.pulumi.azure.cosmosdb.kotlin.CassandraDatacenter.kt Maven / Gradle / Ivy

Go to download

Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.

There is a newer version: 6.14.0.0
Show newest version
@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.azure.cosmosdb.kotlin

import com.pulumi.core.Output
import com.pulumi.kotlin.KotlinCustomResource
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.ResourceMapper
import com.pulumi.kotlin.options.CustomResourceOptions
import com.pulumi.kotlin.options.CustomResourceOptionsBuilder
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.Int
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List

/**
 * Builder for [CassandraDatacenter].
 */
@PulumiTagMarker
public class CassandraDatacenterResourceBuilder internal constructor() {
    public var name: String? = null

    public var args: CassandraDatacenterArgs = CassandraDatacenterArgs()

    public var opts: CustomResourceOptions = CustomResourceOptions()

    /**
     * @param name The _unique_ name of the resulting resource.
     */
    public fun name(`value`: String) {
        this.name = value
    }

    /**
     * @param block The arguments to use to populate this resource's properties.
     */
    public suspend fun args(block: suspend CassandraDatacenterArgsBuilder.() -> Unit) {
        val builder = CassandraDatacenterArgsBuilder()
        block(builder)
        this.args = builder.build()
    }

    /**
     * @param block A bag of options that control this resource's behavior.
     */
    public suspend fun opts(block: suspend CustomResourceOptionsBuilder.() -> Unit) {
        this.opts = com.pulumi.kotlin.options.CustomResourceOptions.opts(block)
    }

    internal fun build(): CassandraDatacenter {
        val builtJavaResource = com.pulumi.azure.cosmosdb.CassandraDatacenter(
            this.name,
            this.args.toJava(),
            this.opts.toJava(),
        )
        return CassandraDatacenter(builtJavaResource)
    }
}

/**
 * Manages a Cassandra Datacenter.
 * > **NOTE:** In order for the `Azure Managed Instances for Apache Cassandra` to work properly the product requires the `Azure Cosmos DB` Application ID to be present and working in your tenant. If the `Azure Cosmos DB` Application ID is missing in your environment you will need to have an administrator of your tenant run the following command to add the `Azure Cosmos DB` Application ID to your tenant:
 * ```powershell
 * New-AzADServicePrincipal -ApplicationId a232010e-820c-4083-83bb-3ace5fc29d0b
 * ```
 * ## Example Usage
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as azure from "@pulumi/azure";
 * import * as azuread from "@pulumi/azuread";
 * const exampleResourceGroup = new azure.core.ResourceGroup("example", {
 *     name: "accexample-rg",
 *     location: "West Europe",
 * });
 * const exampleVirtualNetwork = new azure.network.VirtualNetwork("example", {
 *     name: "example-vnet",
 *     location: exampleResourceGroup.location,
 *     resourceGroupName: exampleResourceGroup.name,
 *     addressSpaces: ["10.0.0.0/16"],
 * });
 * const exampleSubnet = new azure.network.Subnet("example", {
 *     name: "example-subnet",
 *     resourceGroupName: exampleResourceGroup.name,
 *     virtualNetworkName: exampleVirtualNetwork.name,
 *     addressPrefixes: ["10.0.1.0/24"],
 * });
 * const example = azuread.getServicePrincipal({
 *     displayName: "Azure Cosmos DB",
 * });
 * const exampleAssignment = new azure.authorization.Assignment("example", {
 *     scope: exampleVirtualNetwork.id,
 *     roleDefinitionName: "Network Contributor",
 *     principalId: example.then(example => example.objectId),
 * });
 * const exampleCassandraCluster = new azure.cosmosdb.CassandraCluster("example", {
 *     name: "example-cluster",
 *     resourceGroupName: exampleResourceGroup.name,
 *     location: exampleResourceGroup.location,
 *     delegatedManagementSubnetId: exampleSubnet.id,
 *     defaultAdminPassword: "Password1234",
 * });
 * const exampleCassandraDatacenter = new azure.cosmosdb.CassandraDatacenter("example", {
 *     name: "example-datacenter",
 *     location: exampleCassandraCluster.location,
 *     cassandraClusterId: exampleCassandraCluster.id,
 *     delegatedManagementSubnetId: exampleSubnet.id,
 *     nodeCount: 3,
 *     diskCount: 4,
 *     skuName: "Standard_DS14_v2",
 *     availabilityZonesEnabled: false,
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_azure as azure
 * import pulumi_azuread as azuread
 * example_resource_group = azure.core.ResourceGroup("example",
 *     name="accexample-rg",
 *     location="West Europe")
 * example_virtual_network = azure.network.VirtualNetwork("example",
 *     name="example-vnet",
 *     location=example_resource_group.location,
 *     resource_group_name=example_resource_group.name,
 *     address_spaces=["10.0.0.0/16"])
 * example_subnet = azure.network.Subnet("example",
 *     name="example-subnet",
 *     resource_group_name=example_resource_group.name,
 *     virtual_network_name=example_virtual_network.name,
 *     address_prefixes=["10.0.1.0/24"])
 * example = azuread.get_service_principal(display_name="Azure Cosmos DB")
 * example_assignment = azure.authorization.Assignment("example",
 *     scope=example_virtual_network.id,
 *     role_definition_name="Network Contributor",
 *     principal_id=example.object_id)
 * example_cassandra_cluster = azure.cosmosdb.CassandraCluster("example",
 *     name="example-cluster",
 *     resource_group_name=example_resource_group.name,
 *     location=example_resource_group.location,
 *     delegated_management_subnet_id=example_subnet.id,
 *     default_admin_password="Password1234")
 * example_cassandra_datacenter = azure.cosmosdb.CassandraDatacenter("example",
 *     name="example-datacenter",
 *     location=example_cassandra_cluster.location,
 *     cassandra_cluster_id=example_cassandra_cluster.id,
 *     delegated_management_subnet_id=example_subnet.id,
 *     node_count=3,
 *     disk_count=4,
 *     sku_name="Standard_DS14_v2",
 *     availability_zones_enabled=False)
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using Azure = Pulumi.Azure;
 * using AzureAD = Pulumi.AzureAD;
 * return await Deployment.RunAsync(() =>
 * {
 *     var exampleResourceGroup = new Azure.Core.ResourceGroup("example", new()
 *     {
 *         Name = "accexample-rg",
 *         Location = "West Europe",
 *     });
 *     var exampleVirtualNetwork = new Azure.Network.VirtualNetwork("example", new()
 *     {
 *         Name = "example-vnet",
 *         Location = exampleResourceGroup.Location,
 *         ResourceGroupName = exampleResourceGroup.Name,
 *         AddressSpaces = new[]
 *         {
 *             "10.0.0.0/16",
 *         },
 *     });
 *     var exampleSubnet = new Azure.Network.Subnet("example", new()
 *     {
 *         Name = "example-subnet",
 *         ResourceGroupName = exampleResourceGroup.Name,
 *         VirtualNetworkName = exampleVirtualNetwork.Name,
 *         AddressPrefixes = new[]
 *         {
 *             "10.0.1.0/24",
 *         },
 *     });
 *     var example = AzureAD.GetServicePrincipal.Invoke(new()
 *     {
 *         DisplayName = "Azure Cosmos DB",
 *     });
 *     var exampleAssignment = new Azure.Authorization.Assignment("example", new()
 *     {
 *         Scope = exampleVirtualNetwork.Id,
 *         RoleDefinitionName = "Network Contributor",
 *         PrincipalId = example.Apply(getServicePrincipalResult => getServicePrincipalResult.ObjectId),
 *     });
 *     var exampleCassandraCluster = new Azure.CosmosDB.CassandraCluster("example", new()
 *     {
 *         Name = "example-cluster",
 *         ResourceGroupName = exampleResourceGroup.Name,
 *         Location = exampleResourceGroup.Location,
 *         DelegatedManagementSubnetId = exampleSubnet.Id,
 *         DefaultAdminPassword = "Password1234",
 *     });
 *     var exampleCassandraDatacenter = new Azure.CosmosDB.CassandraDatacenter("example", new()
 *     {
 *         Name = "example-datacenter",
 *         Location = exampleCassandraCluster.Location,
 *         CassandraClusterId = exampleCassandraCluster.Id,
 *         DelegatedManagementSubnetId = exampleSubnet.Id,
 *         NodeCount = 3,
 *         DiskCount = 4,
 *         SkuName = "Standard_DS14_v2",
 *         AvailabilityZonesEnabled = false,
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/authorization"
 * 	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
 * 	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/cosmosdb"
 * 	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/network"
 * 	"github.com/pulumi/pulumi-azuread/sdk/v5/go/azuread"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		exampleResourceGroup, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
 * 			Name:     pulumi.String("accexample-rg"),
 * 			Location: pulumi.String("West Europe"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		exampleVirtualNetwork, err := network.NewVirtualNetwork(ctx, "example", &network.VirtualNetworkArgs{
 * 			Name:              pulumi.String("example-vnet"),
 * 			Location:          exampleResourceGroup.Location,
 * 			ResourceGroupName: exampleResourceGroup.Name,
 * 			AddressSpaces: pulumi.StringArray{
 * 				pulumi.String("10.0.0.0/16"),
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		exampleSubnet, err := network.NewSubnet(ctx, "example", &network.SubnetArgs{
 * 			Name:               pulumi.String("example-subnet"),
 * 			ResourceGroupName:  exampleResourceGroup.Name,
 * 			VirtualNetworkName: exampleVirtualNetwork.Name,
 * 			AddressPrefixes: pulumi.StringArray{
 * 				pulumi.String("10.0.1.0/24"),
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		example, err := azuread.LookupServicePrincipal(ctx, &azuread.LookupServicePrincipalArgs{
 * 			DisplayName: pulumi.StringRef("Azure Cosmos DB"),
 * 		}, nil)
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = authorization.NewAssignment(ctx, "example", &authorization.AssignmentArgs{
 * 			Scope:              exampleVirtualNetwork.ID(),
 * 			RoleDefinitionName: pulumi.String("Network Contributor"),
 * 			PrincipalId:        pulumi.String(example.ObjectId),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		exampleCassandraCluster, err := cosmosdb.NewCassandraCluster(ctx, "example", &cosmosdb.CassandraClusterArgs{
 * 			Name:                        pulumi.String("example-cluster"),
 * 			ResourceGroupName:           exampleResourceGroup.Name,
 * 			Location:                    exampleResourceGroup.Location,
 * 			DelegatedManagementSubnetId: exampleSubnet.ID(),
 * 			DefaultAdminPassword:        pulumi.String("Password1234"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = cosmosdb.NewCassandraDatacenter(ctx, "example", &cosmosdb.CassandraDatacenterArgs{
 * 			Name:                        pulumi.String("example-datacenter"),
 * 			Location:                    exampleCassandraCluster.Location,
 * 			CassandraClusterId:          exampleCassandraCluster.ID(),
 * 			DelegatedManagementSubnetId: exampleSubnet.ID(),
 * 			NodeCount:                   pulumi.Int(3),
 * 			DiskCount:                   pulumi.Int(4),
 * 			SkuName:                     pulumi.String("Standard_DS14_v2"),
 * 			AvailabilityZonesEnabled:    pulumi.Bool(false),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		return nil
 * 	})
 * }
 * ```
 * ```java
 * package generated_program;
 * import com.pulumi.Context;
 * import com.pulumi.Pulumi;
 * import com.pulumi.core.Output;
 * import com.pulumi.azure.core.ResourceGroup;
 * import com.pulumi.azure.core.ResourceGroupArgs;
 * import com.pulumi.azure.network.VirtualNetwork;
 * import com.pulumi.azure.network.VirtualNetworkArgs;
 * import com.pulumi.azure.network.Subnet;
 * import com.pulumi.azure.network.SubnetArgs;
 * import com.pulumi.azuread.AzureadFunctions;
 * import com.pulumi.azuread.inputs.GetServicePrincipalArgs;
 * import com.pulumi.azure.authorization.Assignment;
 * import com.pulumi.azure.authorization.AssignmentArgs;
 * import com.pulumi.azure.cosmosdb.CassandraCluster;
 * import com.pulumi.azure.cosmosdb.CassandraClusterArgs;
 * import com.pulumi.azure.cosmosdb.CassandraDatacenter;
 * import com.pulumi.azure.cosmosdb.CassandraDatacenterArgs;
 * import java.util.List;
 * import java.util.ArrayList;
 * import java.util.Map;
 * import java.io.File;
 * import java.nio.file.Files;
 * import java.nio.file.Paths;
 * public class App {
 *     public static void main(String[] args) {
 *         Pulumi.run(App::stack);
 *     }
 *     public static void stack(Context ctx) {
 *         var exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()
 *             .name("accexample-rg")
 *             .location("West Europe")
 *             .build());
 *         var exampleVirtualNetwork = new VirtualNetwork("exampleVirtualNetwork", VirtualNetworkArgs.builder()
 *             .name("example-vnet")
 *             .location(exampleResourceGroup.location())
 *             .resourceGroupName(exampleResourceGroup.name())
 *             .addressSpaces("10.0.0.0/16")
 *             .build());
 *         var exampleSubnet = new Subnet("exampleSubnet", SubnetArgs.builder()
 *             .name("example-subnet")
 *             .resourceGroupName(exampleResourceGroup.name())
 *             .virtualNetworkName(exampleVirtualNetwork.name())
 *             .addressPrefixes("10.0.1.0/24")
 *             .build());
 *         final var example = AzureadFunctions.getServicePrincipal(GetServicePrincipalArgs.builder()
 *             .displayName("Azure Cosmos DB")
 *             .build());
 *         var exampleAssignment = new Assignment("exampleAssignment", AssignmentArgs.builder()
 *             .scope(exampleVirtualNetwork.id())
 *             .roleDefinitionName("Network Contributor")
 *             .principalId(example.applyValue(getServicePrincipalResult -> getServicePrincipalResult.objectId()))
 *             .build());
 *         var exampleCassandraCluster = new CassandraCluster("exampleCassandraCluster", CassandraClusterArgs.builder()
 *             .name("example-cluster")
 *             .resourceGroupName(exampleResourceGroup.name())
 *             .location(exampleResourceGroup.location())
 *             .delegatedManagementSubnetId(exampleSubnet.id())
 *             .defaultAdminPassword("Password1234")
 *             .build());
 *         var exampleCassandraDatacenter = new CassandraDatacenter("exampleCassandraDatacenter", CassandraDatacenterArgs.builder()
 *             .name("example-datacenter")
 *             .location(exampleCassandraCluster.location())
 *             .cassandraClusterId(exampleCassandraCluster.id())
 *             .delegatedManagementSubnetId(exampleSubnet.id())
 *             .nodeCount(3)
 *             .diskCount(4)
 *             .skuName("Standard_DS14_v2")
 *             .availabilityZonesEnabled(false)
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   exampleResourceGroup:
 *     type: azure:core:ResourceGroup
 *     name: example
 *     properties:
 *       name: accexample-rg
 *       location: West Europe
 *   exampleVirtualNetwork:
 *     type: azure:network:VirtualNetwork
 *     name: example
 *     properties:
 *       name: example-vnet
 *       location: ${exampleResourceGroup.location}
 *       resourceGroupName: ${exampleResourceGroup.name}
 *       addressSpaces:
 *         - 10.0.0.0/16
 *   exampleSubnet:
 *     type: azure:network:Subnet
 *     name: example
 *     properties:
 *       name: example-subnet
 *       resourceGroupName: ${exampleResourceGroup.name}
 *       virtualNetworkName: ${exampleVirtualNetwork.name}
 *       addressPrefixes:
 *         - 10.0.1.0/24
 *   exampleAssignment:
 *     type: azure:authorization:Assignment
 *     name: example
 *     properties:
 *       scope: ${exampleVirtualNetwork.id}
 *       roleDefinitionName: Network Contributor
 *       principalId: ${example.objectId}
 *   exampleCassandraCluster:
 *     type: azure:cosmosdb:CassandraCluster
 *     name: example
 *     properties:
 *       name: example-cluster
 *       resourceGroupName: ${exampleResourceGroup.name}
 *       location: ${exampleResourceGroup.location}
 *       delegatedManagementSubnetId: ${exampleSubnet.id}
 *       defaultAdminPassword: Password1234
 *   exampleCassandraDatacenter:
 *     type: azure:cosmosdb:CassandraDatacenter
 *     name: example
 *     properties:
 *       name: example-datacenter
 *       location: ${exampleCassandraCluster.location}
 *       cassandraClusterId: ${exampleCassandraCluster.id}
 *       delegatedManagementSubnetId: ${exampleSubnet.id}
 *       nodeCount: 3
 *       diskCount: 4
 *       skuName: Standard_DS14_v2
 *       availabilityZonesEnabled: false
 * variables:
 *   example:
 *     fn::invoke:
 *       Function: azuread:getServicePrincipal
 *       Arguments:
 *         displayName: Azure Cosmos DB
 * ```
 * 
 * ## Import
 * Cassandra Datacenters can be imported using the `resource id`, e.g.
 * ```sh
 * $ pulumi import azure:cosmosdb/cassandraDatacenter:CassandraDatacenter example /subscriptions/12345678-1234-9876-4563-123456789012/resourceGroups/resGroup1/providers/Microsoft.DocumentDB/cassandraClusters/cluster1/dataCenters/dc1
 * ```
 */
public class CassandraDatacenter internal constructor(
    override val javaResource: com.pulumi.azure.cosmosdb.CassandraDatacenter,
) : KotlinCustomResource(javaResource, CassandraDatacenterMapper) {
    /**
     * Determines whether availability zones are enabled. Defaults to `true`.
     */
    public val availabilityZonesEnabled: Output?
        get() = javaResource.availabilityZonesEnabled().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * The key URI of the customer key to use for the encryption of the backup Storage Account.
     */
    public val backupStorageCustomerKeyUri: Output?
        get() = javaResource.backupStorageCustomerKeyUri().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * The fragment of the cassandra.yaml configuration file to be included in the cassandra.yaml for all nodes in this Cassandra Datacenter. The fragment should be Base64 encoded and only a subset of keys is allowed.
     */
    public val base64EncodedYamlFragment: Output?
        get() = javaResource.base64EncodedYamlFragment().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * The ID of the Cassandra Cluster. Changing this forces a new Cassandra Datacenter to be created.
     */
    public val cassandraClusterId: Output
        get() = javaResource.cassandraClusterId().applyValue({ args0 -> args0 })

    /**
     * The ID of the delegated management subnet for this Cassandra Datacenter. Changing this forces a new Cassandra Datacenter to be created.
     */
    public val delegatedManagementSubnetId: Output
        get() = javaResource.delegatedManagementSubnetId().applyValue({ args0 -> args0 })

    /**
     * Determines the number of p30 disks that are attached to each node.
     */
    public val diskCount: Output?
        get() = javaResource.diskCount().applyValue({ args0 -> args0.map({ args0 -> args0 }).orElse(null) })

    /**
     * The Disk SKU that is used for this Cassandra Datacenter. Defaults to `P30`.
     */
    public val diskSku: Output?
        get() = javaResource.diskSku().applyValue({ args0 -> args0.map({ args0 -> args0 }).orElse(null) })

    /**
     * The Azure Region where the Cassandra Datacenter should exist. Changing this forces a new Cassandra Datacenter to be created.
     */
    public val location: Output
        get() = javaResource.location().applyValue({ args0 -> args0 })

    /**
     * The key URI of the customer key to use for the encryption of the Managed Disk.
     */
    public val managedDiskCustomerKeyUri: Output?
        get() = javaResource.managedDiskCustomerKeyUri().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * The name which should be used for this Cassandra Datacenter. Changing this forces a new Cassandra Datacenter to be created.
     */
    public val name: Output
        get() = javaResource.name().applyValue({ args0 -> args0 })

    /**
     * The number of nodes the Cassandra Datacenter should have. The number should be equal or greater than `3`. Defaults to `3`.
     */
    public val nodeCount: Output?
        get() = javaResource.nodeCount().applyValue({ args0 -> args0.map({ args0 -> args0 }).orElse(null) })

    /**
     * A list of IP Address for the seed nodes in this Cassandra Datacenter.
     */
    public val seedNodeIpAddresses: Output>
        get() = javaResource.seedNodeIpAddresses().applyValue({ args0 -> args0.map({ args0 -> args0 }) })

    /**
     * Determines the selected sku.
     * > **NOTE:** In v4.0 of the provider the `sku_name` will have a default value of `Standard_E16s_v5`.
     */
    public val skuName: Output
        get() = javaResource.skuName().applyValue({ args0 -> args0 })
}

public object CassandraDatacenterMapper : ResourceMapper {
    override fun supportsMappingOfType(javaResource: Resource): Boolean =
        com.pulumi.azure.cosmosdb.CassandraDatacenter::class == javaResource::class

    override fun map(javaResource: Resource): CassandraDatacenter = CassandraDatacenter(
        javaResource
            as com.pulumi.azure.cosmosdb.CassandraDatacenter,
    )
}

/**
 * @see [CassandraDatacenter].
 * @param name The _unique_ name of the resulting resource.
 * @param block Builder for [CassandraDatacenter].
 */
public suspend fun cassandraDatacenter(
    name: String,
    block: suspend CassandraDatacenterResourceBuilder.() -> Unit,
): CassandraDatacenter {
    val builder = CassandraDatacenterResourceBuilder()
    builder.name(name)
    block(builder)
    return builder.build()
}

/**
 * @see [CassandraDatacenter].
 * @param name The _unique_ name of the resulting resource.
 */
public fun cassandraDatacenter(name: String): CassandraDatacenter {
    val builder = CassandraDatacenterResourceBuilder()
    builder.name(name)
    return builder.build()
}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy