ACMP

ACMP is a .NET client and binary PowerShell module for the ALSO Cloud Marketplace Simple API.

This is an independent community project. It is not an official ALSO product and is not supported or endorsed by ALSO.

The API contract is documented in the official Swagger documentation. The vendor specification is not redistributed in this repository.

Packages

• ACMP on NuGet contains the reusable .NET client and typed request and response models.
• ACMP on PowerShell Gallery contains the binary PowerShell module. It bundles the .NET client and all runtime assemblies needed by the module.

The packages are built from the same repository, but are versioned independently.

.NET usage

Install the package:

dotnet add package ACMP

Create and authenticate a client. Supply the base URI and credentials through your application's secure configuration:

using ACMP;

var baseUri = new Uri("https://marketplace.example.com/SimpleAPI");

using var client = new AcmpClient(baseUri);
await client.ConnectAsync(username, password);

var companies = await client.GetCompaniesAsync(parentAccountId);

await client.DisconnectAsync();

The client also accepts an HttpClient or HttpMessageHandler, allowing applications to control connection lifetime and test requests without a live Marketplace account.

PowerShell usage

Install and import the module:

Install-Module -Name ACMP -Scope CurrentUser
Import-Module -Name ACMP

Connect using a credential obtained at runtime:

$credential = Get-Credential

$connectionParameters = @{
    BaseUri    = 'https://marketplace.example.com/SimpleAPI'
    Credential = $credential
}
Connect-ACMP @connectionParameters

Get-ACMPCompanies -ParentAccountId $parentAccountId

Disconnect-ACMP

Generated request models remain available for advanced payloads:

$request = [ACMP.Models.GetSubscriptionRequest]::new()
$request.AccountId = $accountId

Get-ACMPSubscription -Request $request

Discover the complete command surface after importing the module:

Get-Command -Module ACMP

License, forks, and support

ACMP is licensed under the MIT License.

The software is provided as-is, without warranty or liability as described in the license. Martin Engineering AG does not provide support or service commitments for this project.

This repository does not accept external contributions. To make changes, create and maintain a fork in your own GitHub account or organization.

Repository build and release instructions are available in BUILDING.md.