Skip to main content

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.1

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.1
  • SDK version: 0.9.0-alpha.1

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="b6n01-l4p5c2vk4867z")

print(result)

Services

The SDK provides various services to interact with the API.

Below is a list of all available services with links to their detailed documentation:
Name
ContainerGroupsService
WorkloadErrorsService
QueuesService
QuotasService
InferenceEndpointsService
OrganizationDataService
WebhookSecretKeyService

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 with links to their detailed documentation:
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 queue
Queue Represents a queue
UpdateQueue Represents a request to update a 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
ContainerResourceRequirements Represents a container resource requirements
ContainerGroupPriority
ContainerGroupStatus
ContainerGroupInstanceStatusCount Represents a container group instance status count
ContainerNetworkingProtocol
ContainerGroupProbeTcp
ContainerGroupProbeHttp
ContainerGroupProbeGrpc
ContainerGroupProbeExec
ContainerProbeHttpScheme
ContainerGroupProbeHttpHeaders_2
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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

salad_cloud_sdk-0.9.0a1.tar.gz (48.1 kB view details)

Uploaded Source

Built Distribution

salad_cloud_sdk-0.9.0a1-py3-none-any.whl (81.7 kB view details)

Uploaded Python 3

File details

Details for the file salad_cloud_sdk-0.9.0a1.tar.gz.

File metadata

  • Download URL: salad_cloud_sdk-0.9.0a1.tar.gz
  • Upload date:
  • Size: 48.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.19

File hashes

Hashes for salad_cloud_sdk-0.9.0a1.tar.gz
Algorithm Hash digest
SHA256 c9501322ef914c1c878be4598f82d25c3b91eb123eb6f2af32297a1bffa59eed
MD5 b774562c0adde8b4f750194bd90fc8f5
BLAKE2b-256 317a1e538ddfe6d01537c22b9a65d803dd655ac6d5104086a446e1341e5057dc

See more details on using hashes here.

File details

Details for the file salad_cloud_sdk-0.9.0a1-py3-none-any.whl.

File metadata

File hashes

Hashes for salad_cloud_sdk-0.9.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 054ac980213966fd406e86428a02bfdc1d7ae06bd4fc1e84448d6ddbc57aa554
MD5 b6a9d09feb6b6506684bd36997ce1f00
BLAKE2b-256 0a8ab6774069c34896e2d9ae4496e36bc0e8685ea1d1da4c943ff38bb6a35d7f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page