listImages method

Future<ListImagesResponse> listImages({ bool? byName, List<Filter>? filters, bool? includeDeprecated, int? maxResults, String? nextToken, Ownership? owner, })

Returns the list of images that you have access to.

May throw ServiceException. May throw ClientException. May throw ServiceUnavailableException. May throw InvalidRequestException. May throw InvalidPaginationTokenException. May throw ForbiddenException. May throw CallRateLimitExceededException.

Parameter byName : Requests a list of images with a specific recipe name.

Parameter filters : The filters.

Parameter includeDeprecated : Includes deprecated images in the response list.

Parameter maxResults : The maximum items to return in a request.

Parameter nextToken : A token to specify where to start paginating. This is the NextToken from a previously truncated response.

Parameter owner : The owner defines which images you want to list. By default, this request will only show images owned by your account. You can use this field to specify if you want to view images owned by yourself, by Amazon, or those images that have been shared with you by other customers.

Implementation

Future<ListImagesResponse> listImages({
  bool? byName,
  List<Filter>? filters,
  bool? includeDeprecated,
  int? maxResults,
  String? nextToken,
  Ownership? owner,
}) async {
  _s.validateNumRange(
    'maxResults',
    maxResults,
    1,
    25,
  );
  _s.validateStringLength(
    'nextToken',
    nextToken,
    1,
    65535,
  );
  final $payload = <String, dynamic>{
    if (byName != null) 'byName': byName,
    if (filters != null) 'filters': filters,
    if (includeDeprecated != null) 'includeDeprecated': includeDeprecated,
    if (maxResults != null) 'maxResults': maxResults,
    if (nextToken != null) 'nextToken': nextToken,
    if (owner != null) 'owner': owner.toValue(),
  };
  final response = await _protocol.send(
    payload: $payload,
    method: 'POST',
    requestUri: '/ListImages',
    exceptionFnMap: _exceptionFns,
  );
  return ListImagesResponse.fromJson(response);
}