mtn-cloud 0.2.16__tar.gz → 0.2.17__tar.gz

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtn-cloud
-Version: 0.2.16
+Version: 0.2.17
 Summary: Community Python SDK for MTN Cloud - Deploy and manage cloud resources with ease
 Project-URL: Homepage, https://github.com/mahveotm/mtn-cloud-python
 Project-URL: Documentation, https://github.com/mahveotm/mtn-cloud-python#readme
@@ -50,7 +50,7 @@ Description-Content-Type: text/markdown
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A Modern Python SDK for [MTN Cloud](https://console.cloud.mtn.ng) with typed models, clear resource managers, and practical workflows for compute, networking, storage, and archives.
+A Modern Python SDK for [MTN Cloud](https://console.cloud.mtn.ng) with typed models, clear resource managers, and practical workflows for compute, networking, storage, archives, security groups, backups, and more.
 
 Docs: [mtn-cloud-python](https://mahveotm.github.io/mtn-cloud-python/)
 
@@ -78,6 +78,9 @@ pip install mtn-cloud
 - [Instances](https://mahveotm.github.io/mtn-cloud-python/instances/)
 - [Networking](https://mahveotm.github.io/mtn-cloud-python/networking/)
 - [Storage](https://mahveotm.github.io/mtn-cloud-python/storage/)
+- [Security Groups](https://mahveotm.github.io/mtn-cloud-python/security-groups/)
+- [Backups](https://mahveotm.github.io/mtn-cloud-python/backups/)
+- [Virtual Images](https://mahveotm.github.io/mtn-cloud-python/virtual-images/)
 - [Advanced Cookbook](https://mahveotm.github.io/mtn-cloud-python/advanced-cookbook/)
 - [API Overview](https://mahveotm.github.io/mtn-cloud-python/api-overview/)
 - [API Reference](https://mahveotm.github.io/mtn-cloud-python/api-reference/)
@@ -200,7 +203,79 @@ subnets = cloud.networks.list_subnets(new_network.id)
 print(f"Subnets: {len(subnets)}")
 ```
 
-### 5. Work with Storage and Archives
+### 5. Manage Security Groups
+
+```python
+# Create a security group and add rules
+sg = cloud.security_groups.create(
+    name="web-servers",
+    description="HTTP, HTTPS, and SSH access",
+)
+
+cloud.security_groups.create_rule(
+    sg.id,
+    name="allow-ssh",
+    direction="ingress",
+    protocol="tcp",
+    port_range="22",
+)
+
+cloud.security_groups.create_rule(
+    sg.id,
+    name="allow-https",
+    direction="ingress",
+    protocol="tcp",
+    port_range="443",
+)
+
+# Use the security group when provisioning
+instance = cloud.instances.create(
+    name="app-server-01",
+    cloud="MTNNG_CLOUD_AZ_1",
+    type="MTN-CS10",
+    group="MTNNG_CLOUD_AZ_1",
+    layout=327,
+    plan=6776,
+    resource_pool_id="pool-214",
+    security_group="web-servers",
+)
+```
+
+### 6. Snapshot Instances
+
+```python
+# Create a snapshot before a risky operation
+snap = cloud.instances.create_snapshot(
+    instance_id=instance.id,
+    name="pre-upgrade",
+)
+
+# Revert if something goes wrong (stop the instance first)
+cloud.instances.stop(instance.id)
+cloud.instances.wait_until_stopped(instance.id)
+cloud.instances.revert_snapshot(instance.id, snapshot_id=snap.id)
+```
+
+### 7. Work with Backups
+
+```python
+# List configured backups and their status
+for backup in cloud.backups.list():
+    print(f"{backup.name}: last_run={backup.last_run} status={backup.last_status}")
+
+# Trigger an immediate backup run
+cloud.backups.execute(backup_id=42)
+
+# Check execution history
+for result in cloud.backups.list_results(backup_id=42):
+    print(f"{result.start_date}: {result.status} ({result.size_in_mb} MB)")
+
+# List and execute backup jobs (schedules)
+for job in cloud.backups.list_jobs():
+    print(f"{job.name}: cron={job.cron_expression}")
+```
+
+### 8. Work with Storage and Archives
 
 ```python
 # Create S3-compatible storage provider

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/README.md

@@ -6,7 +6,7 @@
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A Modern Python SDK for [MTN Cloud](https://console.cloud.mtn.ng) with typed models, clear resource managers, and practical workflows for compute, networking, storage, and archives.
+A Modern Python SDK for [MTN Cloud](https://console.cloud.mtn.ng) with typed models, clear resource managers, and practical workflows for compute, networking, storage, archives, security groups, backups, and more.
 
 Docs: [mtn-cloud-python](https://mahveotm.github.io/mtn-cloud-python/)
 
@@ -34,6 +34,9 @@ pip install mtn-cloud
 - [Instances](https://mahveotm.github.io/mtn-cloud-python/instances/)
 - [Networking](https://mahveotm.github.io/mtn-cloud-python/networking/)
 - [Storage](https://mahveotm.github.io/mtn-cloud-python/storage/)
+- [Security Groups](https://mahveotm.github.io/mtn-cloud-python/security-groups/)
+- [Backups](https://mahveotm.github.io/mtn-cloud-python/backups/)
+- [Virtual Images](https://mahveotm.github.io/mtn-cloud-python/virtual-images/)
 - [Advanced Cookbook](https://mahveotm.github.io/mtn-cloud-python/advanced-cookbook/)
 - [API Overview](https://mahveotm.github.io/mtn-cloud-python/api-overview/)
 - [API Reference](https://mahveotm.github.io/mtn-cloud-python/api-reference/)
@@ -156,7 +159,79 @@ subnets = cloud.networks.list_subnets(new_network.id)
 print(f"Subnets: {len(subnets)}")
 ```
 
-### 5. Work with Storage and Archives
+### 5. Manage Security Groups
+
+```python
+# Create a security group and add rules
+sg = cloud.security_groups.create(
+    name="web-servers",
+    description="HTTP, HTTPS, and SSH access",
+)
+
+cloud.security_groups.create_rule(
+    sg.id,
+    name="allow-ssh",
+    direction="ingress",
+    protocol="tcp",
+    port_range="22",
+)
+
+cloud.security_groups.create_rule(
+    sg.id,
+    name="allow-https",
+    direction="ingress",
+    protocol="tcp",
+    port_range="443",
+)
+
+# Use the security group when provisioning
+instance = cloud.instances.create(
+    name="app-server-01",
+    cloud="MTNNG_CLOUD_AZ_1",
+    type="MTN-CS10",
+    group="MTNNG_CLOUD_AZ_1",
+    layout=327,
+    plan=6776,
+    resource_pool_id="pool-214",
+    security_group="web-servers",
+)
+```
+
+### 6. Snapshot Instances
+
+```python
+# Create a snapshot before a risky operation
+snap = cloud.instances.create_snapshot(
+    instance_id=instance.id,
+    name="pre-upgrade",
+)
+
+# Revert if something goes wrong (stop the instance first)
+cloud.instances.stop(instance.id)
+cloud.instances.wait_until_stopped(instance.id)
+cloud.instances.revert_snapshot(instance.id, snapshot_id=snap.id)
+```
+
+### 7. Work with Backups
+
+```python
+# List configured backups and their status
+for backup in cloud.backups.list():
+    print(f"{backup.name}: last_run={backup.last_run} status={backup.last_status}")
+
+# Trigger an immediate backup run
+cloud.backups.execute(backup_id=42)
+
+# Check execution history
+for result in cloud.backups.list_results(backup_id=42):
+    print(f"{result.start_date}: {result.status} ({result.size_in_mb} MB)")
+
+# List and execute backup jobs (schedules)
+for job in cloud.backups.list_jobs():
+    print(f"{job.name}: cron={job.cron_expression}")
+```
+
+### 8. Work with Storage and Archives
 
 ```python
 # Create S3-compatible storage provider

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/docs/api-overview.md

@@ -19,6 +19,9 @@ from mtn_cloud import MTNCloud
 - `plans`
 - `storage_buckets`
 - `archive_buckets`
+- `security_groups`
+- `backups`
+- `virtual_images`
 
 ## Authentication Options
 
@@ -43,6 +46,9 @@ cloud.instances.create(...)
 cloud.instances.update(instance_id=123, name="new-name")
 cloud.instances.delete(123)
 
+cloud.instances.create_snapshot(123, "pre-upgrade")
+cloud.instances.revert_snapshot(123, snapshot_id=456)
+
 cloud.networks.create(...)
 cloud.networks.update(298, description="updated")
 cloud.networks.delete(298)
@@ -50,6 +56,11 @@ cloud.networks.delete(298)
 cloud.storage_buckets.create_s3(...)
 cloud.archive_buckets.create(...)
 cloud.archive_buckets.upload_file(...)
+
+cloud.security_groups.create(name="web-servers")
+cloud.security_groups.create_rule(sg_id, direction="ingress", protocol="tcp", port_range="22")
+
+cloud.backups.execute(backup_id=42)
 ```
 
 ## Exception Hierarchy
@@ -80,6 +91,10 @@ Resource methods return typed Pydantic models, for example:
 - `StorageBucket`
 - `ArchiveBucket`
 - `ArchiveFile`
+- `SecurityGroup`, `SecurityGroupRule`
+- `Snapshot`
+- `Backup`, `BackupJob`, `BackupResult`
+- `VirtualImage`
 
 ## Naming Conventions
 

mtn_cloud-0.2.17/docs/api-reference/backups.md

@@ -0,0 +1,59 @@
+# Resource: `cloud.backups` (`BackupsResource`)
+
+### `list(max_results=None, offset=0, phrase=None, **filters) -> list[Backup]`
+
+- Endpoint: `GET /api/backups`
+- Parameters:
+    - Shared list args (see [API Reference](./index.md#shared-list-query-arguments))
+- Returns: `list[Backup]`
+- Raises: common API exceptions
+
+### `get(backup_id: int) -> Backup`
+
+- Endpoint: `GET /api/backups/{backup_id}`
+- Returns: `Backup`
+- Raises: common API exceptions
+
+### `execute(backup_id: int) -> dict[str, Any]`
+
+- Endpoint: `POST /api/backups/{backup_id}/execute`
+- Triggers an immediate out-of-schedule backup run
+- Returns: raw execution status response
+- Raises: common API exceptions
+
+### `list_results(backup_id: int, max_results=None) -> list[BackupResult]`
+
+- Endpoint: `GET /api/backups/{backup_id}/results`
+- Parameters:
+    - `max_results`: maps to query `max`
+- Returns: `list[BackupResult]` — each result carries `status`, `size_in_mb`, `duration_millis`, `start_date`, `end_date`
+- Raises: common API exceptions
+
+### `delete(backup_id: int) -> bool`
+
+- Endpoint: `DELETE /api/backups/{backup_id}`
+- Returns: `True` on success
+- Raises: common API exceptions
+
+---
+
+## Job management
+
+### `list_jobs(max_results=None, offset=0) -> list[BackupJob]`
+
+- Endpoint: `GET /api/backups/jobs`
+- Returns: `list[BackupJob]`
+- Raises: common API exceptions
+
+### `get_job(job_id: int) -> BackupJob`
+
+- Endpoint: `GET /api/backups/jobs/{job_id}`
+- Returns: `BackupJob`
+- Raises: common API exceptions
+
+### `execute_job(job_id: int) -> dict[str, Any]`
+
+- Endpoint: `POST /api/backups/jobs/{job_id}/execute`
+- Triggers an immediate run of all backups under the job
+- Returns: raw execution status response
+- Raises: common API exceptions

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/docs/api-reference/index.md

@@ -13,6 +13,9 @@ This section documents the public SDK surface in endpoint-first format.
 - [Plans (`cloud.plans`)](./plans.md)
 - [Storage Buckets (`cloud.storage_buckets`)](./storage-buckets.md)
 - [Archive Buckets (`cloud.archive_buckets`)](./archive-buckets.md)
+- [Security Groups (`cloud.security_groups`)](./security-groups.md)
+- [Backups (`cloud.backups`)](./backups.md)
+- [Virtual Images (`cloud.virtual_images`)](./virtual-images.md)
 
 ## Conventions
 

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/docs/api-reference/instances.md

@@ -165,3 +165,35 @@ Client-side polling helper.
     - `max_results`: maps to query `max`
 - Returns: list from response key `processes`
 - Raises: common API exceptions
+
+---
+
+## Snapshot management
+
+### `list_snapshots(instance_id: int) -> list[Snapshot]`
+
+- Endpoint: `GET /api/instances/{instance_id}/snapshots`
+- Returns: `list[Snapshot]`
+- Raises: common API exceptions
+
+### `create_snapshot(instance_id: int, name: str, *, description=None) -> Snapshot`
+
+- Endpoint: `POST /api/instances/{instance_id}/snapshots`
+- Parameters:
+    - `name`: snapshot name
+    - `description`: optional description
+- Returns: `Snapshot`
+- Raises: common API exceptions
+
+### `revert_snapshot(instance_id: int, snapshot_id: int) -> bool`
+
+- Endpoint: `PUT /api/instances/{instance_id}/revert-snapshot/{snapshot_id}`
+- The instance should be stopped before reverting
+- Returns: `True` when revert is initiated
+- Raises: common API exceptions
+
+### `delete_snapshot(instance_id: int, snapshot_id: int) -> bool`
+
+- Endpoint: `DELETE /api/instances/{instance_id}/snapshots/{snapshot_id}`
+- Returns: `True` on success
+- Raises: common API exceptions

mtn_cloud-0.2.17/docs/api-reference/security-groups.md

@@ -0,0 +1,94 @@
+# Resource: `cloud.security_groups` (`SecurityGroupsResource`)
+
+### `list(max_results=None, offset=0, phrase=None, name=None, **filters) -> list[SecurityGroup]`
+
+- Endpoint: `GET /api/security-groups`
+- Parameters:
+    - Shared list args (see [API Reference](./index.md#shared-list-query-arguments))
+    - `name`: filter by name
+- Returns: `list[SecurityGroup]` — each includes its embedded `rules` list
+- Raises: common API exceptions
+
+### `get(security_group_id: int) -> SecurityGroup`
+
+- Endpoint: `GET /api/security-groups/{security_group_id}`
+- Returns: `SecurityGroup` with all rules populated
+- Raises: common API exceptions
+
+### `get_by_name(name: str) -> SecurityGroup`
+
+- Endpoint sequence:
+    - `GET /api/security-groups?name=<name>&max=1`
+- Parameters:
+    - `name`: security group name
+- Returns: `SecurityGroup`
+- Raises:
+    - common API exceptions
+    - `NotFoundError` when no group matches
+
+### `create(name: str, *, description=None) -> SecurityGroup`
+
+- Endpoint: `POST /api/security-groups`
+- Parameters:
+    - `name`: group name
+    - `description`: optional description
+- Returns: created `SecurityGroup`
+- Raises: common API exceptions
+
+### `update(security_group_id: int, *, name=None, description=None) -> SecurityGroup`
+
+- Endpoint: `PUT /api/security-groups/{security_group_id}`
+- Parameters:
+    - `name`: replacement name
+    - `description`: replacement description
+- Returns: updated `SecurityGroup`
+- Raises: common API exceptions
+
+### `delete(security_group_id: int) -> bool`
+
+- Endpoint: `DELETE /api/security-groups/{security_group_id}`
+- Returns: `True` on success
+- Raises: common API exceptions
+
+---
+
+## Rule management
+
+### `list_rules(security_group_id: int) -> list[SecurityGroupRule]`
+
+- Endpoint sequence:
+    - `GET /api/security-groups/{security_group_id}` (rules embedded in response)
+- Returns: `list[SecurityGroupRule]`
+- Raises: common API exceptions
+
+### `create_rule(security_group_id: int, *, name=None, direction="ingress", policy="accept", protocol=None, port_range=None, destination_port_range=None, source_type="all", source=None, destination_type="instance", destination=None, ethertype=None, priority=None, enabled=None) -> SecurityGroupRule`
+
+- Endpoint: `POST /api/security-groups/{security_group_id}/rules`
+- Parameters:
+    - `direction`: `"ingress"` or `"egress"`
+    - `policy`: `"accept"` or `"deny"`
+    - `protocol`: `"tcp"`, `"udp"`, `"icmp"`, or `"any"`
+    - `port_range`: source port or range, e.g. `"22"` or `"8000-9000"`
+    - `destination_port_range`: destination port or range
+    - `source_type`: `"cidr"`, `"group"`, `"instance"`, or `"all"`
+    - `source`: CIDR string (required when `source_type="cidr"`)
+    - `destination_type`: `"cidr"`, `"group"`, `"instance"`, or `"all"`
+    - `destination`: destination CIDR or reference
+    - `ethertype`: `"IPv4"` or `"IPv6"`
+    - `priority`: integer — lower value = higher priority
+    - `enabled`: whether rule is active
+- Returns: `SecurityGroupRule`
+- Raises: common API exceptions
+
+### `update_rule(security_group_id: int, rule_id: int, *, name=None, direction=None, policy=None, protocol=None, port_range=None, destination_port_range=None, source_type=None, source=None, destination_type=None, destination=None, ethertype=None, priority=None, enabled=None) -> SecurityGroupRule`
+
+- Endpoint: `PUT /api/security-groups/{security_group_id}/rules/{rule_id}`
+- Parameters: same as `create_rule`, all optional
+- Returns: updated `SecurityGroupRule`
+- Raises: common API exceptions
+
+### `delete_rule(security_group_id: int, rule_id: int) -> bool`
+
+- Endpoint: `DELETE /api/security-groups/{security_group_id}/rules/{rule_id}`
+- Returns: `True` on success
+- Raises: common API exceptions

mtn_cloud-0.2.17/docs/api-reference/virtual-images.md

@@ -0,0 +1,37 @@
+# Resource: `cloud.virtual_images` (`VirtualImagesResource`)
+
+### `list(max_results=None, offset=0, phrase=None, name=None, image_type=None, is_public=None, **filters) -> list[VirtualImage]`
+
+- Endpoint: `GET /api/virtual-images`
+- Parameters:
+    - Shared list args (see [API Reference](./index.md#shared-list-query-arguments))
+    - `name`: filter by name (exact)
+    - `image_type`: filter by image type string (e.g. `"vmware"`, `"qcow2"`)
+    - `is_public`: `True` maps to query `filterType=public`; `False` maps to `filterType=private`
+- Returns: `list[VirtualImage]`
+- Raises: common API exceptions
+
+### `get(virtual_image_id: int) -> VirtualImage`
+
+- Endpoint: `GET /api/virtual-images/{virtual_image_id}`
+- Returns: `VirtualImage`
+- Raises: common API exceptions
+
+### `get_by_name(name: str) -> VirtualImage`
+
+- Endpoint sequence:
+    - `GET /api/virtual-images?phrase=<name>&max=25`
+    - Linear scan of results for exact name match
+- Parameters:
+    - `name`: exact image name
+- Returns: `VirtualImage`
+- Raises:
+    - common API exceptions
+    - `NotFoundError` when no image with that exact name is found
+
+### `delete(virtual_image_id: int) -> bool`
+
+- Endpoint: `DELETE /api/virtual-images/{virtual_image_id}`
+- Only custom (user-uploaded) images can be deleted; platform-provided images will return a 403
+- Returns: `True` on success
+- Raises: common API exceptions

mtn_cloud-0.2.17/docs/backups.md

@@ -0,0 +1,80 @@
+# Backups
+
+Use this guide to list, inspect, and trigger backup jobs via the SDK.
+
+## How Backups Work on MTN Cloud
+
+Backups are configured and scheduled through the MTN Cloud Console under **Backups**. The SDK gives you read and execution access — you can list configured backups, inspect their last run status, retrieve execution results, and trigger an immediate run. Creating new backup configurations is done in the console.
+
+Two distinct objects exist in the API:
+- **Backup** — a configuration attached to a specific instance or server.
+- **Backup Job** — a schedule (cron expression + retention policy) that groups one or more backups.
+
+## List Backups
+
+```python
+from mtn_cloud import MTNCloud
+
+cloud = MTNCloud(token="your-api-token")
+
+backups = cloud.backups.list()
+for b in backups:
+    print(f"{b.id}  {b.name}  last_run={b.last_run}  status={b.last_status}")
+```
+
+## Get a Backup
+
+```python
+backup = cloud.backups.get(42)
+print(backup.name, backup.enabled, backup.retention_count)
+```
+
+## Execute a Backup Immediately
+
+Triggers an out-of-schedule run. Useful before a major change.
+
+```python
+result = cloud.backups.execute(backup_id=42)
+print(result)
+```
+
+## Get Execution Results
+
+Returns the history of runs for a specific backup — each with size, duration, and status.
+
+```python
+results = cloud.backups.list_results(backup_id=42)
+for r in results:
+    print(f"  {r.start_date}  status={r.status}  size={r.size_in_mb} MB  duration={r.duration_millis} ms")
+```
+
+## Backup Jobs
+
+Backup jobs are the scheduling layer. A single job can cover multiple backups.
+
+```python
+# List jobs
+jobs = cloud.backups.list_jobs()
+for job in jobs:
+    print(f"{job.id}  {job.name}  cron={job.cron_expression}  last_status={job.last_status}")
+
+# Get a specific job
+job = cloud.backups.get_job(job_id=10)
+
+# Execute a job immediately
+cloud.backups.execute_job(job_id=10)
+```
+
+## Delete a Backup Configuration
+
+Deletes the backup configuration but does not delete existing backup result data.
+
+```python
+cloud.backups.delete(backup_id=42)
+```
+
+## Notes
+
+- Backup **configuration** (creating new backup jobs, attaching them to instances) is done in the MTN Cloud Console under **Backups → Jobs**.
+- Backup **results** and **executions** are accessible via the SDK.
+- `b.instance_id` and `b.server_id` are convenience properties that extract IDs from the nested `instance`/`server` dict.

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/docs/index.md

@@ -12,10 +12,13 @@ Use this guide in two ways:
 2. [Instances](./instances.md)
 3. [Networking](./networking.md)
 4. [Storage](./storage.md)
-5. [Advanced Cookbook](./advanced-cookbook.md)
-6. [API Overview](./api-overview.md)
-7. [API Reference](./api-reference/index.md)
-8. [Docstring Style Standard](./docstring-style.md)
+5. [Security Groups](./security-groups.md)
+6. [Backups](./backups.md)
+7. [Virtual Images](./virtual-images.md)
+8. [Advanced Cookbook](./advanced-cookbook.md)
+9. [API Overview](./api-overview.md)
+10. [API Reference](./api-reference/index.md)
+11. [Docstring Style Standard](./docstring-style.md)
 
 ## Who This Is For
 
@@ -36,6 +39,9 @@ Use this guide in two ways:
 2. Instances
 3. Networking
 4. Storage
-5. API Overview
-6. API Reference
-7. Advanced Cookbook
+5. Security Groups
+6. Backups
+7. Virtual Images
+8. API Overview
+9. API Reference
+10. Advanced Cookbook

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/docs/instances.md

@@ -128,6 +128,33 @@ cloud.instances.wait_until_running(instance.id, timeout=300)
 cloud.instances.wait_for_status(instance.id, "suspended", timeout=120)
 ```
 
+## Snapshots
+
+Snapshots capture the disk state of an instance at a point in time. Stop the instance before snapshotting to guarantee consistency.
+
+```python
+# Create a snapshot
+snap = cloud.instances.create_snapshot(
+    instance_id=123,
+    name="pre-upgrade",
+    description="State before OS upgrade",
+)
+print(snap.id, snap.name, snap.status)
+
+# List all snapshots for an instance
+snaps = cloud.instances.list_snapshots(instance_id=123)
+for s in snaps:
+    print(s.id, s.name, s.snapshot_created)
+
+# Revert to a snapshot (instance must be stopped)
+cloud.instances.stop(123)
+cloud.instances.wait_until_stopped(123)
+cloud.instances.revert_snapshot(instance_id=123, snapshot_id=snap.id)
+
+# Delete a snapshot
+cloud.instances.delete_snapshot(instance_id=123, snapshot_id=snap.id)
+```
+
 ## Common Pitfalls
 
 - **Resource pool not ready.** The SDK call will fail if you run it before the ~10 minute provisioning window completes. Wait and retry.

{mtn_cloud-0.2.16 → mtn_cloud-0.2.17}/docs/networking.md

@@ -97,4 +97,4 @@ print(allocated.id, allocated.ip_address)
 
 - Many networking fields are OpenStack-specific. The SDK exposes the fields most relevant to MTN Cloud's environment.
 - Always discover and validate IDs (`cloud_id`, `group_id`, `type_id`) for your own account — they are tenant-specific and differ between environments.
-- Security groups (firewall rules) are separate from network configuration. Manage them in **Infrastructure → Network → Security Groups** in the console.
+- Security groups (firewall rules) are separate from network configuration. Manage them via `cloud.security_groups` — see the [Security Groups guide](./security-groups.md).