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.ECR.DescribeImages

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns metadata about the images in a repository.

Beginning with Docker version 1.9, the Docker client compresses image layers before pushing them to a V2 Docker registry. The output of the docker images command shows the uncompressed image size, so it may return a larger image size than the image sizes returned by DescribeImages.

This operation returns paginated results.

Synopsis

data DescribeImages = DescribeImages' {
- registryId :: Maybe Text
- imageIds :: Maybe [ImageIdentifier]
- nextToken :: Maybe Text
- filter' :: Maybe DescribeImagesFilter
- maxResults :: Maybe Natural
- repositoryName :: Text
}
newDescribeImages :: Text -> DescribeImages
describeImages_registryId :: Lens' DescribeImages (Maybe Text)
describeImages_imageIds :: Lens' DescribeImages (Maybe [ImageIdentifier])
describeImages_nextToken :: Lens' DescribeImages (Maybe Text)
describeImages_filter :: Lens' DescribeImages (Maybe DescribeImagesFilter)
describeImages_maxResults :: Lens' DescribeImages (Maybe Natural)
describeImages_repositoryName :: Lens' DescribeImages Text
data DescribeImagesResponse = DescribeImagesResponse' {
- imageDetails :: Maybe [ImageDetail]
- nextToken :: Maybe Text
- httpStatus :: Int
}
newDescribeImagesResponse :: Int -> DescribeImagesResponse
describeImagesResponse_imageDetails :: Lens' DescribeImagesResponse (Maybe [ImageDetail])
describeImagesResponse_nextToken :: Lens' DescribeImagesResponse (Maybe Text)
describeImagesResponse_httpStatus :: Lens' DescribeImagesResponse Int

Creating a Request

data DescribeImages Source #

See: newDescribeImages smart constructor.

Constructors

DescribeImages'

Fields

registryId :: Maybe Text
The Amazon Web Services account ID associated with the registry that contains the repository in which to describe images. If you do not specify a registry, the default registry is assumed.
imageIds :: Maybe [ImageIdentifier]
The list of image IDs for the requested repository.
nextToken :: Maybe Text
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. This option cannot be used when you specify images with imageIds.
filter' :: Maybe DescribeImagesFilter
The filter key and value with which to filter your DescribeImages results.
maxResults :: Maybe Natural
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 1000. If this parameter is not used, then DescribeImages returns up to 100 results and a nextToken value, if applicable. This option cannot be used when you specify images with imageIds.
repositoryName :: Text
The repository that contains the images to describe.

Instances

Instances details

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

newDescribeImages Source #

Arguments

:: Text	`$sel:repositoryName:DescribeImages'`
-> DescribeImages

Create a value of DescribeImages 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:registryId:DescribeImages', describeImages_registryId - The Amazon Web Services account ID associated with the registry that contains the repository in which to describe images. If you do not specify a registry, the default registry is assumed.

$sel:imageIds:DescribeImages', describeImages_imageIds - The list of image IDs for the requested repository.

$sel:nextToken:DescribeImages', describeImages_nextToken - 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. This option cannot be used when you specify images with imageIds.

$sel:filter':DescribeImages', describeImages_filter - The filter key and value with which to filter your DescribeImages results.

$sel:maxResults:DescribeImages', describeImages_maxResults - 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 1000. If this parameter is not used, then DescribeImages returns up to 100 results and a nextToken value, if applicable. This option cannot be used when you specify images with imageIds.

$sel:repositoryName:DescribeImages', describeImages_repositoryName - The repository that contains the images to describe.

Request Lenses

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

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

describeImages_imageIds :: Lens' DescribeImages (Maybe [ImageIdentifier]) Source #

The list of image IDs for the requested repository.

describeImages_nextToken :: 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. This option cannot be used when you specify images with imageIds.

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

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

describeImages_maxResults :: 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 1000. If this parameter is not used, then DescribeImages returns up to 100 results and a nextToken value, if applicable. This option cannot be used when you specify images with imageIds.

describeImages_repositoryName :: Lens' DescribeImages Text Source #

The repository that contains the images to describe.

Destructuring the Response

data DescribeImagesResponse Source #

See: newDescribeImagesResponse smart constructor.

Constructors

DescribeImagesResponse'

Fields

imageDetails :: Maybe [ImageDetail]
A list of ImageDetail objects that contain data about the image.
nextToken :: Maybe Text
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.
httpStatus :: Int
The response's http status code.

Instances

Instances details

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

newDescribeImagesResponse Source #

Arguments

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

Create a value of DescribeImagesResponse 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:imageDetails:DescribeImagesResponse', describeImagesResponse_imageDetails - A list of ImageDetail objects that contain data about the image.

$sel:nextToken:DescribeImages', describeImagesResponse_nextToken - 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.

$sel:httpStatus:DescribeImagesResponse', describeImagesResponse_httpStatus - The response's http status code.

Response Lenses

describeImagesResponse_imageDetails :: Lens' DescribeImagesResponse (Maybe [ImageDetail]) Source #

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

describeImagesResponse_nextToken :: 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.

describeImagesResponse_httpStatus :: Lens' DescribeImagesResponse Int Source #

The response's http status code.