Aiven v6.18.0, Jun 27 24

Aiven v6.18.0 published on Thursday, Jun 27, 2024 by Pulumi

aiven.getKafkaMirrorMaker

Explore with Pulumi AI

Aiven v6.18.0 published on Thursday, Jun 27, 2024 by Pulumi

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aiven from "@pulumi/aiven";

const mm1 = aiven.getKafkaMirrorMaker({
    project: pr1.project,
    serviceName: "my-mm1",
});

import pulumi
import pulumi_aiven as aiven

mm1 = aiven.get_kafka_mirror_maker(project=pr1["project"],
    service_name="my-mm1")

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := aiven.LookupKafkaMirrorMaker(ctx, &aiven.LookupKafkaMirrorMakerArgs{
			Project:     pr1.Project,
			ServiceName: "my-mm1",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aiven = Pulumi.Aiven;

return await Deployment.RunAsync(() => 
{
    var mm1 = Aiven.GetKafkaMirrorMaker.Invoke(new()
    {
        Project = pr1.Project,
        ServiceName = "my-mm1",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aiven.AivenFunctions;
import com.pulumi.aiven.inputs.GetKafkaMirrorMakerArgs;
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) {
        final var mm1 = AivenFunctions.getKafkaMirrorMaker(GetKafkaMirrorMakerArgs.builder()
            .project(pr1.project())
            .serviceName("my-mm1")
            .build());

    }
}

variables:
  mm1:
    fn::invoke:
      Function: aiven:getKafkaMirrorMaker
      Arguments:
        project: ${pr1.project}
        serviceName: my-mm1

Using getKafkaMirrorMaker

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getKafkaMirrorMaker(args: GetKafkaMirrorMakerArgs, opts?: InvokeOptions): Promise<GetKafkaMirrorMakerResult>
function getKafkaMirrorMakerOutput(args: GetKafkaMirrorMakerOutputArgs, opts?: InvokeOptions): Output<GetKafkaMirrorMakerResult>

def get_kafka_mirror_maker(project: Optional[str] = None,
                           service_name: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetKafkaMirrorMakerResult
def get_kafka_mirror_maker_output(project: Optional[pulumi.Input[str]] = None,
                           service_name: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetKafkaMirrorMakerResult]

func LookupKafkaMirrorMaker(ctx *Context, args *LookupKafkaMirrorMakerArgs, opts ...InvokeOption) (*LookupKafkaMirrorMakerResult, error)
func LookupKafkaMirrorMakerOutput(ctx *Context, args *LookupKafkaMirrorMakerOutputArgs, opts ...InvokeOption) LookupKafkaMirrorMakerResultOutput

> Note: This function is named LookupKafkaMirrorMaker in the Go SDK.

public static class GetKafkaMirrorMaker 
{
    public static Task<GetKafkaMirrorMakerResult> InvokeAsync(GetKafkaMirrorMakerArgs args, InvokeOptions? opts = null)
    public static Output<GetKafkaMirrorMakerResult> Invoke(GetKafkaMirrorMakerInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetKafkaMirrorMakerResult> getKafkaMirrorMaker(GetKafkaMirrorMakerArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: aiven:index/getKafkaMirrorMaker:getKafkaMirrorMaker
  arguments:
    # arguments dictionary

The following arguments are supported:

Project 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.
ServiceName 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.

Project 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.
ServiceName 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.

project 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.
serviceName 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.

project 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.
serviceName 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.

project str: 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.
service_name str: 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.

project 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.
serviceName 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.

getKafkaMirrorMaker Result

The following output properties are available:

AdditionalDiskSpace string: Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
CloudName string: 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 and here for AWS.
Components List<GetKafkaMirrorMakerComponent>: Service component information objects
DiskSpace string: Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
DiskSpaceCap string: The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
DiskSpaceDefault 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 disk_space
DiskSpaceStep string: The default disk space step of the service, possible values depend on the service type, the cloud provider and the project. disk_space needs to increment from disk_space_default by increments of this size.
DiskSpaceUsed string: Disk space that service is currently using
Id string: The provider-assigned unique ID for this managed resource.
KafkaMirrormakerUserConfigs List<GetKafkaMirrorMakerKafkaMirrormakerUserConfig>: KafkaMirrormaker user configurable settings
MaintenanceWindowDow string: Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
MaintenanceWindowTime string: Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
Plan string: 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.
Project 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.
ProjectVpcId string: 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.
ServiceHost string: The hostname of the service.
ServiceIntegrations List<GetKafkaMirrorMakerServiceIntegration>: Service integrations to specify when creating a service. Not applied after initial service creation
ServiceName 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.
ServicePassword string: Password used for connecting to the service, if applicable
ServicePort int: The port of the service
ServiceType string: Aiven internal service type code
ServiceUri string: URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
ServiceUsername string: Username used for connecting to the service, if applicable
State string: Service state. One of POWEROFF, REBALANCING, REBUILDING or RUNNING
StaticIps List<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
Tags List<GetKafkaMirrorMakerTag>: Tags are key-value pairs that allow you to categorize services.
TechEmails List<GetKafkaMirrorMakerTechEmail>: The email addresses for service contacts, who will receive important alerts and updates about this service. You can also set email contacts at the project level.
TerminationProtection bool: 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.

AdditionalDiskSpace string: Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
CloudName string: 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 and here for AWS.
Components []GetKafkaMirrorMakerComponent: Service component information objects
DiskSpace string: Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
DiskSpaceCap string: The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
DiskSpaceDefault 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 disk_space
DiskSpaceStep string: The default disk space step of the service, possible values depend on the service type, the cloud provider and the project. disk_space needs to increment from disk_space_default by increments of this size.
DiskSpaceUsed string: Disk space that service is currently using
Id string: The provider-assigned unique ID for this managed resource.
KafkaMirrormakerUserConfigs []GetKafkaMirrorMakerKafkaMirrormakerUserConfig: KafkaMirrormaker user configurable settings
MaintenanceWindowDow string: Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
MaintenanceWindowTime string: Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
Plan string: 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.
Project 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.
ProjectVpcId string: 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.
ServiceHost string: The hostname of the service.
ServiceIntegrations []GetKafkaMirrorMakerServiceIntegration: Service integrations to specify when creating a service. Not applied after initial service creation
ServiceName 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.
ServicePassword string: Password used for connecting to the service, if applicable
ServicePort int: The port of the service
ServiceType string: Aiven internal service type code
ServiceUri string: URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
ServiceUsername string: Username used for connecting to the service, if applicable
State string: Service state. One of POWEROFF, REBALANCING, REBUILDING or RUNNING
StaticIps []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
Tags []GetKafkaMirrorMakerTag: Tags are key-value pairs that allow you to categorize services.
TechEmails []GetKafkaMirrorMakerTechEmail: The email addresses for service contacts, who will receive important alerts and updates about this service. You can also set email contacts at the project level.
TerminationProtection bool: 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.

additionalDiskSpace String: Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
cloudName String: 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 and here for AWS.
components List<GetKafkaMirrorMakerComponent>: Service component information objects
diskSpace String: Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
diskSpaceCap String: The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
diskSpaceDefault 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 disk_space
diskSpaceStep String: The default disk space step of the service, possible values depend on the service type, the cloud provider and the project. disk_space needs to increment from disk_space_default by increments of this size.
diskSpaceUsed String: Disk space that service is currently using
id String: The provider-assigned unique ID for this managed resource.
kafkaMirrormakerUserConfigs List<GetKafkaMirrorMakerKafkaMirrormakerUserConfig>: KafkaMirrormaker user configurable settings
maintenanceWindowDow String: Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
maintenanceWindowTime String: Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
plan String: 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.
project 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.
projectVpcId String: 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.
serviceHost String: The hostname of the service.
serviceIntegrations List<GetKafkaMirrorMakerServiceIntegration>: Service integrations to specify when creating a service. Not applied after initial service creation
serviceName 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.
servicePassword String: Password used for connecting to the service, if applicable
servicePort Integer: The port of the service
serviceType String: Aiven internal service type code
serviceUri String: URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
serviceUsername String: Username used for connecting to the service, if applicable
state String: Service state. One of POWEROFF, REBALANCING, REBUILDING or RUNNING
staticIps List<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
tags List<GetKafkaMirrorMakerTag>: Tags are key-value pairs that allow you to categorize services.
techEmails List<GetKafkaMirrorMakerTechEmail>: The email addresses for service contacts, who will receive important alerts and updates about this service. You can also set email contacts at the project level.
terminationProtection Boolean: 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.

additionalDiskSpace string: Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
cloudName string: 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 and here for AWS.
components GetKafkaMirrorMakerComponent[]: Service component information objects
diskSpace string: Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
diskSpaceCap string: The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
diskSpaceDefault 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 disk_space
diskSpaceStep string: The default disk space step of the service, possible values depend on the service type, the cloud provider and the project. disk_space needs to increment from disk_space_default by increments of this size.
diskSpaceUsed string: Disk space that service is currently using
id string: The provider-assigned unique ID for this managed resource.
kafkaMirrormakerUserConfigs GetKafkaMirrorMakerKafkaMirrormakerUserConfig[]: KafkaMirrormaker user configurable settings
maintenanceWindowDow string: Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
maintenanceWindowTime string: Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
plan string: 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.
project 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.
projectVpcId string: 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.
serviceHost string: The hostname of the service.
serviceIntegrations GetKafkaMirrorMakerServiceIntegration[]: Service integrations to specify when creating a service. Not applied after initial service creation
serviceName 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.
servicePassword string: Password used for connecting to the service, if applicable
servicePort number: The port of the service
serviceType string: Aiven internal service type code
serviceUri string: URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
serviceUsername string: Username used for connecting to the service, if applicable
state string: Service state. One of POWEROFF, REBALANCING, REBUILDING or RUNNING
staticIps 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
tags GetKafkaMirrorMakerTag[]: Tags are key-value pairs that allow you to categorize services.
techEmails GetKafkaMirrorMakerTechEmail[]: The email addresses for service contacts, who will receive important alerts and updates about this service. You can also set email contacts at the project level.
terminationProtection boolean: 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.

additional_disk_space str: Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
cloud_name str: 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 and here for AWS.
components Sequence[GetKafkaMirrorMakerComponent]: Service component information objects
disk_space str: Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
disk_space_cap str: The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
disk_space_default str: 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 disk_space
disk_space_step str: The default disk space step of the service, possible values depend on the service type, the cloud provider and the project. disk_space needs to increment from disk_space_default by increments of this size.
disk_space_used str: Disk space that service is currently using
id str: The provider-assigned unique ID for this managed resource.
kafka_mirrormaker_user_configs Sequence[GetKafkaMirrorMakerKafkaMirrormakerUserConfig]: KafkaMirrormaker user configurable settings
maintenance_window_dow str: Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
maintenance_window_time str: Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
plan str: 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.
project str: 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_vpc_id str: 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.
service_host str: The hostname of the service.
service_integrations Sequence[GetKafkaMirrorMakerServiceIntegration]: Service integrations to specify when creating a service. Not applied after initial service creation
service_name str: 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.
service_password str: Password used for connecting to the service, if applicable
service_port int: The port of the service
service_type str: Aiven internal service type code
service_uri str: URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
service_username str: Username used for connecting to the service, if applicable
state str: Service state. One of POWEROFF, REBALANCING, REBUILDING or RUNNING
static_ips Sequence[str]: 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
tags Sequence[GetKafkaMirrorMakerTag]: Tags are key-value pairs that allow you to categorize services.
tech_emails Sequence[GetKafkaMirrorMakerTechEmail]: The email addresses for service contacts, who will receive important alerts and updates about this service. You can also set email contacts at the project level.
termination_protection bool: 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.

additionalDiskSpace String: Additional disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
cloudName String: 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 and here for AWS.
components List<Property Map>: Service component information objects
diskSpace String: Service disk space. Possible values depend on the service type, the cloud provider and the project. Therefore, reducing will result in the service rebalancing.
diskSpaceCap String: The maximum disk space of the service, possible values depend on the service type, the cloud provider and the project.
diskSpaceDefault 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 disk_space
diskSpaceStep String: The default disk space step of the service, possible values depend on the service type, the cloud provider and the project. disk_space needs to increment from disk_space_default by increments of this size.
diskSpaceUsed String: Disk space that service is currently using
id String: The provider-assigned unique ID for this managed resource.
kafkaMirrormakerUserConfigs List<Property Map>: KafkaMirrormaker user configurable settings
maintenanceWindowDow String: Day of week when maintenance operations should be performed. One monday, tuesday, wednesday, etc.
maintenanceWindowTime String: Time of day when maintenance operations should be performed. UTC time in HH:mm:ss format.
plan String: 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.
project 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.
projectVpcId String: 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.
serviceHost String: The hostname of the service.
serviceIntegrations List<Property Map>: Service integrations to specify when creating a service. Not applied after initial service creation
serviceName 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.
servicePassword String: Password used for connecting to the service, if applicable
servicePort Number: The port of the service
serviceType String: Aiven internal service type code
serviceUri String: URI for connecting to the service. Service specific info is under "kafka", "pg", etc.
serviceUsername String: Username used for connecting to the service, if applicable
state String: Service state. One of POWEROFF, REBALANCING, REBUILDING or RUNNING
staticIps List<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
tags List<Property Map>: Tags are key-value pairs that allow you to categorize services.
techEmails List<Property Map>: The email addresses for service contacts, who will receive important alerts and updates about this service. You can also set email contacts at the project level.
terminationProtection Boolean: 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.

Supporting Types

GetKafkaMirrorMakerComponent

Component string: Service component name
ConnectionUri string: Connection info for connecting to the service component. This is a combination of host and port.
Host string: Host name for connecting to the service component
KafkaAuthenticationMethod string: Kafka authentication method. This is a value specific to the 'kafka' service component
Port int: Port number for connecting to the service component
Route string: Network access route
Ssl bool: Whether the endpoint is encrypted or accepts plaintext. By default endpoints are always encrypted and this property is only included for service components they may disable encryption
Usage string: DNS usage name

Component string: Service component name
ConnectionUri string: Connection info for connecting to the service component. This is a combination of host and port.
Host string: Host name for connecting to the service component
KafkaAuthenticationMethod string: Kafka authentication method. This is a value specific to the 'kafka' service component
Port int: Port number for connecting to the service component
Route string: Network access route
Ssl bool: Whether the endpoint is encrypted or accepts plaintext. By default endpoints are always encrypted and this property is only included for service components they may disable encryption
Usage string: DNS usage name

component String: Service component name
connectionUri String: Connection info for connecting to the service component. This is a combination of host and port.
host String: Host name for connecting to the service component
kafkaAuthenticationMethod String: Kafka authentication method. This is a value specific to the 'kafka' service component
port Integer: Port number for connecting to the service component
route String: Network access route
ssl Boolean: Whether the endpoint is encrypted or accepts plaintext. By default endpoints are always encrypted and this property is only included for service components they may disable encryption
usage String: DNS usage name

component string: Service component name
connectionUri string: Connection info for connecting to the service component. This is a combination of host and port.
host string: Host name for connecting to the service component
kafkaAuthenticationMethod string: Kafka authentication method. This is a value specific to the 'kafka' service component
port number: Port number for connecting to the service component
route string: Network access route
ssl boolean: Whether the endpoint is encrypted or accepts plaintext. By default endpoints are always encrypted and this property is only included for service components they may disable encryption
usage string: DNS usage name

component str: Service component name
connection_uri str: Connection info for connecting to the service component. This is a combination of host and port.
host str: Host name for connecting to the service component
kafka_authentication_method str: Kafka authentication method. This is a value specific to the 'kafka' service component
port int: Port number for connecting to the service component
route str: Network access route
ssl bool: Whether the endpoint is encrypted or accepts plaintext. By default endpoints are always encrypted and this property is only included for service components they may disable encryption
usage str: DNS usage name

component String: Service component name
connectionUri String: Connection info for connecting to the service component. This is a combination of host and port.
host String: Host name for connecting to the service component
kafkaAuthenticationMethod String: Kafka authentication method. This is a value specific to the 'kafka' service component
port Number: Port number for connecting to the service component
route String: Network access route
ssl Boolean: Whether the endpoint is encrypted or accepts plaintext. By default endpoints are always encrypted and this property is only included for service components they may disable encryption
usage String: DNS usage name

GetKafkaMirrorMakerKafkaMirrormakerUserConfig

AdditionalBackupRegions string: Additional Cloud Regions for Backup Replication.
Deprecated: This property is deprecated.
IpFilterObjects List<GetKafkaMirrorMakerKafkaMirrormakerUserConfigIpFilterObject>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16
IpFilterStrings List<string>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
IpFilters List<string>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
Deprecated: Deprecated. Use ip_filter_string instead.
KafkaMirrormaker GetKafkaMirrorMakerKafkaMirrormakerUserConfigKafkaMirrormaker: Kafka MirrorMaker configuration values
ServiceLog bool: Store logs for the service so that they are available in the HTTP API and console.
StaticIps bool: Use static public IP addresses.

AdditionalBackupRegions string: Additional Cloud Regions for Backup Replication.
Deprecated: This property is deprecated.
IpFilterObjects []GetKafkaMirrorMakerKafkaMirrormakerUserConfigIpFilterObject: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16
IpFilterStrings []string: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
IpFilters []string: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
Deprecated: Deprecated. Use ip_filter_string instead.
KafkaMirrormaker GetKafkaMirrorMakerKafkaMirrormakerUserConfigKafkaMirrormaker: Kafka MirrorMaker configuration values
ServiceLog bool: Store logs for the service so that they are available in the HTTP API and console.
StaticIps bool: Use static public IP addresses.

additionalBackupRegions String: Additional Cloud Regions for Backup Replication.
Deprecated: This property is deprecated.
ipFilterObjects List<GetKafkaMirrorMakerKafkaMirrormakerUserConfigIpFilterObject>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16
ipFilterStrings List<String>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
ipFilters List<String>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
Deprecated: Deprecated. Use ip_filter_string instead.
kafkaMirrormaker GetKafkaMirrorMakerKafkaMirrormakerUserConfigKafkaMirrormaker: Kafka MirrorMaker configuration values
serviceLog Boolean: Store logs for the service so that they are available in the HTTP API and console.
staticIps Boolean: Use static public IP addresses.

additionalBackupRegions string: Additional Cloud Regions for Backup Replication.
Deprecated: This property is deprecated.
ipFilterObjects GetKafkaMirrorMakerKafkaMirrormakerUserConfigIpFilterObject[]: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16
ipFilterStrings string[]: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
ipFilters string[]: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
Deprecated: Deprecated. Use ip_filter_string instead.
kafkaMirrormaker GetKafkaMirrorMakerKafkaMirrormakerUserConfigKafkaMirrormaker: Kafka MirrorMaker configuration values
serviceLog boolean: Store logs for the service so that they are available in the HTTP API and console.
staticIps boolean: Use static public IP addresses.

additional_backup_regions str: Additional Cloud Regions for Backup Replication.
Deprecated: This property is deprecated.
ip_filter_objects Sequence[GetKafkaMirrorMakerKafkaMirrormakerUserConfigIpFilterObject]: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16
ip_filter_strings Sequence[str]: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
ip_filters Sequence[str]: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
Deprecated: Deprecated. Use ip_filter_string instead.
kafka_mirrormaker GetKafkaMirrorMakerKafkaMirrormakerUserConfigKafkaMirrormaker: Kafka MirrorMaker configuration values
service_log bool: Store logs for the service so that they are available in the HTTP API and console.
static_ips bool: Use static public IP addresses.

additionalBackupRegions String: Additional Cloud Regions for Backup Replication.
Deprecated: This property is deprecated.
ipFilterObjects List<Property Map>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16
ipFilterStrings List<String>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
ipFilters List<String>: Allow incoming connections from CIDR address block, e.g. 10.20.0.0/16.
Deprecated: Deprecated. Use ip_filter_string instead.
kafkaMirrormaker Property Map: Kafka MirrorMaker configuration values
serviceLog Boolean: Store logs for the service so that they are available in the HTTP API and console.
staticIps Boolean: Use static public IP addresses.

GetKafkaMirrorMakerKafkaMirrormakerUserConfigIpFilterObject

Network string: CIDR address block. Example: 10.20.0.0/16.
Description string: Description for IP filter list entry. Example: Production service IP range.

Network string: CIDR address block. Example: 10.20.0.0/16.
Description string: Description for IP filter list entry. Example: Production service IP range.

network String: CIDR address block. Example: 10.20.0.0/16.
description String: Description for IP filter list entry. Example: Production service IP range.

network string: CIDR address block. Example: 10.20.0.0/16.
description string: Description for IP filter list entry. Example: Production service IP range.

network str: CIDR address block. Example: 10.20.0.0/16.
description str: Description for IP filter list entry. Example: Production service IP range.

network String: CIDR address block. Example: 10.20.0.0/16.
description String: Description for IP filter list entry. Example: Production service IP range.

GetKafkaMirrorMakerKafkaMirrormakerUserConfigKafkaMirrormaker

EmitCheckpointsEnabled bool: Whether to emit consumer group offset checkpoints to target cluster periodically (default: true).
EmitCheckpointsIntervalSeconds int: Frequency at which consumer group offset checkpoints are emitted (default: 60, every minute). Example: 60.
Groups string: Consumer groups to replicate. Supports comma-separated group IDs and regexes. Example: .*.
GroupsExclude string: Exclude groups. Supports comma-separated group IDs and regexes. Excludes take precedence over includes. Example: console-consumer-.*,connect-.*,__.*.
OffsetLagMax int: How out-of-sync a remote partition can be before it is resynced. Example: 100.
RefreshGroupsEnabled bool: Whether to periodically check for new consumer groups. Defaults to true.
RefreshGroupsIntervalSeconds int: Frequency of consumer group refresh in seconds. Defaults to 600 seconds (10 minutes).
RefreshTopicsEnabled bool: Whether to periodically check for new topics and partitions. Defaults to true.
RefreshTopicsIntervalSeconds int: Frequency of topic and partitions refresh in seconds. Defaults to 600 seconds (10 minutes).
SyncGroupOffsetsEnabled bool: Whether to periodically write the translated offsets of replicated consumer groups (in the source cluster) to __consumer_offsets topic in target cluster, as long as no active consumers in that group are connected to the target cluster.
SyncGroupOffsetsIntervalSeconds int: Frequency at which consumer group offsets are synced (default: 60, every minute). Example: 60.
SyncTopicConfigsEnabled bool: Whether to periodically configure remote topics to match their corresponding upstream topics.
TasksMaxPerCpu int: tasks.max is set to this multiplied by the number of CPUs in the service. Default: 1.

EmitCheckpointsEnabled bool: Whether to emit consumer group offset checkpoints to target cluster periodically (default: true).
EmitCheckpointsIntervalSeconds int: Frequency at which consumer group offset checkpoints are emitted (default: 60, every minute). Example: 60.
Groups string: Consumer groups to replicate. Supports comma-separated group IDs and regexes. Example: .*.
GroupsExclude string: Exclude groups. Supports comma-separated group IDs and regexes. Excludes take precedence over includes. Example: console-consumer-.*,connect-.*,__.*.
OffsetLagMax int: How out-of-sync a remote partition can be before it is resynced. Example: 100.
RefreshGroupsEnabled bool: Whether to periodically check for new consumer groups. Defaults to true.
RefreshGroupsIntervalSeconds int: Frequency of consumer group refresh in seconds. Defaults to 600 seconds (10 minutes).
RefreshTopicsEnabled bool: Whether to periodically check for new topics and partitions. Defaults to true.
RefreshTopicsIntervalSeconds int: Frequency of topic and partitions refresh in seconds. Defaults to 600 seconds (10 minutes).
SyncGroupOffsetsEnabled bool: Whether to periodically write the translated offsets of replicated consumer groups (in the source cluster) to __consumer_offsets topic in target cluster, as long as no active consumers in that group are connected to the target cluster.
SyncGroupOffsetsIntervalSeconds int: Frequency at which consumer group offsets are synced (default: 60, every minute). Example: 60.
SyncTopicConfigsEnabled bool: Whether to periodically configure remote topics to match their corresponding upstream topics.
TasksMaxPerCpu int: tasks.max is set to this multiplied by the number of CPUs in the service. Default: 1.

emitCheckpointsEnabled Boolean: Whether to emit consumer group offset checkpoints to target cluster periodically (default: true).
emitCheckpointsIntervalSeconds Integer: Frequency at which consumer group offset checkpoints are emitted (default: 60, every minute). Example: 60.
groups String: Consumer groups to replicate. Supports comma-separated group IDs and regexes. Example: .*.
groupsExclude String: Exclude groups. Supports comma-separated group IDs and regexes. Excludes take precedence over includes. Example: console-consumer-.*,connect-.*,__.*.
offsetLagMax Integer: How out-of-sync a remote partition can be before it is resynced. Example: 100.
refreshGroupsEnabled Boolean: Whether to periodically check for new consumer groups. Defaults to true.
refreshGroupsIntervalSeconds Integer: Frequency of consumer group refresh in seconds. Defaults to 600 seconds (10 minutes).
refreshTopicsEnabled Boolean: Whether to periodically check for new topics and partitions. Defaults to true.
refreshTopicsIntervalSeconds Integer: Frequency of topic and partitions refresh in seconds. Defaults to 600 seconds (10 minutes).
syncGroupOffsetsEnabled Boolean: Whether to periodically write the translated offsets of replicated consumer groups (in the source cluster) to __consumer_offsets topic in target cluster, as long as no active consumers in that group are connected to the target cluster.
syncGroupOffsetsIntervalSeconds Integer: Frequency at which consumer group offsets are synced (default: 60, every minute). Example: 60.
syncTopicConfigsEnabled Boolean: Whether to periodically configure remote topics to match their corresponding upstream topics.
tasksMaxPerCpu Integer: tasks.max is set to this multiplied by the number of CPUs in the service. Default: 1.

emitCheckpointsEnabled boolean: Whether to emit consumer group offset checkpoints to target cluster periodically (default: true).
emitCheckpointsIntervalSeconds number: Frequency at which consumer group offset checkpoints are emitted (default: 60, every minute). Example: 60.
groups string: Consumer groups to replicate. Supports comma-separated group IDs and regexes. Example: .*.
groupsExclude string: Exclude groups. Supports comma-separated group IDs and regexes. Excludes take precedence over includes. Example: console-consumer-.*,connect-.*,__.*.
offsetLagMax number: How out-of-sync a remote partition can be before it is resynced. Example: 100.
refreshGroupsEnabled boolean: Whether to periodically check for new consumer groups. Defaults to true.
refreshGroupsIntervalSeconds number: Frequency of consumer group refresh in seconds. Defaults to 600 seconds (10 minutes).
refreshTopicsEnabled boolean: Whether to periodically check for new topics and partitions. Defaults to true.
refreshTopicsIntervalSeconds number: Frequency of topic and partitions refresh in seconds. Defaults to 600 seconds (10 minutes).
syncGroupOffsetsEnabled boolean: Whether to periodically write the translated offsets of replicated consumer groups (in the source cluster) to __consumer_offsets topic in target cluster, as long as no active consumers in that group are connected to the target cluster.
syncGroupOffsetsIntervalSeconds number: Frequency at which consumer group offsets are synced (default: 60, every minute). Example: 60.
syncTopicConfigsEnabled boolean: Whether to periodically configure remote topics to match their corresponding upstream topics.
tasksMaxPerCpu number: tasks.max is set to this multiplied by the number of CPUs in the service. Default: 1.

emit_checkpoints_enabled bool: Whether to emit consumer group offset checkpoints to target cluster periodically (default: true).
emit_checkpoints_interval_seconds int: Frequency at which consumer group offset checkpoints are emitted (default: 60, every minute). Example: 60.
groups str: Consumer groups to replicate. Supports comma-separated group IDs and regexes. Example: .*.
groups_exclude str: Exclude groups. Supports comma-separated group IDs and regexes. Excludes take precedence over includes. Example: console-consumer-.*,connect-.*,__.*.
offset_lag_max int: How out-of-sync a remote partition can be before it is resynced. Example: 100.
refresh_groups_enabled bool: Whether to periodically check for new consumer groups. Defaults to true.
refresh_groups_interval_seconds int: Frequency of consumer group refresh in seconds. Defaults to 600 seconds (10 minutes).
refresh_topics_enabled bool: Whether to periodically check for new topics and partitions. Defaults to true.
refresh_topics_interval_seconds int: Frequency of topic and partitions refresh in seconds. Defaults to 600 seconds (10 minutes).
sync_group_offsets_enabled bool: Whether to periodically write the translated offsets of replicated consumer groups (in the source cluster) to __consumer_offsets topic in target cluster, as long as no active consumers in that group are connected to the target cluster.
sync_group_offsets_interval_seconds int: Frequency at which consumer group offsets are synced (default: 60, every minute). Example: 60.
sync_topic_configs_enabled bool: Whether to periodically configure remote topics to match their corresponding upstream topics.
tasks_max_per_cpu int: tasks.max is set to this multiplied by the number of CPUs in the service. Default: 1.

emitCheckpointsEnabled Boolean: Whether to emit consumer group offset checkpoints to target cluster periodically (default: true).
emitCheckpointsIntervalSeconds Number: Frequency at which consumer group offset checkpoints are emitted (default: 60, every minute). Example: 60.
groups String: Consumer groups to replicate. Supports comma-separated group IDs and regexes. Example: .*.
groupsExclude String: Exclude groups. Supports comma-separated group IDs and regexes. Excludes take precedence over includes. Example: console-consumer-.*,connect-.*,__.*.
offsetLagMax Number: How out-of-sync a remote partition can be before it is resynced. Example: 100.
refreshGroupsEnabled Boolean: Whether to periodically check for new consumer groups. Defaults to true.
refreshGroupsIntervalSeconds Number: Frequency of consumer group refresh in seconds. Defaults to 600 seconds (10 minutes).
refreshTopicsEnabled Boolean: Whether to periodically check for new topics and partitions. Defaults to true.
refreshTopicsIntervalSeconds Number: Frequency of topic and partitions refresh in seconds. Defaults to 600 seconds (10 minutes).
syncGroupOffsetsEnabled Boolean: Whether to periodically write the translated offsets of replicated consumer groups (in the source cluster) to __consumer_offsets topic in target cluster, as long as no active consumers in that group are connected to the target cluster.
syncGroupOffsetsIntervalSeconds Number: Frequency at which consumer group offsets are synced (default: 60, every minute). Example: 60.
syncTopicConfigsEnabled Boolean: Whether to periodically configure remote topics to match their corresponding upstream topics.
tasksMaxPerCpu Number: tasks.max is set to this multiplied by the number of CPUs in the service. Default: 1.

GetKafkaMirrorMakerServiceIntegration

IntegrationType string: Type of the service integration. The only supported value at the moment is read_replica
SourceServiceName string: Name of the source service

IntegrationType string: Type of the service integration. The only supported value at the moment is read_replica
SourceServiceName string: Name of the source service

integrationType String: Type of the service integration. The only supported value at the moment is read_replica
sourceServiceName String: Name of the source service

integrationType string: Type of the service integration. The only supported value at the moment is read_replica
sourceServiceName string: Name of the source service

integration_type str: Type of the service integration. The only supported value at the moment is read_replica
source_service_name str: Name of the source service

integrationType String: Type of the service integration. The only supported value at the moment is read_replica
sourceServiceName String: Name of the source service

GetKafkaMirrorMakerTag

Key string: Service tag key
Value string: Service tag value

Key string: Service tag key
Value string: Service tag value

key String: Service tag key
value String: Service tag value

key string: Service tag key
value string: Service tag value

key str: Service tag key
value str: Service tag value

key String: Service tag key
value String: Service tag value

GetKafkaMirrorMakerTechEmail

Email string: An email address to contact for technical issues

Email string: An email address to contact for technical issues

email String: An email address to contact for technical issues

email string: An email address to contact for technical issues

email str: An email address to contact for technical issues

email String: An email address to contact for technical issues

Package Details

Repository: Aiven pulumi/pulumi-aiven
License: Apache-2.0
Notes: This Pulumi package is based on the aiven Terraform Provider.

Aiven v6.18.0 published on Thursday, Jun 27, 2024 by Pulumi

pulumi/pulumi-aiven

aiven.getKafkaMirrorMaker

On this page

On this page

Example Usage

Using getKafkaMirrorMaker

getKafkaMirrorMaker Result

Supporting Types

GetKafkaMirrorMakerComponent

GetKafkaMirrorMakerKafkaMirrormakerUserConfig

GetKafkaMirrorMakerKafkaMirrormakerUserConfigIpFilterObject

GetKafkaMirrorMakerKafkaMirrormakerUserConfigKafkaMirrormaker

GetKafkaMirrorMakerServiceIntegration

GetKafkaMirrorMakerTag

GetKafkaMirrorMakerTechEmail

Package Details

On this page

On this page