aws_sdk_codeartifact/client/list_package_versions.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3 /// Constructs a fluent builder for the [`ListPackageVersions`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder) operation.
4 /// This operation supports pagination; See [`into_paginator()`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::into_paginator).
5 ///
6 /// - The fluent builder is configurable:
7 /// - [`domain(impl Into<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::domain) / [`set_domain(Option<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_domain):<br>required: **true**<br><p>The name of the domain that contains the repository that contains the requested package versions.</p><br>
8 /// - [`domain_owner(impl Into<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::domain_owner) / [`set_domain_owner(Option<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_domain_owner):<br>required: **false**<br><p>The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.</p><br>
9 /// - [`repository(impl Into<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::repository) / [`set_repository(Option<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_repository):<br>required: **true**<br><p>The name of the repository that contains the requested package versions.</p><br>
10 /// - [`format(PackageFormat)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::format) / [`set_format(Option<PackageFormat>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_format):<br>required: **true**<br><p>The format of the package versions you want to list.</p><br>
11 /// - [`namespace(impl Into<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::namespace) / [`set_namespace(Option<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_namespace):<br>required: **false**<br><p>The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:</p><note> <p>The namespace is required when deleting package versions of the following formats:</p> <ul> <li> <p>Maven</p></li> <li> <p>Swift</p></li> <li> <p>generic</p></li> </ul> </note> <ul> <li> <p>The namespace of a Maven package version is its <code>groupId</code>.</p></li> <li> <p>The namespace of an npm or Swift package version is its <code>scope</code>.</p></li> <li> <p>The namespace of a generic package is its <code>namespace</code>.</p></li> <li> <p>Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.</p></li> </ul><br>
12 /// - [`package(impl Into<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::package) / [`set_package(Option<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_package):<br>required: **true**<br><p>The name of the package for which you want to request package versions.</p><br>
13 /// - [`status(PackageVersionStatus)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::status) / [`set_status(Option<PackageVersionStatus>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_status):<br>required: **false**<br><p>A string that filters the requested package versions by status.</p><br>
14 /// - [`sort_by(PackageVersionSortType)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::sort_by) / [`set_sort_by(Option<PackageVersionSortType>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_sort_by):<br>required: **false**<br><p>How to sort the requested list of package versions.</p><br>
15 /// - [`max_results(i32)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::max_results) / [`set_max_results(Option<i32>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_max_results):<br>required: **false**<br><p>The maximum number of results to return per page.</p><br>
16 /// - [`next_token(impl Into<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::next_token) / [`set_next_token(Option<String>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_next_token):<br>required: **false**<br><p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p><br>
17 /// - [`origin_type(PackageVersionOriginType)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::origin_type) / [`set_origin_type(Option<PackageVersionOriginType>)`](crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::set_origin_type):<br>required: **false**<br><p>The <code>originType</code> used to filter package versions. Only package versions with the provided <code>originType</code> will be returned.</p><br>
18 /// - On success, responds with [`ListPackageVersionsOutput`](crate::operation::list_package_versions::ListPackageVersionsOutput) with field(s):
19 /// - [`default_display_version(Option<String>)`](crate::operation::list_package_versions::ListPackageVersionsOutput::default_display_version): <p>The default package version to display. This depends on the package format:</p> <ul> <li> <p>For Maven and PyPI packages, it's the most recently published package version.</p></li> <li> <p>For npm packages, it's the version referenced by the <code>latest</code> tag. If the <code>latest</code> tag is not set, it's the most recently published package version.</p></li> </ul>
20 /// - [`format(Option<PackageFormat>)`](crate::operation::list_package_versions::ListPackageVersionsOutput::format): <p>A format of the package.</p>
21 /// - [`namespace(Option<String>)`](crate::operation::list_package_versions::ListPackageVersionsOutput::namespace): <p>The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:</p> <ul> <li> <p>The namespace of a Maven package version is its <code>groupId</code>.</p></li> <li> <p>The namespace of an npm or Swift package version is its <code>scope</code>.</p></li> <li> <p>The namespace of a generic package is its <code>namespace</code>.</p></li> <li> <p>Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.</p></li> </ul>
22 /// - [`package(Option<String>)`](crate::operation::list_package_versions::ListPackageVersionsOutput::package): <p>The name of the package.</p>
23 /// - [`versions(Option<Vec::<PackageVersionSummary>>)`](crate::operation::list_package_versions::ListPackageVersionsOutput::versions): <p>The returned list of <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageVersionSummary.html">PackageVersionSummary</a> objects.</p>
24 /// - [`next_token(Option<String>)`](crate::operation::list_package_versions::ListPackageVersionsOutput::next_token): <p>If there are additional results, this is the token for the next set of results.</p>
25 /// - On failure, responds with [`SdkError<ListPackageVersionsError>`](crate::operation::list_package_versions::ListPackageVersionsError)
26 pub fn list_package_versions(&self) -> crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder {
27 crate::operation::list_package_versions::builders::ListPackageVersionsFluentBuilder::new(self.handle.clone())
28 }
29}