getDragonfly.go

// Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***

package aiven

import (
	"context"
	"reflect"

	"github.com/pulumi/pulumi-aiven/sdk/v6/go/aiven/internal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// The Dragonfly data source provides information about the existing Aiven Dragonfly service.
func LookupDragonfly(ctx *pulumi.Context, args *LookupDragonflyArgs, opts ...pulumi.InvokeOption) (*LookupDragonflyResult, error) {
	opts = internal.PkgInvokeDefaultOpts(opts)
	var rv LookupDragonflyResult
	err := ctx.Invoke("aiven:index/getDragonfly:getDragonfly", args, &rv, opts...)
	if err != nil {
		return nil, err
	}
	return &rv, nil
}

// A collection of arguments for invoking getDragonfly.
type LookupDragonflyArgs struct {
	// Identifies 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 `pulumi:"project"`
	// 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 `pulumi:"serviceName"`
}

// A collection of values returned by getDragonfly.
type LookupDragonflyResult struct {
	// Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
	AdditionalDiskSpace string `pulumi:"additionalDiskSpace"`
	// Defines where the cloud provider and region where the service is hosted in. This can be changed freely after service is created. Changing the value will trigger a potentially lengthy migration process for the service. Format is cloud provider name (`aws`, `azure`, `do` `google`, `upcloud`, etc.), dash, and the cloud provider specific region name. These are documented on each Cloud provider's own support articles, like [here for Google](https://cloud.google.com/compute/docs/regions-zones/) and [here for AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html).
	CloudName string `pulumi:"cloudName"`
	// Service component information objects
	Components []GetDragonflyComponent `pulumi:"components"`
	// Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
	DiskSpace string `pulumi:"diskSpace"`
	// The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
	DiskSpaceCap string `pulumi:"diskSpaceCap"`
	// 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`
	DiskSpaceDefault string `pulumi:"diskSpaceDefault"`
	// 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.
	DiskSpaceStep string `pulumi:"diskSpaceStep"`
	// Disk space that service is currently using
	DiskSpaceUsed string `pulumi:"diskSpaceUsed"`
	// Dragonfly server provided values
	Dragonflies []GetDragonflyDragonfly `pulumi:"dragonflies"`
	// Dragonfly user configurable settings
	DragonflyUserConfigs []GetDragonflyDragonflyUserConfig `pulumi:"dragonflyUserConfigs"`
	// The provider-assigned unique ID for this managed resource.
	Id string `pulumi:"id"`
	// Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
	MaintenanceWindowDow string `pulumi:"maintenanceWindowDow"`
	// Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
	MaintenanceWindowTime string `pulumi:"maintenanceWindowTime"`
	// Defines what kind of computing resources are allocated for the service. 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 seem from the [Aiven pricing page](https://aiven.io/pricing).
	Plan string `pulumi:"plan"`
	// Identifies 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 `pulumi:"project"`
	// Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. 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. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
	ProjectVpcId string `pulumi:"projectVpcId"`
	// The hostname of the service.
	ServiceHost string `pulumi:"serviceHost"`
	// Service integrations to specify when creating a service. Not applied after initial service creation
	ServiceIntegrations []GetDragonflyServiceIntegration `pulumi:"serviceIntegrations"`
	// 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 `pulumi:"serviceName"`
	// Password used for connecting to the service, if applicable
	ServicePassword string `pulumi:"servicePassword"`
	// The port of the service
	ServicePort int `pulumi:"servicePort"`
	// Aiven internal service type code
	ServiceType string `pulumi:"serviceType"`
	// URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
	ServiceUri string `pulumi:"serviceUri"`
	// Username used for connecting to the service, if applicable
	ServiceUsername string `pulumi:"serviceUsername"`
	// Service state. One of `POWEROFF`, `REBALANCING`, `REBUILDING` or `RUNNING`
	State string `pulumi:"state"`
	// 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
	StaticIps []string `pulumi:"staticIps"`
	// Tags are key-value pairs that allow you to categorize services.
	Tags []GetDragonflyTag `pulumi:"tags"`
	// Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability.
	TechEmails []GetDragonflyTechEmail `pulumi:"techEmails"`
	// 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.
	TerminationProtection bool `pulumi:"terminationProtection"`
}

func LookupDragonflyOutput(ctx *pulumi.Context, args LookupDragonflyOutputArgs, opts ...pulumi.InvokeOption) LookupDragonflyResultOutput {
	return pulumi.ToOutputWithContext(context.Background(), args).
		ApplyT(func(v interface{}) (LookupDragonflyResult, error) {
			args := v.(LookupDragonflyArgs)
			r, err := LookupDragonfly(ctx, &args, opts...)
			var s LookupDragonflyResult
			if r != nil {
				s = *r
			}
			return s, err
		}).(LookupDragonflyResultOutput)
}

// A collection of arguments for invoking getDragonfly.
type LookupDragonflyOutputArgs struct {
	// Identifies 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.StringInput `pulumi:"project"`
	// 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.StringInput `pulumi:"serviceName"`
}

func (LookupDragonflyOutputArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*LookupDragonflyArgs)(nil)).Elem()
}

// A collection of values returned by getDragonfly.
type LookupDragonflyResultOutput struct{ *pulumi.OutputState }

func (LookupDragonflyResultOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*LookupDragonflyResult)(nil)).Elem()
}

func (o LookupDragonflyResultOutput) ToLookupDragonflyResultOutput() LookupDragonflyResultOutput {
	return o
}

func (o LookupDragonflyResultOutput) ToLookupDragonflyResultOutputWithContext(ctx context.Context) LookupDragonflyResultOutput {
	return o
}

// Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
func (o LookupDragonflyResultOutput) AdditionalDiskSpace() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.AdditionalDiskSpace }).(pulumi.StringOutput)
}

// Defines where the cloud provider and region where the service is hosted in. This can be changed freely after service is created. Changing the value will trigger a potentially lengthy migration process for the service. Format is cloud provider name (`aws`, `azure`, `do` `google`, `upcloud`, etc.), dash, and the cloud provider specific region name. These are documented on each Cloud provider's own support articles, like [here for Google](https://cloud.google.com/compute/docs/regions-zones/) and [here for AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html).
func (o LookupDragonflyResultOutput) CloudName() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.CloudName }).(pulumi.StringOutput)
}

// Service component information objects
func (o LookupDragonflyResultOutput) Components() GetDragonflyComponentArrayOutput {
	return o.ApplyT(func(v LookupDragonflyResult) []GetDragonflyComponent { return v.Components }).(GetDragonflyComponentArrayOutput)
}

// Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
func (o LookupDragonflyResultOutput) DiskSpace() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.DiskSpace }).(pulumi.StringOutput)
}

// The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
func (o LookupDragonflyResultOutput) DiskSpaceCap() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.DiskSpaceCap }).(pulumi.StringOutput)
}

// 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`
func (o LookupDragonflyResultOutput) DiskSpaceDefault() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.DiskSpaceDefault }).(pulumi.StringOutput)
}

// 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.
func (o LookupDragonflyResultOutput) DiskSpaceStep() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.DiskSpaceStep }).(pulumi.StringOutput)
}

// Disk space that service is currently using
func (o LookupDragonflyResultOutput) DiskSpaceUsed() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.DiskSpaceUsed }).(pulumi.StringOutput)
}

// Dragonfly server provided values
func (o LookupDragonflyResultOutput) Dragonflies() GetDragonflyDragonflyArrayOutput {
	return o.ApplyT(func(v LookupDragonflyResult) []GetDragonflyDragonfly { return v.Dragonflies }).(GetDragonflyDragonflyArrayOutput)
}

// Dragonfly user configurable settings
func (o LookupDragonflyResultOutput) DragonflyUserConfigs() GetDragonflyDragonflyUserConfigArrayOutput {
	return o.ApplyT(func(v LookupDragonflyResult) []GetDragonflyDragonflyUserConfig { return v.DragonflyUserConfigs }).(GetDragonflyDragonflyUserConfigArrayOutput)
}

// The provider-assigned unique ID for this managed resource.
func (o LookupDragonflyResultOutput) Id() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.Id }).(pulumi.StringOutput)
}

// Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
func (o LookupDragonflyResultOutput) MaintenanceWindowDow() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.MaintenanceWindowDow }).(pulumi.StringOutput)
}

// Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
func (o LookupDragonflyResultOutput) MaintenanceWindowTime() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.MaintenanceWindowTime }).(pulumi.StringOutput)
}

// Defines what kind of computing resources are allocated for the service. 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 seem from the [Aiven pricing page](https://aiven.io/pricing).
func (o LookupDragonflyResultOutput) Plan() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.Plan }).(pulumi.StringOutput)
}

// Identifies 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.
func (o LookupDragonflyResultOutput) Project() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.Project }).(pulumi.StringOutput)
}

// Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. 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. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
func (o LookupDragonflyResultOutput) ProjectVpcId() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.ProjectVpcId }).(pulumi.StringOutput)
}

// The hostname of the service.
func (o LookupDragonflyResultOutput) ServiceHost() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.ServiceHost }).(pulumi.StringOutput)
}

// Service integrations to specify when creating a service. Not applied after initial service creation
func (o LookupDragonflyResultOutput) ServiceIntegrations() GetDragonflyServiceIntegrationArrayOutput {
	return o.ApplyT(func(v LookupDragonflyResult) []GetDragonflyServiceIntegration { return v.ServiceIntegrations }).(GetDragonflyServiceIntegrationArrayOutput)
}

// 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.
func (o LookupDragonflyResultOutput) ServiceName() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.ServiceName }).(pulumi.StringOutput)
}

// Password used for connecting to the service, if applicable
func (o LookupDragonflyResultOutput) ServicePassword() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.ServicePassword }).(pulumi.StringOutput)
}

// The port of the service
func (o LookupDragonflyResultOutput) ServicePort() pulumi.IntOutput {
	return o.ApplyT(func(v LookupDragonflyResult) int { return v.ServicePort }).(pulumi.IntOutput)
}

// Aiven internal service type code
func (o LookupDragonflyResultOutput) ServiceType() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.ServiceType }).(pulumi.StringOutput)
}

// URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
func (o LookupDragonflyResultOutput) ServiceUri() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.ServiceUri }).(pulumi.StringOutput)
}

// Username used for connecting to the service, if applicable
func (o LookupDragonflyResultOutput) ServiceUsername() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.ServiceUsername }).(pulumi.StringOutput)
}

// Service state. One of `POWEROFF`, `REBALANCING`, `REBUILDING` or `RUNNING`
func (o LookupDragonflyResultOutput) State() pulumi.StringOutput {
	return o.ApplyT(func(v LookupDragonflyResult) string { return v.State }).(pulumi.StringOutput)
}

// 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
func (o LookupDragonflyResultOutput) StaticIps() pulumi.StringArrayOutput {
	return o.ApplyT(func(v LookupDragonflyResult) []string { return v.StaticIps }).(pulumi.StringArrayOutput)
}

// Tags are key-value pairs that allow you to categorize services.
func (o LookupDragonflyResultOutput) Tags() GetDragonflyTagArrayOutput {
	return o.ApplyT(func(v LookupDragonflyResult) []GetDragonflyTag { return v.Tags }).(GetDragonflyTagArrayOutput)
}

// Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability.
func (o LookupDragonflyResultOutput) TechEmails() GetDragonflyTechEmailArrayOutput {
	return o.ApplyT(func(v LookupDragonflyResult) []GetDragonflyTechEmail { return v.TechEmails }).(GetDragonflyTechEmailArrayOutput)
}

// 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.
func (o LookupDragonflyResultOutput) TerminationProtection() pulumi.BoolOutput {
	return o.ApplyT(func(v LookupDragonflyResult) bool { return v.TerminationProtection }).(pulumi.BoolOutput)
}

func init() {
	pulumi.RegisterOutputType(LookupDragonflyResultOutput{})
}