Use the Python SDK to interact with the Stax platform
staxapp is the Stax Software Development Kit (SDK) for Python which allows users to interact with the Stax platform. The SDK provides you with all the tools you need to interact with the Stax API, including code examples for making requests against the Stax API.
In order to use the Stax Python SDK, you must be authenticated using a Stax API Token.
A Stax API Token is a unique Access Key and Secret Key that allows you to make authorized calls to the Stax API so that you can interact with your Stax Organization securely. To get started see how to create a Stax API Token.
Installation and Setup
Follow this guide to install and setup the Stax SDK.
You can find the most up to date usage examples inside the examples folder in our Stax Python SDK repository.
For advanced queries, refer to the Stax API Reference documentation for a complete guide to all schemas, methods and parameters.
|Accounts||Operations relating to the management of your AWS Accounts within Stax|
|Account Types||Operations relating to the management of your Stax Account Types|
|API Tokens||Operations relating to the management of your Stax API Tokens|
|Groups||Operations relating to the management of your Stax Groups|
|Networking||Operations relating to the management of your Stax Networks|
|Policy||Operations relating to the management of your Stax Policies|
|Tasks||Retrieves the details and status for asynchronous operations|
|Users||Operations relating to the management of your Stax Users|
|Workloads||Operations relating to the management of your Stax Workload Catalogs and Workloads|
The rate limit is the maximum number of requests that you can make using the Stax Python SDK in a given period. There are no limits on the requests that you make.
The back-off requirement is the minimum period of time you must wait before issuing another valid request. Back-off requirements do not apply when using the Stax SDK. See the Stax Service Level Agreement for more details.
Stax include the following user-agent headers in all calls made from the Stax SDK for internal analytics and support purposes. This data provides valuable insight which Stax use to identify bugs, improve the SDK and enhance your developer experience.
|platform||The client operating system being used|
|python_version||The version of Python being used|
|sdk_version||The version of the Stax SDK being used|
This section describes some common issues that you may encounter while attempting to use the SDK and suggests possible solutions.
Exporting API Token Secret Key as environment variable fails
As the API Token Secret Key may contain special characters, try enclosing your Secret Key in single quotes, as shown in the following example:
"Could not find a version that satisfies the requirement staxapp" error
If you receive the following error in your console after attempting to install the staxapp pip module, you are using an unsupported version of Python. You must upgrade to Python 3.6 or greater.
pip install staxapp ERROR: Could not find a version that satisfies the requirement staxapp (from versions: none) ERROR: No matching distribution found for staxapp
A recent change to an API Token's role does not change the token's permissions
If you have an active session, you will be required to re-initialize the SDK for the role change to take effect.
Information on new features, fixes and older release versions can be found here:
Stax Platform Status
The availability of the Stax SDK is dependant on the Stax Platform. To monitor the availability and read status updates about outages, please visit the status page. There, you can also subscribe to notifications.
View the source code, browse our open-source GitHub repository and contribute! For more information on contributing to the Stax SDK, please see our guide.
You can review all open Stax SDK issues in GitHub.
If you've encountered an issue, found a bug or want to request a feature, please open an issue in GitHub.
If you would like to raise a feature request or report an issue relating to the Stax Platform or API, please raise a Stax Support Case from within your Stax console. In order to speed up the resolution of your issue, provide as much information as possible. This will allow our engineers to investigate your problem quickly.
Stax Python SDK is licensed under the Apache Software License, v2.0.