com.pulumi.digitalocean.kotlin.DatabaseKafkaTopicArgs.kt Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of pulumi-digitalocean-kotlin Show documentation
Show all versions of pulumi-digitalocean-kotlin Show documentation
Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.
@file:Suppress("NAME_SHADOWING", "DEPRECATION")
package com.pulumi.digitalocean.kotlin
import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.digitalocean.DatabaseKafkaTopicArgs.builder
import com.pulumi.digitalocean.kotlin.inputs.DatabaseKafkaTopicConfigArgs
import com.pulumi.digitalocean.kotlin.inputs.DatabaseKafkaTopicConfigArgsBuilder
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.applySuspend
import kotlin.Int
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List
import kotlin.jvm.JvmName
/**
* Provides a DigitalOcean Kafka topic for Kafka clusters.
* ## Example Usage
* ### Create a new Kafka topic
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as digitalocean from "@pulumi/digitalocean";
* const kafka_example = new digitalocean.DatabaseCluster("kafka-example", {
* name: "example-kafka-cluster",
* engine: "kafka",
* version: "3.5",
* size: "db-s-2vcpu-2gb",
* region: digitalocean.Region.NYC1,
* nodeCount: 3,
* tags: ["production"],
* });
* const topic_01 = new digitalocean.DatabaseKafkaTopic("topic-01", {
* clusterId: kafka_example.id,
* name: "topic-01",
* partitionCount: 3,
* replicationFactor: 2,
* configs: [{
* cleanupPolicy: "compact",
* compressionType: "uncompressed",
* deleteRetentionMs: "14000",
* fileDeleteDelayMs: "170000",
* flushMessages: "92233",
* flushMs: "92233720368",
* indexIntervalBytes: "40962",
* maxCompactionLagMs: "9223372036854775807",
* maxMessageBytes: "1048588",
* messageDownConversionEnable: true,
* messageFormatVersion: "3.0-IV1",
* messageTimestampDifferenceMaxMs: "9223372036854775807",
* messageTimestampType: "log_append_time",
* minCleanableDirtyRatio: 0.5,
* minCompactionLagMs: "20000",
* minInsyncReplicas: 2,
* preallocate: false,
* retentionBytes: "-1",
* retentionMs: "-1",
* segmentBytes: "209715200",
* segmentIndexBytes: "10485760",
* segmentJitterMs: "0",
* segmentMs: "604800000",
* }],
* });
* ```
* ```python
* import pulumi
* import pulumi_digitalocean as digitalocean
* kafka_example = digitalocean.DatabaseCluster("kafka-example",
* name="example-kafka-cluster",
* engine="kafka",
* version="3.5",
* size="db-s-2vcpu-2gb",
* region=digitalocean.Region.NYC1,
* node_count=3,
* tags=["production"])
* topic_01 = digitalocean.DatabaseKafkaTopic("topic-01",
* cluster_id=kafka_example.id,
* name="topic-01",
* partition_count=3,
* replication_factor=2,
* configs=[{
* "cleanup_policy": "compact",
* "compression_type": "uncompressed",
* "delete_retention_ms": "14000",
* "file_delete_delay_ms": "170000",
* "flush_messages": "92233",
* "flush_ms": "92233720368",
* "index_interval_bytes": "40962",
* "max_compaction_lag_ms": "9223372036854775807",
* "max_message_bytes": "1048588",
* "message_down_conversion_enable": True,
* "message_format_version": "3.0-IV1",
* "message_timestamp_difference_max_ms": "9223372036854775807",
* "message_timestamp_type": "log_append_time",
* "min_cleanable_dirty_ratio": 0.5,
* "min_compaction_lag_ms": "20000",
* "min_insync_replicas": 2,
* "preallocate": False,
* "retention_bytes": "-1",
* "retention_ms": "-1",
* "segment_bytes": "209715200",
* "segment_index_bytes": "10485760",
* "segment_jitter_ms": "0",
* "segment_ms": "604800000",
* }])
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using DigitalOcean = Pulumi.DigitalOcean;
* return await Deployment.RunAsync(() =>
* {
* var kafka_example = new DigitalOcean.DatabaseCluster("kafka-example", new()
* {
* Name = "example-kafka-cluster",
* Engine = "kafka",
* Version = "3.5",
* Size = "db-s-2vcpu-2gb",
* Region = DigitalOcean.Region.NYC1,
* NodeCount = 3,
* Tags = new[]
* {
* "production",
* },
* });
* var topic_01 = new DigitalOcean.DatabaseKafkaTopic("topic-01", new()
* {
* ClusterId = kafka_example.Id,
* Name = "topic-01",
* PartitionCount = 3,
* ReplicationFactor = 2,
* Configs = new[]
* {
* new DigitalOcean.Inputs.DatabaseKafkaTopicConfigArgs
* {
* CleanupPolicy = "compact",
* CompressionType = "uncompressed",
* DeleteRetentionMs = "14000",
* FileDeleteDelayMs = "170000",
* FlushMessages = "92233",
* FlushMs = "92233720368",
* IndexIntervalBytes = "40962",
* MaxCompactionLagMs = "9223372036854775807",
* MaxMessageBytes = "1048588",
* MessageDownConversionEnable = true,
* MessageFormatVersion = "3.0-IV1",
* MessageTimestampDifferenceMaxMs = "9223372036854775807",
* MessageTimestampType = "log_append_time",
* MinCleanableDirtyRatio = 0.5,
* MinCompactionLagMs = "20000",
* MinInsyncReplicas = 2,
* Preallocate = false,
* RetentionBytes = "-1",
* RetentionMs = "-1",
* SegmentBytes = "209715200",
* SegmentIndexBytes = "10485760",
* SegmentJitterMs = "0",
* SegmentMs = "604800000",
* },
* },
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* _, err := digitalocean.NewDatabaseCluster(ctx, "kafka-example", &digitalocean.DatabaseClusterArgs{
* Name: pulumi.String("example-kafka-cluster"),
* Engine: pulumi.String("kafka"),
* Version: pulumi.String("3.5"),
* Size: pulumi.String("db-s-2vcpu-2gb"),
* Region: pulumi.String(digitalocean.RegionNYC1),
* NodeCount: pulumi.Int(3),
* Tags: pulumi.StringArray{
* pulumi.String("production"),
* },
* })
* if err != nil {
* return err
* }
* _, err = digitalocean.NewDatabaseKafkaTopic(ctx, "topic-01", &digitalocean.DatabaseKafkaTopicArgs{
* ClusterId: kafka_example.ID(),
* Name: pulumi.String("topic-01"),
* PartitionCount: pulumi.Int(3),
* ReplicationFactor: pulumi.Int(2),
* Configs: digitalocean.DatabaseKafkaTopicConfigArray{
* &digitalocean.DatabaseKafkaTopicConfigArgs{
* CleanupPolicy: pulumi.String("compact"),
* CompressionType: pulumi.String("uncompressed"),
* DeleteRetentionMs: pulumi.String("14000"),
* FileDeleteDelayMs: pulumi.String("170000"),
* FlushMessages: pulumi.String("92233"),
* FlushMs: pulumi.String("92233720368"),
* IndexIntervalBytes: pulumi.String("40962"),
* MaxCompactionLagMs: pulumi.String("9223372036854775807"),
* MaxMessageBytes: pulumi.String("1048588"),
* MessageDownConversionEnable: pulumi.Bool(true),
* MessageFormatVersion: pulumi.String("3.0-IV1"),
* MessageTimestampDifferenceMaxMs: pulumi.String("9223372036854775807"),
* MessageTimestampType: pulumi.String("log_append_time"),
* MinCleanableDirtyRatio: pulumi.Float64(0.5),
* MinCompactionLagMs: pulumi.String("20000"),
* MinInsyncReplicas: pulumi.Int(2),
* Preallocate: pulumi.Bool(false),
* RetentionBytes: pulumi.String("-1"),
* RetentionMs: pulumi.String("-1"),
* SegmentBytes: pulumi.String("209715200"),
* SegmentIndexBytes: pulumi.String("10485760"),
* SegmentJitterMs: pulumi.String("0"),
* SegmentMs: pulumi.String("604800000"),
* },
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```yaml
* resources:
* topic-01:
* type: digitalocean:DatabaseKafkaTopic
* properties:
* clusterId: ${["kafka-example"].id}
* name: topic-01
* partitionCount: 3
* replicationFactor: 2
* configs:
* - cleanupPolicy: compact
* compressionType: uncompressed
* deleteRetentionMs: 14000
* fileDeleteDelayMs: 170000
* flushMessages: 92233
* flushMs: 9.2233720368e+10
* indexIntervalBytes: 40962
* maxCompactionLagMs: 9.223372036854776e+18
* maxMessageBytes: 1.048588e+06
* messageDownConversionEnable: true
* messageFormatVersion: 3.0-IV1
* messageTimestampDifferenceMaxMs: 9.223372036854776e+18
* messageTimestampType: log_append_time
* minCleanableDirtyRatio: 0.5
* minCompactionLagMs: 20000
* minInsyncReplicas: 2
* preallocate: false
* retentionBytes: -1
* retentionMs: -1
* segmentBytes: 2.097152e+08
* segmentIndexBytes: 1.048576e+07
* segmentJitterMs: 0
* segmentMs: 6.048e+08
* kafka-example:
* type: digitalocean:DatabaseCluster
* properties:
* name: example-kafka-cluster
* engine: kafka
* version: '3.5'
* size: db-s-2vcpu-2gb
* region: nyc1
* nodeCount: 3
* tags:
* - production
* ```
*
* ## Import
* Topics can be imported using the `id` of the source cluster and the `name` of the topic joined with a comma. For example:
* ```sh
* $ pulumi import digitalocean:index/databaseKafkaTopic:DatabaseKafkaTopic topic-01 245bcfd0-7f31-4ce6-a2bc-475a116cca97,topic-01
* ```
* @property clusterId The ID of the source database cluster. Note: This must be a Kafka cluster.
* @property configs A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
* @property name The name for the topic.
* @property partitionCount The number of partitions for the topic. Default and minimum set at 3, maximum is 2048.
* @property replicationFactor The number of nodes that topics are replicated across. Default and minimum set at 2, maximum is the number of nodes in the cluster.
*/
public data class DatabaseKafkaTopicArgs(
public val clusterId: Output? = null,
public val configs: Output>? = null,
public val name: Output? = null,
public val partitionCount: Output? = null,
public val replicationFactor: Output? = null,
) : ConvertibleToJava {
override fun toJava(): com.pulumi.digitalocean.DatabaseKafkaTopicArgs =
com.pulumi.digitalocean.DatabaseKafkaTopicArgs.builder()
.clusterId(clusterId?.applyValue({ args0 -> args0 }))
.configs(
configs?.applyValue({ args0 ->
args0.map({ args0 ->
args0.let({ args0 ->
args0.toJava()
})
})
}),
)
.name(name?.applyValue({ args0 -> args0 }))
.partitionCount(partitionCount?.applyValue({ args0 -> args0 }))
.replicationFactor(replicationFactor?.applyValue({ args0 -> args0 })).build()
}
/**
* Builder for [DatabaseKafkaTopicArgs].
*/
@PulumiTagMarker
public class DatabaseKafkaTopicArgsBuilder internal constructor() {
private var clusterId: Output? = null
private var configs: Output>? = null
private var name: Output? = null
private var partitionCount: Output? = null
private var replicationFactor: Output? = null
/**
* @param value The ID of the source database cluster. Note: This must be a Kafka cluster.
*/
@JvmName("dwfotmfkgeruypgi")
public suspend fun clusterId(`value`: Output) {
this.clusterId = value
}
/**
* @param value A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
*/
@JvmName("sgxofwmxiekbghoe")
public suspend fun configs(`value`: Output>) {
this.configs = value
}
@JvmName("cxlijnccxertakfn")
public suspend fun configs(vararg values: Output) {
this.configs = Output.all(values.asList())
}
/**
* @param values A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
*/
@JvmName("pxquopypgjfcuagt")
public suspend fun configs(values: List>) {
this.configs = Output.all(values)
}
/**
* @param value The name for the topic.
*/
@JvmName("opmwmbdvxwymtvgs")
public suspend fun name(`value`: Output) {
this.name = value
}
/**
* @param value The number of partitions for the topic. Default and minimum set at 3, maximum is 2048.
*/
@JvmName("tkynnnunmykwmkhy")
public suspend fun partitionCount(`value`: Output) {
this.partitionCount = value
}
/**
* @param value The number of nodes that topics are replicated across. Default and minimum set at 2, maximum is the number of nodes in the cluster.
*/
@JvmName("tlgryvvbccupysyr")
public suspend fun replicationFactor(`value`: Output) {
this.replicationFactor = value
}
/**
* @param value The ID of the source database cluster. Note: This must be a Kafka cluster.
*/
@JvmName("jgwdqeuwuhrxeupx")
public suspend fun clusterId(`value`: String?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.clusterId = mapped
}
/**
* @param value A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
*/
@JvmName("avnivxtlnjalqlju")
public suspend fun configs(`value`: List?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.configs = mapped
}
/**
* @param argument A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
*/
@JvmName("sdbrxtkhbtnusaun")
public suspend fun configs(argument: List Unit>) {
val toBeMapped = argument.toList().map {
DatabaseKafkaTopicConfigArgsBuilder().applySuspend {
it()
}.build()
}
val mapped = of(toBeMapped)
this.configs = mapped
}
/**
* @param argument A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
*/
@JvmName("soxxcxandkklawoi")
public suspend fun configs(vararg argument: suspend DatabaseKafkaTopicConfigArgsBuilder.() -> Unit) {
val toBeMapped = argument.toList().map {
DatabaseKafkaTopicConfigArgsBuilder().applySuspend {
it()
}.build()
}
val mapped = of(toBeMapped)
this.configs = mapped
}
/**
* @param argument A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
*/
@JvmName("foredysmyopeuetw")
public suspend fun configs(argument: suspend DatabaseKafkaTopicConfigArgsBuilder.() -> Unit) {
val toBeMapped = listOf(
DatabaseKafkaTopicConfigArgsBuilder().applySuspend {
argument()
}.build(),
)
val mapped = of(toBeMapped)
this.configs = mapped
}
/**
* @param values A set of advanced configuration parameters. Defaults will be set for any of the parameters that are not included.
* The `config` block is documented below.
*/
@JvmName("xvfhiteetvgpesqs")
public suspend fun configs(vararg values: DatabaseKafkaTopicConfigArgs) {
val toBeMapped = values.toList()
val mapped = toBeMapped.let({ args0 -> of(args0) })
this.configs = mapped
}
/**
* @param value The name for the topic.
*/
@JvmName("gornvteopepfviyc")
public suspend fun name(`value`: String?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.name = mapped
}
/**
* @param value The number of partitions for the topic. Default and minimum set at 3, maximum is 2048.
*/
@JvmName("teyxrchffiikkcwx")
public suspend fun partitionCount(`value`: Int?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.partitionCount = mapped
}
/**
* @param value The number of nodes that topics are replicated across. Default and minimum set at 2, maximum is the number of nodes in the cluster.
*/
@JvmName("yuxwptmhaqwntfwd")
public suspend fun replicationFactor(`value`: Int?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.replicationFactor = mapped
}
internal fun build(): DatabaseKafkaTopicArgs = DatabaseKafkaTopicArgs(
clusterId = clusterId,
configs = configs,
name = name,
partitionCount = partitionCount,
replicationFactor = replicationFactor,
)
}