Skip to content

nom¤

Usage:

nom [OPTIONS] COMMAND [ARGS]...

Options:

  --version   Show the version and exit.
  -h, --help  Show this message and exit.

nom attachment¤

Usage:

nom attachment [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom attachment download¤

Download an attachment with the given RID to the specified location on disk.

Usage:

nom attachment download [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  -o, --output TEXT        full path to write the attachment to (not just the
                           directory)  [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom attachment get¤

Get an attachment by its RID

Usage:

nom attachment get [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom attachment upload¤

Upload attachment from a local file with a given name and description and display the details of the newly created attachment to the user.

Usage:

nom attachment upload [OPTIONS]

Options:

  -n, --name TEXT          [required]
  -f, --file TEXT          path to the file to upload  [required]
  -d, --description TEXT   description of the attachment
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom config¤

Usage:

nom config [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom config migrate¤

Interactively migrate deprecated config at ~/.nominal.yml to new profile-based config at ~/.config/nominal/config.yml

Usage:

nom config migrate [OPTIONS]

Options:

  -h, --help  Show this message and exit.

nom config profile¤

Usage:

nom config profile [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom config profile add¤

Add or update a profile to your Nominal config

Usage:

nom config profile add [OPTIONS] PROFILE

Options:

  -t, --token TEXT            bearer token or api key  [required]
  -u, --base-url TEXT         [default: https://api.gov.nominal.io/api]
  -w, --workspace-rid TEXT    workspace RID  [optional]
  --validate / --no-validate  Validate authentication parameters  [default:
                              validate]
  --no-color                  If provided, don't color terminal log output
  -v, --verbose               Verbosity to use within the CLI. Pass -v to
                              allow info-level logs, or -vv for debug-level.
                              [default: 0]
  -h, --help                  Show this message and exit.

nom config profile list¤

List the profiles in your Nominal config

Usage:

nom config profile list [OPTIONS]

Options:

  --no-color     If provided, don't color terminal log output
  -v, --verbose  Verbosity to use within the CLI. Pass -v to allow info-level
                 logs, or -vv for debug-level.  [default: 0]
  -h, --help     Show this message and exit.

nom config profile remove¤

Remove a profile from your Nominal config

Usage:

nom config profile remove [OPTIONS] PROFILE

Options:

  --no-color     If provided, don't color terminal log output
  -v, --verbose  Verbosity to use within the CLI. Pass -v to allow info-level
                 logs, or -vv for debug-level.  [default: 0]
  -h, --help     Show this message and exit.

nom container¤

Work with containerized extractors and the container images they run.

An extractor carries identity; its execution contract (inputs, parameters, output format, timestamp defaults) lives on the container images registered against it, exactly one of which is active.

Usage:

nom container [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom container extractor¤

Create and manage containerized extractors and their image lifecycle

Usage:

nom container extractor [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom container extractor archive¤

Archive a containerized extractor

Usage:

nom container extractor archive [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom container extractor create¤

Create a containerized extractor.

A newly created extractor has no container image: register one with register-image and activate it with set-active-image before ingesting.

Usage:

nom container extractor create [OPTIONS]

Options:

  -n, --name TEXT          [required]
  -d, --description TEXT   description of the extractor
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom container extractor get¤

Get a containerized extractor by its RID

Usage:

nom container extractor get [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom container extractor register-image¤

Upload a docker save tarball and register it as a container image for an extractor.

Prints the resulting container image RID on stdout (status messages go to stderr), suitable for capturing in CI:

IMAGE_RID=$(nom container extractor register-image -r "$EXTRACTOR_RID" \
    -f image.tar -t $(git rev-parse --short HEAD) -c extractor-config.json)
nom container extractor set-active-image -r "$EXTRACTOR_RID" -i "$IMAGE_RID"

The registered image starts PENDING and must be activated with set-active-image once READY.

Build the image for amd64 (docker build --platform linux/amd64). Nominal runs extractor images on amd64 and registration does not check the tarball's architecture, so an arm64 image registers and activates, then fails at ingest with an exec format error.

Usage:

nom container extractor register-image [OPTIONS]

Options:

  -r, --rid TEXT                  RID of the extractor to register the image
                                  against  [required]
  -f, --file FILE                 path to the uncompressed `docker save`
                                  tarball to upload  [required]
  -t, --tag TEXT                  tag to register the image under, typically a
                                  git short SHA
  -c, --config FILE               path to a JSON file describing the image's
                                  execution contract: `inputs` and
                                  `parameters` (lists of objects with
                                  snake_case FileExtractionInput /
                                  FileExtractionParameter fields), and
                                  optionally `tag`,
                                  `default_timestamp_column`,
                                  `default_timestamp_type`, and
                                  `output_format`. Typically a per-package
                                  config checked into the repo. Values
                                  supplied via flags override fields in the
                                  JSON.
  --timestamp-column TEXT         the column containing timestamp data in the
                                  extractor's output files
  --timestamp-type [iso_8601|epoch_picoseconds|epoch_nanoseconds|epoch_microseconds|epoch_milliseconds|epoch_seconds|epoch_minutes|epoch_hours|epoch_days]
                                  interpretation of the timestamp column in
                                  the extractor's output files
  --output-format [avro_stream|csv|manifest|parquet]
                                  file format the extractor writes  [default:
                                  parquet]
  --wait / --no-wait              wait until the image is READY  [default:
                                  wait]
  --profile TEXT                  If provided, use the given named config
                                  profile for instantiating a Nominal Client.
                                  This is the preferred mechanism for
                                  instantiating a client today-- see `nom
                                  config profile add` to create a
                                  configuration profile. If provided, takes
                                  precedence over --token, --token-path, and
                                  --base-url.  [required]
  --trust-store-path FILE         Path to a trust store CA root file to
                                  initiate SSL connections. If not provided,
                                  defaults to certifi's trust store.
  --no-color                      If provided, don't color terminal log output
  -v, --verbose                   Verbosity to use within the CLI. Pass -v to
                                  allow info-level logs, or -vv for debug-
                                  level.  [default: 0]
  -h, --help                      Show this message and exit.

Search for containerized extractors (filters are ANDed together)

Usage:

nom container extractor search [OPTIONS]

Options:

  --include-archived        include archived extractors in the results
  --file-extension TEXT     only include extractors whose active image accepts
                            files with this suffix (e.g. "csv" -- no leading
                            dot)
  --workspace TEXT          workspace RID to search  [default: the profile's
                            workspace]
  -o, --output FILE         If provided, a path to write the output to as a
                            file
  -f, --format [csv|table]  Output data format to represent the data as
                            [default: table]
  --profile TEXT            If provided, use the given named config profile
                            for instantiating a Nominal Client. This is the
                            preferred mechanism for instantiating a client
                            today-- see `nom config profile add` to create a
                            configuration profile. If provided, takes
                            precedence over --token, --token-path, and --base-
                            url.  [required]
  --trust-store-path FILE   Path to a trust store CA root file to initiate SSL
                            connections. If not provided, defaults to
                            certifi's trust store.
  --no-color                If provided, don't color terminal log output
  -v, --verbose             Verbosity to use within the CLI. Pass -v to allow
                            info-level logs, or -vv for debug-level.
                            [default: 0]
  -h, --help                Show this message and exit.

nom container extractor set-active-image¤

Select the container image an extractor runs when ingesting

Usage:

nom container extractor set-active-image [OPTIONS]

Options:

  -r, --rid TEXT           RID of the extractor  [required]
  -i, --image-rid TEXT     RID of the registered image to activate  [required]
  --wait / --no-wait       wait until the image is READY before activating
                           (with --no-wait, a non-READY image errors)
                           [default: wait]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom container extractor unarchive¤

Unarchive a containerized extractor

Usage:

nom container extractor unarchive [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom container extractor update¤

Update mutable fields of a containerized extractor (only the flags you pass are sent)

Usage:

nom container extractor update [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  -n, --name TEXT          replace the extractor's name
  -d, --description TEXT   replace the extractor's description
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom container extractor validate-config¤

Validate a register-image config JSON without contacting Nominal.

Runs the exact validation register-image performs before uploading, so it can lint a checked-in config in CI without credentials. Values that must be supplied via flags at register time (e.g. a missing tag) are reported as notes, not errors.

Usage:

nom container extractor validate-config [OPTIONS] CONFIG_PATH

Options:

  --no-color     If provided, don't color terminal log output
  -v, --verbose  Verbosity to use within the CLI. Pass -v to allow info-level
                 logs, or -vv for debug-level.  [default: 0]
  -h, --help     Show this message and exit.

nom container image¤

Inspect and manage container images in Nominal's registry

Usage:

nom container image [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom container image delete¤

Delete a container image (fails if an extractor still has it as its active image)

Usage:

nom container image delete [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --yes                    skip the confirmation prompt
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom container image get¤

Get a container image by its RID

Usage:

nom container image get [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

Search for container images, filtering by tag, status, and/or extractor (filters are ANDed together)

Usage:

nom container image search [OPTIONS]

Options:

  -t, --tag TEXT                  filter to images with this exact tag
  --status [pending|ready|failed]
                                  filter to images with this lifecycle status
  -e, --extractor TEXT            filter to images registered against this
                                  extractor RID
  --workspace TEXT                workspace RID to search  [default: the
                                  profile's workspace]
  -o, --output FILE               If provided, a path to write the output to
                                  as a file
  -f, --format [csv|table]        Output data format to represent the data as
                                  [default: table]
  --profile TEXT                  If provided, use the given named config
                                  profile for instantiating a Nominal Client.
                                  This is the preferred mechanism for
                                  instantiating a client today-- see `nom
                                  config profile add` to create a
                                  configuration profile. If provided, takes
                                  precedence over --token, --token-path, and
                                  --base-url.  [required]
  --trust-store-path FILE         Path to a trust store CA root file to
                                  initiate SSL connections. If not provided,
                                  defaults to certifi's trust store.
  --no-color                      If provided, don't color terminal log output
  -v, --verbose                   Verbosity to use within the CLI. Pass -v to
                                  allow info-level logs, or -vv for debug-
                                  level.  [default: 0]
  -h, --help                      Show this message and exit.

nom dataset¤

Usage:

nom dataset [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom dataset get¤

Fetch a dataset by its RID

Usage:

nom dataset get [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom dataset summarize¤

Summarize the dataset(s) by their schema (column names, types, and RIDs)

Usage:

nom dataset summarize [OPTIONS]

Options:

  -r, --rid TEXT                RID(s) of the dataset(s) to summarize
                                [required]
  --show-rids / --no-show-rids  If provided, show channel / dataset RIDs as
                                part of tabulated output  [default: no-show-
                                rids]
  -o, --output FILE             If provided, a path to write the output to as
                                a file
  -f, --format [csv|table]      Output data format to represent the data as
                                [default: table]
  --profile TEXT                If provided, use the given named config
                                profile for instantiating a Nominal Client.
                                This is the preferred mechanism for
                                instantiating a client today-- see `nom config
                                profile add` to create a configuration
                                profile. If provided, takes precedence over
                                --token, --token-path, and --base-url.
                                [required]
  --trust-store-path FILE       Path to a trust store CA root file to initiate
                                SSL connections. If not provided, defaults to
                                certifi's trust store.
  --no-color                    If provided, don't color terminal log output
  -v, --verbose                 Verbosity to use within the CLI. Pass -v to
                                allow info-level logs, or -vv for debug-level.
                                [default: 0]
  -h, --help                    Show this message and exit.

nom dataset upload-csv¤

Upload a local CSV file to Nominal, create and ingest the data into a dataset, and print the details of the newly created dataset to the user.

Usage:

nom dataset upload-csv [OPTIONS]

Options:

  -n, --name TEXT                 [required]
  -f, --file TEXT                 path to the CSV file to upload  [required]
  -t, --timestamp-column TEXT     the primary timestamp column name
                                  [required]
  -T, --timestamp-type [iso_8601|epoch_days|epoch_hours|epoch_minutes|epoch_seconds|epoch_milliseconds|epoch_microseconds|epoch_nanoseconds]
                                  interpretation the primary timestamp column
                                  [required]
  -d, --description TEXT          description of the dataset
  --channel-name-delimiter TEXT   the character used to delimit the hierarchy
                                  in the channel name  [default: .]
  --wait / --no-wait              wait until the upload is complete  [default:
                                  wait]
  --profile TEXT                  If provided, use the given named config
                                  profile for instantiating a Nominal Client.
                                  This is the preferred mechanism for
                                  instantiating a client today-- see `nom
                                  config profile add` to create a
                                  configuration profile. If provided, takes
                                  precedence over --token, --token-path, and
                                  --base-url.  [required]
  --trust-store-path FILE         Path to a trust store CA root file to
                                  initiate SSL connections. If not provided,
                                  defaults to certifi's trust store.
  --no-color                      If provided, don't color terminal log output
  -v, --verbose                   Verbosity to use within the CLI. Pass -v to
                                  allow info-level logs, or -vv for debug-
                                  level.  [default: 0]
  -h, --help                      Show this message and exit.

nom download¤

Browse assets, pick a dataset, filter channels by exact name, and download.

Usage:

nom download [OPTIONS]

Options:

  --channels-per-request INTEGER RANGE
                                  Number of channels to request at a time. For
                                  requesting a small number of channels,
                                  setting this value low helps parallelize
                                  downloads.  [default: 10; x>=1]
  --points-per-file INTEGER RANGE
                                  Number of points to put in each written
                                  file.  [default: 25000000; x>=1]
  --format [csv|parquet]          [default: parquet]
  --profile TEXT                  If provided, use the given named config
                                  profile for instantiating a Nominal Client.
                                  This is the preferred mechanism for
                                  instantiating a client today-- see `nom
                                  config profile add` to create a
                                  configuration profile. If provided, takes
                                  precedence over --token, --token-path, and
                                  --base-url.  [required]
  --trust-store-path FILE         Path to a trust store CA root file to
                                  initiate SSL connections. If not provided,
                                  defaults to certifi's trust store.
  --no-color                      If provided, don't color terminal log output
  -v, --verbose                   Verbosity to use within the CLI. Pass -v to
                                  allow info-level logs, or -vv for debug-
                                  level.  [default: 0]
  -h, --help                      Show this message and exit.

nom migrate¤

Commands to migrate resources between Nominal tenants.

Usage:

nom migrate [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom migrate copy¤

Copy resources from a source tenant to a destination tenant.

Usage:

nom migrate copy [OPTIONS]

Options:

  --destination-profile TEXT      If provided, use the given named config
                                  profile for instantiating a Nominal Client
                                  for the destination tenant. This is the
                                  preferred mechanism for instantiating a
                                  client today-- see `nom config profile add`
                                  to create a configuration profile. If
                                  provided, takes precedence over --token,
                                  --token-path, and --base-url.  [required]
  --source-profile TEXT           If provided, use the given named config
                                  profile for instantiating a Nominal Client
                                  for the source tenant. This is the preferred
                                  mechanism for instantiating a client today--
                                  see `nom config profile add` to create a
                                  configuration profile. If provided, takes
                                  precedence over --token, --token-path, and
                                  --base-url.  [required]
  --trust-store-path FILE         Path to a trust store CA root file to
                                  initiate SSL connections. If not provided,
                                  defaults to certifi's trust store.
  --no-color                      If provided, don't color terminal log output
  -v, --verbose                   Verbosity to use within the CLI. Pass -v to
                                  allow info-level logs, or -vv for debug-
                                  level.  [default: 0]
  --config FILE                   Path to the migration config YAML file.
                                  [required]
  --migration-state-path PATH     Path to load/save migration state JSON for
                                  resumable migrations. Defaults to
                                  'migration_state.json'.
  --max-workers INTEGER RANGE     Maximum number of top-level asset/template
                                  migrations to run concurrently.  [default:
                                  1; x>=1]
  --video-ingest-timeout-seconds INTEGER RANGE
                                  How long to wait for a copied video to
                                  finish ingesting before recording it as
                                  incomplete and moving on. 0 waits
                                  indefinitely.  [default: 7200; x>=0]
  --dry-run                       Log what would be created without writing
                                  anything to the destination tenant or state
                                  file.
  -h, --help                      Show this message and exit.

nom migrate prep¤

Count in-scope and out-of-scope resources and generate a migration config.

Usage:

nom migrate prep [OPTIONS]

Options:

  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  --name TEXT              Name for the migration (written into the generated
                           config file).  [required]
  --output FILE            Path where the generated migration config YAML will
                           be written.  [required]
  -h, --help               Show this message and exit.

nom migrate summary¤

Summarize a migration as a markdown table. Fully offline: no profiles or tokens required.

Usage:

nom migrate summary [OPTIONS]

Options:

  --no-color          If provided, don't color terminal log output
  -v, --verbose       Verbosity to use within the CLI. Pass -v to allow info-
                      level logs, or -vv for debug-level.  [default: 0]
  --from-config FILE  Migration config YAML for an offline size check. Repeat
                      the flag to summarize several configs.
  --from-log FILE     Captured 'nom migrate copy --dry-run' log to tally
                      would-create lines from.
  --from-state FILE   Migration-state JSON to count created resources from.
  --output FILE       File to append the markdown summary to, e.g.
                      $GITHUB_STEP_SUMMARY.
  -h, --help          Show this message and exit.

nom mis¤

This CLI processes an MIS and turns it into unit assignments and channel descriptions on a dataset. MIS must be a CSV with the following columns: Channel, Description, UCUM Unit

Example:

Channel, Description, UCUM Unit

RPM, Engine RPM, rpm

ECT1, Engine Coolant Temperature Main, Cel

Usage:

nom mis [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom mis list-units¤

List all available units in Nominal.

Usage:

nom mis list-units [OPTIONS]

Options:

  -o, --output FILE         If provided, write the output to a file.
  -f, --format [table|csv]  The format to represent the data as  [default:
                            table]
  --profile TEXT            If provided, use the given named config profile
                            for instantiating a Nominal Client. This is the
                            preferred mechanism for instantiating a client
                            today-- see `nom config profile add` to create a
                            configuration profile. If provided, takes
                            precedence over --token, --token-path, and --base-
                            url.  [required]
  --trust-store-path FILE   Path to a trust store CA root file to initiate SSL
                            connections. If not provided, defaults to
                            certifi's trust store.
  --no-color                If provided, don't color terminal log output
  -v, --verbose             Verbosity to use within the CLI. Pass -v to allow
                            info-level logs, or -vv for debug-level.
                            [default: 0]
  -h, --help                Show this message and exit.

nom mis process¤

Processes an MIS file and updates channel descriptions and units.

Usage:

nom mis process [OPTIONS] MIS_PATH

Options:

  --dataset-rid TEXT       The RID of the dataset to update.  [required]
  --sheet TEXT             The sheet to use in the Excel file if parsing
                           direct from Excel. Only needed if there are
                           multiple sheets.
  --override-channel-info  If channel is already present and has different
                           description/units information, overwrite.
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom mis validate¤

Validate units in an MIS file against available units in Nominal.

Usage:

nom mis validate [OPTIONS] MIS_PATH

Options:

  --sheet TEXT             The sheet to use in the Excel file if parsing
                           direct from Excel. Only needed if there are
                           multiple sheets.
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.

nom run¤

Usage:

nom run [OPTIONS] COMMAND [ARGS]...

Options:

  -h, --help  Show this message and exit.

nom run create¤

Create a new run

Usage:

nom run create [OPTIONS]

Options:

  -n, --name TEXT            [required]
  -s, --start TEXT           [required]
  -e, --end TEXT             [required]
  -d, --description TEXT     description of the run
  --property <TEXT TEXT>...
  --label TEXT
  --profile TEXT             If provided, use the given named config profile
                             for instantiating a Nominal Client. This is the
                             preferred mechanism for instantiating a client
                             today-- see `nom config profile add` to create a
                             configuration profile. If provided, takes
                             precedence over --token, --token-path, and
                             --base-url.  [required]
  --trust-store-path FILE    Path to a trust store CA root file to initiate
                             SSL connections. If not provided, defaults to
                             certifi's trust store.
  --no-color                 If provided, don't color terminal log output
  -v, --verbose              Verbosity to use within the CLI. Pass -v to allow
                             info-level logs, or -vv for debug-level.
                             [default: 0]
  -h, --help                 Show this message and exit.

nom run get¤

Get a run by its RID

Usage:

nom run get [OPTIONS]

Options:

  -r, --rid TEXT           [required]
  --profile TEXT           If provided, use the given named config profile for
                           instantiating a Nominal Client. This is the
                           preferred mechanism for instantiating a client
                           today-- see `nom config profile add` to create a
                           configuration profile. If provided, takes
                           precedence over --token, --token-path, and --base-
                           url.  [required]
  --trust-store-path FILE  Path to a trust store CA root file to initiate SSL
                           connections. If not provided, defaults to certifi's
                           trust store.
  --no-color               If provided, don't color terminal log output
  -v, --verbose            Verbosity to use within the CLI. Pass -v to allow
                           info-level logs, or -vv for debug-level.  [default:
                           0]
  -h, --help               Show this message and exit.