Network.AWS.ECR.ListImages

Lists all the image IDs for a given repository.

You can filter images based on whether or not they are tagged by setting the tagStatus parameter to TAGGED or UNTAGGED . For example, you can filter your results to return only UNTAGGED images and then pipe that result to a BatchDeleteImage operation to delete them. Or, you can filter your results to return only TAGGED images to list all of the tags in your repository.

This operation returns paginated results.

Creating a Request

listImages

Arguments

:: Text

liRepositoryName

-> ListImages

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

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

• liRegistryId - 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.
• liNextToken - The nextToken value returned from a previous paginated ListImages 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.
• liFilter - The filter key and value with which to filter your ListImages results.
• liMaxResults - The maximum number of image results returned by ListImages in paginated output. When this parameter is used, ListImages 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 ListImages request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListImages returns up to 100 results and a nextToken value, if applicable.
• liRepositoryName - The repository with image IDs to be listed.

data ListImages

See: listImages smart constructor.

Instances

Eq ListImages

Defined in Network.AWS.ECR.ListImages

Methods

(==) :: ListImages -> ListImages -> Bool

(/=) :: ListImages -> ListImages -> Bool

Data ListImages

Defined in Network.AWS.ECR.ListImages

Methods

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

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

toConstr :: ListImages -> Constr

dataTypeOf :: ListImages -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c ListImages)

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

gmapT :: (forall b. Data b => b -> b) -> ListImages -> ListImages

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

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

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

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

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

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

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

Read ListImages

Defined in Network.AWS.ECR.ListImages

Methods

readsPrec :: Int -> ReadS ListImages

readList :: ReadS [ListImages]

readPrec :: ReadPrec ListImages

readListPrec :: ReadPrec [ListImages]

Show ListImages

Defined in Network.AWS.ECR.ListImages

Methods

showsPrec :: Int -> ListImages -> ShowS

show :: ListImages -> String

showList :: [ListImages] -> ShowS

Generic ListImages

Defined in Network.AWS.ECR.ListImages

Associated Types

type Rep ListImages :: Type -> Type

Methods

from :: ListImages -> Rep ListImages x

to :: Rep ListImages x -> ListImages

Hashable ListImages

Defined in Network.AWS.ECR.ListImages

Methods

hashWithSalt :: Int -> ListImages -> Int

hash :: ListImages -> Int

ToJSON ListImages

Defined in Network.AWS.ECR.ListImages

Methods

toJSON :: ListImages -> Value

toEncoding :: ListImages -> Encoding

toJSONList :: [ListImages] -> Value

toEncodingList :: [ListImages] -> Encoding

AWSPager ListImages

Defined in Network.AWS.ECR.ListImages

Methods

page :: ListImages -> Rs ListImages -> Maybe ListImages

AWSRequest ListImages

Defined in Network.AWS.ECR.ListImages

Associated Types

type Rs ListImages :: Type

Methods

request :: ListImages -> Request ListImages

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy ListImages -> ClientResponse -> m (Response ListImages)

ToHeaders ListImages

Defined in Network.AWS.ECR.ListImages

Methods

toHeaders :: ListImages -> [Header]

ToPath ListImages

Defined in Network.AWS.ECR.ListImages

Methods

toPath :: ListImages -> ByteString

ToQuery ListImages

Defined in Network.AWS.ECR.ListImages

Methods

toQuery :: ListImages -> QueryString

NFData ListImages

Defined in Network.AWS.ECR.ListImages

Methods

rnf :: ListImages -> ()

type Rep ListImages

Defined in Network.AWS.ECR.ListImages

type Rep ListImages = D1 (MetaData "ListImages" "Network.AWS.ECR.ListImages" "amazonka-ecr-1.6.1-KW57ahBO482CZBe4C57Res" False) (C1 (MetaCons "ListImages'" PrefixI True) ((S1 (MetaSel (Just "_liRegistryId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_liNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 (MetaSel (Just "_liFilter") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ListImagesFilter)) :*: (S1 (MetaSel (Just "_liMaxResults") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat)) :*: S1 (MetaSel (Just "_liRepositoryName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))

type Rs ListImages

Defined in Network.AWS.ECR.ListImages

type Rs ListImages = ListImagesResponse

Request Lenses

liRegistryId :: Lens' ListImages (Maybe Text)

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.

liNextToken :: Lens' ListImages (Maybe Text)

The nextToken value returned from a previous paginated ListImages 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.

liFilter :: Lens' ListImages (Maybe ListImagesFilter)

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

liMaxResults :: Lens' ListImages (Maybe Natural)

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

liRepositoryName :: Lens' ListImages Text

The repository with image IDs to be listed.

Destructuring the Response

listImagesResponse

Arguments

:: Int

lirsResponseStatus

-> ListImagesResponse

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

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

• lirsImageIds - The list of image IDs for the requested repository.
• lirsNextToken - The nextToken value to include in a future ListImages request. When the results of a ListImages 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.
• lirsResponseStatus - -- | The response status code.

data ListImagesResponse

See: listImagesResponse smart constructor.

Instances

Eq ListImagesResponse

Defined in Network.AWS.ECR.ListImages

Methods

(==) :: ListImagesResponse -> ListImagesResponse -> Bool

(/=) :: ListImagesResponse -> ListImagesResponse -> Bool

Data ListImagesResponse

Defined in Network.AWS.ECR.ListImages

Methods

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

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

toConstr :: ListImagesResponse -> Constr

dataTypeOf :: ListImagesResponse -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c ListImagesResponse)

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

gmapT :: (forall b. Data b => b -> b) -> ListImagesResponse -> ListImagesResponse

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

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

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

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

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

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

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

Read ListImagesResponse

Defined in Network.AWS.ECR.ListImages

Methods

readsPrec :: Int -> ReadS ListImagesResponse

readList :: ReadS [ListImagesResponse]

readPrec :: ReadPrec ListImagesResponse

readListPrec :: ReadPrec [ListImagesResponse]

Show ListImagesResponse

Defined in Network.AWS.ECR.ListImages

Methods

showsPrec :: Int -> ListImagesResponse -> ShowS

show :: ListImagesResponse -> String

showList :: [ListImagesResponse] -> ShowS

Generic ListImagesResponse

Defined in Network.AWS.ECR.ListImages

Associated Types

type Rep ListImagesResponse :: Type -> Type

Methods

from :: ListImagesResponse -> Rep ListImagesResponse x

to :: Rep ListImagesResponse x -> ListImagesResponse

NFData ListImagesResponse

Defined in Network.AWS.ECR.ListImages

Methods

rnf :: ListImagesResponse -> ()

type Rep ListImagesResponse

Defined in Network.AWS.ECR.ListImages

type Rep ListImagesResponse = D1 (MetaData "ListImagesResponse" "Network.AWS.ECR.ListImages" "amazonka-ecr-1.6.1-KW57ahBO482CZBe4C57Res" False) (C1 (MetaCons "ListImagesResponse'" PrefixI True) (S1 (MetaSel (Just "_lirsImageIds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [ImageIdentifier])) :*: (S1 (MetaSel (Just "_lirsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_lirsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

lirsImageIds :: Lens' ListImagesResponse [ImageIdentifier]

The list of image IDs for the requested repository.

lirsNextToken :: Lens' ListImagesResponse (Maybe Text)

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

lirsResponseStatus :: Lens' ListImagesResponse Int

• - | The response status code.