incapsula.DataCentersConfiguration
Explore with Pulumi AI
Provides a Incapsula Data Centers Configuration resource. Each Site must have one or more Data Centers. Each Data Center must have one or more Origin Servers. Both Load Balancing and Failover can be configured for both Data Centers and Origin Servers. Each Data Center can be assigned to serve a specific list of Geo locations. Or be dedicated to serve requests that were routed using AD Forward Rules.
Example Usage
Basic Usage - Single Data Center with one Active and one Standby Origin Servers
import * as pulumi from "@pulumi/pulumi";
import * as incapsula from "@pulumi/incapsula";
const example_basic_data_centers_configuration = new incapsula.DataCentersConfiguration("example-basic-data-centers-configuration", {
siteId: incapsula_site["example-basic-site"].id,
siteTopology: "SINGLE_DC",
dataCenters: [{
name: "New DC",
ipMode: "MULTIPLE_IP",
originServers: [
{
address: "54.74.193.120",
isActive: true,
},
{
address: "44.72.103.175",
isActive: false,
},
],
}],
});
import pulumi
import pulumi_incapsula as incapsula
example_basic_data_centers_configuration = incapsula.DataCentersConfiguration("example-basic-data-centers-configuration",
site_id=incapsula_site["example-basic-site"]["id"],
site_topology="SINGLE_DC",
data_centers=[{
"name": "New DC",
"ip_mode": "MULTIPLE_IP",
"origin_servers": [
{
"address": "54.74.193.120",
"is_active": True,
},
{
"address": "44.72.103.175",
"is_active": False,
},
],
}])
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/incapsula/v3/incapsula"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := incapsula.NewDataCentersConfiguration(ctx, "example-basic-data-centers-configuration", &incapsula.DataCentersConfigurationArgs{
SiteId: pulumi.Any(incapsula_site.ExampleBasicSite.Id),
SiteTopology: pulumi.String("SINGLE_DC"),
DataCenters: incapsula.DataCentersConfigurationDataCenterArray{
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("New DC"),
IpMode: pulumi.String("MULTIPLE_IP"),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("54.74.193.120"),
IsActive: pulumi.Bool(true),
},
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("44.72.103.175"),
IsActive: pulumi.Bool(false),
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Incapsula = Pulumi.Incapsula;
return await Deployment.RunAsync(() =>
{
var example_basic_data_centers_configuration = new Incapsula.DataCentersConfiguration("example-basic-data-centers-configuration", new()
{
SiteId = incapsula_site.Example_basic_site.Id,
SiteTopology = "SINGLE_DC",
DataCenters = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "New DC",
IpMode = "MULTIPLE_IP",
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "54.74.193.120",
IsActive = true,
},
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "44.72.103.175",
IsActive = false,
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.incapsula.DataCentersConfiguration;
import com.pulumi.incapsula.DataCentersConfigurationArgs;
import com.pulumi.incapsula.inputs.DataCentersConfigurationDataCenterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example_basic_data_centers_configuration = new DataCentersConfiguration("example-basic-data-centers-configuration", DataCentersConfigurationArgs.builder()
.siteId(incapsula_site.example-basic-site().id())
.siteTopology("SINGLE_DC")
.dataCenters(DataCentersConfigurationDataCenterArgs.builder()
.name("New DC")
.ipMode("MULTIPLE_IP")
.originServers(
DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("54.74.193.120")
.isActive(true)
.build(),
DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("44.72.103.175")
.isActive(false)
.build())
.build())
.build());
}
}
resources:
example-basic-data-centers-configuration:
type: incapsula:DataCentersConfiguration
properties:
siteId: ${incapsula_site"example-basic-site"[%!s(MISSING)].id}
siteTopology: SINGLE_DC
dataCenters:
- name: New DC
ipMode: MULTIPLE_IP
originServers:
- address: 54.74.193.120
isActive: true
- address: 44.72.103.175
isActive: false
Multiple Data Centers across Geo Locations
import * as pulumi from "@pulumi/pulumi";
import * as incapsula from "@pulumi/incapsula";
const example_geo_assigned_data_centers_configuration = new incapsula.DataCentersConfiguration("example-geo-assigned-data-centers-configuration", {
siteId: incapsula_site["example-geo-assigned-site"].id,
isPersistent: true,
siteLbAlgorithm: "GEO_PREFERRED",
siteTopology: "MULTIPLE_DC",
dataCenters: [
{
name: "Rest of the world DC",
ipMode: "MULTIPLE_IP",
isRestOfTheWorld: true,
originPop: "hkg",
originServers: [{
address: "55.66.77.123",
isActive: true,
isEnabled: true,
}],
},
{
name: "EMEA DC",
geoLocations: "AFRICA,EUROPE,ASIA",
originPop: "lon",
originServers: [{
address: "54.74.193.120",
isActive: true,
}],
},
{
name: "Americas DC",
geoLocations: "US_EAST,US_WEST",
originPop: "iad",
originServers: [{
address: "54.90.145.67",
isActive: true,
isEnabled: true,
}],
},
],
});
import pulumi
import pulumi_incapsula as incapsula
example_geo_assigned_data_centers_configuration = incapsula.DataCentersConfiguration("example-geo-assigned-data-centers-configuration",
site_id=incapsula_site["example-geo-assigned-site"]["id"],
is_persistent=True,
site_lb_algorithm="GEO_PREFERRED",
site_topology="MULTIPLE_DC",
data_centers=[
{
"name": "Rest of the world DC",
"ip_mode": "MULTIPLE_IP",
"is_rest_of_the_world": True,
"origin_pop": "hkg",
"origin_servers": [{
"address": "55.66.77.123",
"is_active": True,
"is_enabled": True,
}],
},
{
"name": "EMEA DC",
"geo_locations": "AFRICA,EUROPE,ASIA",
"origin_pop": "lon",
"origin_servers": [{
"address": "54.74.193.120",
"is_active": True,
}],
},
{
"name": "Americas DC",
"geo_locations": "US_EAST,US_WEST",
"origin_pop": "iad",
"origin_servers": [{
"address": "54.90.145.67",
"is_active": True,
"is_enabled": True,
}],
},
])
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/incapsula/v3/incapsula"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := incapsula.NewDataCentersConfiguration(ctx, "example-geo-assigned-data-centers-configuration", &incapsula.DataCentersConfigurationArgs{
SiteId: pulumi.Any(incapsula_site.ExampleGeoAssignedSite.Id),
IsPersistent: pulumi.Bool(true),
SiteLbAlgorithm: pulumi.String("GEO_PREFERRED"),
SiteTopology: pulumi.String("MULTIPLE_DC"),
DataCenters: incapsula.DataCentersConfigurationDataCenterArray{
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("Rest of the world DC"),
IpMode: pulumi.String("MULTIPLE_IP"),
IsRestOfTheWorld: pulumi.Bool(true),
OriginPop: pulumi.String("hkg"),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("55.66.77.123"),
IsActive: pulumi.Bool(true),
IsEnabled: pulumi.Bool(true),
},
},
},
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("EMEA DC"),
GeoLocations: pulumi.String("AFRICA,EUROPE,ASIA"),
OriginPop: pulumi.String("lon"),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("54.74.193.120"),
IsActive: pulumi.Bool(true),
},
},
},
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("Americas DC"),
GeoLocations: pulumi.String("US_EAST,US_WEST"),
OriginPop: pulumi.String("iad"),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("54.90.145.67"),
IsActive: pulumi.Bool(true),
IsEnabled: pulumi.Bool(true),
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Incapsula = Pulumi.Incapsula;
return await Deployment.RunAsync(() =>
{
var example_geo_assigned_data_centers_configuration = new Incapsula.DataCentersConfiguration("example-geo-assigned-data-centers-configuration", new()
{
SiteId = incapsula_site.Example_geo_assigned_site.Id,
IsPersistent = true,
SiteLbAlgorithm = "GEO_PREFERRED",
SiteTopology = "MULTIPLE_DC",
DataCenters = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "Rest of the world DC",
IpMode = "MULTIPLE_IP",
IsRestOfTheWorld = true,
OriginPop = "hkg",
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "55.66.77.123",
IsActive = true,
IsEnabled = true,
},
},
},
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "EMEA DC",
GeoLocations = "AFRICA,EUROPE,ASIA",
OriginPop = "lon",
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "54.74.193.120",
IsActive = true,
},
},
},
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "Americas DC",
GeoLocations = "US_EAST,US_WEST",
OriginPop = "iad",
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "54.90.145.67",
IsActive = true,
IsEnabled = true,
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.incapsula.DataCentersConfiguration;
import com.pulumi.incapsula.DataCentersConfigurationArgs;
import com.pulumi.incapsula.inputs.DataCentersConfigurationDataCenterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example_geo_assigned_data_centers_configuration = new DataCentersConfiguration("example-geo-assigned-data-centers-configuration", DataCentersConfigurationArgs.builder()
.siteId(incapsula_site.example-geo-assigned-site().id())
.isPersistent(true)
.siteLbAlgorithm("GEO_PREFERRED")
.siteTopology("MULTIPLE_DC")
.dataCenters(
DataCentersConfigurationDataCenterArgs.builder()
.name("Rest of the world DC")
.ipMode("MULTIPLE_IP")
.isRestOfTheWorld(true)
.originPop("hkg")
.originServers(DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("55.66.77.123")
.isActive(true)
.isEnabled(true)
.build())
.build(),
DataCentersConfigurationDataCenterArgs.builder()
.name("EMEA DC")
.geoLocations("AFRICA,EUROPE,ASIA")
.originPop("lon")
.originServers(DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("54.74.193.120")
.isActive(true)
.build())
.build(),
DataCentersConfigurationDataCenterArgs.builder()
.name("Americas DC")
.geoLocations("US_EAST,US_WEST")
.originPop("iad")
.originServers(DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("54.90.145.67")
.isActive(true)
.isEnabled(true)
.build())
.build())
.build());
}
}
resources:
example-geo-assigned-data-centers-configuration:
type: incapsula:DataCentersConfiguration
properties:
siteId: ${incapsula_site"example-geo-assigned-site"[%!s(MISSING)].id}
isPersistent: true
siteLbAlgorithm: GEO_PREFERRED
siteTopology: MULTIPLE_DC
dataCenters:
- name: Rest of the world DC
ipMode: MULTIPLE_IP
isRestOfTheWorld: true
originPop: hkg
originServers:
- address: 55.66.77.123
isActive: true
isEnabled: true
- name: EMEA DC
geoLocations: AFRICA,EUROPE,ASIA
originPop: lon
originServers:
- address: 54.74.193.120
isActive: true
- name: Americas DC
geoLocations: US_EAST,US_WEST
originPop: iad
originServers:
- address: 54.90.145.67
isActive: true
isEnabled: true
Multiple Data Centers with different capacities plus a dedicated Data Center for handling AD forward rules’ traffic
import * as pulumi from "@pulumi/pulumi";
import * as incapsula from "@pulumi/incapsula";
const example_weighted_data_centers_configuration = new incapsula.DataCentersConfiguration("example-weighted-data-centers-configuration", {
siteId: incapsula_site["example-weighted-site"].id,
isPersistent: true,
siteLbAlgorithm: "WEIGHTED_LB",
siteTopology: "MULTIPLE_DC",
dataCenters: [
{
name: "AD Forward Rules DC",
isContent: true,
originServers: [{
address: "55.66.77.123",
}],
},
{
name: "Powerful DC",
weight: 67,
originServers: [{
address: "54.74.193.120",
isActive: true,
}],
},
{
name: "Slagish DC",
weight: 33,
dcLbAlgorithm: "WEIGHTED",
originServers: [
{
address: "54.90.145.67",
weight: 50,
},
{
address: "54.90.145.68",
weight: 30,
},
{
address: "54.90.145.69",
weight: 20,
},
],
},
],
});
import pulumi
import pulumi_incapsula as incapsula
example_weighted_data_centers_configuration = incapsula.DataCentersConfiguration("example-weighted-data-centers-configuration",
site_id=incapsula_site["example-weighted-site"]["id"],
is_persistent=True,
site_lb_algorithm="WEIGHTED_LB",
site_topology="MULTIPLE_DC",
data_centers=[
{
"name": "AD Forward Rules DC",
"is_content": True,
"origin_servers": [{
"address": "55.66.77.123",
}],
},
{
"name": "Powerful DC",
"weight": 67,
"origin_servers": [{
"address": "54.74.193.120",
"is_active": True,
}],
},
{
"name": "Slagish DC",
"weight": 33,
"dc_lb_algorithm": "WEIGHTED",
"origin_servers": [
{
"address": "54.90.145.67",
"weight": 50,
},
{
"address": "54.90.145.68",
"weight": 30,
},
{
"address": "54.90.145.69",
"weight": 20,
},
],
},
])
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/incapsula/v3/incapsula"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := incapsula.NewDataCentersConfiguration(ctx, "example-weighted-data-centers-configuration", &incapsula.DataCentersConfigurationArgs{
SiteId: pulumi.Any(incapsula_site.ExampleWeightedSite.Id),
IsPersistent: pulumi.Bool(true),
SiteLbAlgorithm: pulumi.String("WEIGHTED_LB"),
SiteTopology: pulumi.String("MULTIPLE_DC"),
DataCenters: incapsula.DataCentersConfigurationDataCenterArray{
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("AD Forward Rules DC"),
IsContent: pulumi.Bool(true),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("55.66.77.123"),
},
},
},
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("Powerful DC"),
Weight: pulumi.Float64(67),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("54.74.193.120"),
IsActive: pulumi.Bool(true),
},
},
},
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("Slagish DC"),
Weight: pulumi.Float64(33),
DcLbAlgorithm: pulumi.String("WEIGHTED"),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("54.90.145.67"),
Weight: pulumi.Float64(50),
},
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("54.90.145.68"),
Weight: pulumi.Float64(30),
},
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("54.90.145.69"),
Weight: pulumi.Float64(20),
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Incapsula = Pulumi.Incapsula;
return await Deployment.RunAsync(() =>
{
var example_weighted_data_centers_configuration = new Incapsula.DataCentersConfiguration("example-weighted-data-centers-configuration", new()
{
SiteId = incapsula_site.Example_weighted_site.Id,
IsPersistent = true,
SiteLbAlgorithm = "WEIGHTED_LB",
SiteTopology = "MULTIPLE_DC",
DataCenters = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "AD Forward Rules DC",
IsContent = true,
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "55.66.77.123",
},
},
},
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "Powerful DC",
Weight = 67,
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "54.74.193.120",
IsActive = true,
},
},
},
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "Slagish DC",
Weight = 33,
DcLbAlgorithm = "WEIGHTED",
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "54.90.145.67",
Weight = 50,
},
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "54.90.145.68",
Weight = 30,
},
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "54.90.145.69",
Weight = 20,
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.incapsula.DataCentersConfiguration;
import com.pulumi.incapsula.DataCentersConfigurationArgs;
import com.pulumi.incapsula.inputs.DataCentersConfigurationDataCenterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example_weighted_data_centers_configuration = new DataCentersConfiguration("example-weighted-data-centers-configuration", DataCentersConfigurationArgs.builder()
.siteId(incapsula_site.example-weighted-site().id())
.isPersistent(true)
.siteLbAlgorithm("WEIGHTED_LB")
.siteTopology("MULTIPLE_DC")
.dataCenters(
DataCentersConfigurationDataCenterArgs.builder()
.name("AD Forward Rules DC")
.isContent(true)
.originServers(DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("55.66.77.123")
.build())
.build(),
DataCentersConfigurationDataCenterArgs.builder()
.name("Powerful DC")
.weight(67)
.originServers(DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("54.74.193.120")
.isActive(true)
.build())
.build(),
DataCentersConfigurationDataCenterArgs.builder()
.name("Slagish DC")
.weight(33)
.dcLbAlgorithm("WEIGHTED")
.originServers(
DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("54.90.145.67")
.weight(50)
.build(),
DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("54.90.145.68")
.weight(30)
.build(),
DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("54.90.145.69")
.weight(20)
.build())
.build())
.build());
}
}
resources:
example-weighted-data-centers-configuration:
type: incapsula:DataCentersConfiguration
properties:
siteId: ${incapsula_site"example-weighted-site"[%!s(MISSING)].id}
isPersistent: true
siteLbAlgorithm: WEIGHTED_LB
siteTopology: MULTIPLE_DC
dataCenters:
- name: AD Forward Rules DC
isContent: true
originServers:
- address: 55.66.77.123
- name: Powerful DC
weight: 67
originServers:
- address: 54.74.193.120
isActive: true
- name: Slagish DC
weight: 33
dcLbAlgorithm: WEIGHTED
originServers:
- address: 54.90.145.67
weight: 50
- address: 54.90.145.68
weight: 30
- address: 54.90.145.69
weight: 20
Create DataCentersConfiguration Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DataCentersConfiguration(name: string, args: DataCentersConfigurationArgs, opts?: CustomResourceOptions);
@overload
def DataCentersConfiguration(resource_name: str,
args: DataCentersConfigurationArgs,
opts: Optional[ResourceOptions] = None)
@overload
def DataCentersConfiguration(resource_name: str,
opts: Optional[ResourceOptions] = None,
data_centers: Optional[Sequence[DataCentersConfigurationDataCenterArgs]] = None,
site_id: Optional[str] = None,
data_centers_configuration_id: Optional[str] = None,
fail_over_required_monitors: Optional[str] = None,
is_persistent: Optional[bool] = None,
kickstart_password: Optional[str] = None,
kickstart_url: Optional[str] = None,
kickstart_user: Optional[str] = None,
min_available_servers_for_dc_up: Optional[float] = None,
site_lb_algorithm: Optional[str] = None,
site_topology: Optional[str] = None)
func NewDataCentersConfiguration(ctx *Context, name string, args DataCentersConfigurationArgs, opts ...ResourceOption) (*DataCentersConfiguration, error)
public DataCentersConfiguration(string name, DataCentersConfigurationArgs args, CustomResourceOptions? opts = null)
public DataCentersConfiguration(String name, DataCentersConfigurationArgs args)
public DataCentersConfiguration(String name, DataCentersConfigurationArgs args, CustomResourceOptions options)
type: incapsula:DataCentersConfiguration
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DataCentersConfigurationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DataCentersConfigurationArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DataCentersConfigurationArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DataCentersConfigurationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DataCentersConfigurationArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var dataCentersConfigurationResource = new Incapsula.DataCentersConfiguration("dataCentersConfigurationResource", new()
{
DataCenters = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterArgs
{
Name = "string",
OriginServers = new[]
{
new Incapsula.Inputs.DataCentersConfigurationDataCenterOriginServerArgs
{
Address = "string",
IsActive = false,
IsEnabled = false,
Weight = 0,
},
},
IsEnabled = false,
IpMode = "string",
IsActive = false,
IsContent = false,
DcId = 0,
IsRestOfTheWorld = false,
GeoLocations = "string",
OriginPop = "string",
DcLbAlgorithm = "string",
WebServersPerServer = 0,
Weight = 0,
},
},
SiteId = "string",
DataCentersConfigurationId = "string",
FailOverRequiredMonitors = "string",
IsPersistent = false,
KickstartPassword = "string",
KickstartUrl = "string",
KickstartUser = "string",
MinAvailableServersForDcUp = 0,
SiteLbAlgorithm = "string",
SiteTopology = "string",
});
example, err := incapsula.NewDataCentersConfiguration(ctx, "dataCentersConfigurationResource", &incapsula.DataCentersConfigurationArgs{
DataCenters: incapsula.DataCentersConfigurationDataCenterArray{
&incapsula.DataCentersConfigurationDataCenterArgs{
Name: pulumi.String("string"),
OriginServers: incapsula.DataCentersConfigurationDataCenterOriginServerArray{
&incapsula.DataCentersConfigurationDataCenterOriginServerArgs{
Address: pulumi.String("string"),
IsActive: pulumi.Bool(false),
IsEnabled: pulumi.Bool(false),
Weight: pulumi.Float64(0),
},
},
IsEnabled: pulumi.Bool(false),
IpMode: pulumi.String("string"),
IsActive: pulumi.Bool(false),
IsContent: pulumi.Bool(false),
DcId: pulumi.Float64(0),
IsRestOfTheWorld: pulumi.Bool(false),
GeoLocations: pulumi.String("string"),
OriginPop: pulumi.String("string"),
DcLbAlgorithm: pulumi.String("string"),
WebServersPerServer: pulumi.Float64(0),
Weight: pulumi.Float64(0),
},
},
SiteId: pulumi.String("string"),
DataCentersConfigurationId: pulumi.String("string"),
FailOverRequiredMonitors: pulumi.String("string"),
IsPersistent: pulumi.Bool(false),
KickstartPassword: pulumi.String("string"),
KickstartUrl: pulumi.String("string"),
KickstartUser: pulumi.String("string"),
MinAvailableServersForDcUp: pulumi.Float64(0),
SiteLbAlgorithm: pulumi.String("string"),
SiteTopology: pulumi.String("string"),
})
var dataCentersConfigurationResource = new DataCentersConfiguration("dataCentersConfigurationResource", DataCentersConfigurationArgs.builder()
.dataCenters(DataCentersConfigurationDataCenterArgs.builder()
.name("string")
.originServers(DataCentersConfigurationDataCenterOriginServerArgs.builder()
.address("string")
.isActive(false)
.isEnabled(false)
.weight(0)
.build())
.isEnabled(false)
.ipMode("string")
.isActive(false)
.isContent(false)
.dcId(0)
.isRestOfTheWorld(false)
.geoLocations("string")
.originPop("string")
.dcLbAlgorithm("string")
.webServersPerServer(0)
.weight(0)
.build())
.siteId("string")
.dataCentersConfigurationId("string")
.failOverRequiredMonitors("string")
.isPersistent(false)
.kickstartPassword("string")
.kickstartUrl("string")
.kickstartUser("string")
.minAvailableServersForDcUp(0)
.siteLbAlgorithm("string")
.siteTopology("string")
.build());
data_centers_configuration_resource = incapsula.DataCentersConfiguration("dataCentersConfigurationResource",
data_centers=[{
"name": "string",
"origin_servers": [{
"address": "string",
"is_active": False,
"is_enabled": False,
"weight": 0,
}],
"is_enabled": False,
"ip_mode": "string",
"is_active": False,
"is_content": False,
"dc_id": 0,
"is_rest_of_the_world": False,
"geo_locations": "string",
"origin_pop": "string",
"dc_lb_algorithm": "string",
"web_servers_per_server": 0,
"weight": 0,
}],
site_id="string",
data_centers_configuration_id="string",
fail_over_required_monitors="string",
is_persistent=False,
kickstart_password="string",
kickstart_url="string",
kickstart_user="string",
min_available_servers_for_dc_up=0,
site_lb_algorithm="string",
site_topology="string")
const dataCentersConfigurationResource = new incapsula.DataCentersConfiguration("dataCentersConfigurationResource", {
dataCenters: [{
name: "string",
originServers: [{
address: "string",
isActive: false,
isEnabled: false,
weight: 0,
}],
isEnabled: false,
ipMode: "string",
isActive: false,
isContent: false,
dcId: 0,
isRestOfTheWorld: false,
geoLocations: "string",
originPop: "string",
dcLbAlgorithm: "string",
webServersPerServer: 0,
weight: 0,
}],
siteId: "string",
dataCentersConfigurationId: "string",
failOverRequiredMonitors: "string",
isPersistent: false,
kickstartPassword: "string",
kickstartUrl: "string",
kickstartUser: "string",
minAvailableServersForDcUp: 0,
siteLbAlgorithm: "string",
siteTopology: "string",
});
type: incapsula:DataCentersConfiguration
properties:
dataCenters:
- dcId: 0
dcLbAlgorithm: string
geoLocations: string
ipMode: string
isActive: false
isContent: false
isEnabled: false
isRestOfTheWorld: false
name: string
originPop: string
originServers:
- address: string
isActive: false
isEnabled: false
weight: 0
webServersPerServer: 0
weight: 0
dataCentersConfigurationId: string
failOverRequiredMonitors: string
isPersistent: false
kickstartPassword: string
kickstartUrl: string
kickstartUser: string
minAvailableServersForDcUp: 0
siteId: string
siteLbAlgorithm: string
siteTopology: string
DataCentersConfiguration Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The DataCentersConfiguration resource accepts the following input properties:
- Data
Centers List<DataCenters Configuration Data Center> - A set of Data Centers and their Origin Servers
- Site
Id string - Numeric identifier of the site to operate on.
- Data
Centers stringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- Fail
Over stringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- Is
Persistent bool When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- Kickstart
Password string - User name, if required by the kickstart URL.
- Kickstart
Url string - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- Kickstart
User string - User name, if required by the kickstart URL.
- double
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- Site
Lb stringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- Site
Topology string - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- Data
Centers []DataCenters Configuration Data Center Args - A set of Data Centers and their Origin Servers
- Site
Id string - Numeric identifier of the site to operate on.
- Data
Centers stringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- Fail
Over stringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- Is
Persistent bool When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- Kickstart
Password string - User name, if required by the kickstart URL.
- Kickstart
Url string - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- Kickstart
User string - User name, if required by the kickstart URL.
- float64
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- Site
Lb stringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- Site
Topology string - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data
Centers List<DataCenters Configuration Data Center> - A set of Data Centers and their Origin Servers
- site
Id String - Numeric identifier of the site to operate on.
- data
Centers StringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail
Over StringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is
Persistent Boolean When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart
Password String - User name, if required by the kickstart URL.
- kickstart
Url String - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart
User String - User name, if required by the kickstart URL.
- Double
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site
Lb StringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site
Topology String - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data
Centers DataCenters Configuration Data Center[] - A set of Data Centers and their Origin Servers
- site
Id string - Numeric identifier of the site to operate on.
- data
Centers stringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail
Over stringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is
Persistent boolean When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart
Password string - User name, if required by the kickstart URL.
- kickstart
Url string - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart
User string - User name, if required by the kickstart URL.
- number
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site
Lb stringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site
Topology string - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data_
centers Sequence[DataCenters Configuration Data Center Args] - A set of Data Centers and their Origin Servers
- site_
id str - Numeric identifier of the site to operate on.
- data_
centers_ strconfiguration_ id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail_
over_ strrequired_ monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is_
persistent bool When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart_
password str - User name, if required by the kickstart URL.
- kickstart_
url str - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart_
user str - User name, if required by the kickstart URL.
- min_
available_ floatservers_ for_ dc_ up - The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site_
lb_ stralgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site_
topology str - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data
Centers List<Property Map> - A set of Data Centers and their Origin Servers
- site
Id String - Numeric identifier of the site to operate on.
- data
Centers StringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail
Over StringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is
Persistent Boolean When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart
Password String - User name, if required by the kickstart URL.
- kickstart
Url String - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart
User String - User name, if required by the kickstart URL.
- Number
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site
Lb StringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site
Topology String - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
Outputs
All input properties are implicitly available as output properties. Additionally, the DataCentersConfiguration resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing DataCentersConfiguration Resource
Get an existing DataCentersConfiguration resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: DataCentersConfigurationState, opts?: CustomResourceOptions): DataCentersConfiguration
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
data_centers: Optional[Sequence[DataCentersConfigurationDataCenterArgs]] = None,
data_centers_configuration_id: Optional[str] = None,
fail_over_required_monitors: Optional[str] = None,
is_persistent: Optional[bool] = None,
kickstart_password: Optional[str] = None,
kickstart_url: Optional[str] = None,
kickstart_user: Optional[str] = None,
min_available_servers_for_dc_up: Optional[float] = None,
site_id: Optional[str] = None,
site_lb_algorithm: Optional[str] = None,
site_topology: Optional[str] = None) -> DataCentersConfiguration
func GetDataCentersConfiguration(ctx *Context, name string, id IDInput, state *DataCentersConfigurationState, opts ...ResourceOption) (*DataCentersConfiguration, error)
public static DataCentersConfiguration Get(string name, Input<string> id, DataCentersConfigurationState? state, CustomResourceOptions? opts = null)
public static DataCentersConfiguration get(String name, Output<String> id, DataCentersConfigurationState state, CustomResourceOptions options)
resources: _: type: incapsula:DataCentersConfiguration get: id: ${id}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Data
Centers List<DataCenters Configuration Data Center> - A set of Data Centers and their Origin Servers
- Data
Centers stringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- Fail
Over stringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- Is
Persistent bool When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- Kickstart
Password string - User name, if required by the kickstart URL.
- Kickstart
Url string - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- Kickstart
User string - User name, if required by the kickstart URL.
- double
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- Site
Id string - Numeric identifier of the site to operate on.
- Site
Lb stringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- Site
Topology string - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- Data
Centers []DataCenters Configuration Data Center Args - A set of Data Centers and their Origin Servers
- Data
Centers stringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- Fail
Over stringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- Is
Persistent bool When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- Kickstart
Password string - User name, if required by the kickstart URL.
- Kickstart
Url string - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- Kickstart
User string - User name, if required by the kickstart URL.
- float64
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- Site
Id string - Numeric identifier of the site to operate on.
- Site
Lb stringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- Site
Topology string - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data
Centers List<DataCenters Configuration Data Center> - A set of Data Centers and their Origin Servers
- data
Centers StringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail
Over StringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is
Persistent Boolean When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart
Password String - User name, if required by the kickstart URL.
- kickstart
Url String - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart
User String - User name, if required by the kickstart URL.
- Double
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site
Id String - Numeric identifier of the site to operate on.
- site
Lb StringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site
Topology String - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data
Centers DataCenters Configuration Data Center[] - A set of Data Centers and their Origin Servers
- data
Centers stringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail
Over stringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is
Persistent boolean When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart
Password string - User name, if required by the kickstart URL.
- kickstart
Url string - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart
User string - User name, if required by the kickstart URL.
- number
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site
Id string - Numeric identifier of the site to operate on.
- site
Lb stringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site
Topology string - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data_
centers Sequence[DataCenters Configuration Data Center Args] - A set of Data Centers and their Origin Servers
- data_
centers_ strconfiguration_ id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail_
over_ strrequired_ monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is_
persistent bool When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart_
password str - User name, if required by the kickstart URL.
- kickstart_
url str - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart_
user str - User name, if required by the kickstart URL.
- min_
available_ floatservers_ for_ dc_ up - The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site_
id str - Numeric identifier of the site to operate on.
- site_
lb_ stralgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site_
topology str - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
- data
Centers List<Property Map> - A set of Data Centers and their Origin Servers
- data
Centers StringConfiguration Id - Unique identifier in the API for the data centers configuration. The id is identical to Site id.
- fail
Over StringRequired Monitors - How many Imperva PoPs should assess Data Center as down before failover is performed. One of: ONE, MANY, MOST, ALL.
- is
Persistent Boolean When true (the default) our proxy servers will maintain session stickiness to origin servers by a cookie.
At least one
data_center
sub resource must be defined. The following Data Center arguments are supported:- kickstart
Password String - User name, if required by the kickstart URL.
- kickstart
Url String - The URL that will be sent to the standby server when Imperva performs failover based on our monitoring. E.g. "https://www.example.com/kickStart".
- kickstart
User String - User name, if required by the kickstart URL.
- Number
- The minimal number of available data center's servers to consider that data center as UP. Default: 1.
- site
Id String - Numeric identifier of the site to operate on.
- site
Lb StringAlgorithm - How to load balance between multiple Data Centers. One of: BEST_CONNECTION_TIME, GEO_PREFERRED, GEO_REQUIRED, WEIGHTED_LB.
- site
Topology String - One of: SINGLE_SERVER (no failover), SINGLE_DC (allows failover and LB), or MULTIPLE_DC (allows also Geo and/or AD Forward rules assignment)
Supporting Types
DataCentersConfigurationDataCenter, DataCentersConfigurationDataCenterArgs
- Name string
- Data Center Name. Must be unique within a Site.
- Origin
Servers List<DataCenters Configuration Data Center Origin Server> - A set of Origin Servers
- Dc
Id double - Internal Data Center id.
- Dc
Lb stringAlgorithm - How to load balance between the servers of this data center. One of: LB_LEAST_PENDING_REQUESTS (the default), LB_LEAST_OPEN_CONNECTIONS, LB_SOURCE_IP_HASH, RANDOM, WEIGHTED.
- Geo
Locations string - Comma separated list of geo regions that this data center will serve. Mandatory if site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED. E.g. "ASIA,AFRICA". Allowed regions: EUROPE, AUSTRALIA, US_EAST, US_WEST, AFRICA, ASIA, SOUTH_AMERICA, NORTH_AMERICA.
- Ip
Mode string - Load-balancing mode. Possible values:
- SINGLE_IP - Use it only when you need to support multiple ports. Allows a single active server listening on multiple ports, plus the option of a single standby server. Traffic is distributed across the server ports. Note: The server address must be a valid IP address (i.e. not host/domain name). SINGLE_IP is applicable only for datacenters, It may not be used when dataCenterMode = ‘SINGLE_SERVER’.
- MULTIPLE_IP – Allows one or more origin servers having a single webserver and listening port per server. Traffic is distributed across servers.
- Is
Active bool - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- Is
Content bool - When true, this Data Center will only serve requests that were routed using AD Forward rules. If true, it must also be enabled.
- Is
Enabled bool - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- Is
Rest boolOf The World - When true and site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED, this data center will handle traffic from any region that is not assigned to a specific data center. Exactly one data center must have is_rest_of_the_world = true.
- Origin
Pop string The ID of the PoP that serves as an access point between Imperva and the customer’s origin server. E.g. "lax", for Los Angeles. When not specified, all Imperva PoPs can send traffic to this data center. The list of available PoPs is documented at: https://docs.imperva.com/bundle/cloud-application-security/page/more/pops.htm.
For each
data_center
sub resource, at least oneorigin_server
sub resource must be defined. The following Origin Server arguments are supported:- Web
Servers doublePer Server - When IP mode = SINGLE_IP, number of web servers (processes) per server. Each web server listens to different port. E.g. when web_servers_per_server = 5, HTTP traffic will use ports 80-84 while HTTPS traffic will use ports 443-447. Default: 1.
- Weight double
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- Name string
- Data Center Name. Must be unique within a Site.
- Origin
Servers []DataCenters Configuration Data Center Origin Server - A set of Origin Servers
- Dc
Id float64 - Internal Data Center id.
- Dc
Lb stringAlgorithm - How to load balance between the servers of this data center. One of: LB_LEAST_PENDING_REQUESTS (the default), LB_LEAST_OPEN_CONNECTIONS, LB_SOURCE_IP_HASH, RANDOM, WEIGHTED.
- Geo
Locations string - Comma separated list of geo regions that this data center will serve. Mandatory if site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED. E.g. "ASIA,AFRICA". Allowed regions: EUROPE, AUSTRALIA, US_EAST, US_WEST, AFRICA, ASIA, SOUTH_AMERICA, NORTH_AMERICA.
- Ip
Mode string - Load-balancing mode. Possible values:
- SINGLE_IP - Use it only when you need to support multiple ports. Allows a single active server listening on multiple ports, plus the option of a single standby server. Traffic is distributed across the server ports. Note: The server address must be a valid IP address (i.e. not host/domain name). SINGLE_IP is applicable only for datacenters, It may not be used when dataCenterMode = ‘SINGLE_SERVER’.
- MULTIPLE_IP – Allows one or more origin servers having a single webserver and listening port per server. Traffic is distributed across servers.
- Is
Active bool - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- Is
Content bool - When true, this Data Center will only serve requests that were routed using AD Forward rules. If true, it must also be enabled.
- Is
Enabled bool - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- Is
Rest boolOf The World - When true and site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED, this data center will handle traffic from any region that is not assigned to a specific data center. Exactly one data center must have is_rest_of_the_world = true.
- Origin
Pop string The ID of the PoP that serves as an access point between Imperva and the customer’s origin server. E.g. "lax", for Los Angeles. When not specified, all Imperva PoPs can send traffic to this data center. The list of available PoPs is documented at: https://docs.imperva.com/bundle/cloud-application-security/page/more/pops.htm.
For each
data_center
sub resource, at least oneorigin_server
sub resource must be defined. The following Origin Server arguments are supported:- Web
Servers float64Per Server - When IP mode = SINGLE_IP, number of web servers (processes) per server. Each web server listens to different port. E.g. when web_servers_per_server = 5, HTTP traffic will use ports 80-84 while HTTPS traffic will use ports 443-447. Default: 1.
- Weight float64
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- name String
- Data Center Name. Must be unique within a Site.
- origin
Servers List<DataCenters Configuration Data Center Origin Server> - A set of Origin Servers
- dc
Id Double - Internal Data Center id.
- dc
Lb StringAlgorithm - How to load balance between the servers of this data center. One of: LB_LEAST_PENDING_REQUESTS (the default), LB_LEAST_OPEN_CONNECTIONS, LB_SOURCE_IP_HASH, RANDOM, WEIGHTED.
- geo
Locations String - Comma separated list of geo regions that this data center will serve. Mandatory if site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED. E.g. "ASIA,AFRICA". Allowed regions: EUROPE, AUSTRALIA, US_EAST, US_WEST, AFRICA, ASIA, SOUTH_AMERICA, NORTH_AMERICA.
- ip
Mode String - Load-balancing mode. Possible values:
- SINGLE_IP - Use it only when you need to support multiple ports. Allows a single active server listening on multiple ports, plus the option of a single standby server. Traffic is distributed across the server ports. Note: The server address must be a valid IP address (i.e. not host/domain name). SINGLE_IP is applicable only for datacenters, It may not be used when dataCenterMode = ‘SINGLE_SERVER’.
- MULTIPLE_IP – Allows one or more origin servers having a single webserver and listening port per server. Traffic is distributed across servers.
- is
Active Boolean - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is
Content Boolean - When true, this Data Center will only serve requests that were routed using AD Forward rules. If true, it must also be enabled.
- is
Enabled Boolean - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- is
Rest BooleanOf The World - When true and site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED, this data center will handle traffic from any region that is not assigned to a specific data center. Exactly one data center must have is_rest_of_the_world = true.
- origin
Pop String The ID of the PoP that serves as an access point between Imperva and the customer’s origin server. E.g. "lax", for Los Angeles. When not specified, all Imperva PoPs can send traffic to this data center. The list of available PoPs is documented at: https://docs.imperva.com/bundle/cloud-application-security/page/more/pops.htm.
For each
data_center
sub resource, at least oneorigin_server
sub resource must be defined. The following Origin Server arguments are supported:- web
Servers DoublePer Server - When IP mode = SINGLE_IP, number of web servers (processes) per server. Each web server listens to different port. E.g. when web_servers_per_server = 5, HTTP traffic will use ports 80-84 while HTTPS traffic will use ports 443-447. Default: 1.
- weight Double
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- name string
- Data Center Name. Must be unique within a Site.
- origin
Servers DataCenters Configuration Data Center Origin Server[] - A set of Origin Servers
- dc
Id number - Internal Data Center id.
- dc
Lb stringAlgorithm - How to load balance between the servers of this data center. One of: LB_LEAST_PENDING_REQUESTS (the default), LB_LEAST_OPEN_CONNECTIONS, LB_SOURCE_IP_HASH, RANDOM, WEIGHTED.
- geo
Locations string - Comma separated list of geo regions that this data center will serve. Mandatory if site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED. E.g. "ASIA,AFRICA". Allowed regions: EUROPE, AUSTRALIA, US_EAST, US_WEST, AFRICA, ASIA, SOUTH_AMERICA, NORTH_AMERICA.
- ip
Mode string - Load-balancing mode. Possible values:
- SINGLE_IP - Use it only when you need to support multiple ports. Allows a single active server listening on multiple ports, plus the option of a single standby server. Traffic is distributed across the server ports. Note: The server address must be a valid IP address (i.e. not host/domain name). SINGLE_IP is applicable only for datacenters, It may not be used when dataCenterMode = ‘SINGLE_SERVER’.
- MULTIPLE_IP – Allows one or more origin servers having a single webserver and listening port per server. Traffic is distributed across servers.
- is
Active boolean - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is
Content boolean - When true, this Data Center will only serve requests that were routed using AD Forward rules. If true, it must also be enabled.
- is
Enabled boolean - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- is
Rest booleanOf The World - When true and site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED, this data center will handle traffic from any region that is not assigned to a specific data center. Exactly one data center must have is_rest_of_the_world = true.
- origin
Pop string The ID of the PoP that serves as an access point between Imperva and the customer’s origin server. E.g. "lax", for Los Angeles. When not specified, all Imperva PoPs can send traffic to this data center. The list of available PoPs is documented at: https://docs.imperva.com/bundle/cloud-application-security/page/more/pops.htm.
For each
data_center
sub resource, at least oneorigin_server
sub resource must be defined. The following Origin Server arguments are supported:- web
Servers numberPer Server - When IP mode = SINGLE_IP, number of web servers (processes) per server. Each web server listens to different port. E.g. when web_servers_per_server = 5, HTTP traffic will use ports 80-84 while HTTPS traffic will use ports 443-447. Default: 1.
- weight number
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- name str
- Data Center Name. Must be unique within a Site.
- origin_
servers Sequence[DataCenters Configuration Data Center Origin Server] - A set of Origin Servers
- dc_
id float - Internal Data Center id.
- dc_
lb_ stralgorithm - How to load balance between the servers of this data center. One of: LB_LEAST_PENDING_REQUESTS (the default), LB_LEAST_OPEN_CONNECTIONS, LB_SOURCE_IP_HASH, RANDOM, WEIGHTED.
- geo_
locations str - Comma separated list of geo regions that this data center will serve. Mandatory if site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED. E.g. "ASIA,AFRICA". Allowed regions: EUROPE, AUSTRALIA, US_EAST, US_WEST, AFRICA, ASIA, SOUTH_AMERICA, NORTH_AMERICA.
- ip_
mode str - Load-balancing mode. Possible values:
- SINGLE_IP - Use it only when you need to support multiple ports. Allows a single active server listening on multiple ports, plus the option of a single standby server. Traffic is distributed across the server ports. Note: The server address must be a valid IP address (i.e. not host/domain name). SINGLE_IP is applicable only for datacenters, It may not be used when dataCenterMode = ‘SINGLE_SERVER’.
- MULTIPLE_IP – Allows one or more origin servers having a single webserver and listening port per server. Traffic is distributed across servers.
- is_
active bool - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is_
content bool - When true, this Data Center will only serve requests that were routed using AD Forward rules. If true, it must also be enabled.
- is_
enabled bool - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- is_
rest_ boolof_ the_ world - When true and site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED, this data center will handle traffic from any region that is not assigned to a specific data center. Exactly one data center must have is_rest_of_the_world = true.
- origin_
pop str The ID of the PoP that serves as an access point between Imperva and the customer’s origin server. E.g. "lax", for Los Angeles. When not specified, all Imperva PoPs can send traffic to this data center. The list of available PoPs is documented at: https://docs.imperva.com/bundle/cloud-application-security/page/more/pops.htm.
For each
data_center
sub resource, at least oneorigin_server
sub resource must be defined. The following Origin Server arguments are supported:- web_
servers_ floatper_ server - When IP mode = SINGLE_IP, number of web servers (processes) per server. Each web server listens to different port. E.g. when web_servers_per_server = 5, HTTP traffic will use ports 80-84 while HTTPS traffic will use ports 443-447. Default: 1.
- weight float
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- name String
- Data Center Name. Must be unique within a Site.
- origin
Servers List<Property Map> - A set of Origin Servers
- dc
Id Number - Internal Data Center id.
- dc
Lb StringAlgorithm - How to load balance between the servers of this data center. One of: LB_LEAST_PENDING_REQUESTS (the default), LB_LEAST_OPEN_CONNECTIONS, LB_SOURCE_IP_HASH, RANDOM, WEIGHTED.
- geo
Locations String - Comma separated list of geo regions that this data center will serve. Mandatory if site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED. E.g. "ASIA,AFRICA". Allowed regions: EUROPE, AUSTRALIA, US_EAST, US_WEST, AFRICA, ASIA, SOUTH_AMERICA, NORTH_AMERICA.
- ip
Mode String - Load-balancing mode. Possible values:
- SINGLE_IP - Use it only when you need to support multiple ports. Allows a single active server listening on multiple ports, plus the option of a single standby server. Traffic is distributed across the server ports. Note: The server address must be a valid IP address (i.e. not host/domain name). SINGLE_IP is applicable only for datacenters, It may not be used when dataCenterMode = ‘SINGLE_SERVER’.
- MULTIPLE_IP – Allows one or more origin servers having a single webserver and listening port per server. Traffic is distributed across servers.
- is
Active Boolean - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is
Content Boolean - When true, this Data Center will only serve requests that were routed using AD Forward rules. If true, it must also be enabled.
- is
Enabled Boolean - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- is
Rest BooleanOf The World - When true and site_lb_algorithm = GEO_PREFERRED or GEO_REQUIRED, this data center will handle traffic from any region that is not assigned to a specific data center. Exactly one data center must have is_rest_of_the_world = true.
- origin
Pop String The ID of the PoP that serves as an access point between Imperva and the customer’s origin server. E.g. "lax", for Los Angeles. When not specified, all Imperva PoPs can send traffic to this data center. The list of available PoPs is documented at: https://docs.imperva.com/bundle/cloud-application-security/page/more/pops.htm.
For each
data_center
sub resource, at least oneorigin_server
sub resource must be defined. The following Origin Server arguments are supported:- web
Servers NumberPer Server - When IP mode = SINGLE_IP, number of web servers (processes) per server. Each web server listens to different port. E.g. when web_servers_per_server = 5, HTTP traffic will use ports 80-84 while HTTPS traffic will use ports 443-447. Default: 1.
- weight Number
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
DataCentersConfigurationDataCenterOriginServer, DataCentersConfigurationDataCenterOriginServerArgs
- Address string
- Server Address. If Data Center's ip_mode = 'SINGLE_IP', then a valid IP address must be specified. Otherwise, Host / DNS name can be specified as well.
- Is
Active bool - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- Is
Enabled bool - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- Weight double
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- Address string
- Server Address. If Data Center's ip_mode = 'SINGLE_IP', then a valid IP address must be specified. Otherwise, Host / DNS name can be specified as well.
- Is
Active bool - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- Is
Enabled bool - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- Weight float64
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- address String
- Server Address. If Data Center's ip_mode = 'SINGLE_IP', then a valid IP address must be specified. Otherwise, Host / DNS name can be specified as well.
- is
Active Boolean - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is
Enabled Boolean - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- weight Double
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- address string
- Server Address. If Data Center's ip_mode = 'SINGLE_IP', then a valid IP address must be specified. Otherwise, Host / DNS name can be specified as well.
- is
Active boolean - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is
Enabled boolean - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- weight number
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- address str
- Server Address. If Data Center's ip_mode = 'SINGLE_IP', then a valid IP address must be specified. Otherwise, Host / DNS name can be specified as well.
- is_
active bool - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is_
enabled bool - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- weight float
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
- address String
- Server Address. If Data Center's ip_mode = 'SINGLE_IP', then a valid IP address must be specified. Otherwise, Host / DNS name can be specified as well.
- is
Active Boolean - When true (the default), this Origin Server is active. When false, this Origin Server will Standby until failover is performed.
- is
Enabled Boolean - When true (the default), this Origin Server is enabled. I.e. can serve requests.
- weight Number
- When dc_lb_algorithm = WEIGHTED, the weight in percentage of this Origin Server. Then, total weight of all Data Center's Origin Servers must be 100.
Import
Data Centers Configuration can be imported using the id
, e.g.:
$ pulumi import incapsula:index/dataCentersConfiguration:DataCentersConfiguration demo 1234
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- incapsula imperva/terraform-provider-incapsula
- License
- Notes
- This Pulumi package is based on the
incapsula
Terraform Provider.