The SaladCloud REST API. Please refer to the [SaladCloud API Documentation](https://docs.salad.com/api-reference) for more details.
Project description
SaladCloudSdk Python SDK 0.9.0-alpha.2
Welcome to the SaladCloudSdk SDK documentation. This guide will help you get started with integrating and using the SaladCloudSdk SDK in your project.
Versions
- API version:
0.9.0-alpha.2
- SDK version:
0.9.0-alpha.2
About the API
The SaladCloud REST API. Please refer to the SaladCloud API Documentation for more details.
Table of Contents
Setup & Configuration
Supported Language Versions
This SDK is compatible with the following versions: Python >= 3.7
Installation
To get started with the SDK, we recommend installing using pip
:
pip install salad-cloud-sdk
Authentication
API Key Authentication
The SaladCloudSdk API uses API keys as a form of authentication. An API key is a unique identifier used to authenticate a user, developer, or a program that is calling the API.
Setting the API key
When you initialize the SDK, you can set the API key as follows:
SaladCloudSdk(
api_key="YOUR_API_KEY",
api_key_header="YOUR_API_KEY_HEADER",
timeout=10000
)
If you need to set or update the API key after initializing the SDK, you can use:
sdk.set_api_key("YOUR_API_KEY", "YOUR_API_KEY_HEADER")
Setting a Custom Timeout
You can set a custom timeout for the SDK's HTTP requests as follows:
from salad_cloud_sdk import SaladCloudSdk
sdk = SaladCloudSdk(timeout=10000)
Sample Usage
Below is a comprehensive example demonstrating how to authenticate and call a simple endpoint:
from salad_cloud_sdk import SaladCloudSdk, Environment
sdk = SaladCloudSdk(
api_key="YOUR_API_KEY",
api_key_header="YOUR_API_KEY_HEADER",
base_url=Environment.DEFAULT.value,
timeout=10000
)
result = sdk.quotas.get_quotas(organization_name="o110sou")
print(result)
Services
The SDK provides various services to interact with the API.
Below is a list of all available services:
Name |
---|
container_groups |
workload_errors |
queues |
quotas |
inference_endpoints |
organization_data |
webhook_secret_key |
Models
The SDK includes several models that represent the data structures used in API requests and responses. These models help in organizing and managing the data efficiently.
Below is a list of all available models:
Name | Description |
---|---|
ContainerGroupList | Represents a list of container groups |
CreateContainerGroup | Represents a request to create a container group |
ContainerGroup | Represents a container group |
UpdateContainerGroup | Represents a request to update a container group |
ContainerGroupInstances | Represents a list of container group instances |
ContainerGroupInstance | Represents the details of a single container group instance |
WorkloadErrorList | Represents a list of workload errors |
QueueList | Represents a list of queues |
CreateQueue | Represents a request to create a new queue. |
Queue | Represents a queue. |
UpdateQueue | Represents a request to update an existing queue. |
QueueJobList | Represents a list of queue jobs |
CreateQueueJob | Represents a request to create a queue job |
QueueJob | Represents a queue job |
Quotas | Represents the organization quotas |
InferenceEndpointsList | Represents a list of inference endpoints |
InferenceEndpoint | Represents an inference endpoint |
InferenceEndpointJobList | Represents a list of inference endpoint jobs |
CreateInferenceEndpointJob | Represents a request to create a inference endpoint job |
InferenceEndpointJob | Represents a inference endpoint job |
GpuClassesList | Represents a list of GPU classes |
WebhookSecretKey | Represents a webhook secret key |
Container | Represents a container |
ContainerRestartPolicy | |
ContainerGroupState | Represents a container group state |
CountryCode | |
ContainerGroupNetworking | Represents container group networking parameters |
ContainerGroupLivenessProbe | Represents the container group liveness probe |
ContainerGroupReadinessProbe | Represents the container group readiness probe |
ContainerGroupStartupProbe | Represents the container group startup probe |
ContainerGroupQueueConnection | Represents container group queue connection |
QueueAutoscaler | Represents the autoscaling rules for a queue |
ContainerResourceRequirements | Represents a container resource requirements |
ContainerGroupPriority | |
ContainerGroupStatus | |
ContainerGroupInstanceStatusCount | Represents a container group instance status count |
ContainerNetworkingProtocol | |
ContainerGroupProbeTcp | |
ContainerGroupProbeHttp | |
ContainerGroupProbeGrpc | |
ContainerGroupProbeExec | |
ContainerProbeHttpScheme | |
ContainerGroupProbeHttpHeaders2 | |
CreateContainer | Represents a container |
CreateContainerGroupNetworking | Represents container group networking parameters |
UpdateContainer | Represents an update container object |
UpdateContainerGroupNetworking | Represents update container group networking parameters |
WorkloadError | Represents a workload error |
QueueJobEvent | Represents an event for queue job |
ContainerGroupsQuotas | |
RecipesQuotas | |
InferenceEndpointJobEvent | Represents an event for inference endpoint job |
GpuClass | Represents a GPU Class |
GpuClassPrice | Represents the price of a GPU class for a given container group priority |
License
This SDK is licensed under the MIT License.
See the LICENSE file for more details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file salad_cloud_sdk-0.9.0a2.tar.gz
.
File metadata
- Download URL: salad_cloud_sdk-0.9.0a2.tar.gz
- Upload date:
- Size: 49.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1ba4fe875147581f9b26b36ffb32963f93875a4011db4cbcb66ac524e2aedb4b |
|
MD5 | 0723a1d74342a84a7ba9ff9c6a61548c |
|
BLAKE2b-256 | 887715216000179428f128bbbb541b24f5e08dd857f186e23028f2e1c90b11f8 |
File details
Details for the file salad_cloud_sdk-0.9.0a2-py3-none-any.whl
.
File metadata
- Download URL: salad_cloud_sdk-0.9.0a2-py3-none-any.whl
- Upload date:
- Size: 83.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e2e09c092a5332d47c4fba6957c41bbb912586996864d4a764e8a9b8418a3f32 |
|
MD5 | 068594d1a5a071fc7658ebccdc4a7394 |
|
BLAKE2b-256 | c5772ad6b2183b88eb0c5adf3c8f9df87a45090a151471d8d3ac019b510966a8 |