libZSservicesZSamazonka-iotsitewiseZSamazonka-iotsitewise
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.IoTSiteWise.ListAssets

Description

Retrieves a paginated list of asset summaries.

You can use this operation to do the following:

  • List assets based on a specific asset model.
  • List top-level assets.

You can't use this operation to list all assets. To retrieve summaries for all of your assets, use ListAssetModels to get all of your asset model IDs. Then, use ListAssets to get all assets for each asset model.

This operation returns paginated results.

Synopsis

Creating a Request

data ListAssets Source #

See: newListAssets smart constructor.

Constructors

ListAssets' 

Fields

  • assetModelId :: Maybe Text

    The ID of the asset model by which to filter the list of assets. This parameter is required if you choose ALL for filter.

  • nextToken :: Maybe Text

    The token to be used for the next set of paginated results.

  • filter' :: Maybe ListAssetsFilter

    The filter for the requested list of assets. Choose one of the following options:

    • ALL – The list includes all assets for a given asset model ID. The assetModelId parameter is required if you filter by ALL.
    • TOP_LEVEL – The list includes only top-level assets in the asset hierarchy tree.

    Default: ALL

  • maxResults :: Maybe Natural

    The maximum number of results to return for each paginated request.

    Default: 50

Instances

Instances details
Eq ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Read ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Show ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Generic ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Associated Types

type Rep ListAssets :: Type -> Type #

NFData ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Methods

rnf :: ListAssets -> () #

Hashable ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

AWSPager ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

AWSRequest ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Associated Types

type AWSResponse ListAssets #

ToHeaders ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Methods

toHeaders :: ListAssets -> [Header] #

ToPath ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

ToQuery ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

type Rep ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

type Rep ListAssets = D1 ('MetaData "ListAssets" "Amazonka.IoTSiteWise.ListAssets" "libZSservicesZSamazonka-iotsitewiseZSamazonka-iotsitewise" 'False) (C1 ('MetaCons "ListAssets'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "assetModelId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "filter'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ListAssetsFilter)) :*: S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)))))
type AWSResponse ListAssets Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

newListAssets :: ListAssets Source #

Create a value of ListAssets with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:assetModelId:ListAssets', listAssets_assetModelId - The ID of the asset model by which to filter the list of assets. This parameter is required if you choose ALL for filter.

$sel:nextToken:ListAssets', listAssets_nextToken - The token to be used for the next set of paginated results.

$sel:filter':ListAssets', listAssets_filter - The filter for the requested list of assets. Choose one of the following options:

  • ALL – The list includes all assets for a given asset model ID. The assetModelId parameter is required if you filter by ALL.
  • TOP_LEVEL – The list includes only top-level assets in the asset hierarchy tree.

Default: ALL

$sel:maxResults:ListAssets', listAssets_maxResults - The maximum number of results to return for each paginated request.

Default: 50

Request Lenses

listAssets_assetModelId :: Lens' ListAssets (Maybe Text) Source #

The ID of the asset model by which to filter the list of assets. This parameter is required if you choose ALL for filter.

listAssets_nextToken :: Lens' ListAssets (Maybe Text) Source #

The token to be used for the next set of paginated results.

listAssets_filter :: Lens' ListAssets (Maybe ListAssetsFilter) Source #

The filter for the requested list of assets. Choose one of the following options:

  • ALL – The list includes all assets for a given asset model ID. The assetModelId parameter is required if you filter by ALL.
  • TOP_LEVEL – The list includes only top-level assets in the asset hierarchy tree.

Default: ALL

listAssets_maxResults :: Lens' ListAssets (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

Destructuring the Response

data ListAssetsResponse Source #

See: newListAssetsResponse smart constructor.

Constructors

ListAssetsResponse' 

Fields

Instances

Instances details
Eq ListAssetsResponse Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Read ListAssetsResponse Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Show ListAssetsResponse Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Generic ListAssetsResponse Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Associated Types

type Rep ListAssetsResponse :: Type -> Type #

NFData ListAssetsResponse Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

Methods

rnf :: ListAssetsResponse -> () #

type Rep ListAssetsResponse Source # 
Instance details

Defined in Amazonka.IoTSiteWise.ListAssets

type Rep ListAssetsResponse = D1 ('MetaData "ListAssetsResponse" "Amazonka.IoTSiteWise.ListAssets" "libZSservicesZSamazonka-iotsitewiseZSamazonka-iotsitewise" 'False) (C1 ('MetaCons "ListAssetsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "assetSummaries") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [AssetSummary]))))

newListAssetsResponse Source #

Create a value of ListAssetsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:nextToken:ListAssets', listAssetsResponse_nextToken - The token for the next set of results, or null if there are no additional results.

$sel:httpStatus:ListAssetsResponse', listAssetsResponse_httpStatus - The response's http status code.

$sel:assetSummaries:ListAssetsResponse', listAssetsResponse_assetSummaries - A list that summarizes each asset.

Response Lenses

listAssetsResponse_nextToken :: Lens' ListAssetsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.