# nomctl asset

```text
Asset management commands

Usage: nomctl asset <COMMAND>

Commands:
  list            List all assets
  search          Search assets by substring, label, and/or property. Multiple filters are AND-ed together
  get             Get a specific asset by RID
  create          Create a new asset
  add-dataset     Attach a dataset to an asset under a scope name
  add-video       Attach a video to an asset under a scope name
  add-connection  Attach a connection to an asset under a scope name
  update          Update asset metadata
  help            Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help
```

## nomctl asset list

```text
List all assets

Usage: nomctl asset list

Options:
  -h, --help
          Print help
```

## nomctl asset search

```text
Search assets by substring, label, and/or property. Multiple filters are AND-ed together

Usage: nomctl asset search [OPTIONS]

Options:
  -s, --substring <SUBSTR>
          Case-insensitive substring match against the asset name. Repeatable

  -l, --label <LABEL>
          Filter by label. Repeatable

  -p, --property <KEY> <VALUE>
          Filter by property KEY VALUE pair. Repeatable

  -h, --help
          Print help
```

## nomctl asset get

```text
Get a specific asset by RID

Usage: nomctl asset get <RID>

Arguments:
  <RID>
          The RID of the asset to retrieve

Options:
  -h, --help
          Print help
```

## nomctl asset create

```text
Create a new asset

Usage: nomctl asset create [OPTIONS] --name <NAME>

Options:
  -n, --name <NAME>
          The asset name

  -d, --description <DESCRIPTION>
          Set the asset description

  -l, --label <LABEL>
          Add labels. Repeatable

  -p, --property <KEY> <VALUE>
          Add properties as KEY VALUE pairs. Repeatable

  -h, --help
          Print help
```

## nomctl asset add-dataset

```text
Attach a dataset to an asset under a scope name

Usage: nomctl asset add-dataset [OPTIONS] <RID> <NAME> <DATASET_RID>

Arguments:
  <RID>
          The RID of the asset

  <NAME>
          Scope name for the dataset within the asset

  <DATASET_RID>
          The RID of the dataset to attach

Options:
      --tag-filter <KEY> <VALUE>
          Filter the scope to series whose tags match all given KEY VALUE pairs. Repeatable

  -h, --help
          Print help
```

## nomctl asset add-video

```text
Attach a video to an asset under a scope name

Usage: nomctl asset add-video <RID> <NAME> <VIDEO_RID>

Arguments:
  <RID>
          The RID of the asset

  <NAME>
          Scope name for the video within the asset

  <VIDEO_RID>
          The RID of the video to attach

Options:
  -h, --help
          Print help
```

## nomctl asset add-connection

```text
Attach a connection to an asset under a scope name

Usage: nomctl asset add-connection <RID> <NAME> <CONNECTION_RID>

Arguments:
  <RID>
          The RID of the asset

  <NAME>
          Scope name for the connection within the asset

  <CONNECTION_RID>
          The RID of the connection to attach

Options:
  -h, --help
          Print help
```

## nomctl asset update

```text
Update asset metadata

Usage: nomctl asset update [OPTIONS] <RID>

Arguments:
  <RID>
          The RID of the asset to update

Options:
  -n, --name <NAME>
          Set the asset name

  -d, --description <DESCRIPTION>
          Set the asset description

  -l, --label <LABEL>
          Replace all labels. Repeatable. Omit to leave labels unchanged

      --clear-labels
          Clear all labels

  -p, --property <KEY> <VALUE>
          Replace all properties as KEY VALUE pairs. Repeatable. Omit to leave properties unchanged

      --clear-properties
          Clear all properties

  -h, --help
          Print help
```