canic-core 0.111.0

Canic — a canister orchestration and management toolkit for the Internet Computer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! Module: infra::ic::mgmt::snapshots
//!
//! Responsibility: list and delete exact management-canister snapshots.
//! Does not own: reset authority, retention policy or lifecycle orchestration.
//! Boundary: raw management calls used by the observed operations facade.

use super::{
    MgmtInfra,
    types::{InfraCanisterIdRecord, InfraCanisterSnapshot, InfraDeleteCanisterSnapshotArgs},
};
use crate::{
    cdk::types::Principal,
    infra::ic::{IcInfraError, call::Call},
};

impl MgmtInfra {
    /// List exact snapshot identities retained by one canister.
    pub async fn list_canister_snapshot_ids(
        canister_id: Principal,
    ) -> Result<Vec<Vec<u8>>, IcInfraError> {
        let response =
            Call::bounded_wait(Principal::management_canister(), "list_canister_snapshots")
                .with_arg(InfraCanisterIdRecord { canister_id })?
                .execute()
                .await?;
        let (snapshots,): (Vec<InfraCanisterSnapshot>,) = response.candid_tuple()?;
        Ok(snapshots.into_iter().map(|snapshot| snapshot.id).collect())
    }

    /// Delete one observed snapshot without changing the installed canister.
    pub async fn delete_canister_snapshot(
        canister_id: Principal,
        snapshot_id: Vec<u8>,
    ) -> Result<(), IcInfraError> {
        Call::unbounded_wait(Principal::management_canister(), "delete_canister_snapshot")
            .with_arg(InfraDeleteCanisterSnapshotArgs {
                canister_id,
                snapshot_id,
            })?
            .execute()
            .await?;
        Ok(())
    }
}