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}