Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Juniper Mist Provider
  3. API Docs
  4. org
  5. NacEndpoint
Juniper Mist v0.2.4 published on Saturday, Mar 1, 2025 by Pulumi
pulumi/pulumi-junipermist

junipermist.org.NacEndpoint

Explore with Pulumi AI

junipermist logo
Juniper Mist v0.2.4 published on Saturday, Mar 1, 2025 by Pulumi
pulumi/pulumi-junipermist

    This resource manages the NAC Endpoints (User MACs).

    NAC Endpoints (User MACs) provide a database of endpoints identified by their MAC addresses. They can be used assign each endpoint with various attributes, such as name, VLAN, role and client label. Once an endpoint is labeled, the label name can be used to create junipermist.org.Nactag resource as match criteria.

    The junipermist.org.Nactag resource can be used to create Tags regrouping one or multiple endpoint MAC Addresses, but the use of the User MACs provides additional features:

    • possitility to assign specific attributes, like a Name, a Radius Group, a VLAN ID, …
    • possibility to assign one or multiple Tags (Labels) to a User MAC
    • improved management for large list of MAC Addresses

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as junipermist from "@pulumi/juniper-mist";

const endpointOne = new junipermist.org.NacEndpoint("endpoint_one", {
    mac: "921b638445cd",
    labels: [
        "byod",
        "flr1",
    ],
    vlan: "30",
    notes: "mac address refers to Canon printers",
    name: "endpoint_one",
    radiusGroup: "VIP",
});

    import pulumi
import pulumi_juniper_mist as junipermist

endpoint_one = junipermist.org.NacEndpoint("endpoint_one",
    mac="921b638445cd",
    labels=[
        "byod",
        "flr1",
    ],
    vlan="30",
    notes="mac address refers to Canon printers",
    name="endpoint_one",
    radius_group="VIP")

    package main

import (
	"github.com/pulumi/pulumi-junipermist/sdk/go/junipermist/org"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := org.NewNacEndpoint(ctx, "endpoint_one", &org.NacEndpointArgs{
			Mac: pulumi.String("921b638445cd"),
			Labels: pulumi.StringArray{
				pulumi.String("byod"),
				pulumi.String("flr1"),
			},
			Vlan:        pulumi.String("30"),
			Notes:       pulumi.String("mac address refers to Canon printers"),
			Name:        pulumi.String("endpoint_one"),
			RadiusGroup: pulumi.String("VIP"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var endpointOne = new JuniperMist.Org.NacEndpoint("endpoint_one", new()
    {
        Mac = "921b638445cd",
        Labels = new[]
        {
            "byod",
            "flr1",
        },
        Vlan = "30",
        Notes = "mac address refers to Canon printers",
        Name = "endpoint_one",
        RadiusGroup = "VIP",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.junipermist.org.NacEndpoint;
import com.pulumi.junipermist.org.NacEndpointArgs;
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 endpointOne = new NacEndpoint("endpointOne", NacEndpointArgs.builder()
            .mac("921b638445cd")
            .labels(            
                "byod",
                "flr1")
            .vlan("30")
            .notes("mac address refers to Canon printers")
            .name("endpoint_one")
            .radiusGroup("VIP")
            .build());

    }
}

    resources:
  endpointOne:
    type: junipermist:org:NacEndpoint
    name: endpoint_one
    properties:
      mac: 921b638445cd
      labels:
        - byod
        - flr1
      vlan: '30'
      notes: mac address refers to Canon printers
      name: endpoint_one
      radiusGroup: VIP

    Create NacEndpoint Resource

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

    Constructor syntax

    new NacEndpoint(name: string, args: NacEndpointArgs, opts?: CustomResourceOptions);
    @overload
def NacEndpoint(resource_name: str,
                args: NacEndpointArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def NacEndpoint(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                mac: Optional[str] = None,
                org_id: Optional[str] = None,
                labels: Optional[Sequence[str]] = None,
                name: Optional[str] = None,
                notes: Optional[str] = None,
                radius_group: Optional[str] = None,
                vlan: Optional[str] = None)
    func NewNacEndpoint(ctx *Context, name string, args NacEndpointArgs, opts ...ResourceOption) (*NacEndpoint, error)
    public NacEndpoint(string name, NacEndpointArgs args, CustomResourceOptions? opts = null)
    public NacEndpoint(String name, NacEndpointArgs args)
public NacEndpoint(String name, NacEndpointArgs args, CustomResourceOptions options)

    type: junipermist:org:NacEndpoint
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 NacEndpointArgs
    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 NacEndpointArgs
    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 NacEndpointArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NacEndpointArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NacEndpointArgs
    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 nacEndpointResource = new JuniperMist.Org.NacEndpoint("nacEndpointResource", new()
{
    Mac = "string",
    OrgId = "string",
    Labels = new[]
    {
        "string",
    },
    Name = "string",
    Notes = "string",
    RadiusGroup = "string",
    Vlan = "string",
});

    example, err := org.NewNacEndpoint(ctx, "nacEndpointResource", &org.NacEndpointArgs{
	Mac:   pulumi.String("string"),
	OrgId: pulumi.String("string"),
	Labels: pulumi.StringArray{
		pulumi.String("string"),
	},
	Name:        pulumi.String("string"),
	Notes:       pulumi.String("string"),
	RadiusGroup: pulumi.String("string"),
	Vlan:        pulumi.String("string"),
})

    var nacEndpointResource = new NacEndpoint("nacEndpointResource", NacEndpointArgs.builder()
    .mac("string")
    .orgId("string")
    .labels("string")
    .name("string")
    .notes("string")
    .radiusGroup("string")
    .vlan("string")
    .build());

    nac_endpoint_resource = junipermist.org.NacEndpoint("nacEndpointResource",
    mac="string",
    org_id="string",
    labels=["string"],
    name="string",
    notes="string",
    radius_group="string",
    vlan="string")

    const nacEndpointResource = new junipermist.org.NacEndpoint("nacEndpointResource", {
    mac: "string",
    orgId: "string",
    labels: ["string"],
    name: "string",
    notes: "string",
    radiusGroup: "string",
    vlan: "string",
});

    type: junipermist:org:NacEndpoint
properties:
    labels:
        - string
    mac: string
    name: string
    notes: string
    orgId: string
    radiusGroup: string
    vlan: string

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

    Mac string
    only non-local-admin MAC is accepted
    OrgId string
    Labels List<string>
    Name string
    Notes string
    RadiusGroup string
    Vlan string
    Mac string
    only non-local-admin MAC is accepted
    OrgId string
    Labels []string
    Name string
    Notes string
    RadiusGroup string
    Vlan string
    mac String
    only non-local-admin MAC is accepted
    orgId String
    labels List<String>
    name String
    notes String
    radiusGroup String
    vlan String
    mac string
    only non-local-admin MAC is accepted
    orgId string
    labels string[]
    name string
    notes string
    radiusGroup string
    vlan string
    mac str
    only non-local-admin MAC is accepted
    org_id str
    labels Sequence[str]
    name str
    notes str
    radius_group str
    vlan str
    mac String
    only non-local-admin MAC is accepted
    orgId String
    labels List<String>
    name String
    notes String
    radiusGroup String
    vlan String

    Outputs

    All input properties are implicitly available as output properties. Additionally, the NacEndpoint 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 NacEndpoint Resource

    Get an existing NacEndpoint 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?: NacEndpointState, opts?: CustomResourceOptions): NacEndpoint
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        labels: Optional[Sequence[str]] = None,
        mac: Optional[str] = None,
        name: Optional[str] = None,
        notes: Optional[str] = None,
        org_id: Optional[str] = None,
        radius_group: Optional[str] = None,
        vlan: Optional[str] = None) -> NacEndpoint
    func GetNacEndpoint(ctx *Context, name string, id IDInput, state *NacEndpointState, opts ...ResourceOption) (*NacEndpoint, error)
    public static NacEndpoint Get(string name, Input<string> id, NacEndpointState? state, CustomResourceOptions? opts = null)
    public static NacEndpoint get(String name, Output<String> id, NacEndpointState state, CustomResourceOptions options)
    resources:  _:    type: junipermist:org:NacEndpoint    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.
    The following state arguments are supported:
    Labels List<string>
    Mac string
    only non-local-admin MAC is accepted
    Name string
    Notes string
    OrgId string
    RadiusGroup string
    Vlan string
    Labels []string
    Mac string
    only non-local-admin MAC is accepted
    Name string
    Notes string
    OrgId string
    RadiusGroup string
    Vlan string
    labels List<String>
    mac String
    only non-local-admin MAC is accepted
    name String
    notes String
    orgId String
    radiusGroup String
    vlan String
    labels string[]
    mac string
    only non-local-admin MAC is accepted
    name string
    notes string
    orgId string
    radiusGroup string
    vlan string
    labels Sequence[str]
    mac str
    only non-local-admin MAC is accepted
    name str
    notes str
    org_id str
    radius_group str
    vlan str
    labels List<String>
    mac String
    only non-local-admin MAC is accepted
    name String
    notes String
    orgId String
    radiusGroup String
    vlan String

    Import

    Using pulumi import, import mist_org_nac_endpoint with:

    NAC Endpoint can be imported by specifying the org_id and the nac_endpoint_id

    $ pulumi import junipermist:org/nacEndpoint:NacEndpoint endpoint_one 17b46405-3a6d-4715-8bb4-6bb6d06f316a.d3c42998-9012-4859-9743-6b9bee475309

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    junipermist pulumi/pulumi-junipermist
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the mist Terraform Provider.
    junipermist logo
    Juniper Mist v0.2.4 published on Saturday, Mar 1, 2025 by Pulumi
    pulumi/pulumi-junipermist