Skip to main content

"listOutputs"

Abstract

listOutputs obtains a list of the names of previously created outputs.

The "listOutputs" action obtains a list of the names of previously created outputs.

Things to know

  • You can return a filtered list by specifying a partial name in the "partialName" property.

  • You can include additional items in the list by searching for words contained in the item’s metadata.

  • Use "describeOutputs" to get detailed information about specific outputs.

Request examples

Minimal request example

{
  "api":        "hub",
  "apiVersion": "1.0",
  "action":     "listOutputs",
  "requestId":  "00000001",
  "authToken":  "anAuthorizationTokenFromTheServer",
  "params":     { }
}

Maximal request example

{
  "api":        "hub",
  "apiVersion": "1.0",
  "action":     "listOutputs",
  "requestId":  "00000001",
  "authToken":  "anAuthorizationTokenFromTheServer",
  "params":     {
    "partialName": ""
  }
}

Response examples

Minimal response example

{
    "result": {
        "data": []
    },
    "requestId": "00000055",
    "errorCode": 0,
    "errorMessage": ""
}

Maximal response example

{
    "result": {
        "data": []
    },
    "requestId": "00000056",
    "errorCode": 0,
    "errorMessage": ""
}

"params"

The "params" property is an object that contains an action's parameters. Each action defines its own required and optional properties.

Property summary

Table 1. "params" property summaries

Property

Description

Default

Type

Limits (inclusive)

"partialName"

filters the returned topics by applying partial matches to their names

""

string

Minimum length: 0
Maximum length: 64


"result"

Property summary

Table 2. "result" property summaries

Property

Description

Type

Limits (inclusive)

"data"

contains an array or object that the server returns, such as records returned by a query

Note

It is an empty array when there are no results available.

array

Its contents are determined by the action