asset_instances

Creates, updates, deletes, gets or lists an asset_instances resource.

Overview

Name	asset_instances
Type	Resource
Id	aws.outposts.asset_instances

Fields

The following fields are returned by SELECT queries:

list_asset_instances

Name	Datatype	Description
account_id	string	The ID of the Amazon Web Services account. (pattern: <code>\d{12}</code>)
asset_id	string	The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration. (pattern: <code>^(\w+)$</code>)
aws_service_name	string	The Amazon Web Services service name of the instance. (AWS, EC2, EKS, ELASTICACHE, ELB, RDS, ROUTE53)
instance_id	string	The ID of the instance. (pattern: <code>^i-[0-9a-z]+$</code>)
instance_type	string	The type of instance. (pattern: <code>[a-z0-9-.]+</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_asset_instances	select	outpost_id, region	AssetIdFilter, InstanceTypeFilter, AccountIdFilter, AwsServiceFilter, MaxResults, NextToken	A list of Amazon EC2 instances, belonging to all accounts, running on the specified Outpost. Does not include Amazon EBS or Amazon S3 instances.

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.

Name	Datatype	Description
outpost_id	string	The ID of the Outpost.
region	string	AWS region (default: us-east-1)
AccountIdFilter	array	Filters the results by account ID.
AssetIdFilter	array	Filters the results by asset ID.
AwsServiceFilter	array	Filters the results by Amazon Web Services service.
InstanceTypeFilter	array	Filters the results by instance ID.
MaxResults	integer
NextToken	string

SELECT examples

list_asset_instances

A list of Amazon EC2 instances, belonging to all accounts, running on the specified Outpost. Does not include Amazon EBS or Amazon S3 instances.

SELECT
account_id,
asset_id,
aws_service_name,
instance_id,
instance_type
FROM aws.outposts.asset_instances
WHERE outpost_id = '{{ outpost_id }}' -- required
AND region = '{{ region }}' -- required
AND AssetIdFilter = '{{ AssetIdFilter }}'
AND InstanceTypeFilter = '{{ InstanceTypeFilter }}'
AND AccountIdFilter = '{{ AccountIdFilter }}'
AND AwsServiceFilter = '{{ AwsServiceFilter }}'
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;