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.
get/assets
Query parameters
nextTokenstring
The token to be used for the next set of paginated results.
maxResultsinteger
<p>The maximum number of results to return for each paginated request.</p> <p>Default: 50</p>
assetModelIdstring
The ID of the asset model by which to filter the list of assets. This parameter is required if you choose <code>ALL</code> for <code>filter</code>.
filter'ALL' | 'TOP_LEVEL'
<p>The filter for the requested list of assets. Choose one of the following options:</p> <ul> <li> <p> <code>ALL</code> – The list includes all assets for a given asset model ID. The <code>assetModelId</code> parameter is required if you filter by <code>ALL</code>.</p> </li> <li> <p> <code>TOP_LEVEL</code> – The list includes only top-level assets in the asset hierarchy tree.</p> </li> </ul> <p>Default: <code>ALL</code> </p>
Response
Success