1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. networkmanager
  5. GlobalNetwork

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.9.0 published on Monday, Nov 18, 2024 by Pulumi

aws-native.networkmanager.GlobalNetwork

Explore with Pulumi AI

aws-native logo

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.9.0 published on Monday, Nov 18, 2024 by Pulumi

    The AWS::NetworkManager::GlobalNetwork type specifies a global network of the user’s account

    Example Usage

    Example

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AwsNative = Pulumi.AwsNative;
    
    return await Deployment.RunAsync(() => 
    {
        var globalNetwork = new AwsNative.NetworkManager.GlobalNetwork("globalNetwork");
    
        var site = new AwsNative.NetworkManager.Site("site", new()
        {
            GlobalNetworkId = globalNetwork.Id,
            Location = new AwsNative.NetworkManager.Inputs.SiteLocationArgs
            {
                Address = "227 W Monroe St, Chicago, IL 60606",
                Latitude = "41.8",
                Longitude = "-87.6",
            },
        });
    
        var link = new AwsNative.NetworkManager.Link("link", new()
        {
            Description = "Broadband link",
            GlobalNetworkId = globalNetwork.Id,
            SiteId = site.SiteId,
            Bandwidth = new AwsNative.NetworkManager.Inputs.LinkBandwidthArgs
            {
                DownloadSpeed = 20,
                UploadSpeed = 20,
            },
            Provider = "AnyCompany",
            Type = "Broadband",
            Tags = new[]
            {
                new AwsNative.Inputs.TagArgs
                {
                    Key = "Name",
                    Value = "broadband-link-1",
                },
            },
        });
    
        var device = new AwsNative.NetworkManager.Device("device", new()
        {
            Description = "Chicago office device",
            GlobalNetworkId = globalNetwork.Id,
            SiteId = site.SiteId,
            Tags = new[]
            {
                new AwsNative.Inputs.TagArgs
                {
                    Key = "Network",
                    Value = "north-america",
                },
            },
        });
    
        var linkAssociation = new AwsNative.NetworkManager.LinkAssociation("linkAssociation", new()
        {
            GlobalNetworkId = globalNetwork.Id,
            LinkId = link.LinkId,
            DeviceId = device.DeviceId,
        });
    
    });
    
    package main
    
    import (
    	awsnative "github.com/pulumi/pulumi-aws-native/sdk/go/aws"
    	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/networkmanager"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		globalNetwork, err := networkmanager.NewGlobalNetwork(ctx, "globalNetwork", nil)
    		if err != nil {
    			return err
    		}
    		site, err := networkmanager.NewSite(ctx, "site", &networkmanager.SiteArgs{
    			GlobalNetworkId: globalNetwork.ID(),
    			Location: &networkmanager.SiteLocationArgs{
    				Address:   pulumi.String("227 W Monroe St, Chicago, IL 60606"),
    				Latitude:  pulumi.String("41.8"),
    				Longitude: pulumi.String("-87.6"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		link, err := networkmanager.NewLink(ctx, "link", &networkmanager.LinkArgs{
    			Description:     pulumi.String("Broadband link"),
    			GlobalNetworkId: globalNetwork.ID(),
    			SiteId:          site.SiteId,
    			Bandwidth: &networkmanager.LinkBandwidthArgs{
    				DownloadSpeed: pulumi.Int(20),
    				UploadSpeed:   pulumi.Int(20),
    			},
    			Provider: pulumi.String("AnyCompany"),
    			Type:     pulumi.String("Broadband"),
    			Tags: aws.TagArray{
    				&aws.TagArgs{
    					Key:   pulumi.String("Name"),
    					Value: pulumi.String("broadband-link-1"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		device, err := networkmanager.NewDevice(ctx, "device", &networkmanager.DeviceArgs{
    			Description:     pulumi.String("Chicago office device"),
    			GlobalNetworkId: globalNetwork.ID(),
    			SiteId:          site.SiteId,
    			Tags: aws.TagArray{
    				&aws.TagArgs{
    					Key:   pulumi.String("Network"),
    					Value: pulumi.String("north-america"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		_, err = networkmanager.NewLinkAssociation(ctx, "linkAssociation", &networkmanager.LinkAssociationArgs{
    			GlobalNetworkId: globalNetwork.ID(),
    			LinkId:          link.LinkId,
    			DeviceId:        device.DeviceId,
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    

    Coming soon!

    import pulumi
    import pulumi_aws_native as aws_native
    
    global_network = aws_native.networkmanager.GlobalNetwork("globalNetwork")
    site = aws_native.networkmanager.Site("site",
        global_network_id=global_network.id,
        location={
            "address": "227 W Monroe St, Chicago, IL 60606",
            "latitude": "41.8",
            "longitude": "-87.6",
        })
    link = aws_native.networkmanager.Link("link",
        description="Broadband link",
        global_network_id=global_network.id,
        site_id=site.site_id,
        bandwidth={
            "download_speed": 20,
            "upload_speed": 20,
        },
        provider="AnyCompany",
        type="Broadband",
        tags=[{
            "key": "Name",
            "value": "broadband-link-1",
        }])
    device = aws_native.networkmanager.Device("device",
        description="Chicago office device",
        global_network_id=global_network.id,
        site_id=site.site_id,
        tags=[{
            "key": "Network",
            "value": "north-america",
        }])
    link_association = aws_native.networkmanager.LinkAssociation("linkAssociation",
        global_network_id=global_network.id,
        link_id=link.link_id,
        device_id=device.device_id)
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws_native from "@pulumi/aws-native";
    
    const globalNetwork = new aws_native.networkmanager.GlobalNetwork("globalNetwork", {});
    const site = new aws_native.networkmanager.Site("site", {
        globalNetworkId: globalNetwork.id,
        location: {
            address: "227 W Monroe St, Chicago, IL 60606",
            latitude: "41.8",
            longitude: "-87.6",
        },
    });
    const link = new aws_native.networkmanager.Link("link", {
        description: "Broadband link",
        globalNetworkId: globalNetwork.id,
        siteId: site.siteId,
        bandwidth: {
            downloadSpeed: 20,
            uploadSpeed: 20,
        },
        provider: "AnyCompany",
        type: "Broadband",
        tags: [{
            key: "Name",
            value: "broadband-link-1",
        }],
    });
    const device = new aws_native.networkmanager.Device("device", {
        description: "Chicago office device",
        globalNetworkId: globalNetwork.id,
        siteId: site.siteId,
        tags: [{
            key: "Network",
            value: "north-america",
        }],
    });
    const linkAssociation = new aws_native.networkmanager.LinkAssociation("linkAssociation", {
        globalNetworkId: globalNetwork.id,
        linkId: link.linkId,
        deviceId: device.deviceId,
    });
    

    Coming soon!

    Example

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AwsNative = Pulumi.AwsNative;
    
    return await Deployment.RunAsync(() => 
    {
        var globalNetwork = new AwsNative.NetworkManager.GlobalNetwork("globalNetwork");
    
        var site = new AwsNative.NetworkManager.Site("site", new()
        {
            GlobalNetworkId = globalNetwork.Id,
            Location = new AwsNative.NetworkManager.Inputs.SiteLocationArgs
            {
                Address = "227 W Monroe St, Chicago, IL 60606",
                Latitude = "41.8",
                Longitude = "-87.6",
            },
        });
    
        var link = new AwsNative.NetworkManager.Link("link", new()
        {
            Description = "Broadband link",
            GlobalNetworkId = globalNetwork.Id,
            SiteId = site.SiteId,
            Bandwidth = new AwsNative.NetworkManager.Inputs.LinkBandwidthArgs
            {
                DownloadSpeed = 20,
                UploadSpeed = 20,
            },
            Provider = "AnyCompany",
            Type = "Broadband",
            Tags = new[]
            {
                new AwsNative.Inputs.TagArgs
                {
                    Key = "Name",
                    Value = "broadband-link-1",
                },
            },
        });
    
        var device = new AwsNative.NetworkManager.Device("device", new()
        {
            Description = "Chicago office device",
            GlobalNetworkId = globalNetwork.Id,
            SiteId = site.SiteId,
            Tags = new[]
            {
                new AwsNative.Inputs.TagArgs
                {
                    Key = "Network",
                    Value = "north-america",
                },
            },
        });
    
        var linkAssociation = new AwsNative.NetworkManager.LinkAssociation("linkAssociation", new()
        {
            GlobalNetworkId = globalNetwork.Id,
            LinkId = link.LinkId,
            DeviceId = device.DeviceId,
        });
    
    });
    
    package main
    
    import (
    	awsnative "github.com/pulumi/pulumi-aws-native/sdk/go/aws"
    	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/networkmanager"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		globalNetwork, err := networkmanager.NewGlobalNetwork(ctx, "globalNetwork", nil)
    		if err != nil {
    			return err
    		}
    		site, err := networkmanager.NewSite(ctx, "site", &networkmanager.SiteArgs{
    			GlobalNetworkId: globalNetwork.ID(),
    			Location: &networkmanager.SiteLocationArgs{
    				Address:   pulumi.String("227 W Monroe St, Chicago, IL 60606"),
    				Latitude:  pulumi.String("41.8"),
    				Longitude: pulumi.String("-87.6"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		link, err := networkmanager.NewLink(ctx, "link", &networkmanager.LinkArgs{
    			Description:     pulumi.String("Broadband link"),
    			GlobalNetworkId: globalNetwork.ID(),
    			SiteId:          site.SiteId,
    			Bandwidth: &networkmanager.LinkBandwidthArgs{
    				DownloadSpeed: pulumi.Int(20),
    				UploadSpeed:   pulumi.Int(20),
    			},
    			Provider: pulumi.String("AnyCompany"),
    			Type:     pulumi.String("Broadband"),
    			Tags: aws.TagArray{
    				&aws.TagArgs{
    					Key:   pulumi.String("Name"),
    					Value: pulumi.String("broadband-link-1"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		device, err := networkmanager.NewDevice(ctx, "device", &networkmanager.DeviceArgs{
    			Description:     pulumi.String("Chicago office device"),
    			GlobalNetworkId: globalNetwork.ID(),
    			SiteId:          site.SiteId,
    			Tags: aws.TagArray{
    				&aws.TagArgs{
    					Key:   pulumi.String("Network"),
    					Value: pulumi.String("north-america"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		_, err = networkmanager.NewLinkAssociation(ctx, "linkAssociation", &networkmanager.LinkAssociationArgs{
    			GlobalNetworkId: globalNetwork.ID(),
    			LinkId:          link.LinkId,
    			DeviceId:        device.DeviceId,
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    

    Coming soon!

    import pulumi
    import pulumi_aws_native as aws_native
    
    global_network = aws_native.networkmanager.GlobalNetwork("globalNetwork")
    site = aws_native.networkmanager.Site("site",
        global_network_id=global_network.id,
        location={
            "address": "227 W Monroe St, Chicago, IL 60606",
            "latitude": "41.8",
            "longitude": "-87.6",
        })
    link = aws_native.networkmanager.Link("link",
        description="Broadband link",
        global_network_id=global_network.id,
        site_id=site.site_id,
        bandwidth={
            "download_speed": 20,
            "upload_speed": 20,
        },
        provider="AnyCompany",
        type="Broadband",
        tags=[{
            "key": "Name",
            "value": "broadband-link-1",
        }])
    device = aws_native.networkmanager.Device("device",
        description="Chicago office device",
        global_network_id=global_network.id,
        site_id=site.site_id,
        tags=[{
            "key": "Network",
            "value": "north-america",
        }])
    link_association = aws_native.networkmanager.LinkAssociation("linkAssociation",
        global_network_id=global_network.id,
        link_id=link.link_id,
        device_id=device.device_id)
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws_native from "@pulumi/aws-native";
    
    const globalNetwork = new aws_native.networkmanager.GlobalNetwork("globalNetwork", {});
    const site = new aws_native.networkmanager.Site("site", {
        globalNetworkId: globalNetwork.id,
        location: {
            address: "227 W Monroe St, Chicago, IL 60606",
            latitude: "41.8",
            longitude: "-87.6",
        },
    });
    const link = new aws_native.networkmanager.Link("link", {
        description: "Broadband link",
        globalNetworkId: globalNetwork.id,
        siteId: site.siteId,
        bandwidth: {
            downloadSpeed: 20,
            uploadSpeed: 20,
        },
        provider: "AnyCompany",
        type: "Broadband",
        tags: [{
            key: "Name",
            value: "broadband-link-1",
        }],
    });
    const device = new aws_native.networkmanager.Device("device", {
        description: "Chicago office device",
        globalNetworkId: globalNetwork.id,
        siteId: site.siteId,
        tags: [{
            key: "Network",
            value: "north-america",
        }],
    });
    const linkAssociation = new aws_native.networkmanager.LinkAssociation("linkAssociation", {
        globalNetworkId: globalNetwork.id,
        linkId: link.linkId,
        deviceId: device.deviceId,
    });
    

    Coming soon!

    Create GlobalNetwork Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new GlobalNetwork(name: string, args?: GlobalNetworkArgs, opts?: CustomResourceOptions);
    @overload
    def GlobalNetwork(resource_name: str,
                      args: Optional[GlobalNetworkArgs] = None,
                      opts: Optional[ResourceOptions] = None)
    
    @overload
    def GlobalNetwork(resource_name: str,
                      opts: Optional[ResourceOptions] = None,
                      created_at: Optional[str] = None,
                      description: Optional[str] = None,
                      state: Optional[str] = None,
                      tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewGlobalNetwork(ctx *Context, name string, args *GlobalNetworkArgs, opts ...ResourceOption) (*GlobalNetwork, error)
    public GlobalNetwork(string name, GlobalNetworkArgs? args = null, CustomResourceOptions? opts = null)
    public GlobalNetwork(String name, GlobalNetworkArgs args)
    public GlobalNetwork(String name, GlobalNetworkArgs args, CustomResourceOptions options)
    
    type: aws-native:networkmanager:GlobalNetwork
    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 GlobalNetworkArgs
    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 GlobalNetworkArgs
    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 GlobalNetworkArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args GlobalNetworkArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args GlobalNetworkArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    GlobalNetwork 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 GlobalNetwork resource accepts the following input properties:

    CreatedAt string
    The date and time that the global network was created.
    Description string
    The description of the global network.
    State string
    The state of the global network.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags for the global network.
    CreatedAt string
    The date and time that the global network was created.
    Description string
    The description of the global network.
    State string
    The state of the global network.
    Tags TagArgs
    The tags for the global network.
    createdAt String
    The date and time that the global network was created.
    description String
    The description of the global network.
    state String
    The state of the global network.
    tags List<Tag>
    The tags for the global network.
    createdAt string
    The date and time that the global network was created.
    description string
    The description of the global network.
    state string
    The state of the global network.
    tags Tag[]
    The tags for the global network.
    created_at str
    The date and time that the global network was created.
    description str
    The description of the global network.
    state str
    The state of the global network.
    tags Sequence[TagArgs]
    The tags for the global network.
    createdAt String
    The date and time that the global network was created.
    description String
    The description of the global network.
    state String
    The state of the global network.
    tags List<Property Map>
    The tags for the global network.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the GlobalNetwork resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the global network.
    AwsId string
    The ID of the global network.
    Id string
    The provider-assigned unique ID for this managed resource.
    Arn string
    The Amazon Resource Name (ARN) of the global network.
    AwsId string
    The ID of the global network.
    Id string
    The provider-assigned unique ID for this managed resource.
    arn String
    The Amazon Resource Name (ARN) of the global network.
    awsId String
    The ID of the global network.
    id String
    The provider-assigned unique ID for this managed resource.
    arn string
    The Amazon Resource Name (ARN) of the global network.
    awsId string
    The ID of the global network.
    id string
    The provider-assigned unique ID for this managed resource.
    arn str
    The Amazon Resource Name (ARN) of the global network.
    aws_id str
    The ID of the global network.
    id str
    The provider-assigned unique ID for this managed resource.
    arn String
    The Amazon Resource Name (ARN) of the global network.
    awsId String
    The ID of the global network.
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    Tag, TagArgs

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    AWS Cloud Control v1.9.0 published on Monday, Nov 18, 2024 by Pulumi