amazonka-config-1.3.3.1: Amazon Config SDK.

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

Network.AWS.Config.ListDiscoveredResources

Contents

Description

Accepts a resource type and returns a list of resource identifiers for the resources of that type. A resource identifier includes the resource type, ID, and (if available) the custom resource name. The results consist of resources that AWS Config has discovered, including those that AWS Config is not currently recording. You can narrow the results to include only resources that have specific resource IDs or a resource name.

You can specify either resource IDs or a resource name but not both in the same request.

The response is paginated, and by default AWS Config lists 100 resource identifiers on each page. You can customize this number with the limit parameter. The response includes a nextToken string, and to get the next page of results, run the request again and enter this string for the nextToken parameter.

See: AWS API Reference for ListDiscoveredResources.

Synopsis

Creating a Request

listDiscoveredResources Source

Creates a value of ListDiscoveredResources with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

ldrResourceIds :: Lens' ListDiscoveredResources [Text] Source

The IDs of only those resources that you want AWS Config to list in the response. If you do not specify this parameter, AWS Config lists all resources of the specified type that it has discovered.

ldrResourceName :: Lens' ListDiscoveredResources (Maybe Text) Source

The custom name of only those resources that you want AWS Config to list in the response. If you do not specify this parameter, AWS Config lists all resources of the specified type that it has discovered.

ldrIncludeDeletedResources :: Lens' ListDiscoveredResources (Maybe Bool) Source

Specifies whether AWS Config includes deleted resources in the results. By default, deleted resources are not included.

ldrNextToken :: Lens' ListDiscoveredResources (Maybe Text) Source

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

ldrLimit :: Lens' ListDiscoveredResources (Maybe Natural) Source

The maximum number of resource identifiers returned on each page. The default is 100. You cannot specify a limit greater than 100. If you specify 0, AWS Config uses the default.

ldrResourceType :: Lens' ListDiscoveredResources ResourceType Source

The type of resources that you want AWS Config to list in the response.

Destructuring the Response

listDiscoveredResourcesResponse Source

Creates a value of ListDiscoveredResourcesResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

ldrrsNextToken :: Lens' ListDiscoveredResourcesResponse (Maybe Text) Source

The string that you use in a subsequent request to get the next page of results in a paginated response.

ldrrsResourceIdentifiers :: Lens' ListDiscoveredResourcesResponse [ResourceIdentifier] Source

The details that identify a resource that is discovered by AWS Config, including the resource type, ID, and (if available) the custom resource name.