import * as pulumi from "@pulumi/pulumi"; import * as outputs from "./types/output"; /** * Gets information about a ClickHouse service. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aiven from "@pulumi/aiven"; * * const exampleClickhouse = aiven.getClickhouse({ * project: exampleProject.project, * serviceName: "example-clickhouse-service", * }); * ``` */ export declare function getClickhouse(args: GetClickhouseArgs, opts?: pulumi.InvokeOptions): Promise; /** * A collection of arguments for invoking getClickhouse. */ export interface GetClickhouseArgs { /** * The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource. */ project: string; /** * Specifies the actual name of the service. The name cannot be changed later without destroying and re-creating the service so name should be picked based on intended service usage rather than current attributes. */ serviceName: string; } /** * A collection of values returned by getClickhouse. */ export interface GetClickhouseResult { /** * Add [disk storage](https://aiven.io/docs/platform/howto/add-storage-space) in increments of 30 GiB to the default disk space defined by the `plan`. The maximum value depends on the service type and cloud provider. Removing additional storage causes the service nodes to go through a rolling restart, and there might be a short downtime for services without an autoscaler integration or high availability capabilities. The field can be safely removed when autoscaler is enabled without causing any changes. */ readonly additionalDiskSpace: string; /** * Clickhouse user configurable settings. **Warning:** There's no way to reset advanced configuration options to default. Options that you add cannot be removed later */ readonly clickhouseUserConfigs: outputs.GetClickhouseClickhouseUserConfig[]; /** * Values provided by the ClickHouse server. */ readonly clickhouses: outputs.GetClickhouseClickhouse[]; /** * The cloud provider and region the service is hosted in. The format is `provider-region`, for example: `google-europe-west1`. The [available cloud regions](https://aiven.io/docs/platform/reference/list_of_clouds) can differ per project and service. Changing this value [migrates the service to another cloud provider or region](https://aiven.io/docs/platform/howto/migrate-services-cloud-region). The migration runs in the background and includes a DNS update to redirect traffic to the new region. Most services experience no downtime, but some databases may have a brief interruption during DNS propagation. */ readonly cloudName: string; /** * UUID of the Customer Managed Key (CMK) used to apply [bring your own key (BYOK) encryption](https://aiven.io/docs/platform/howto/bring-your-own-key) to this service's data at rest. You can register a CMK for an Aiven project using the `aiven.Cmk` resource. Removing this attribute doesn't remove the CMK association. To remove it from this service, set this attribute to the all-zero UUID `00000000-0000-0000-0000-000000000000`. */ readonly cmkId: string; /** * Service component information objects */ readonly components: outputs.GetClickhouseComponent[]; /** * Service disk space to set. Possible values depend on the service type, the cloud provider and the project. Reducing will result in the service rebalancing. */ readonly diskSpace: string; /** * The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project. */ readonly diskSpaceCap: string; /** * The default disk space of the service, possible values depend on the service type, the cloud provider and the project. Its also the minimum value for `diskSpace` */ readonly diskSpaceDefault: string; /** * The default disk space step of the service, possible values depend on the service type, the cloud provider and the project. `diskSpace` needs to increment from `diskSpaceDefault` by increments of this size. */ readonly diskSpaceStep: string; /** * The disk space that the service is currently using. This is the sum of the `plan` default disk space and `additionalDiskSpace` in human-readable format (for example: `90GiB`). */ readonly diskSpaceUsed: string; /** * The provider-assigned unique ID for this managed resource. */ readonly id: string; /** * Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc. */ readonly maintenanceWindowDow: string; /** * Indicates whether the maintenance window is currently enabled for this service. */ readonly maintenanceWindowEnabled: boolean; /** * Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format. */ readonly maintenanceWindowTime: string; /** * Defines what kind of computing resources are allocated for the service. Plan names must be lowercase alphanumeric (e.g., `business-8`, `myPlan16`). It can be changed after creation, though there are some restrictions when going to a smaller plan such as the new plan must have sufficient amount of disk space to store all current data and switching to a plan with fewer nodes might not be supported. The basic plan names are `hobbyist`, `startup-x`, `business-x` and `premium-x` where `x` is (roughly) the amount of memory on each node (also other attributes like number of CPUs and amount of disk space varies but naming is based on memory). The available options can be seen from the [Aiven pricing page](https://aiven.io/pricing). */ readonly plan: string; /** * The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource. */ readonly project: string; /** * Specifies the VPC the service should run in. If the value is not set, the service runs on the Public Internet. When set, the value should be given as a reference to set up dependencies correctly, and the VPC must be in the same cloud and region as the service itself. The service can be freely moved to and from VPC after creation, but doing so triggers migration to new servers, so the operation can take a significant amount of time to complete if the service has a lot of data. */ readonly projectVpcId: string; /** * The hostname of the service. */ readonly serviceHost: string; /** * Service integrations to specify when creating a service. Not applied after initial service creation */ readonly serviceIntegrations: outputs.GetClickhouseServiceIntegration[]; /** * Specifies the actual name of the service. The name cannot be changed later without destroying and re-creating the service so name should be picked based on intended service usage rather than current attributes. */ readonly serviceName: string; /** * Password used for connecting to the service, if applicable */ readonly servicePassword: string; /** * The port of the service */ readonly servicePort: number; /** * Aiven internal service type code */ readonly serviceType: string; /** * The service URI for the ClickHouse service, which contains the hostname and port (e.g., 'service-name.h.aivencloud.com:16539') used to connect to the service. For protocol-specific connections, see the ClickHouse service example. */ readonly serviceUri: string; /** * Username used for connecting to the service, if applicable */ readonly serviceUsername: string; /** * Service state. Possible values are `POWEROFF`, `REBALANCING`, `REBUILDING` or `RUNNING`. Services cannot be powered on or off with Terraform. To power a service on or off, [use the Aiven Console or Aiven CLI](https://aiven.io/docs/platform/concepts/service-power-cycle). */ readonly state: string; /** * Static IPs that are going to be associated with this service. Please assign a value using the 'toset' function. Once a static ip resource is in the 'assigned' state it cannot be unbound from the node again */ readonly staticIps: string[]; /** * Tags are key-value pairs that allow you to categorize services. */ readonly tags: outputs.GetClickhouseTag[]; /** * The email addresses for [service contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this service. You can also set email contacts at the project level. */ readonly techEmails: outputs.GetClickhouseTechEmail[]; /** * Prevents the service from being deleted. It is recommended to set this to `true` for all production services to prevent unintentional service deletion. This does not shield against deleting databases or topics but for services with backups much of the content can at least be restored from backup in case accidental deletion is done. */ readonly terminationProtection: boolean; } /** * Gets information about a ClickHouse service. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aiven from "@pulumi/aiven"; * * const exampleClickhouse = aiven.getClickhouse({ * project: exampleProject.project, * serviceName: "example-clickhouse-service", * }); * ``` */ export declare function getClickhouseOutput(args: GetClickhouseOutputArgs, opts?: pulumi.InvokeOutputOptions): pulumi.Output; /** * A collection of arguments for invoking getClickhouse. */ export interface GetClickhouseOutputArgs { /** * The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource. */ project: pulumi.Input; /** * Specifies the actual name of the service. The name cannot be changed later without destroying and re-creating the service so name should be picked based on intended service usage rather than current attributes. */ serviceName: pulumi.Input; } //# sourceMappingURL=getClickhouse.d.ts.map