Cisco Meraki v0.4.4 published on Wednesday, Oct 22, 2025 by Pulumi
meraki.organizations.getClientsSearch
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as meraki from "@pulumi/meraki";
const example = meraki.organizations.getClientsSearch({
    endingBefore: "string",
    mac: "string",
    organizationId: "string",
    perPage: 1,
    startingAfter: "string",
});
export const merakiOrganizationsClientsSearchExample = example.then(example => example.item);
import pulumi
import pulumi_meraki as meraki
example = meraki.organizations.get_clients_search(ending_before="string",
    mac="string",
    organization_id="string",
    per_page=1,
    starting_after="string")
pulumi.export("merakiOrganizationsClientsSearchExample", example.item)
package main
import (
	"github.com/pulumi/pulumi-meraki/sdk/go/meraki/organizations"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := organizations.GetClientsSearch(ctx, &organizations.GetClientsSearchArgs{
			EndingBefore:   pulumi.StringRef("string"),
			Mac:            "string",
			OrganizationId: "string",
			PerPage:        pulumi.IntRef(1),
			StartingAfter:  pulumi.StringRef("string"),
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("merakiOrganizationsClientsSearchExample", example.Item)
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Meraki = Pulumi.Meraki;
return await Deployment.RunAsync(() => 
{
    var example = Meraki.Organizations.GetClientsSearch.Invoke(new()
    {
        EndingBefore = "string",
        Mac = "string",
        OrganizationId = "string",
        PerPage = 1,
        StartingAfter = "string",
    });
    return new Dictionary<string, object?>
    {
        ["merakiOrganizationsClientsSearchExample"] = example.Apply(getClientsSearchResult => getClientsSearchResult.Item),
    };
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.meraki.organizations.OrganizationsFunctions;
import com.pulumi.meraki.organizations.inputs.GetClientsSearchArgs;
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) {
        final var example = OrganizationsFunctions.getClientsSearch(GetClientsSearchArgs.builder()
            .endingBefore("string")
            .mac("string")
            .organizationId("string")
            .perPage(1)
            .startingAfter("string")
            .build());
        ctx.export("merakiOrganizationsClientsSearchExample", example.item());
    }
}
variables:
  example:
    fn::invoke:
      function: meraki:organizations:getClientsSearch
      arguments:
        endingBefore: string
        mac: string
        organizationId: string
        perPage: 1
        startingAfter: string
outputs:
  merakiOrganizationsClientsSearchExample: ${example.item}
Using getClientsSearch
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getClientsSearch(args: GetClientsSearchArgs, opts?: InvokeOptions): Promise<GetClientsSearchResult>
function getClientsSearchOutput(args: GetClientsSearchOutputArgs, opts?: InvokeOptions): Output<GetClientsSearchResult>def get_clients_search(ending_before: Optional[str] = None,
                       mac: Optional[str] = None,
                       organization_id: Optional[str] = None,
                       per_page: Optional[int] = None,
                       starting_after: Optional[str] = None,
                       opts: Optional[InvokeOptions] = None) -> GetClientsSearchResult
def get_clients_search_output(ending_before: Optional[pulumi.Input[str]] = None,
                       mac: Optional[pulumi.Input[str]] = None,
                       organization_id: Optional[pulumi.Input[str]] = None,
                       per_page: Optional[pulumi.Input[int]] = None,
                       starting_after: Optional[pulumi.Input[str]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetClientsSearchResult]func GetClientsSearch(ctx *Context, args *GetClientsSearchArgs, opts ...InvokeOption) (*GetClientsSearchResult, error)
func GetClientsSearchOutput(ctx *Context, args *GetClientsSearchOutputArgs, opts ...InvokeOption) GetClientsSearchResultOutput> Note: This function is named GetClientsSearch in the Go SDK.
public static class GetClientsSearch 
{
    public static Task<GetClientsSearchResult> InvokeAsync(GetClientsSearchArgs args, InvokeOptions? opts = null)
    public static Output<GetClientsSearchResult> Invoke(GetClientsSearchInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetClientsSearchResult> getClientsSearch(GetClientsSearchArgs args, InvokeOptions options)
public static Output<GetClientsSearchResult> getClientsSearch(GetClientsSearchArgs args, InvokeOptions options)
fn::invoke:
  function: meraki:organizations/getClientsSearch:getClientsSearch
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Mac string
- mac query parameter. The MAC address of the client. Required.
- OrganizationId string
- organizationId path parameter. Organization ID
- EndingBefore string
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- PerPage int
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- StartingAfter string
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- Mac string
- mac query parameter. The MAC address of the client. Required.
- OrganizationId string
- organizationId path parameter. Organization ID
- EndingBefore string
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- PerPage int
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- StartingAfter string
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- mac String
- mac query parameter. The MAC address of the client. Required.
- organizationId String
- organizationId path parameter. Organization ID
- endingBefore String
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- perPage Integer
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- startingAfter String
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- mac string
- mac query parameter. The MAC address of the client. Required.
- organizationId string
- organizationId path parameter. Organization ID
- endingBefore string
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- perPage number
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- startingAfter string
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- mac str
- mac query parameter. The MAC address of the client. Required.
- organization_id str
- organizationId path parameter. Organization ID
- ending_before str
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- per_page int
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- starting_after str
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- mac String
- mac query parameter. The MAC address of the client. Required.
- organizationId String
- organizationId path parameter. Organization ID
- endingBefore String
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- perPage Number
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- startingAfter String
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
getClientsSearch Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Item
GetClients Search Item 
- Mac string
- mac query parameter. The MAC address of the client. Required.
- OrganizationId string
- organizationId path parameter. Organization ID
- EndingBefore string
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- PerPage int
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- StartingAfter string
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- Id string
- The provider-assigned unique ID for this managed resource.
- Item
GetClients Search Item 
- Mac string
- mac query parameter. The MAC address of the client. Required.
- OrganizationId string
- organizationId path parameter. Organization ID
- EndingBefore string
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- PerPage int
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- StartingAfter string
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- id String
- The provider-assigned unique ID for this managed resource.
- item
GetClients Search Item 
- mac String
- mac query parameter. The MAC address of the client. Required.
- organizationId String
- organizationId path parameter. Organization ID
- endingBefore String
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- perPage Integer
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- startingAfter String
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- id string
- The provider-assigned unique ID for this managed resource.
- item
GetClients Search Item 
- mac string
- mac query parameter. The MAC address of the client. Required.
- organizationId string
- organizationId path parameter. Organization ID
- endingBefore string
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- perPage number
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- startingAfter string
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- id str
- The provider-assigned unique ID for this managed resource.
- item
GetClients Search Item 
- mac str
- mac query parameter. The MAC address of the client. Required.
- organization_id str
- organizationId path parameter. Organization ID
- ending_before str
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- per_page int
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- starting_after str
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- id String
- The provider-assigned unique ID for this managed resource.
- item Property Map
- mac String
- mac query parameter. The MAC address of the client. Required.
- organizationId String
- organizationId path parameter. Organization ID
- endingBefore String
- endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
- perPage Number
- perPage query parameter. The number of entries per page returned. Acceptable range is 3 5. Default is 5.
- startingAfter String
- startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
Supporting Types
GetClientsSearchItem   
- ClientId string
- Mac string
- Manufacturer string
- Records
List<GetClients Search Item Record> 
- ClientId string
- Mac string
- Manufacturer string
- Records
[]GetClients Search Item Record 
- clientId String
- mac String
- manufacturer String
- records
List<GetClients Search Item Record> 
- clientId string
- mac string
- manufacturer string
- records
GetClients Search Item Record[] 
- clientId String
- mac String
- manufacturer String
- records List<Property Map>
GetClientsSearchItemRecord    
- Cdp string
- ClientVpn List<GetConnections Clients Search Item Record Client Vpn Connection> 
- Description string
- FirstSeen int
- Ip string
- Ip6 string
- LastSeen int
- Lldps List<string>
- Network
GetClients Search Item Record Network 
- Os string
- SmInstalled bool
- Ssid string
- Status string
- Switchport string
- User string
- Vlan string
- WirelessCapabilities string
- Cdp string
- ClientVpn []GetConnections Clients Search Item Record Client Vpn Connection 
- Description string
- FirstSeen int
- Ip string
- Ip6 string
- LastSeen int
- Lldps []string
- Network
GetClients Search Item Record Network 
- Os string
- SmInstalled bool
- Ssid string
- Status string
- Switchport string
- User string
- Vlan string
- WirelessCapabilities string
- cdp String
- clientVpn List<GetConnections Clients Search Item Record Client Vpn Connection> 
- description String
- firstSeen Integer
- ip String
- ip6 String
- lastSeen Integer
- lldps List<String>
- network
GetClients Search Item Record Network 
- os String
- smInstalled Boolean
- ssid String
- status String
- switchport String
- user String
- vlan String
- wirelessCapabilities String
- cdp string
- clientVpn GetConnections Clients Search Item Record Client Vpn Connection[] 
- description string
- firstSeen number
- ip string
- ip6 string
- lastSeen number
- lldps string[]
- network
GetClients Search Item Record Network 
- os string
- smInstalled boolean
- ssid string
- status string
- switchport string
- user string
- vlan string
- wirelessCapabilities string
- cdp str
- client_vpn_ Sequence[Getconnections Clients Search Item Record Client Vpn Connection] 
- description str
- first_seen int
- ip str
- ip6 str
- last_seen int
- lldps Sequence[str]
- network
GetClients Search Item Record Network 
- os str
- sm_installed bool
- ssid str
- status str
- switchport str
- user str
- vlan str
- wireless_capabilities str
- cdp String
- clientVpn List<Property Map>Connections 
- description String
- firstSeen Number
- ip String
- ip6 String
- lastSeen Number
- lldps List<String>
- network Property Map
- os String
- smInstalled Boolean
- ssid String
- status String
- switchport String
- user String
- vlan String
- wirelessCapabilities String
GetClientsSearchItemRecordClientVpnConnection       
- ConnectedAt int
- DisconnectedAt int
- RemoteIp string
- ConnectedAt int
- DisconnectedAt int
- RemoteIp string
- connectedAt Integer
- disconnectedAt Integer
- remoteIp String
- connectedAt number
- disconnectedAt number
- remoteIp string
- connected_at int
- disconnected_at int
- remote_ip str
- connectedAt Number
- disconnectedAt Number
- remoteIp String
GetClientsSearchItemRecordNetwork     
- EnrollmentString string
- Id string
- IsBound boolTo Config Template 
- Name string
- Notes string
- OrganizationId string
- ProductTypes List<string>
- List<string>
- TimeZone string
- EnrollmentString string
- Id string
- IsBound boolTo Config Template 
- Name string
- Notes string
- OrganizationId string
- ProductTypes []string
- []string
- TimeZone string
- enrollmentString String
- id String
- isBound BooleanTo Config Template 
- name String
- notes String
- organizationId String
- productTypes List<String>
- List<String>
- timeZone String
- enrollmentString string
- id string
- isBound booleanTo Config Template 
- name string
- notes string
- organizationId string
- productTypes string[]
- string[]
- timeZone string
- enrollment_string str
- id str
- is_bound_ boolto_ config_ template 
- name str
- notes str
- organization_id str
- product_types Sequence[str]
- Sequence[str]
- time_zone str
- enrollmentString String
- id String
- isBound BooleanTo Config Template 
- name String
- notes String
- organizationId String
- productTypes List<String>
- List<String>
- timeZone String
Package Details
- Repository
- meraki pulumi/pulumi-meraki
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the merakiTerraform Provider.
 
