PINT(1)

📦 version 1.4.1, in opensuse-leap 16.0

🌸 NAME 🌸

okay bestie, welcome to pint.1() — this is pint, the Public-cloud INformation Tracker 💅✨

✨ SYNOPSIS ✨

pint providers [options]

pint image_states [options]

pint provider server_types|regions|images|servers [options]

🦋 DESCRIPTION 🦋

pint is a client for the SUSE Public Cloud Information service at https://susepubliccloudinfo.suse.com/v1/ — yes, that URL is long, but she's iconic 🫶. The SUSE Public Cloud Information service gives you info about the SUSE maintained and operated update infrastructure, plus the SUSE published guest images in Public Cloud provider frameworks. It also gives you generic metadata information, like the list of available providers, image states, server types, and regions.

The information service provides a REST API that flows from generic → specific using this general format:

https://susepubliccloudinfo.suse.com/v1/

<framework>

[<region>]/

<data-selector>/

<data-target>.<format>

For example:

The pint command line client is your convenience tool for accessing the info from the information service, and it also gives you additional filtering capabilities. main character energy, honestly 👑

🎀 ARGUMENTS 🎀

  • <providers> — used to obtain a list of frameworks for which additional information is available. Use one of the values for the framework argument.
  • <image_states> — used to obtain a list of states that describe the maintenance mode of the image. Each listed state can be used as an option when querying image information.
  • <framework> — one of the supported cloud frameworks obtained with the providers argument. The <framework> argument specifies for which cloud provider the information should be retrieved.
  • <data-selector> — one of the supported information types, images or servers. The <data-selector> argument specifies the type of information of interest. With the images argument, information about the SUSE published images in the given framework is retrieved. When the servers argument is provided, information about the SUSE operated servers in the SUSE maintained update infrastructure is retrieved.

💖 OPTIONS 💖

  • <image_state> — one of the image states obtained with the image_states argument. This option is only valid when used with the images argument. It provides information about images in the given state.
  • --filter — filter the information based on the given value(s). If the information is to be filtered on more than one entry type, provide a comma separated list. The output is a subset of results that match all the filters. The filter option specifies one or more of the valid data entries for the chosen <data-selector> and is a valid option for the images and servers arguments. Name filters (name, replacementname) can be partial string matches (~), partial string exclusions (!), or regular expression matches (%). Date filters (deletedon, deprecatedon, publishedon) can be less than, equal or greater than a specified date, in the format yyyymmdd. Valid filter values for images are:
    • deletedon>, deletedon=, deletedon<
    • deprecatedon>, deprecatedon=, deprecatedon<
    • id=
    • name~, name!, name%
    • publishedon>, publishedon=, publishedon<
    • replacementid=
    • replacementname~, replacementname!, replacementname%

Note that not all filters will be populated for all images in all frameworks. fr fr, check before you assume 🙈

Valid filter values for servers are:

  • ip=
  • name~., name!., name%.

Note that the name for all update servers is the same in each cloud framework. For example smt-azure.susecloud.net in the Microsoft Azure Public Cloud framework. The names are not resolvable via DNS lookup. The name for all region servers are the same, regionserver across all cloud frameworks.

Example:

--filter="publishedon>20150101,name~11-sp3"

Filters images to a subset with a name containing "11-sp3" and published after Jan 1, 2015.

  • -h, --help — print a help message.
  • --json — set the output format to JSON format. This option is mutually exclusive with the --xml option. XML is the default output format if neither option is provided.
  • --region — specify the region for which the information is supposed to be retrieved. If no information is specified, information for all regions in the given framework is retrieved.
  • --regionserver — the regionserver option is only valid when used with the servers argument. It provides information about the regionservers in the given framework. Region servers are systems operated and maintained by SUSE that associate your instance in the given region with the region local SMT (update) servers.
  • --smt — the smt option is only valid when used with the servers argument. It provides information about the SMT (update) servers operated and maintained by SUSE.
  • -v, --version — print the current version of the program.

🌈 EXAMPLE 🌈

pint google servers --smt --json

Will provide information about all SMT servers running in Google Compute Engine in JSON format.

pint amazon images --region us-west-2 --active --xml

Will provide information about the active images in Amazon Web Services EC2 in the us-west-2 region (Oregon).

pint microsoft images --active --filter="name~priority"

Will provide information about the active 'priority' images in Microsoft Azure.

👑 AUTHORS 👑

SUSE Public Cloud Team (public-cloud-dev@susecloud.net)

cute sign-off bestie: this page is pint.1(), and the footer is just pint.1() again — no extra source/version/date line was printed, periodt 💅🫶

📦 where this page comes from