aws_sdk_codeartifact/client/list_packages.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 [`ListPackages`](crate::operation::list_packages::builders::ListPackagesFluentBuilder) operation.
4 /// This operation supports pagination; See [`into_paginator()`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::into_paginator).
5 ///
6 /// - The fluent builder is configurable:
7 /// - [`domain(impl Into<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::domain) / [`set_domain(Option<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_domain):<br>required: **true**<br><p>The name of the domain that contains the repository that contains the requested packages.</p><br>
8 /// - [`domain_owner(impl Into<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::domain_owner) / [`set_domain_owner(Option<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::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_packages::builders::ListPackagesFluentBuilder::repository) / [`set_repository(Option<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_repository):<br>required: **true**<br><p>The name of the repository that contains the requested packages.</p><br>
10 /// - [`format(PackageFormat)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::format) / [`set_format(Option<PackageFormat>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_format):<br>required: **false**<br><p>The format used to filter requested packages. Only packages from the provided format will be returned.</p><br>
11 /// - [`namespace(impl Into<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::namespace) / [`set_namespace(Option<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_namespace):<br>required: **false**<br><p>The namespace prefix used to filter requested packages. Only packages with a namespace that starts with the provided string value are returned. Note that although this option is called <code>--namespace</code> and not <code>--namespace-prefix</code>, it has prefix-matching behavior.</p> <p>Each package format uses namespace as follows:</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><br>
12 /// - [`package_prefix(impl Into<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::package_prefix) / [`set_package_prefix(Option<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_package_prefix):<br>required: **false**<br><p>A prefix used to filter requested packages. Only packages with names that start with <code>packagePrefix</code> are returned.</p><br>
13 /// - [`max_results(i32)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::max_results) / [`set_max_results(Option<i32>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_max_results):<br>required: **false**<br><p>The maximum number of results to return per page.</p><br>
14 /// - [`next_token(impl Into<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::next_token) / [`set_next_token(Option<String>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::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>
15 /// - [`publish(AllowPublish)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::publish) / [`set_publish(Option<AllowPublish>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_publish):<br>required: **false**<br><p>The value of the <code>Publish</code> package origin control restriction used to filter requested packages. Only packages with the provided restriction are returned. For more information, see <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageOriginRestrictions.html">PackageOriginRestrictions</a>.</p><br>
16 /// - [`upstream(AllowUpstream)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::upstream) / [`set_upstream(Option<AllowUpstream>)`](crate::operation::list_packages::builders::ListPackagesFluentBuilder::set_upstream):<br>required: **false**<br><p>The value of the <code>Upstream</code> package origin control restriction used to filter requested packages. Only packages with the provided restriction are returned. For more information, see <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageOriginRestrictions.html">PackageOriginRestrictions</a>.</p><br>
17 /// - On success, responds with [`ListPackagesOutput`](crate::operation::list_packages::ListPackagesOutput) with field(s):
18 /// - [`packages(Option<Vec::<PackageSummary>>)`](crate::operation::list_packages::ListPackagesOutput::packages): <p>The list of returned <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageSummary.html">PackageSummary</a> objects.</p>
19 /// - [`next_token(Option<String>)`](crate::operation::list_packages::ListPackagesOutput::next_token): <p>If there are additional results, this is the token for the next set of results.</p>
20 /// - On failure, responds with [`SdkError<ListPackagesError>`](crate::operation::list_packages::ListPackagesError)
21 pub fn list_packages(&self) -> crate::operation::list_packages::builders::ListPackagesFluentBuilder {
22 crate::operation::list_packages::builders::ListPackagesFluentBuilder::new(self.handle.clone())
23 }
24}