azure logo
Azure Classic v5.43.0, May 6 23

azure.network.NetworkManager

Explore with Pulumi AI

Manages a Network Managers.

Example Usage

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

return await Deployment.RunAsync(() => 
{
    var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new()
    {
        Location = "West Europe",
    });

    var current = Azure.Core.GetSubscription.Invoke();

    var exampleNetworkManager = new Azure.Network.NetworkManager("exampleNetworkManager", new()
    {
        Location = exampleResourceGroup.Location,
        ResourceGroupName = exampleResourceGroup.Name,
        Scope = new Azure.Network.Inputs.NetworkManagerScopeArgs
        {
            SubscriptionIds = new[]
            {
                current.Apply(getSubscriptionResult => getSubscriptionResult.Id),
            },
        },
        ScopeAccesses = new[]
        {
            "Connectivity",
            "SecurityAdmin",
        },
        Description = "example network manager",
        Tags = 
        {
            { "foo", "bar" },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/network"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		current, err := core.LookupSubscription(ctx, nil, nil)
		if err != nil {
			return err
		}
		_, err = network.NewNetworkManager(ctx, "exampleNetworkManager", &network.NetworkManagerArgs{
			Location:          exampleResourceGroup.Location,
			ResourceGroupName: exampleResourceGroup.Name,
			Scope: &network.NetworkManagerScopeArgs{
				SubscriptionIds: pulumi.StringArray{
					*pulumi.String(current.Id),
				},
			},
			ScopeAccesses: pulumi.StringArray{
				pulumi.String("Connectivity"),
				pulumi.String("SecurityAdmin"),
			},
			Description: pulumi.String("example network manager"),
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar"),
			},
		})
		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.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.core.CoreFunctions;
import com.pulumi.azure.core.inputs.GetSubscriptionArgs;
import com.pulumi.azure.network.NetworkManager;
import com.pulumi.azure.network.NetworkManagerArgs;
import com.pulumi.azure.network.inputs.NetworkManagerScopeArgs;
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 exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()        
            .location("West Europe")
            .build());

        final var current = CoreFunctions.getSubscription();

        var exampleNetworkManager = new NetworkManager("exampleNetworkManager", NetworkManagerArgs.builder()        
            .location(exampleResourceGroup.location())
            .resourceGroupName(exampleResourceGroup.name())
            .scope(NetworkManagerScopeArgs.builder()
                .subscriptionIds(current.applyValue(getSubscriptionResult -> getSubscriptionResult.id()))
                .build())
            .scopeAccesses(            
                "Connectivity",
                "SecurityAdmin")
            .description("example network manager")
            .tags(Map.of("foo", "bar"))
            .build());

    }
}
import pulumi
import pulumi_azure as azure

example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
current = azure.core.get_subscription()
example_network_manager = azure.network.NetworkManager("exampleNetworkManager",
    location=example_resource_group.location,
    resource_group_name=example_resource_group.name,
    scope=azure.network.NetworkManagerScopeArgs(
        subscription_ids=[current.id],
    ),
    scope_accesses=[
        "Connectivity",
        "SecurityAdmin",
    ],
    description="example network manager",
    tags={
        "foo": "bar",
    })
import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
const current = azure.core.getSubscription({});
const exampleNetworkManager = new azure.network.NetworkManager("exampleNetworkManager", {
    location: exampleResourceGroup.location,
    resourceGroupName: exampleResourceGroup.name,
    scope: {
        subscriptionIds: [current.then(current => current.id)],
    },
    scopeAccesses: [
        "Connectivity",
        "SecurityAdmin",
    ],
    description: "example network manager",
    tags: {
        foo: "bar",
    },
});
resources:
  exampleResourceGroup:
    type: azure:core:ResourceGroup
    properties:
      location: West Europe
  exampleNetworkManager:
    type: azure:network:NetworkManager
    properties:
      location: ${exampleResourceGroup.location}
      resourceGroupName: ${exampleResourceGroup.name}
      scope:
        subscriptionIds:
          - ${current.id}
      scopeAccesses:
        - Connectivity
        - SecurityAdmin
      description: example network manager
      tags:
        foo: bar
variables:
  current:
    fn::invoke:
      Function: azure:core:getSubscription
      Arguments: {}

Create NetworkManager Resource

new NetworkManager(name: string, args: NetworkManagerArgs, opts?: CustomResourceOptions);
@overload
def NetworkManager(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   description: Optional[str] = None,
                   location: Optional[str] = None,
                   name: Optional[str] = None,
                   resource_group_name: Optional[str] = None,
                   scope: Optional[NetworkManagerScopeArgs] = None,
                   scope_accesses: Optional[Sequence[str]] = None,
                   tags: Optional[Mapping[str, str]] = None)
@overload
def NetworkManager(resource_name: str,
                   args: NetworkManagerArgs,
                   opts: Optional[ResourceOptions] = None)
func NewNetworkManager(ctx *Context, name string, args NetworkManagerArgs, opts ...ResourceOption) (*NetworkManager, error)
public NetworkManager(string name, NetworkManagerArgs args, CustomResourceOptions? opts = null)
public NetworkManager(String name, NetworkManagerArgs args)
public NetworkManager(String name, NetworkManagerArgs args, CustomResourceOptions options)
type: azure:network:NetworkManager
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args NetworkManagerArgs
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 NetworkManagerArgs
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 NetworkManagerArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args NetworkManagerArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args NetworkManagerArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

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

ResourceGroupName string

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

Scope NetworkManagerScopeArgs

A scope block as defined below.

ScopeAccesses List<string>

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

Description string

A description of the network manager.

Location string

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

Name string

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

Tags Dictionary<string, string>

A mapping of tags which should be assigned to the Network Managers.

ResourceGroupName string

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

Scope NetworkManagerScopeArgs

A scope block as defined below.

ScopeAccesses []string

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

Description string

A description of the network manager.

Location string

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

Name string

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

Tags map[string]string

A mapping of tags which should be assigned to the Network Managers.

resourceGroupName String

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope NetworkManagerScopeArgs

A scope block as defined below.

scopeAccesses List<String>

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

description String

A description of the network manager.

location String

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name String

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

tags Map<String,String>

A mapping of tags which should be assigned to the Network Managers.

resourceGroupName string

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope NetworkManagerScopeArgs

A scope block as defined below.

scopeAccesses string[]

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

description string

A description of the network manager.

location string

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name string

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

tags {[key: string]: string}

A mapping of tags which should be assigned to the Network Managers.

resource_group_name str

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope NetworkManagerScopeArgs

A scope block as defined below.

scope_accesses Sequence[str]

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

description str

A description of the network manager.

location str

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name str

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

tags Mapping[str, str]

A mapping of tags which should be assigned to the Network Managers.

resourceGroupName String

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope Property Map

A scope block as defined below.

scopeAccesses List<String>

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

description String

A description of the network manager.

location String

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name String

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

tags Map<String>

A mapping of tags which should be assigned to the Network Managers.

Outputs

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

CrossTenantScopes List<NetworkManagerCrossTenantScope>

A cross_tenant_scopes block as defined below.

Id string

The provider-assigned unique ID for this managed resource.

CrossTenantScopes []NetworkManagerCrossTenantScope

A cross_tenant_scopes block as defined below.

Id string

The provider-assigned unique ID for this managed resource.

crossTenantScopes List<NetworkManagerCrossTenantScope>

A cross_tenant_scopes block as defined below.

id String

The provider-assigned unique ID for this managed resource.

crossTenantScopes NetworkManagerCrossTenantScope[]

A cross_tenant_scopes block as defined below.

id string

The provider-assigned unique ID for this managed resource.

cross_tenant_scopes Sequence[NetworkManagerCrossTenantScope]

A cross_tenant_scopes block as defined below.

id str

The provider-assigned unique ID for this managed resource.

crossTenantScopes List<Property Map>

A cross_tenant_scopes block as defined below.

id String

The provider-assigned unique ID for this managed resource.

Look up Existing NetworkManager Resource

Get an existing NetworkManager 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?: NetworkManagerState, opts?: CustomResourceOptions): NetworkManager
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        cross_tenant_scopes: Optional[Sequence[NetworkManagerCrossTenantScopeArgs]] = None,
        description: Optional[str] = None,
        location: Optional[str] = None,
        name: Optional[str] = None,
        resource_group_name: Optional[str] = None,
        scope: Optional[NetworkManagerScopeArgs] = None,
        scope_accesses: Optional[Sequence[str]] = None,
        tags: Optional[Mapping[str, str]] = None) -> NetworkManager
func GetNetworkManager(ctx *Context, name string, id IDInput, state *NetworkManagerState, opts ...ResourceOption) (*NetworkManager, error)
public static NetworkManager Get(string name, Input<string> id, NetworkManagerState? state, CustomResourceOptions? opts = null)
public static NetworkManager get(String name, Output<String> id, NetworkManagerState 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.
The following state arguments are supported:
CrossTenantScopes List<NetworkManagerCrossTenantScopeArgs>

A cross_tenant_scopes block as defined below.

Description string

A description of the network manager.

Location string

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

Name string

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

ResourceGroupName string

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

Scope NetworkManagerScopeArgs

A scope block as defined below.

ScopeAccesses List<string>

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

Tags Dictionary<string, string>

A mapping of tags which should be assigned to the Network Managers.

CrossTenantScopes []NetworkManagerCrossTenantScopeArgs

A cross_tenant_scopes block as defined below.

Description string

A description of the network manager.

Location string

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

Name string

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

ResourceGroupName string

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

Scope NetworkManagerScopeArgs

A scope block as defined below.

ScopeAccesses []string

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

Tags map[string]string

A mapping of tags which should be assigned to the Network Managers.

crossTenantScopes List<NetworkManagerCrossTenantScopeArgs>

A cross_tenant_scopes block as defined below.

description String

A description of the network manager.

location String

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name String

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

resourceGroupName String

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope NetworkManagerScopeArgs

A scope block as defined below.

scopeAccesses List<String>

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

tags Map<String,String>

A mapping of tags which should be assigned to the Network Managers.

crossTenantScopes NetworkManagerCrossTenantScopeArgs[]

A cross_tenant_scopes block as defined below.

description string

A description of the network manager.

location string

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name string

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

resourceGroupName string

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope NetworkManagerScopeArgs

A scope block as defined below.

scopeAccesses string[]

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

tags {[key: string]: string}

A mapping of tags which should be assigned to the Network Managers.

cross_tenant_scopes Sequence[NetworkManagerCrossTenantScopeArgs]

A cross_tenant_scopes block as defined below.

description str

A description of the network manager.

location str

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name str

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

resource_group_name str

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope NetworkManagerScopeArgs

A scope block as defined below.

scope_accesses Sequence[str]

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

tags Mapping[str, str]

A mapping of tags which should be assigned to the Network Managers.

crossTenantScopes List<Property Map>

A cross_tenant_scopes block as defined below.

description String

A description of the network manager.

location String

Specifies the Azure Region where the Network Managers should exist. Changing this forces a new resource to be created.

name String

Specifies the name which should be used for this Network Managers. Changing this forces a new Network Managers to be created.

resourceGroupName String

Specifies the name of the Resource Group where the Network Managers should exist. Changing this forces a new Network Managers to be created.

scope Property Map

A scope block as defined below.

scopeAccesses List<String>

A list of configuration deployment type. Possible values are Connectivity and SecurityAdmin, corresponds to if Connectivity Configuration and Security Admin Configuration is allowed for the Network Manager.

tags Map<String>

A mapping of tags which should be assigned to the Network Managers.

Supporting Types

NetworkManagerCrossTenantScope

ManagementGroups List<string>

List of management groups.

Subscriptions List<string>

List of subscriptions.

TenantId string

Tenant ID.

ManagementGroups []string

List of management groups.

Subscriptions []string

List of subscriptions.

TenantId string

Tenant ID.

managementGroups List<String>

List of management groups.

subscriptions List<String>

List of subscriptions.

tenantId String

Tenant ID.

managementGroups string[]

List of management groups.

subscriptions string[]

List of subscriptions.

tenantId string

Tenant ID.

management_groups Sequence[str]

List of management groups.

subscriptions Sequence[str]

List of subscriptions.

tenant_id str

Tenant ID.

managementGroups List<String>

List of management groups.

subscriptions List<String>

List of subscriptions.

tenantId String

Tenant ID.

NetworkManagerScope

ManagementGroupIds List<string>

A list of management group IDs.

SubscriptionIds List<string>

A list of subscription IDs.

ManagementGroupIds []string

A list of management group IDs.

SubscriptionIds []string

A list of subscription IDs.

managementGroupIds List<String>

A list of management group IDs.

subscriptionIds List<String>

A list of subscription IDs.

managementGroupIds string[]

A list of management group IDs.

subscriptionIds string[]

A list of subscription IDs.

management_group_ids Sequence[str]

A list of management group IDs.

subscription_ids Sequence[str]

A list of subscription IDs.

managementGroupIds List<String>

A list of management group IDs.

subscriptionIds List<String>

A list of subscription IDs.

Import

Network Managers can be imported using the resource id, e.g.

 $ pulumi import azure:network/networkManager:NetworkManager example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1/providers/Microsoft.Network/networkManagers/networkManager1

Package Details

Repository
Azure Classic pulumi/pulumi-azure
License
Apache-2.0
Notes

This Pulumi package is based on the azurerm Terraform Provider.