Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.ECS.ListServices

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns a list of services. You can filter the results by cluster, launch type, and scheduling strategy.

This operation returns paginated results.

Synopsis

data ListServices = ListServices' {
- cluster :: Maybe Text
- nextToken :: Maybe Text
- launchType :: Maybe LaunchType
- schedulingStrategy :: Maybe SchedulingStrategy
- maxResults :: Maybe Int
}
newListServices :: ListServices
listServices_cluster :: Lens' ListServices (Maybe Text)
listServices_nextToken :: Lens' ListServices (Maybe Text)
listServices_launchType :: Lens' ListServices (Maybe LaunchType)
listServices_schedulingStrategy :: Lens' ListServices (Maybe SchedulingStrategy)
listServices_maxResults :: Lens' ListServices (Maybe Int)
data ListServicesResponse = ListServicesResponse' {
- serviceArns :: Maybe [Text]
- nextToken :: Maybe Text
- httpStatus :: Int
}
newListServicesResponse :: Int -> ListServicesResponse
listServicesResponse_serviceArns :: Lens' ListServicesResponse (Maybe [Text])
listServicesResponse_nextToken :: Lens' ListServicesResponse (Maybe Text)
listServicesResponse_httpStatus :: Lens' ListServicesResponse Int

Creating a Request

data ListServices Source #

See: newListServices smart constructor.

Constructors

ListServices'

Fields

cluster :: Maybe Text
The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the ListServices results. If you do not specify a cluster, the default cluster is assumed.
nextToken :: Maybe Text
The nextToken value returned from a ListServices request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.
This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.
launchType :: Maybe LaunchType
The launch type to use when filtering the ListServices results.
schedulingStrategy :: Maybe SchedulingStrategy
The scheduling strategy to use when filtering the ListServices results.
maxResults :: Maybe Int
The maximum number of service results returned by ListServices in paginated output. When this parameter is used, ListServices only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListServices request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListServices returns up to 10 results and a nextToken value if applicable.

Instances

Instances details

Eq ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods (==) :: ListServices -> ListServices -> Bool # (/=) :: ListServices -> ListServices -> Bool #
Read ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods readsPrec :: Int -> ReadS ListServices # readList :: ReadS [ListServices] # readPrec :: ReadPrec ListServices # readListPrec :: ReadPrec [ListServices] #
Show ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods showsPrec :: Int -> ListServices -> ShowS # show :: ListServices -> String # showList :: [ListServices] -> ShowS #
Generic ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Associated Types type Rep ListServices :: Type -> Type # Methods from :: ListServices -> Rep ListServices x # to :: Rep ListServices x -> ListServices #
NFData ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods rnf :: ListServices -> () #
Hashable ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods hashWithSalt :: Int -> ListServices -> Int # hash :: ListServices -> Int #
ToJSON ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods toJSON :: ListServices -> Value # toEncoding :: ListServices -> Encoding # toJSONList :: [ListServices] -> Value # toEncodingList :: [ListServices] -> Encoding #
AWSPager ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods page :: ListServices -> AWSResponse ListServices -> Maybe ListServices #
AWSRequest ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Associated Types type AWSResponse ListServices # Methods request :: ListServices -> Request ListServices # response :: MonadResource m => Logger -> Service -> Proxy ListServices -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse ListServices))) #
ToHeaders ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods toHeaders :: ListServices -> [Header] #
ToPath ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods toPath :: ListServices -> ByteString #
ToQuery ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices Methods toQuery :: ListServices -> QueryString #
type Rep ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices type Rep ListServices = D1 ('MetaData "ListServices" "Amazonka.ECS.ListServices" "libZSservicesZSamazonka-ecsZSamazonka-ecs" 'False) (C1 ('MetaCons "ListServices'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "cluster") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "launchType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe LaunchType)) :: (S1 ('MetaSel ('Just "schedulingStrategy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SchedulingStrategy)) :: S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int))))))
type AWSResponse ListServices Source #
Instance details Defined in Amazonka.ECS.ListServices type AWSResponse ListServices = ListServicesResponse

newListServices :: ListServices Source #

Create a value of ListServices 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:cluster:ListServices', listServices_cluster - The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the ListServices results. If you do not specify a cluster, the default cluster is assumed.

$sel:nextToken:ListServices', listServices_nextToken - The nextToken value returned from a ListServices request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

$sel:launchType:ListServices', listServices_launchType - The launch type to use when filtering the ListServices results.

$sel:schedulingStrategy:ListServices', listServices_schedulingStrategy - The scheduling strategy to use when filtering the ListServices results.

$sel:maxResults:ListServices', listServices_maxResults - The maximum number of service results returned by ListServices in paginated output. When this parameter is used, ListServices only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListServices request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListServices returns up to 10 results and a nextToken value if applicable.

Request Lenses

listServices_cluster :: Lens' ListServices (Maybe Text) Source #

The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the ListServices results. If you do not specify a cluster, the default cluster is assumed.

listServices_nextToken :: Lens' ListServices (Maybe Text) Source #

The nextToken value returned from a ListServices request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

listServices_launchType :: Lens' ListServices (Maybe LaunchType) Source #

The launch type to use when filtering the ListServices results.

listServices_schedulingStrategy :: Lens' ListServices (Maybe SchedulingStrategy) Source #

The scheduling strategy to use when filtering the ListServices results.

listServices_maxResults :: Lens' ListServices (Maybe Int) Source #

The maximum number of service results returned by ListServices in paginated output. When this parameter is used, ListServices only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListServices request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListServices returns up to 10 results and a nextToken value if applicable.

Destructuring the Response

data ListServicesResponse Source #

See: newListServicesResponse smart constructor.

Constructors

ListServicesResponse'

Fields

serviceArns :: Maybe [Text]
The list of full ARN entries for each service associated with the specified cluster.
nextToken :: Maybe Text
The nextToken value to include in a future ListServices request. When the results of a ListServices request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Eq ListServicesResponse Source #
Instance details Defined in Amazonka.ECS.ListServices Methods (==) :: ListServicesResponse -> ListServicesResponse -> Bool # (/=) :: ListServicesResponse -> ListServicesResponse -> Bool #
Read ListServicesResponse Source #
Instance details Defined in Amazonka.ECS.ListServices Methods readsPrec :: Int -> ReadS ListServicesResponse # readList :: ReadS [ListServicesResponse] # readPrec :: ReadPrec ListServicesResponse # readListPrec :: ReadPrec [ListServicesResponse] #
Show ListServicesResponse Source #
Instance details Defined in Amazonka.ECS.ListServices Methods showsPrec :: Int -> ListServicesResponse -> ShowS # show :: ListServicesResponse -> String # showList :: [ListServicesResponse] -> ShowS #
Generic ListServicesResponse Source #
Instance details Defined in Amazonka.ECS.ListServices Associated Types type Rep ListServicesResponse :: Type -> Type # Methods from :: ListServicesResponse -> Rep ListServicesResponse x # to :: Rep ListServicesResponse x -> ListServicesResponse #
NFData ListServicesResponse Source #
Instance details Defined in Amazonka.ECS.ListServices Methods rnf :: ListServicesResponse -> () #
type Rep ListServicesResponse Source #
Instance details Defined in Amazonka.ECS.ListServices type Rep ListServicesResponse = D1 ('MetaData "ListServicesResponse" "Amazonka.ECS.ListServices" "libZSservicesZSamazonka-ecsZSamazonka-ecs" 'False) (C1 ('MetaCons "ListServicesResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "serviceArns") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListServicesResponse Source #

Arguments

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

Create a value of ListServicesResponse 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:serviceArns:ListServicesResponse', listServicesResponse_serviceArns - The list of full ARN entries for each service associated with the specified cluster.

$sel:nextToken:ListServices', listServicesResponse_nextToken - The nextToken value to include in a future ListServices request. When the results of a ListServices request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

$sel:httpStatus:ListServicesResponse', listServicesResponse_httpStatus - The response's http status code.

Response Lenses

listServicesResponse_serviceArns :: Lens' ListServicesResponse (Maybe [Text]) Source #

The list of full ARN entries for each service associated with the specified cluster.

listServicesResponse_nextToken :: Lens' ListServicesResponse (Maybe Text) Source #

The nextToken value to include in a future ListServices request. When the results of a ListServices request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

listServicesResponse_httpStatus :: Lens' ListServicesResponse Int Source #

The response's http status code.