Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.CloudControl.ListResources

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns information about the specified resources. For more information, see Discovering resources in the Amazon Web Services Cloud Control API User Guide.

You can use this action to return information about existing resources in your account and Amazon Web Services Region, whether those resources were provisioned using Cloud Control API.

This operation returns paginated results.

Synopsis

data ListResources = ListResources' {
- maxResults :: Maybe Natural
- nextToken :: Maybe Text
- resourceModel :: Maybe (Sensitive Text)
- roleArn :: Maybe Text
- typeVersionId :: Maybe Text
- typeName :: Text
}
newListResources :: Text -> ListResources
listResources_maxResults :: Lens' ListResources (Maybe Natural)
listResources_nextToken :: Lens' ListResources (Maybe Text)
listResources_resourceModel :: Lens' ListResources (Maybe Text)
listResources_roleArn :: Lens' ListResources (Maybe Text)
listResources_typeVersionId :: Lens' ListResources (Maybe Text)
listResources_typeName :: Lens' ListResources Text
data ListResourcesResponse = ListResourcesResponse' {
- nextToken :: Maybe Text
- resourceDescriptions :: Maybe [ResourceDescription]
- typeName :: Maybe Text
- httpStatus :: Int
}
newListResourcesResponse :: Int -> ListResourcesResponse
listResourcesResponse_nextToken :: Lens' ListResourcesResponse (Maybe Text)
listResourcesResponse_resourceDescriptions :: Lens' ListResourcesResponse (Maybe [ResourceDescription])
listResourcesResponse_typeName :: Lens' ListResourcesResponse (Maybe Text)
listResourcesResponse_httpStatus :: Lens' ListResourcesResponse Int

Creating a Request

data ListResources Source #

See: newListResources smart constructor.

Constructors

ListResources'

Fields

maxResults :: Maybe Natural
Reserved.
nextToken :: Maybe Text
If the previous paginated request didn't return all of the remaining results, the response object's NextToken parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
resourceModel :: Maybe (Sensitive Text)
The resource model to use to select the resources to return.
roleArn :: Maybe Text
The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.
If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.
For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.
typeVersionId :: Maybe Text
For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.
typeName :: Text
The name of the resource type.

Instances

Instances details

ToJSON ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods toJSON :: ListResources -> Value # toEncoding :: ListResources -> Encoding # toJSONList :: [ListResources] -> Value # toEncodingList :: [ListResources] -> Encoding #
ToHeaders ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods toHeaders :: ListResources -> [Header] #
ToPath ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods toPath :: ListResources -> ByteString #
ToQuery ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods toQuery :: ListResources -> QueryString #
AWSPager ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods page :: ListResources -> AWSResponse ListResources -> Maybe ListResources #
AWSRequest ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Associated Types type AWSResponse ListResources # Methods request :: (Service -> Service) -> ListResources -> Request ListResources # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy ListResources -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse ListResources))) #
Generic ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Associated Types type Rep ListResources :: Type -> Type # Methods from :: ListResources -> Rep ListResources x # to :: Rep ListResources x -> ListResources #
Show ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods showsPrec :: Int -> ListResources -> ShowS # show :: ListResources -> String # showList :: [ListResources] -> ShowS #
NFData ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods rnf :: ListResources -> () #
Eq ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods (==) :: ListResources -> ListResources -> Bool # (/=) :: ListResources -> ListResources -> Bool #
Hashable ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods hashWithSalt :: Int -> ListResources -> Int # hash :: ListResources -> Int #
type AWSResponse ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources type AWSResponse ListResources = ListResourcesResponse
type Rep ListResources Source #
Instance details Defined in Amazonka.CloudControl.ListResources type Rep ListResources = D1 ('MetaData "ListResources" "Amazonka.CloudControl.ListResources" "amazonka-cloudcontrol-2.0-J9DMMWxCmrC2c0fQs7XDnF" 'False) (C1 ('MetaCons "ListResources'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "resourceModel") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (Sensitive Text))))) :: (S1 ('MetaSel ('Just "roleArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "typeVersionId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "typeName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newListResources Source #

Arguments

:: Text	`ListResources`
-> ListResources

Create a value of ListResources 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:maxResults:ListResources', listResources_maxResults - Reserved.

ListResources, listResources_nextToken - If the previous paginated request didn't return all of the remaining results, the response object's NextToken parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

ListResources, listResources_resourceModel - The resource model to use to select the resources to return.

$sel:roleArn:ListResources', listResources_roleArn - The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.

If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.

For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.

$sel:typeVersionId:ListResources', listResources_typeVersionId - For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.

ListResources, listResources_typeName - The name of the resource type.

Request Lenses

listResources_maxResults :: Lens' ListResources (Maybe Natural) Source #

Reserved.

listResources_nextToken :: Lens' ListResources (Maybe Text) Source #

If the previous paginated request didn't return all of the remaining results, the response object's NextToken parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

listResources_resourceModel :: Lens' ListResources (Maybe Text) Source #

The resource model to use to select the resources to return.

listResources_roleArn :: Lens' ListResources (Maybe Text) Source #

The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.

If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.

For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.

listResources_typeVersionId :: Lens' ListResources (Maybe Text) Source #

For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.

listResources_typeName :: Lens' ListResources Text Source #

The name of the resource type.

Destructuring the Response

data ListResourcesResponse Source #

See: newListResourcesResponse smart constructor.

Constructors

ListResourcesResponse'

Fields

nextToken :: Maybe Text
If the request doesn't return all of the remaining results, NextToken is set to a token. To retrieve the next set of results, call ListResources again and assign that token to the request object's NextToken parameter. If the request returns all results, NextToken is set to null.
resourceDescriptions :: Maybe [ResourceDescription]
Information about the specified resources, including primary identifier and resource model.
typeName :: Maybe Text
The name of the resource type.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Generic ListResourcesResponse Source #
Instance details Defined in Amazonka.CloudControl.ListResources Associated Types type Rep ListResourcesResponse :: Type -> Type # Methods from :: ListResourcesResponse -> Rep ListResourcesResponse x # to :: Rep ListResourcesResponse x -> ListResourcesResponse #
Show ListResourcesResponse Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods showsPrec :: Int -> ListResourcesResponse -> ShowS # show :: ListResourcesResponse -> String # showList :: [ListResourcesResponse] -> ShowS #
NFData ListResourcesResponse Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods rnf :: ListResourcesResponse -> () #
Eq ListResourcesResponse Source #
Instance details Defined in Amazonka.CloudControl.ListResources Methods (==) :: ListResourcesResponse -> ListResourcesResponse -> Bool # (/=) :: ListResourcesResponse -> ListResourcesResponse -> Bool #
type Rep ListResourcesResponse Source #
Instance details Defined in Amazonka.CloudControl.ListResources type Rep ListResourcesResponse = D1 ('MetaData "ListResourcesResponse" "Amazonka.CloudControl.ListResources" "amazonka-cloudcontrol-2.0-J9DMMWxCmrC2c0fQs7XDnF" 'False) (C1 ('MetaCons "ListResourcesResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "resourceDescriptions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ResourceDescription]))) :: (S1 ('MetaSel ('Just "typeName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListResourcesResponse Source #

Arguments

:: Int	`$sel:httpStatus:ListResourcesResponse'`
-> ListResourcesResponse

Create a value of ListResourcesResponse 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:

ListResources, listResourcesResponse_nextToken - If the request doesn't return all of the remaining results, NextToken is set to a token. To retrieve the next set of results, call ListResources again and assign that token to the request object's NextToken parameter. If the request returns all results, NextToken is set to null.

$sel:resourceDescriptions:ListResourcesResponse', listResourcesResponse_resourceDescriptions - Information about the specified resources, including primary identifier and resource model.

ListResources, listResourcesResponse_typeName - The name of the resource type.

$sel:httpStatus:ListResourcesResponse', listResourcesResponse_httpStatus - The response's http status code.

Response Lenses

listResourcesResponse_nextToken :: Lens' ListResourcesResponse (Maybe Text) Source #

If the request doesn't return all of the remaining results, NextToken is set to a token. To retrieve the next set of results, call ListResources again and assign that token to the request object's NextToken parameter. If the request returns all results, NextToken is set to null.

listResourcesResponse_resourceDescriptions :: Lens' ListResourcesResponse (Maybe [ResourceDescription]) Source #

Information about the specified resources, including primary identifier and resource model.

listResourcesResponse_typeName :: Lens' ListResourcesResponse (Maybe Text) Source #

The name of the resource type.

listResourcesResponse_httpStatus :: Lens' ListResourcesResponse Int Source #

The response's http status code.