Skip to content

Generates a summary of managed instance/node metadata based on the filters and aggregators you specify

Description

Generates a summary of managed instance/node metadata based on the filters and aggregators you specify. Results are grouped by the input aggregator you specify.

Usage

ssm_list_nodes_summary(SyncName, Filters, Aggregators, NextToken,
  MaxResults)

Arguments

  • SyncName

    The name of the Amazon Web Services managed resource data sync to retrieve information about.

    For cross-account/cross-Region configurations, this parameter is required, and the name of the supported resource data sync is AWS-QuickSetup-ManagedNode.

    For single account/single-Region configurations, the parameter is not required.

  • Filters

    One or more filters. Use a filter to generate a summary that matches your specified filter criteria.

  • Aggregators

    [required] Specify one or more aggregators to return a count of managed nodes that match that expression. For example, a count of managed nodes by operating system.

  • NextToken

    The token for the next set of items to return. (You received this token from a previous call.) The call also returns a token that you can specify in a subsequent call to get the next set of results.

  • MaxResults

    The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

Value

A list with the following syntax:

list(
  Summary = list(
    list(
      "string"
    )
  ),
  NextToken = "string"
)

Request syntax

svc$list_nodes_summary(
  SyncName = "string",
  Filters = list(
    list(
      Key = "AgentType"|"AgentVersion"|"ComputerName"|"InstanceId"|"InstanceStatus"|"IpAddress"|"ManagedStatus"|"PlatformName"|"PlatformType"|"PlatformVersion"|"ResourceType"|"OrganizationalUnitId"|"OrganizationalUnitPath"|"Region"|"AccountId"|"SourceType"|"SourceId"|"SourceLocation"|"AvailabilityZone"|"AvailabilityZoneId",
      Values = list(
        "string"
      ),
      Type = "Equal"|"NotEqual"|"BeginWith"
    )
  ),
  Aggregators = list(
    list(
      AggregatorType = "Count",
      TypeName = "Instance",
      AttributeName = "AgentVersion"|"PlatformName"|"PlatformType"|"PlatformVersion"|"Region"|"ResourceType"|"SourceType"|"AvailabilityZone",
      Aggregators = list()
    )
  ),
  NextToken = "string",
  MaxResults = 123
)