IBM InfoSphere Streams Version 4.1.1
Instance hosts
This collection resource provides access to information about the InfoSphere® Streams resources for a specific instance.
Universal Resource Identifier (URI) pattern
https://server:port/streams/rest/instances/{restid}/hosts
Properties
This collection resource has
the following properties:
- hosts
- An array of host objects. For more information about the properties for each host object, see Instance host.
- next
- A string that represents the URI for the next page in the list. This property is not present if the list is not paged or if the current page is the last page.
- previous
- A string that represents the URI for the previous page in the list. This property is not present if the list is not paged or if the current page is the first page.
- resourceType
- A string that represents the REST resource type: hostList.
- total
- A number that represents the total number of objects in the list. If the list is filtered, the total corresponds to the total number of items that match the filter parameters.
Resource retrieval
You can use the following HTTP methods and query parameters to retrieve this resource:
- HTTP methods
- GET
- Query parameters
- This collection resource supports the standard query
parameters for collection resources. The following query parameter
is also supported for the collection resource:
- job.restid
- This parameter specifies the value of the restid property
for a job resource. For more information about job resources, see Job. If this
parameter is used, the list is limited to the InfoSphere Streams resources for
the job that you specify. For example:
https://server1:8443/streams/rest/instances/StreamsInstance/hosts?job.restid=123