1. Packages
  2. Cisco Meraki
  3. API Docs
  4. networks
  5. SmDevicesModifyTags
Cisco Meraki v0.2.4 published on Friday, Jun 14, 2024 by Pulumi

meraki.networks.SmDevicesModifyTags

Explore with Pulumi AI

meraki logo
Cisco Meraki v0.2.4 published on Friday, Jun 14, 2024 by Pulumi

    ~>Warning: This resource does not represent a real-world entity in Meraki Dashboard, therefore changing or deleting this resource on its own has no immediate effect. Instead, it is a task part of a Meraki Dashboard workflow. It is executed in Meraki without any additional verification. It does not check if it was executed before or if a similar configuration or action already existed previously.

    Example Usage

    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.meraki.networks.SmDevicesModifyTags;
    import com.pulumi.meraki.networks.SmDevicesModifyTagsArgs;
    import com.pulumi.meraki.networks.inputs.SmDevicesModifyTagsParametersArgs;
    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 example = new SmDevicesModifyTags("example", SmDevicesModifyTagsArgs.builder()
                .networkId("string")
                .parameters(SmDevicesModifyTagsParametersArgs.builder()
                    .ids(                
                        "1284392014819",
                        "2983092129865")
                    .scope("withAny, old_tag")
                    .serials(                
                        "XY0XX0Y0X0",
                        "A01B01CD00E",
                        "X02YZ1ZYZX")
                    .tags(                
                        "tag1",
                        "tag2")
                    .update_action("add")
                    .wifi_macs("00:11:22:33:44:55")
                    .build())
                .build());
    
            ctx.export("merakiNetworksSmDevicesModifyTagsExample", example);
        }
    }
    
    resources:
      example:
        type: meraki:networks:SmDevicesModifyTags
        properties:
          networkId: string
          parameters:
            ids:
              - '1284392014819'
              - '2983092129865'
            scope:
              - withAny, old_tag
            serials:
              - XY0XX0Y0X0
              - A01B01CD00E
              - X02YZ1ZYZX
            tags:
              - tag1
              - tag2
            update_action: add
            wifi_macs:
              - 00:11:22:33:44:55
    outputs:
      merakiNetworksSmDevicesModifyTagsExample: ${example}
    

    Create SmDevicesModifyTags Resource

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

    Constructor syntax

    new SmDevicesModifyTags(name: string, args: SmDevicesModifyTagsArgs, opts?: CustomResourceOptions);
    @overload
    def SmDevicesModifyTags(resource_name: str,
                            args: SmDevicesModifyTagsArgs,
                            opts: Optional[ResourceOptions] = None)
    
    @overload
    def SmDevicesModifyTags(resource_name: str,
                            opts: Optional[ResourceOptions] = None,
                            network_id: Optional[str] = None,
                            parameters: Optional[SmDevicesModifyTagsParametersArgs] = None)
    func NewSmDevicesModifyTags(ctx *Context, name string, args SmDevicesModifyTagsArgs, opts ...ResourceOption) (*SmDevicesModifyTags, error)
    public SmDevicesModifyTags(string name, SmDevicesModifyTagsArgs args, CustomResourceOptions? opts = null)
    public SmDevicesModifyTags(String name, SmDevicesModifyTagsArgs args)
    public SmDevicesModifyTags(String name, SmDevicesModifyTagsArgs args, CustomResourceOptions options)
    
    type: meraki:networks:SmDevicesModifyTags
    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 SmDevicesModifyTagsArgs
    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 SmDevicesModifyTagsArgs
    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 SmDevicesModifyTagsArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args SmDevicesModifyTagsArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args SmDevicesModifyTagsArgs
    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 smDevicesModifyTagsResource = new Meraki.Networks.SmDevicesModifyTags("smDevicesModifyTagsResource", new()
    {
        NetworkId = "string",
        Parameters = new Meraki.Networks.Inputs.SmDevicesModifyTagsParametersArgs
        {
            Ids = new[]
            {
                "string",
            },
            Scopes = new[]
            {
                "string",
            },
            Serials = new[]
            {
                "string",
            },
            Tags = new[]
            {
                "string",
            },
            UpdateAction = "string",
            WifiMacs = new[]
            {
                "string",
            },
        },
    });
    
    example, err := networks.NewSmDevicesModifyTags(ctx, "smDevicesModifyTagsResource", &networks.SmDevicesModifyTagsArgs{
    	NetworkId: pulumi.String("string"),
    	Parameters: &networks.SmDevicesModifyTagsParametersArgs{
    		Ids: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		Scopes: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		Serials: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		Tags: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		UpdateAction: pulumi.String("string"),
    		WifiMacs: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    	},
    })
    
    var smDevicesModifyTagsResource = new SmDevicesModifyTags("smDevicesModifyTagsResource", SmDevicesModifyTagsArgs.builder()
        .networkId("string")
        .parameters(SmDevicesModifyTagsParametersArgs.builder()
            .ids("string")
            .scopes("string")
            .serials("string")
            .tags("string")
            .updateAction("string")
            .wifiMacs("string")
            .build())
        .build());
    
    sm_devices_modify_tags_resource = meraki.networks.SmDevicesModifyTags("smDevicesModifyTagsResource",
        network_id="string",
        parameters=meraki.networks.SmDevicesModifyTagsParametersArgs(
            ids=["string"],
            scopes=["string"],
            serials=["string"],
            tags=["string"],
            update_action="string",
            wifi_macs=["string"],
        ))
    
    const smDevicesModifyTagsResource = new meraki.networks.SmDevicesModifyTags("smDevicesModifyTagsResource", {
        networkId: "string",
        parameters: {
            ids: ["string"],
            scopes: ["string"],
            serials: ["string"],
            tags: ["string"],
            updateAction: "string",
            wifiMacs: ["string"],
        },
    });
    
    type: meraki:networks:SmDevicesModifyTags
    properties:
        networkId: string
        parameters:
            ids:
                - string
            scopes:
                - string
            serials:
                - string
            tags:
                - string
            updateAction: string
            wifiMacs:
                - string
    

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

    NetworkId string
    networkId path parameter. Network ID
    Parameters SmDevicesModifyTagsParameters
    NetworkId string
    networkId path parameter. Network ID
    Parameters SmDevicesModifyTagsParametersArgs
    networkId String
    networkId path parameter. Network ID
    parameters SmDevicesModifyTagsParameters
    networkId string
    networkId path parameter. Network ID
    parameters SmDevicesModifyTagsParameters
    network_id str
    networkId path parameter. Network ID
    parameters SmDevicesModifyTagsParametersArgs
    networkId String
    networkId path parameter. Network ID
    parameters Property Map

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Items List<SmDevicesModifyTagsItem>
    Array of ResponseSmModifyNetworkSmDevicesTags
    Id string
    The provider-assigned unique ID for this managed resource.
    Items []SmDevicesModifyTagsItem
    Array of ResponseSmModifyNetworkSmDevicesTags
    id String
    The provider-assigned unique ID for this managed resource.
    items List<SmDevicesModifyTagsItem>
    Array of ResponseSmModifyNetworkSmDevicesTags
    id string
    The provider-assigned unique ID for this managed resource.
    items SmDevicesModifyTagsItem[]
    Array of ResponseSmModifyNetworkSmDevicesTags
    id str
    The provider-assigned unique ID for this managed resource.
    items Sequence[SmDevicesModifyTagsItem]
    Array of ResponseSmModifyNetworkSmDevicesTags
    id String
    The provider-assigned unique ID for this managed resource.
    items List<Property Map>
    Array of ResponseSmModifyNetworkSmDevicesTags

    Look up Existing SmDevicesModifyTags Resource

    Get an existing SmDevicesModifyTags 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?: SmDevicesModifyTagsState, opts?: CustomResourceOptions): SmDevicesModifyTags
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            items: Optional[Sequence[SmDevicesModifyTagsItemArgs]] = None,
            network_id: Optional[str] = None,
            parameters: Optional[SmDevicesModifyTagsParametersArgs] = None) -> SmDevicesModifyTags
    func GetSmDevicesModifyTags(ctx *Context, name string, id IDInput, state *SmDevicesModifyTagsState, opts ...ResourceOption) (*SmDevicesModifyTags, error)
    public static SmDevicesModifyTags Get(string name, Input<string> id, SmDevicesModifyTagsState? state, CustomResourceOptions? opts = null)
    public static SmDevicesModifyTags get(String name, Output<String> id, SmDevicesModifyTagsState 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:
    Items List<SmDevicesModifyTagsItem>
    Array of ResponseSmModifyNetworkSmDevicesTags
    NetworkId string
    networkId path parameter. Network ID
    Parameters SmDevicesModifyTagsParameters
    Items []SmDevicesModifyTagsItemArgs
    Array of ResponseSmModifyNetworkSmDevicesTags
    NetworkId string
    networkId path parameter. Network ID
    Parameters SmDevicesModifyTagsParametersArgs
    items List<SmDevicesModifyTagsItem>
    Array of ResponseSmModifyNetworkSmDevicesTags
    networkId String
    networkId path parameter. Network ID
    parameters SmDevicesModifyTagsParameters
    items SmDevicesModifyTagsItem[]
    Array of ResponseSmModifyNetworkSmDevicesTags
    networkId string
    networkId path parameter. Network ID
    parameters SmDevicesModifyTagsParameters
    items Sequence[SmDevicesModifyTagsItemArgs]
    Array of ResponseSmModifyNetworkSmDevicesTags
    network_id str
    networkId path parameter. Network ID
    parameters SmDevicesModifyTagsParametersArgs
    items List<Property Map>
    Array of ResponseSmModifyNetworkSmDevicesTags
    networkId String
    networkId path parameter. Network ID
    parameters Property Map

    Supporting Types

    SmDevicesModifyTagsItem, SmDevicesModifyTagsItemArgs

    Id string
    The Meraki Id of the device record.
    Serial string
    The device serial.
    Tags List<string>
    An array of tags associated with the device.
    WifiMac string
    The MAC of the device.
    Id string
    The Meraki Id of the device record.
    Serial string
    The device serial.
    Tags []string
    An array of tags associated with the device.
    WifiMac string
    The MAC of the device.
    id String
    The Meraki Id of the device record.
    serial String
    The device serial.
    tags List<String>
    An array of tags associated with the device.
    wifiMac String
    The MAC of the device.
    id string
    The Meraki Id of the device record.
    serial string
    The device serial.
    tags string[]
    An array of tags associated with the device.
    wifiMac string
    The MAC of the device.
    id str
    The Meraki Id of the device record.
    serial str
    The device serial.
    tags Sequence[str]
    An array of tags associated with the device.
    wifi_mac str
    The MAC of the device.
    id String
    The Meraki Id of the device record.
    serial String
    The device serial.
    tags List<String>
    An array of tags associated with the device.
    wifiMac String
    The MAC of the device.

    SmDevicesModifyTagsParameters, SmDevicesModifyTagsParametersArgs

    Ids List<string>
    The ids of the devices to be modified.
    Scopes List<string>
    The scope (one of all, none, withAny, withAll, withoutAny, or withoutAll) and a set of tags of the devices to be modified.
    Serials List<string>
    The serials of the devices to be modified.
    Tags List<string>
    The tags to be added, deleted, or updated.
    UpdateAction string
    One of add, delete, or update. Only devices that have been modified will be returned.
    WifiMacs List<string>
    The wifiMacs of the devices to be modified.
    Ids []string
    The ids of the devices to be modified.
    Scopes []string
    The scope (one of all, none, withAny, withAll, withoutAny, or withoutAll) and a set of tags of the devices to be modified.
    Serials []string
    The serials of the devices to be modified.
    Tags []string
    The tags to be added, deleted, or updated.
    UpdateAction string
    One of add, delete, or update. Only devices that have been modified will be returned.
    WifiMacs []string
    The wifiMacs of the devices to be modified.
    ids List<String>
    The ids of the devices to be modified.
    scopes List<String>
    The scope (one of all, none, withAny, withAll, withoutAny, or withoutAll) and a set of tags of the devices to be modified.
    serials List<String>
    The serials of the devices to be modified.
    tags List<String>
    The tags to be added, deleted, or updated.
    updateAction String
    One of add, delete, or update. Only devices that have been modified will be returned.
    wifiMacs List<String>
    The wifiMacs of the devices to be modified.
    ids string[]
    The ids of the devices to be modified.
    scopes string[]
    The scope (one of all, none, withAny, withAll, withoutAny, or withoutAll) and a set of tags of the devices to be modified.
    serials string[]
    The serials of the devices to be modified.
    tags string[]
    The tags to be added, deleted, or updated.
    updateAction string
    One of add, delete, or update. Only devices that have been modified will be returned.
    wifiMacs string[]
    The wifiMacs of the devices to be modified.
    ids Sequence[str]
    The ids of the devices to be modified.
    scopes Sequence[str]
    The scope (one of all, none, withAny, withAll, withoutAny, or withoutAll) and a set of tags of the devices to be modified.
    serials Sequence[str]
    The serials of the devices to be modified.
    tags Sequence[str]
    The tags to be added, deleted, or updated.
    update_action str
    One of add, delete, or update. Only devices that have been modified will be returned.
    wifi_macs Sequence[str]
    The wifiMacs of the devices to be modified.
    ids List<String>
    The ids of the devices to be modified.
    scopes List<String>
    The scope (one of all, none, withAny, withAll, withoutAny, or withoutAll) and a set of tags of the devices to be modified.
    serials List<String>
    The serials of the devices to be modified.
    tags List<String>
    The tags to be added, deleted, or updated.
    updateAction String
    One of add, delete, or update. Only devices that have been modified will be returned.
    wifiMacs List<String>
    The wifiMacs of the devices to be modified.

    Package Details

    Repository
    meraki pulumi/pulumi-meraki
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the meraki Terraform Provider.
    meraki logo
    Cisco Meraki v0.2.4 published on Friday, Jun 14, 2024 by Pulumi