1. Packages
  2. Nsxt Provider
  3. API Docs
  4. MacManagementSwitchingProfile
nsxt 3.8.1 published on Wednesday, Apr 30, 2025 by vmware

nsxt.MacManagementSwitchingProfile

Explore with Pulumi AI

nsxt logo
nsxt 3.8.1 published on Wednesday, Apr 30, 2025 by vmware

    Create MacManagementSwitchingProfile Resource

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

    Constructor syntax

    new MacManagementSwitchingProfile(name: string, args?: MacManagementSwitchingProfileArgs, opts?: CustomResourceOptions);
    @overload
    def MacManagementSwitchingProfile(resource_name: str,
                                      args: Optional[MacManagementSwitchingProfileArgs] = None,
                                      opts: Optional[ResourceOptions] = None)
    
    @overload
    def MacManagementSwitchingProfile(resource_name: str,
                                      opts: Optional[ResourceOptions] = None,
                                      description: Optional[str] = None,
                                      display_name: Optional[str] = None,
                                      mac_change_allowed: Optional[bool] = None,
                                      mac_learning: Optional[MacManagementSwitchingProfileMacLearningArgs] = None,
                                      mac_management_switching_profile_id: Optional[str] = None,
                                      tags: Optional[Sequence[MacManagementSwitchingProfileTagArgs]] = None)
    func NewMacManagementSwitchingProfile(ctx *Context, name string, args *MacManagementSwitchingProfileArgs, opts ...ResourceOption) (*MacManagementSwitchingProfile, error)
    public MacManagementSwitchingProfile(string name, MacManagementSwitchingProfileArgs? args = null, CustomResourceOptions? opts = null)
    public MacManagementSwitchingProfile(String name, MacManagementSwitchingProfileArgs args)
    public MacManagementSwitchingProfile(String name, MacManagementSwitchingProfileArgs args, CustomResourceOptions options)
    
    type: nsxt:MacManagementSwitchingProfile
    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 MacManagementSwitchingProfileArgs
    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 MacManagementSwitchingProfileArgs
    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 MacManagementSwitchingProfileArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MacManagementSwitchingProfileArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MacManagementSwitchingProfileArgs
    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 macManagementSwitchingProfileResource = new Nsxt.MacManagementSwitchingProfile("macManagementSwitchingProfileResource", new()
    {
        Description = "string",
        DisplayName = "string",
        MacChangeAllowed = false,
        MacLearning = new Nsxt.Inputs.MacManagementSwitchingProfileMacLearningArgs
        {
            Enabled = false,
            Limit = 0,
            LimitPolicy = "string",
            UnicastFloodingAllowed = false,
        },
        MacManagementSwitchingProfileId = "string",
        Tags = new[]
        {
            new Nsxt.Inputs.MacManagementSwitchingProfileTagArgs
            {
                Scope = "string",
                Tag = "string",
            },
        },
    });
    
    example, err := nsxt.NewMacManagementSwitchingProfile(ctx, "macManagementSwitchingProfileResource", &nsxt.MacManagementSwitchingProfileArgs{
    	Description:      pulumi.String("string"),
    	DisplayName:      pulumi.String("string"),
    	MacChangeAllowed: pulumi.Bool(false),
    	MacLearning: &nsxt.MacManagementSwitchingProfileMacLearningArgs{
    		Enabled:                pulumi.Bool(false),
    		Limit:                  pulumi.Float64(0),
    		LimitPolicy:            pulumi.String("string"),
    		UnicastFloodingAllowed: pulumi.Bool(false),
    	},
    	MacManagementSwitchingProfileId: pulumi.String("string"),
    	Tags: nsxt.MacManagementSwitchingProfileTagArray{
    		&nsxt.MacManagementSwitchingProfileTagArgs{
    			Scope: pulumi.String("string"),
    			Tag:   pulumi.String("string"),
    		},
    	},
    })
    
    var macManagementSwitchingProfileResource = new MacManagementSwitchingProfile("macManagementSwitchingProfileResource", MacManagementSwitchingProfileArgs.builder()
        .description("string")
        .displayName("string")
        .macChangeAllowed(false)
        .macLearning(MacManagementSwitchingProfileMacLearningArgs.builder()
            .enabled(false)
            .limit(0)
            .limitPolicy("string")
            .unicastFloodingAllowed(false)
            .build())
        .macManagementSwitchingProfileId("string")
        .tags(MacManagementSwitchingProfileTagArgs.builder()
            .scope("string")
            .tag("string")
            .build())
        .build());
    
    mac_management_switching_profile_resource = nsxt.MacManagementSwitchingProfile("macManagementSwitchingProfileResource",
        description="string",
        display_name="string",
        mac_change_allowed=False,
        mac_learning={
            "enabled": False,
            "limit": 0,
            "limit_policy": "string",
            "unicast_flooding_allowed": False,
        },
        mac_management_switching_profile_id="string",
        tags=[{
            "scope": "string",
            "tag": "string",
        }])
    
    const macManagementSwitchingProfileResource = new nsxt.MacManagementSwitchingProfile("macManagementSwitchingProfileResource", {
        description: "string",
        displayName: "string",
        macChangeAllowed: false,
        macLearning: {
            enabled: false,
            limit: 0,
            limitPolicy: "string",
            unicastFloodingAllowed: false,
        },
        macManagementSwitchingProfileId: "string",
        tags: [{
            scope: "string",
            tag: "string",
        }],
    });
    
    type: nsxt:MacManagementSwitchingProfile
    properties:
        description: string
        displayName: string
        macChangeAllowed: false
        macLearning:
            enabled: false
            limit: 0
            limitPolicy: string
            unicastFloodingAllowed: false
        macManagementSwitchingProfileId: string
        tags:
            - scope: string
              tag: string
    

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

    Description string
    Description of this resource.
    DisplayName string
    The display name of this resource. Defaults to ID if not set.
    MacChangeAllowed bool
    A boolean flag indicating allowing source MAC address change.
    MacLearning MacManagementSwitchingProfileMacLearning
    Mac learning configuration:
    MacManagementSwitchingProfileId string
    ID of the MAC management switching profile.
    Tags List<MacManagementSwitchingProfileTag>
    A list of scope + tag pairs to associate with this MAC management switching profile.
    Description string
    Description of this resource.
    DisplayName string
    The display name of this resource. Defaults to ID if not set.
    MacChangeAllowed bool
    A boolean flag indicating allowing source MAC address change.
    MacLearning MacManagementSwitchingProfileMacLearningArgs
    Mac learning configuration:
    MacManagementSwitchingProfileId string
    ID of the MAC management switching profile.
    Tags []MacManagementSwitchingProfileTagArgs
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description String
    Description of this resource.
    displayName String
    The display name of this resource. Defaults to ID if not set.
    macChangeAllowed Boolean
    A boolean flag indicating allowing source MAC address change.
    macLearning MacManagementSwitchingProfileMacLearning
    Mac learning configuration:
    macManagementSwitchingProfileId String
    ID of the MAC management switching profile.
    tags List<MacManagementSwitchingProfileTag>
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description string
    Description of this resource.
    displayName string
    The display name of this resource. Defaults to ID if not set.
    macChangeAllowed boolean
    A boolean flag indicating allowing source MAC address change.
    macLearning MacManagementSwitchingProfileMacLearning
    Mac learning configuration:
    macManagementSwitchingProfileId string
    ID of the MAC management switching profile.
    tags MacManagementSwitchingProfileTag[]
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description str
    Description of this resource.
    display_name str
    The display name of this resource. Defaults to ID if not set.
    mac_change_allowed bool
    A boolean flag indicating allowing source MAC address change.
    mac_learning MacManagementSwitchingProfileMacLearningArgs
    Mac learning configuration:
    mac_management_switching_profile_id str
    ID of the MAC management switching profile.
    tags Sequence[MacManagementSwitchingProfileTagArgs]
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description String
    Description of this resource.
    displayName String
    The display name of this resource. Defaults to ID if not set.
    macChangeAllowed Boolean
    A boolean flag indicating allowing source MAC address change.
    macLearning Property Map
    Mac learning configuration:
    macManagementSwitchingProfileId String
    ID of the MAC management switching profile.
    tags List<Property Map>
    A list of scope + tag pairs to associate with this MAC management switching profile.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Revision double
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    Id string
    The provider-assigned unique ID for this managed resource.
    Revision float64
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    id String
    The provider-assigned unique ID for this managed resource.
    revision Double
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    id string
    The provider-assigned unique ID for this managed resource.
    revision number
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    id str
    The provider-assigned unique ID for this managed resource.
    revision float
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    id String
    The provider-assigned unique ID for this managed resource.
    revision Number
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.

    Look up Existing MacManagementSwitchingProfile Resource

    Get an existing MacManagementSwitchingProfile 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?: MacManagementSwitchingProfileState, opts?: CustomResourceOptions): MacManagementSwitchingProfile
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            description: Optional[str] = None,
            display_name: Optional[str] = None,
            mac_change_allowed: Optional[bool] = None,
            mac_learning: Optional[MacManagementSwitchingProfileMacLearningArgs] = None,
            mac_management_switching_profile_id: Optional[str] = None,
            revision: Optional[float] = None,
            tags: Optional[Sequence[MacManagementSwitchingProfileTagArgs]] = None) -> MacManagementSwitchingProfile
    func GetMacManagementSwitchingProfile(ctx *Context, name string, id IDInput, state *MacManagementSwitchingProfileState, opts ...ResourceOption) (*MacManagementSwitchingProfile, error)
    public static MacManagementSwitchingProfile Get(string name, Input<string> id, MacManagementSwitchingProfileState? state, CustomResourceOptions? opts = null)
    public static MacManagementSwitchingProfile get(String name, Output<String> id, MacManagementSwitchingProfileState state, CustomResourceOptions options)
    resources:  _:    type: nsxt:MacManagementSwitchingProfile    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:
    Description string
    Description of this resource.
    DisplayName string
    The display name of this resource. Defaults to ID if not set.
    MacChangeAllowed bool
    A boolean flag indicating allowing source MAC address change.
    MacLearning MacManagementSwitchingProfileMacLearning
    Mac learning configuration:
    MacManagementSwitchingProfileId string
    ID of the MAC management switching profile.
    Revision double
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    Tags List<MacManagementSwitchingProfileTag>
    A list of scope + tag pairs to associate with this MAC management switching profile.
    Description string
    Description of this resource.
    DisplayName string
    The display name of this resource. Defaults to ID if not set.
    MacChangeAllowed bool
    A boolean flag indicating allowing source MAC address change.
    MacLearning MacManagementSwitchingProfileMacLearningArgs
    Mac learning configuration:
    MacManagementSwitchingProfileId string
    ID of the MAC management switching profile.
    Revision float64
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    Tags []MacManagementSwitchingProfileTagArgs
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description String
    Description of this resource.
    displayName String
    The display name of this resource. Defaults to ID if not set.
    macChangeAllowed Boolean
    A boolean flag indicating allowing source MAC address change.
    macLearning MacManagementSwitchingProfileMacLearning
    Mac learning configuration:
    macManagementSwitchingProfileId String
    ID of the MAC management switching profile.
    revision Double
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    tags List<MacManagementSwitchingProfileTag>
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description string
    Description of this resource.
    displayName string
    The display name of this resource. Defaults to ID if not set.
    macChangeAllowed boolean
    A boolean flag indicating allowing source MAC address change.
    macLearning MacManagementSwitchingProfileMacLearning
    Mac learning configuration:
    macManagementSwitchingProfileId string
    ID of the MAC management switching profile.
    revision number
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    tags MacManagementSwitchingProfileTag[]
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description str
    Description of this resource.
    display_name str
    The display name of this resource. Defaults to ID if not set.
    mac_change_allowed bool
    A boolean flag indicating allowing source MAC address change.
    mac_learning MacManagementSwitchingProfileMacLearningArgs
    Mac learning configuration:
    mac_management_switching_profile_id str
    ID of the MAC management switching profile.
    revision float
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    tags Sequence[MacManagementSwitchingProfileTagArgs]
    A list of scope + tag pairs to associate with this MAC management switching profile.
    description String
    Description of this resource.
    displayName String
    The display name of this resource. Defaults to ID if not set.
    macChangeAllowed Boolean
    A boolean flag indicating allowing source MAC address change.
    macLearning Property Map
    Mac learning configuration:
    macManagementSwitchingProfileId String
    ID of the MAC management switching profile.
    revision Number
    Indicates current revision number of the object as seen by NSX-T API server. This attribute can be useful for debugging.
    tags List<Property Map>
    A list of scope + tag pairs to associate with this MAC management switching profile.

    Supporting Types

    MacManagementSwitchingProfileMacLearning, MacManagementSwitchingProfileMacLearningArgs

    Enabled bool
    A boolean flag indicating allowing source MAC address learning.
    Limit double
    The maximum number of MAC addresses that can be learned on this port.
    LimitPolicy string
    The policy after MAC Limit is exceeded: ALLOW/DROP.
    UnicastFloodingAllowed bool
    A boolean flag indicating allowing flooding for unlearned MAC for ingress traffic. Can be True only if mac_learning is enabled.
    Enabled bool
    A boolean flag indicating allowing source MAC address learning.
    Limit float64
    The maximum number of MAC addresses that can be learned on this port.
    LimitPolicy string
    The policy after MAC Limit is exceeded: ALLOW/DROP.
    UnicastFloodingAllowed bool
    A boolean flag indicating allowing flooding for unlearned MAC for ingress traffic. Can be True only if mac_learning is enabled.
    enabled Boolean
    A boolean flag indicating allowing source MAC address learning.
    limit Double
    The maximum number of MAC addresses that can be learned on this port.
    limitPolicy String
    The policy after MAC Limit is exceeded: ALLOW/DROP.
    unicastFloodingAllowed Boolean
    A boolean flag indicating allowing flooding for unlearned MAC for ingress traffic. Can be True only if mac_learning is enabled.
    enabled boolean
    A boolean flag indicating allowing source MAC address learning.
    limit number
    The maximum number of MAC addresses that can be learned on this port.
    limitPolicy string
    The policy after MAC Limit is exceeded: ALLOW/DROP.
    unicastFloodingAllowed boolean
    A boolean flag indicating allowing flooding for unlearned MAC for ingress traffic. Can be True only if mac_learning is enabled.
    enabled bool
    A boolean flag indicating allowing source MAC address learning.
    limit float
    The maximum number of MAC addresses that can be learned on this port.
    limit_policy str
    The policy after MAC Limit is exceeded: ALLOW/DROP.
    unicast_flooding_allowed bool
    A boolean flag indicating allowing flooding for unlearned MAC for ingress traffic. Can be True only if mac_learning is enabled.
    enabled Boolean
    A boolean flag indicating allowing source MAC address learning.
    limit Number
    The maximum number of MAC addresses that can be learned on this port.
    limitPolicy String
    The policy after MAC Limit is exceeded: ALLOW/DROP.
    unicastFloodingAllowed Boolean
    A boolean flag indicating allowing flooding for unlearned MAC for ingress traffic. Can be True only if mac_learning is enabled.

    MacManagementSwitchingProfileTag, MacManagementSwitchingProfileTagArgs

    Scope string
    Tag string
    A list of scope + tag pairs to associate with this MAC management switching profile.
    Scope string
    Tag string
    A list of scope + tag pairs to associate with this MAC management switching profile.
    scope String
    tag String
    A list of scope + tag pairs to associate with this MAC management switching profile.
    scope string
    tag string
    A list of scope + tag pairs to associate with this MAC management switching profile.
    scope str
    tag str
    A list of scope + tag pairs to associate with this MAC management switching profile.
    scope String
    tag String
    A list of scope + tag pairs to associate with this MAC management switching profile.

    Package Details

    Repository
    nsxt vmware/terraform-provider-nsxt
    License
    Notes
    This Pulumi package is based on the nsxt Terraform Provider.
    nsxt logo
    nsxt 3.8.1 published on Wednesday, Apr 30, 2025 by vmware