The Wasabi Account Control API (formerly known as the Wasabi Partner API or the Wasabi Account Management API) enables you to manage multiple Wasabi accounts using API methods. If you do not want to use the API and, instead, want to use Wasabi's hosted, pre-built platform, refer to the Wasabi Account Control Manager.
Below are several FAQs pertaining to the Wasabi Account Control API:
What is the Wasabi Account Control API?
The Wasabi Account Control API (WACA) is a RESTful API that allows for the following functions:
- Create a new sub-account that is linked to the partner’s Wasabi account.
- Generate AWS key sets for sub-accounts.
- Manage sub-account trial parameters, such as to extend the sub-account trial period and change sub-account trial quotas.
- Convert a sub-account trial period into a full (paying) account.
- Query utilization of sub-accounts both at the summary account level and bucket level.
- Query invoices of sub-accounts.
- Delete sub-accounts.
- Manage account “profile” information, such as email address.
What is the difference between WACM and WACA?
Wasabi Account Control Manager leverages WACA and an easy-to-use interface to bring you account management without the need for development. However, if developing your own medium for managing Wasabi accounts is your preferred approach, the Wasabi Account Control API is right for you.
How can I get started using the Account Control API?
To get started using the Account Control API, contact a Wasabi Sales Representative at sales@wasabi.com.
What is the relationship between my Wasabi account and an account created with WACA?
Your Wasabi account will become the Control Account that is associated with billing. Accounts created on WACA are sub-accounts related to your control account. Sub-accounts are Wasabi storage accounts whose administration (billing, password resets, and so on) is managed by you.
How am I billed when using WACA?
You are billed as you normally would be through your main Wasabi account. The only difference is that you will be billed for the storage consumption of your sub-accounts in addition to your main Wasabi account (control account).
How are consumers billed when created with WACA?
The sub-accounts associated with your main Wasabi account (control account) have their billing rolled up to your account. You will receive one bill for yourself and all of your sub-accounts. Your sub-accounts will not be billed individually.
How can I determine the amount of storage used by consumers?
To return the daily storage and data transfer associated with the sub-account across all buckets in the sub-account, use:
GET /v1/accounts/<AcctNum>/utilizationsUsing from and to query string parameters (in the format YYYY-MM-DD) will apply date filters to the result set.
Can I migrate an existing Wasabi Account to an account created with WACA?
There is no way to migrate an existing Wasabi account to an account created with WACA. All accounts available via the API must be newly created there.
Can I migrate data from an existing Wasabi account to a new account created with WACA?
You can migrate data from an existing Wasabi account to a new account created with WACA. However, the only way to migrate data is by using Wasabi Explorer or another third-party transfer application.
What is the difference between a WACA key and an S3 API key?
WACA keys are a unique keyset of primary and secondary keys that are used only to create and manage your WACA implementation. Each Wasabi account does not necessarily gain access to the WACA keyset.
S3 API keys are a unique keyset of Active and Secret keys that are used only to manage your storage account. Each Wasabi account is entitled to a minimum of one pair of S3 keys.
What is the difference between a primary and secondary WACA key?
Primary and secondary API keys provided by Wasabi are not different in entitlement. Either of the keys can be used for WACA implementation.
How do I check all the sub-accounts I have created?
I created a sub-account using the API and, when I log into my control account, I don’t see it listed there. How do I check all the sub-accounts I have created?
From a storage perspective, a control Wasabi account is not different from a sub-account. Control accounts will NOT display the sub-accounts created via the WACA interface. The only way to list all the sub-accounts created is by performing a GET /v1/accounts operation using your existing WACA implementation.
How do I see account information for a specific sub-account?
To see sub-account information, you must pass the GET /v1/accounts/<AcctNum> operation. Inputting the correct account number for the account in question will return details about that account.
What happens if I choose to cancel my WACA subscription?
A WACA subscription can be canceled at any time.
What happens to my existing sub-accounts when I cancel my subscription?
At cancellation, account control API keys are no longer valid. Any sub-accounts created while the subscription was active will continue to operate as before; however, the control account will lose the ability to manage (update, delete, reset S3 API keys, and so on) all of the sub-accounts, including access to sub-invoice data.
What is Wasabi's recommended approach to cancel a WACA subscription?
Before canceling a WACA subscription, consider deleting all sub-accounts. But first, export all sub-invoice data set so any pending charges that your customer owes can be recovered. When sub-accounts are deleted, all associated data stored in the sub-account will also be purged, including sub-users, access keys, IAM policies, and so on.