amazonka-ecr-1.4.5: Amazon EC2 Container Registry SDK.

Copyright(c) 2013-2016 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.ECR.DescribeImages

Contents

Description

Returns metadata about the images in a repository, including image size and creation date.

This operation returns paginated results.

Synopsis

Creating a Request

describeImages Source #

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

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

  • diRegistryId - The AWS account ID associated with the registry that contains the repository in which to list images. If you do not specify a registry, the default registry is assumed.
  • diImageIds - The list of image IDs for the requested repository.
  • diNextToken - The nextToken value returned from a previous paginated DescribeImages request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.
  • diFilter - The filter key and value with which to filter your DescribeImages results.
  • diMaxResults - The maximum number of repository results returned by DescribeImages in paginated output. When this parameter is used, DescribeImages 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 DescribeImages request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then DescribeImages returns up to 100 results and a nextToken value, if applicable.
  • diRepositoryName - A list of repositories to describe. If this parameter is omitted, then all repositories in a registry are described.

data DescribeImages Source #

See: describeImages smart constructor.

Instances

Eq DescribeImages Source # 
Data DescribeImages Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeImages -> c DescribeImages #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeImages #

toConstr :: DescribeImages -> Constr #

dataTypeOf :: DescribeImages -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribeImages) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeImages) #

gmapT :: (forall b. Data b => b -> b) -> DescribeImages -> DescribeImages #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeImages -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeImages -> r #

gmapQ :: (forall d. Data d => d -> u) -> DescribeImages -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeImages -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeImages -> m DescribeImages #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeImages -> m DescribeImages #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeImages -> m DescribeImages #

Read DescribeImages Source # 
Show DescribeImages Source # 
Generic DescribeImages Source # 

Associated Types

type Rep DescribeImages :: * -> * #

Hashable DescribeImages Source # 
ToJSON DescribeImages Source # 
NFData DescribeImages Source # 

Methods

rnf :: DescribeImages -> () #

AWSPager DescribeImages Source # 
AWSRequest DescribeImages Source # 
ToPath DescribeImages Source # 
ToHeaders DescribeImages Source # 
ToQuery DescribeImages Source # 
type Rep DescribeImages Source # 
type Rs DescribeImages Source # 

Request Lenses

diRegistryId :: Lens' DescribeImages (Maybe Text) Source #

The AWS account ID associated with the registry that contains the repository in which to list images. If you do not specify a registry, the default registry is assumed.

diImageIds :: Lens' DescribeImages [ImageIdentifier] Source #

The list of image IDs for the requested repository.

diNextToken :: Lens' DescribeImages (Maybe Text) Source #

The nextToken value returned from a previous paginated DescribeImages request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

diFilter :: Lens' DescribeImages (Maybe DescribeImagesFilter) Source #

The filter key and value with which to filter your DescribeImages results.

diMaxResults :: Lens' DescribeImages (Maybe Natural) Source #

The maximum number of repository results returned by DescribeImages in paginated output. When this parameter is used, DescribeImages 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 DescribeImages request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then DescribeImages returns up to 100 results and a nextToken value, if applicable.

diRepositoryName :: Lens' DescribeImages Text Source #

A list of repositories to describe. If this parameter is omitted, then all repositories in a registry are described.

Destructuring the Response

describeImagesResponse Source #

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

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

  • dirsImageDetails - A list of ImageDetail objects that contain data about the image.
  • dirsNextToken - The nextToken value to include in a future DescribeImages request. When the results of a DescribeImages 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.
  • dirsResponseStatus - -- | The response status code.

data DescribeImagesResponse Source #

See: describeImagesResponse smart constructor.

Instances

Eq DescribeImagesResponse Source # 
Data DescribeImagesResponse Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeImagesResponse -> c DescribeImagesResponse #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeImagesResponse #

toConstr :: DescribeImagesResponse -> Constr #

dataTypeOf :: DescribeImagesResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribeImagesResponse) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeImagesResponse) #

gmapT :: (forall b. Data b => b -> b) -> DescribeImagesResponse -> DescribeImagesResponse #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeImagesResponse -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeImagesResponse -> r #

gmapQ :: (forall d. Data d => d -> u) -> DescribeImagesResponse -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeImagesResponse -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeImagesResponse -> m DescribeImagesResponse #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeImagesResponse -> m DescribeImagesResponse #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeImagesResponse -> m DescribeImagesResponse #

Read DescribeImagesResponse Source # 
Show DescribeImagesResponse Source # 
Generic DescribeImagesResponse Source # 
NFData DescribeImagesResponse Source # 

Methods

rnf :: DescribeImagesResponse -> () #

type Rep DescribeImagesResponse Source # 
type Rep DescribeImagesResponse = D1 (MetaData "DescribeImagesResponse" "Network.AWS.ECR.DescribeImages" "amazonka-ecr-1.4.5-CCdpOETgEgK6cFz60uVoIg" False) (C1 (MetaCons "DescribeImagesResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_dirsImageDetails") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [ImageDetail]))) ((:*:) (S1 (MetaSel (Just Symbol "_dirsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dirsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)))))

Response Lenses

dirsImageDetails :: Lens' DescribeImagesResponse [ImageDetail] Source #

A list of ImageDetail objects that contain data about the image.

dirsNextToken :: Lens' DescribeImagesResponse (Maybe Text) Source #

The nextToken value to include in a future DescribeImages request. When the results of a DescribeImages 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.

dirsResponseStatus :: Lens' DescribeImagesResponse Int Source #

  • - | The response status code.