alicloud.cen.BandwidthLimit
Provides a CEN cross-regional interconnection bandwidth resource. To connect networks in different regions, you must set cross-region interconnection bandwidth after buying a bandwidth package. The total bandwidth set for all the interconnected regions of a bandwidth package cannot exceed the bandwidth of the bandwidth package. By default, 1 Kbps bandwidth is provided for connectivity test. To run normal business, you must buy a bandwidth package and set a proper interconnection bandwidth.
For example, a CEN instance is bound to a bandwidth package of 20 Mbps and the interconnection areas are Mainland China and North America. You can set the cross-region interconnection bandwidth between US West 1 and China East 1, China East 2, China South 1, and so on. However, the total bandwidth set for all the interconnected regions cannot exceed 20 Mbps.
For information about CEN and how to use it, see Cross-region interconnection bandwidth
Example Usage
Basic Usage
using System.Collections.Generic;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var config = new Config();
var name = config.Get("name") ?? "tf-testAccCenBandwidthLimitConfig";
var fra = new AliCloud.Provider("fra", new()
{
Region = "eu-central-1",
});
var sh = new AliCloud.Provider("sh", new()
{
Region = "cn-shanghai",
});
var vpc1 = new AliCloud.Vpc.Network("vpc1", new()
{
VpcName = name,
CidrBlock = "192.168.0.0/16",
}, new CustomResourceOptions
{
Provider = alicloud.Fra,
});
var vpc2 = new AliCloud.Vpc.Network("vpc2", new()
{
CidrBlock = "172.16.0.0/12",
}, new CustomResourceOptions
{
Provider = alicloud.Sh,
});
var cen = new AliCloud.Cen.Instance("cen", new()
{
Description = "tf-testAccCenBandwidthLimitConfigDescription",
});
var bwp = new AliCloud.Cen.BandwidthPackage("bwp", new()
{
Bandwidth = 5,
GeographicRegionIds = new[]
{
"Europe",
"China",
},
});
var bwpAttach = new AliCloud.Cen.BandwidthPackageAttachment("bwpAttach", new()
{
InstanceId = cen.Id,
BandwidthPackageId = bwp.Id,
});
var vpcAttach1 = new AliCloud.Cen.InstanceAttachment("vpcAttach1", new()
{
InstanceId = cen.Id,
ChildInstanceId = vpc1.Id,
ChildInstanceType = "VPC",
ChildInstanceRegionId = "eu-central-1",
});
var vpcAttach2 = new AliCloud.Cen.InstanceAttachment("vpcAttach2", new()
{
InstanceId = cen.Id,
ChildInstanceId = vpc2.Id,
ChildInstanceType = "VPC",
ChildInstanceRegionId = "cn-shanghai",
});
var foo = new AliCloud.Cen.BandwidthLimit("foo", new()
{
InstanceId = cen.Id,
RegionIds = new[]
{
"eu-central-1",
"cn-shanghai",
},
Limit = 4,
}, new CustomResourceOptions
{
DependsOn = new[]
{
bwpAttach,
vpcAttach1,
vpcAttach2,
},
});
});
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/cen"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
name := "tf-testAccCenBandwidthLimitConfig"
if param := cfg.Get("name"); param != "" {
name = param
}
_, err := alicloud.NewProvider(ctx, "fra", &alicloud.ProviderArgs{
Region: pulumi.String("eu-central-1"),
})
if err != nil {
return err
}
_, err = alicloud.NewProvider(ctx, "sh", &alicloud.ProviderArgs{
Region: pulumi.String("cn-shanghai"),
})
if err != nil {
return err
}
vpc1, err := vpc.NewNetwork(ctx, "vpc1", &vpc.NetworkArgs{
VpcName: pulumi.String(name),
CidrBlock: pulumi.String("192.168.0.0/16"),
}, pulumi.Provider(alicloud.Fra))
if err != nil {
return err
}
vpc2, err := vpc.NewNetwork(ctx, "vpc2", &vpc.NetworkArgs{
CidrBlock: pulumi.String("172.16.0.0/12"),
}, pulumi.Provider(alicloud.Sh))
if err != nil {
return err
}
cen, err := cen.NewInstance(ctx, "cen", &cen.InstanceArgs{
Description: pulumi.String("tf-testAccCenBandwidthLimitConfigDescription"),
})
if err != nil {
return err
}
bwp, err := cen.NewBandwidthPackage(ctx, "bwp", &cen.BandwidthPackageArgs{
Bandwidth: pulumi.Int(5),
GeographicRegionIds: pulumi.StringArray{
pulumi.String("Europe"),
pulumi.String("China"),
},
})
if err != nil {
return err
}
bwpAttach, err := cen.NewBandwidthPackageAttachment(ctx, "bwpAttach", &cen.BandwidthPackageAttachmentArgs{
InstanceId: cen.ID(),
BandwidthPackageId: bwp.ID(),
})
if err != nil {
return err
}
vpcAttach1, err := cen.NewInstanceAttachment(ctx, "vpcAttach1", &cen.InstanceAttachmentArgs{
InstanceId: cen.ID(),
ChildInstanceId: vpc1.ID(),
ChildInstanceType: pulumi.String("VPC"),
ChildInstanceRegionId: pulumi.String("eu-central-1"),
})
if err != nil {
return err
}
vpcAttach2, err := cen.NewInstanceAttachment(ctx, "vpcAttach2", &cen.InstanceAttachmentArgs{
InstanceId: cen.ID(),
ChildInstanceId: vpc2.ID(),
ChildInstanceType: pulumi.String("VPC"),
ChildInstanceRegionId: pulumi.String("cn-shanghai"),
})
if err != nil {
return err
}
_, err = cen.NewBandwidthLimit(ctx, "foo", &cen.BandwidthLimitArgs{
InstanceId: cen.ID(),
RegionIds: pulumi.StringArray{
pulumi.String("eu-central-1"),
pulumi.String("cn-shanghai"),
},
BandwidthLimit: pulumi.Int(4),
}, pulumi.DependsOn([]pulumi.Resource{
bwpAttach,
vpcAttach1,
vpcAttach2,
}))
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.Provider;
import com.pulumi.alicloud.ProviderArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.cen.Instance;
import com.pulumi.alicloud.cen.InstanceArgs;
import com.pulumi.alicloud.cen.BandwidthPackage;
import com.pulumi.alicloud.cen.BandwidthPackageArgs;
import com.pulumi.alicloud.cen.BandwidthPackageAttachment;
import com.pulumi.alicloud.cen.BandwidthPackageAttachmentArgs;
import com.pulumi.alicloud.cen.InstanceAttachment;
import com.pulumi.alicloud.cen.InstanceAttachmentArgs;
import com.pulumi.alicloud.cen.BandwidthLimit;
import com.pulumi.alicloud.cen.BandwidthLimitArgs;
import com.pulumi.resources.CustomResourceOptions;
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 config = ctx.config();
final var name = config.get("name").orElse("tf-testAccCenBandwidthLimitConfig");
var fra = new Provider("fra", ProviderArgs.builder()
.region("eu-central-1")
.build());
var sh = new Provider("sh", ProviderArgs.builder()
.region("cn-shanghai")
.build());
var vpc1 = new Network("vpc1", NetworkArgs.builder()
.vpcName(name)
.cidrBlock("192.168.0.0/16")
.build(), CustomResourceOptions.builder()
.provider(alicloud.fra())
.build());
var vpc2 = new Network("vpc2", NetworkArgs.builder()
.cidrBlock("172.16.0.0/12")
.build(), CustomResourceOptions.builder()
.provider(alicloud.sh())
.build());
var cen = new Instance("cen", InstanceArgs.builder()
.description("tf-testAccCenBandwidthLimitConfigDescription")
.build());
var bwp = new BandwidthPackage("bwp", BandwidthPackageArgs.builder()
.bandwidth(5)
.geographicRegionIds(
"Europe",
"China")
.build());
var bwpAttach = new BandwidthPackageAttachment("bwpAttach", BandwidthPackageAttachmentArgs.builder()
.instanceId(cen.id())
.bandwidthPackageId(bwp.id())
.build());
var vpcAttach1 = new InstanceAttachment("vpcAttach1", InstanceAttachmentArgs.builder()
.instanceId(cen.id())
.childInstanceId(vpc1.id())
.childInstanceType("VPC")
.childInstanceRegionId("eu-central-1")
.build());
var vpcAttach2 = new InstanceAttachment("vpcAttach2", InstanceAttachmentArgs.builder()
.instanceId(cen.id())
.childInstanceId(vpc2.id())
.childInstanceType("VPC")
.childInstanceRegionId("cn-shanghai")
.build());
var foo = new BandwidthLimit("foo", BandwidthLimitArgs.builder()
.instanceId(cen.id())
.regionIds(
"eu-central-1",
"cn-shanghai")
.bandwidthLimit(4)
.build(), CustomResourceOptions.builder()
.dependsOn(
bwpAttach,
vpcAttach1,
vpcAttach2)
.build());
}
}
import pulumi
import pulumi_alicloud as alicloud
config = pulumi.Config()
name = config.get("name")
if name is None:
name = "tf-testAccCenBandwidthLimitConfig"
fra = alicloud.Provider("fra", region="eu-central-1")
sh = alicloud.Provider("sh", region="cn-shanghai")
vpc1 = alicloud.vpc.Network("vpc1",
vpc_name=name,
cidr_block="192.168.0.0/16",
opts=pulumi.ResourceOptions(provider=alicloud["fra"]))
vpc2 = alicloud.vpc.Network("vpc2", cidr_block="172.16.0.0/12",
opts=pulumi.ResourceOptions(provider=alicloud["sh"]))
cen = alicloud.cen.Instance("cen", description="tf-testAccCenBandwidthLimitConfigDescription")
bwp = alicloud.cen.BandwidthPackage("bwp",
bandwidth=5,
geographic_region_ids=[
"Europe",
"China",
])
bwp_attach = alicloud.cen.BandwidthPackageAttachment("bwpAttach",
instance_id=cen.id,
bandwidth_package_id=bwp.id)
vpc_attach1 = alicloud.cen.InstanceAttachment("vpcAttach1",
instance_id=cen.id,
child_instance_id=vpc1.id,
child_instance_type="VPC",
child_instance_region_id="eu-central-1")
vpc_attach2 = alicloud.cen.InstanceAttachment("vpcAttach2",
instance_id=cen.id,
child_instance_id=vpc2.id,
child_instance_type="VPC",
child_instance_region_id="cn-shanghai")
foo = alicloud.cen.BandwidthLimit("foo",
instance_id=cen.id,
region_ids=[
"eu-central-1",
"cn-shanghai",
],
bandwidth_limit=4,
opts=pulumi.ResourceOptions(depends_on=[
bwp_attach,
vpc_attach1,
vpc_attach2,
]))
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const config = new pulumi.Config();
const name = config.get("name") || "tf-testAccCenBandwidthLimitConfig";
const fra = new alicloud.Provider("fra", {region: "eu-central-1"});
const sh = new alicloud.Provider("sh", {region: "cn-shanghai"});
const vpc1 = new alicloud.vpc.Network("vpc1", {
vpcName: name,
cidrBlock: "192.168.0.0/16",
}, {
provider: alicloud.fra,
});
const vpc2 = new alicloud.vpc.Network("vpc2", {cidrBlock: "172.16.0.0/12"}, {
provider: alicloud.sh,
});
const cen = new alicloud.cen.Instance("cen", {description: "tf-testAccCenBandwidthLimitConfigDescription"});
const bwp = new alicloud.cen.BandwidthPackage("bwp", {
bandwidth: 5,
geographicRegionIds: [
"Europe",
"China",
],
});
const bwpAttach = new alicloud.cen.BandwidthPackageAttachment("bwpAttach", {
instanceId: cen.id,
bandwidthPackageId: bwp.id,
});
const vpcAttach1 = new alicloud.cen.InstanceAttachment("vpcAttach1", {
instanceId: cen.id,
childInstanceId: vpc1.id,
childInstanceType: "VPC",
childInstanceRegionId: "eu-central-1",
});
const vpcAttach2 = new alicloud.cen.InstanceAttachment("vpcAttach2", {
instanceId: cen.id,
childInstanceId: vpc2.id,
childInstanceType: "VPC",
childInstanceRegionId: "cn-shanghai",
});
const foo = new alicloud.cen.BandwidthLimit("foo", {
instanceId: cen.id,
regionIds: [
"eu-central-1",
"cn-shanghai",
],
bandwidthLimit: 4,
}, {
dependsOn: [
bwpAttach,
vpcAttach1,
vpcAttach2,
],
});
configuration:
name:
type: string
default: tf-testAccCenBandwidthLimitConfig
resources:
fra:
type: pulumi:providers:alicloud
properties:
region: eu-central-1
sh:
type: pulumi:providers:alicloud
properties:
region: cn-shanghai
vpc1:
type: alicloud:vpc:Network
properties:
vpcName: ${name}
cidrBlock: 192.168.0.0/16
options:
provider: ${alicloud.fra}
vpc2:
type: alicloud:vpc:Network
properties:
cidrBlock: 172.16.0.0/12
options:
provider: ${alicloud.sh}
cen:
type: alicloud:cen:Instance
properties:
description: tf-testAccCenBandwidthLimitConfigDescription
bwp:
type: alicloud:cen:BandwidthPackage
properties:
bandwidth: 5
geographicRegionIds:
- Europe
- China
bwpAttach:
type: alicloud:cen:BandwidthPackageAttachment
properties:
instanceId: ${cen.id}
bandwidthPackageId: ${bwp.id}
vpcAttach1:
type: alicloud:cen:InstanceAttachment
properties:
instanceId: ${cen.id}
childInstanceId: ${vpc1.id}
childInstanceType: VPC
childInstanceRegionId: eu-central-1
vpcAttach2:
type: alicloud:cen:InstanceAttachment
properties:
instanceId: ${cen.id}
childInstanceId: ${vpc2.id}
childInstanceType: VPC
childInstanceRegionId: cn-shanghai
foo:
type: alicloud:cen:BandwidthLimit
properties:
instanceId: ${cen.id}
regionIds:
- eu-central-1
- cn-shanghai
bandwidthLimit: 4
options:
dependson:
- ${bwpAttach}
- ${vpcAttach1}
- ${vpcAttach2}
Create BandwidthLimit Resource
new BandwidthLimit(name: string, args: BandwidthLimitArgs, opts?: CustomResourceOptions);
@overload
def BandwidthLimit(resource_name: str,
opts: Optional[ResourceOptions] = None,
bandwidth_limit: Optional[int] = None,
instance_id: Optional[str] = None,
region_ids: Optional[Sequence[str]] = None)
@overload
def BandwidthLimit(resource_name: str,
args: BandwidthLimitArgs,
opts: Optional[ResourceOptions] = None)
func NewBandwidthLimit(ctx *Context, name string, args BandwidthLimitArgs, opts ...ResourceOption) (*BandwidthLimit, error)
public BandwidthLimit(string name, BandwidthLimitArgs args, CustomResourceOptions? opts = null)
public BandwidthLimit(String name, BandwidthLimitArgs args)
public BandwidthLimit(String name, BandwidthLimitArgs args, CustomResourceOptions options)
type: alicloud:cen:BandwidthLimit
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BandwidthLimitArgs
- 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 BandwidthLimitArgs
- 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 BandwidthLimitArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BandwidthLimitArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args BandwidthLimitArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
BandwidthLimit Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The BandwidthLimit resource accepts the following input properties:
- Instance
Id string The ID of the CEN.
- Limit int
The bandwidth configured for the interconnected regions communication.
- Region
Ids List<string> List of the two regions to interconnect. Must be two different regions.
- Bandwidth
Limit int The bandwidth configured for the interconnected regions communication.
- Instance
Id string The ID of the CEN.
- Region
Ids []string List of the two regions to interconnect. Must be two different regions.
- bandwidth
Limit Integer The bandwidth configured for the interconnected regions communication.
- instance
Id String The ID of the CEN.
- region
Ids List<String> List of the two regions to interconnect. Must be two different regions.
- bandwidth
Limit number The bandwidth configured for the interconnected regions communication.
- instance
Id string The ID of the CEN.
- region
Ids string[] List of the two regions to interconnect. Must be two different regions.
- bandwidth_
limit int The bandwidth configured for the interconnected regions communication.
- instance_
id str The ID of the CEN.
- region_
ids Sequence[str] List of the two regions to interconnect. Must be two different regions.
- bandwidth
Limit Number The bandwidth configured for the interconnected regions communication.
- instance
Id String The ID of the CEN.
- region
Ids List<String> List of the two regions to interconnect. Must be two different regions.
Outputs
All input properties are implicitly available as output properties. Additionally, the BandwidthLimit 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 BandwidthLimit Resource
Get an existing BandwidthLimit 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?: BandwidthLimitState, opts?: CustomResourceOptions): BandwidthLimit
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
bandwidth_limit: Optional[int] = None,
instance_id: Optional[str] = None,
region_ids: Optional[Sequence[str]] = None) -> BandwidthLimit
func GetBandwidthLimit(ctx *Context, name string, id IDInput, state *BandwidthLimitState, opts ...ResourceOption) (*BandwidthLimit, error)
public static BandwidthLimit Get(string name, Input<string> id, BandwidthLimitState? state, CustomResourceOptions? opts = null)
public static BandwidthLimit get(String name, Output<String> id, BandwidthLimitState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- Instance
Id string The ID of the CEN.
- Limit int
The bandwidth configured for the interconnected regions communication.
- Region
Ids List<string> List of the two regions to interconnect. Must be two different regions.
- Bandwidth
Limit int The bandwidth configured for the interconnected regions communication.
- Instance
Id string The ID of the CEN.
- Region
Ids []string List of the two regions to interconnect. Must be two different regions.
- bandwidth
Limit Integer The bandwidth configured for the interconnected regions communication.
- instance
Id String The ID of the CEN.
- region
Ids List<String> List of the two regions to interconnect. Must be two different regions.
- bandwidth
Limit number The bandwidth configured for the interconnected regions communication.
- instance
Id string The ID of the CEN.
- region
Ids string[] List of the two regions to interconnect. Must be two different regions.
- bandwidth_
limit int The bandwidth configured for the interconnected regions communication.
- instance_
id str The ID of the CEN.
- region_
ids Sequence[str] List of the two regions to interconnect. Must be two different regions.
- bandwidth
Limit Number The bandwidth configured for the interconnected regions communication.
- instance
Id String The ID of the CEN.
- region
Ids List<String> List of the two regions to interconnect. Must be two different regions.
Import
CEN bandwidth limit can be imported using the id, e.g.
$ pulumi import alicloud:cen/bandwidthLimit:BandwidthLimit example cen-abc123456:cn-beijing:eu-west-1
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
alicloud
Terraform Provider.