Skip to content
Academy
API & SDKs

3 min readintermediate

Python SDK

Edge does not provide its own Python SDK. For Storage, use boto3. For Compute, CDN, and DNS, use the REST API with requests.

CoversStorageComputeCDNDNS

How it works#

Edge Storage is S3-compatible. Use boto3 (the AWS SDK for Python) with Edge’s endpoint and credentials. For Compute, CDN, and DNS, call the REST API at https://api.edge.network using the requests library.

Storage: installing and configuring#

Install boto3 (and requests for REST API calls):

Terminal
pip install boto3 requests

Configure the S3 client with Edge’s Storage endpoint (region us-east-1, path-style access):

Python
import boto3
import os

s3 = boto3.client(
    's3',
    endpoint_url='https://storage.edge.network',
    region_name='us-east-1',
    aws_access_key_id=os.environ['EDGE_ACCESS_KEY'],
    aws_secret_access_key=os.environ['EDGE_SECRET_KEY'],
    config=boto3.session.Config(
        signature_version='s3v4',
        s3={'addressing_style': 'path'}
    )
)

Create the bucket with a location constraint or omit it for Edge:

Python
s3.create_bucket(Bucket='my-bucket')

Storage operations#

Upload a file#

Python
s3.upload_fileobj(
    open('local/file.txt', 'rb'),
    'my-bucket',
    'backups/file.txt',
    ExtraArgs={'ContentType': 'text/plain'}
)

List objects#

Python
paginator = s3.get_paginator('list_objects_v2')
for page in paginator.paginate(Bucket='my-bucket', Prefix='backups/'):
    for obj in page.get('Contents', []):
        print(obj['Key'])

Download a file#

Python
s3.download_file('my-bucket', 'backups/file.txt', 'local/file.txt')

Generate a presigned URL#

Python
url = s3.generate_presigned_url(
    'get_object',
    Params={'Bucket': 'my-bucket', 'Key': 'backups/file.txt'},
    ExpiresIn=3600
)

Compute, CDN, DNS: REST API with requests#

For non-Storage products, use requests:

Python
import requests

resp = requests.get(
    'https://api.edge.network/api/compute/vms',
    headers={
        'Authorization': f"Bearer {os.environ['EDGE_API_KEY']}",
        'Content-Type': 'application/json'
    }
)
data = resp.json()

Use the same pattern for CDN, DNS, and VM operations. See the API reference for endpoints.

Practical example: backup script#

This script uploads local files to Edge Storage with dated prefixes:

Python
from pathlib import Path
from datetime import datetime

def backup_to_edge(local_dir: str, bucket: str, prefix: str = 'backups'):
    """Upload directory tree to Edge Storage with timestamp prefix."""
    base = Path(local_dir)
    timestamp = datetime.utcnow().strftime('%Y%m%d-%H%M%S')

    for path in base.rglob('*'):
        if path.is_file():
            key = f"{prefix}/{timestamp}/{path.relative_to(base)}"
            key = key.replace('\\', '/')
            s3.upload_file(str(path), bucket, key)
            print(f"Uploaded {path} -> {key}")

backup_to_edge('./data', 'my-bucket')

Run it via cron for scheduled backups. You can add lifecycle rules or expiry in the console to retain only recent backups.

Next steps

Keep learning