aws_sdk_codeartifact/client/
get_package_version_readme.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 [`GetPackageVersionReadme`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`domain(impl Into<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::domain) / [`set_domain(Option<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::set_domain):<br>required: **true**<br><p>The name of the domain that contains the repository that contains the package version with the requested readme file.</p><br>
7    ///   - [`domain_owner(impl Into<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::domain_owner) / [`set_domain_owner(Option<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::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>
8    ///   - [`repository(impl Into<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::repository) / [`set_repository(Option<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::set_repository):<br>required: **true**<br><p>The repository that contains the package with the requested readme file.</p><br>
9    ///   - [`format(PackageFormat)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::format) / [`set_format(Option<PackageFormat>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::set_format):<br>required: **true**<br><p>A format that specifies the type of the package version with the requested readme file.</p><br>
10    ///   - [`namespace(impl Into<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::namespace) / [`set_namespace(Option<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::set_namespace):<br>required: **false**<br><p>The namespace of the package version with the requested readme file. The package component that specifies its namespace depends on its type. For example:</p><note>  <p>The namespace is required when requesting the readme from 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>
11    ///   - [`package(impl Into<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::package) / [`set_package(Option<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::set_package):<br>required: **true**<br><p>The name of the package version that contains the requested readme file.</p><br>
12    ///   - [`package_version(impl Into<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::package_version) / [`set_package_version(Option<String>)`](crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::set_package_version):<br>required: **true**<br><p>A string that contains the package version (for example, <code>3.5.2</code>).</p><br>
13    /// - On success, responds with [`GetPackageVersionReadmeOutput`](crate::operation::get_package_version_readme::GetPackageVersionReadmeOutput) with field(s):
14    ///   - [`format(Option<PackageFormat>)`](crate::operation::get_package_version_readme::GetPackageVersionReadmeOutput::format): <p>The format of the package with the requested readme file.</p>
15    ///   - [`namespace(Option<String>)`](crate::operation::get_package_version_readme::GetPackageVersionReadmeOutput::namespace): <p>The namespace of the package version with the requested readme file. 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>
16    ///   - [`package(Option<String>)`](crate::operation::get_package_version_readme::GetPackageVersionReadmeOutput::package): <p>The name of the package that contains the returned readme file.</p>
17    ///   - [`version(Option<String>)`](crate::operation::get_package_version_readme::GetPackageVersionReadmeOutput::version): <p>The version of the package with the requested readme file.</p>
18    ///   - [`version_revision(Option<String>)`](crate::operation::get_package_version_readme::GetPackageVersionReadmeOutput::version_revision): <p>The current revision associated with the package version.</p>
19    ///   - [`readme(Option<String>)`](crate::operation::get_package_version_readme::GetPackageVersionReadmeOutput::readme): <p>The text of the returned readme file.</p>
20    /// - On failure, responds with [`SdkError<GetPackageVersionReadmeError>`](crate::operation::get_package_version_readme::GetPackageVersionReadmeError)
21    pub fn get_package_version_readme(&self) -> crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder {
22        crate::operation::get_package_version_readme::builders::GetPackageVersionReadmeFluentBuilder::new(self.handle.clone())
23    }
24}