Skip to main content

collectors

Creates, updates, deletes, gets or lists a collectors resource.

Overview

Namecollectors
TypeResource
Idaws.migrationhubstrategy.collectors

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
collector_healthstringIndicates the health of a collector. (COLLECTOR_HEALTHY, COLLECTOR_UNHEALTHY)
collector_idstringThe ID of the collector. (pattern: <code>.\S.</code>)
collector_versionstringCurrent version of the collector that is running in the environment that you specify. (pattern: <code>.\S.</code>)
configuration_summaryobjectSummary of the collector configuration.
host_namestringHostname of the server that is hosting the collector. (pattern: <code>.\S.</code>)
ip_addressstringIP address of the server that is hosting the collector. (pattern: <code>.\S.</code>)
last_activity_time_stampstringTime when the collector last pinged the service. (pattern: <code>.\S.</code>)
registered_time_stampstringTime when the collector registered with the service. (pattern: <code>.\S.</code>)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_collectorsselectregionmaxResults, nextTokenRetrieves a list of all the installed collectors.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
maxResultsintegerThe maximum number of items to include in the response. The maximum value is 100.
nextTokenstringThe token from a previous call that you use to retrieve the next set of results. For example, if a previous call to this action returned 100 items, but you set maxResults to 10. You'll receive a set of 10 results along with a token. You then use the returned token to retrieve the next set of 10.

SELECT examples

Retrieves a list of all the installed collectors.

SELECT
collector_health,
collector_id,
collector_version,
configuration_summary,
host_name,
ip_address,
last_activity_time_stamp,
registered_time_stamp
FROM aws.migrationhubstrategy.collectors
WHERE region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;