AWS Marketplace is a curated digital catalog that customers can use to find, buy, deploy, and manage third-party software, data, and services to build solutions and run their businesses. The AWS Marketplace Agreement Service provides an API interface that helps AWS Marketplace sellers manage their product-related agreements, including listing, searching, and filtering agreements.

To manage agreements in AWS Marketplace, you must ensure that your AWS Identity and Access Management (IAM) policies and roles are set up. The user must have the required policies/permissions that allow them to carry out the actions in AWS:

• DescribeAgreement – Grants permission to users to obtain detailed meta data about any of their agreements.
• GetAgreementTerms – Grants permission to users to obtain details about the terms of an agreement.
• SearchAgreements – Grants permission to users to search through all their agreements.

§Getting Started

Examples are available for many services and operations, check out theexamples folder in GitHub.

The SDK provides one crate per AWS service. You must addTokioas a dependency within your Rust project to execute asynchronous code. To addaws-sdk-marketplaceagreement toyour project, add the following to yourCargo.toml file:

[dependencies]aws-config = { version = "1.1.7", features = ["behavior-version-latest"] }aws-sdk-marketplaceagreement = "1.61.0"tokio = { version = "1", features = ["full"] }

Then in code, a client can be created with the following:

useaws_sdk_marketplaceagreementasmarketplaceagreement;#[::tokio::main]async fnmain() ->Result<(), marketplaceagreement::Error> {letconfig = aws_config::load_from_env().await;letclient = aws_sdk_marketplaceagreement::Client::new(&config);// ... make some calls with the clientOk(())}

See theclient documentationfor information on what calls can be made, and the inputs and outputs for each of those calls.

§Using the SDK

Until the SDK is released, we will be adding information about using the SDK to theDeveloper Guide. Feel free to suggestadditional sections for the guide by opening an issue and describing what you are trying to do.

§Getting Help

• GitHub discussions - For ideas, RFCs & general questions
• GitHub issues - For bug reports & feature requests
• Generated Docs (latest version)
• Usage examples

§Crate Organization

The entry point for most customers will beClient, which exposes one method for each APIoffered by AWS Marketplace Agreement Service. The return value of each of these methods is a “fluent builder”,where the different inputs for that API are added by builder-style function call chaining,followed by callingsend() to get aFuture that will result ineither a successful output or aSdkError.

Some of these API inputs may be structs or enums to provide more complex structured information.These structs and enums live intypes. There are some simpler types forrepresenting data such as date times or binary blobs that live inprimitives.

All types required to configure a client via theConfig struct liveinconfig.

Theoperation module has a submodule for every API, and in each submoduleis the input, output, and error type for that API, as well as builders to construct each of those.

There is a top-levelError type that encompasses all the errors that theclient can return. Any other error type can be converted to thisError type via theFrom trait.

The other modules within this crate are not required for normal usage.