org.opensuse.tukit.Snapshot

org.opensuse.tukit.Snapshot — Snapshot interface

Methods

List (in  's'      columns,
      out 'aa{ss}' list)

Implemented Interfaces

Objects implementing org.opensuse.tukit.Snapshot also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties

Description

Details

List ()

List (in  's'      columns,
      out 'aa{ss}' list)

Retrieve a list of snapshots present on the system, including their properties. For performance reasons only the properties explicity requested via the columns arg are queried.

Request several common fields:

busctl call org.opensuse.tukit /org/opensuse/tukit/Snapshot org.opensuse.tukit.Snapshot List "s" "number,description,default,active,userdata,cleanup,date,user"

Example output on bus:

‣ Type=method_return  Endian=l  Flags=1  Version=1 Cookie=7  ReplyCookie=2  Timestamp="Tue 2022-08-02 11:28:14.651537 UTC"
  Sender=:1.6222  Destination=:1.7658
  UniqueName=:1.6222
  MESSAGE "aa{ss}" {
          ARRAY "a{ss}" {
                  ARRAY "{ss}" {
                          DICT_ENTRY "ss" {
                                  STRING "number";
                                  STRING "0";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "description";
                                  STRING "current";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "default";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "active";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "userdata";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "cleanup";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "date";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "user";
                                  STRING "root";
                          };
                  };
                  ARRAY "{ss}" {
                          DICT_ENTRY "ss" {
                                  STRING "number";
                                  STRING "2264";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "description";
                                  STRING "Snapshot Update of #2263";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "default";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "active";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "userdata";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "cleanup";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "date";
                                  STRING "2022-07-11 17:00:12";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "user";
                                  STRING "root";
                          };
                  };
                  ARRAY "{ss}" {
                          DICT_ENTRY "ss" {
                                  STRING "number";
                                  STRING "2304";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "description";
                                  STRING "Snapshot Update of #2300";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "default";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "active";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "userdata";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "cleanup";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "date";
                                  STRING "2022-07-14 13:52:15";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "user";
                                  STRING "root";
                          };
                  };
                  ARRAY "{ss}" {
                          DICT_ENTRY "ss" {
                                  STRING "number";
                                  STRING "2305";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "description";
                                  STRING "Open";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "default";
                                  STRING "yes";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "active";
                                  STRING "yes";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "userdata";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "cleanup";
                                  STRING "";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "date";
                                  STRING "2022-07-14 14:08:54";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "user";
                                  STRING "root";
                          };
                  };
                  ARRAY "{ss}" {
                          DICT_ENTRY "ss" {
                                  STRING "number";
                                  STRING "2310";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "description";
                                  STRING "zypp(zypper)";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "default";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "active";
                                  STRING "no";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "userdata";
                                  STRING "important=yes";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "cleanup";
                                  STRING "number";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "date";
                                  STRING "2022-07-28 13:45:52";
                          };
                          DICT_ENTRY "ss" {
                                  STRING "user";
                                  STRING "root";
                          };
                  };
          };
  };
      

columns:

A comma separated list of fields to query, such as the snapshot id, the description or whether it is the default snapshot. The accepted field names currently match the accepted fields of the "snapper list" command. If the list is empty, an empty map array will be returned; this can be used to query the number of snapshots.

list:

An array of maps of property - value pairs, with the properties being the requested fields. The map arrays are grouped together in an outer array, separating the snapshots.

Errors

org.opensuse.tukit.Error:

if an error occured.