SaladCloudImdsSdk Python SDK 0.9.0-alpha.5

Welcome to the SaladCloudImdsSdk SDK documentation. This guide will help you get started with integrating and using the SaladCloudImdsSdk SDK in your project.

Versions

• API version: 0.9.0-alpha.2
• SDK version: 0.9.0-alpha.5

About the API

The SaladCloud Instance Metadata Service (IMDS). Please refer to the SaladCloud API Documentation for more details.

Table of Contents

• Setup & Configuration
  • Supported Language Versions
  • Installation
• Setting a Custom Timeout
• Sample Usage
• Async Usage
• Services
• Models
• License

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-imds-sdk

Setting a Custom Timeout

You can set a custom timeout for the SDK's HTTP requests as follows:

from salad_cloud_imds_sdk import SaladCloudImdsSdk

sdk = SaladCloudImdsSdk(timeout=10000)

Sample Usage

Below is a comprehensive example demonstrating how to authenticate and call a simple endpoint:

from salad_cloud_imds_sdk import SaladCloudImdsSdk

sdk = SaladCloudImdsSdk(
    timeout=10000
)

result = sdk.metadata.get_deletion_cost()

print(result)

Async Usage

The SDK includes an Async Client for making asynchronous API requests. This is useful for applications that need non-blocking operations, like web servers or apps with a graphical user interface.

import asyncio
from salad_cloud_imds_sdk import SaladCloudImdsSdkAsync

sdk = SaladCloudImdsSdkAsync(
    timeout=10000
)


async def main():
  result = await sdk.metadata.get_deletion_cost()
  print(result)

asyncio.run(main())

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
MetadataService

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
DeletionCost	The deletion cost of the current container instance.
ReallocatePrototype	Represents a request to reallocate the current container instance to another SaladCloud node.
Status	The health statuses of the current container instance.
Token	The identity token of the current container instance.
SaladCloudImdsError	An API error. The code and type uniquely identify the type of the error. The code is a short value that may be used for programmatic error handling. The type is an absolute URL that may be resolved for more detailed information. Refer to the SaladCloud IMDS reference for a list of the expected code and type values. Also, note that all properties are optional. Clients should implement robust error handling to account for unexpected errors.

License

This SDK is licensed under the MIT License.

See the LICENSE file for more details.