Using input sets¶

Info

Learn the concepts and fundamentals of input sets in the Explanation page.

Input sets are defined sets of input files to use for tests and experiments, such as:

Included in this how-to guide are instructions on how to interact with the actions under the nextmv cloud input-set command tree. Go the reference section or use the --help option to see all the available options for each command.

Create an input set¶

Use the nextmv cloud input-set create command to create a new input set for an application. You can create an input set from the following data sources:

--run-ids: Create from a list of existing run IDs.
--managed-inputs: Create from existing managed inputs in the application. The data should be an array of JSON objects with the following attributes:
- id: The managed input ID.
- name (optional): The name of the managed input.
- description (optional): The description of the managed input.
--instance-id with --start-time and --end-time: Create from instance runs matching the time range criteria.

Here are two example commands that create an input set using run IDs and managed inputs, respectively.

Run IDsManaged inputs

$ nextmv cloud input-set create --app-id uncanny-rodent \
    --run-ids production-QVT7PxEvg \
    --run-ids production-wfqnEbEvg \
    --run-ids production-KyzVPbEvR

⏳ Creating input set...
{
  "app_id": "uncanny-rodent",
  "created_at": "2026-07-27T02:23:10.267370Z",
  "description": "",
  "id": "input-set-q6fquyks",
  "input_ids": [
    "production-QVT7PxEvg",
    "production-wfqnEbEvg",
    "production-KyzVPbEvR"
  ],
  "name": "input-set-q6fquyks",
  "updated_at": "2026-07-27T02:23:10.267370Z",
  "inputs": []
}

$ nextmv cloud input-set create --app-id uncanny-rodent \
    --managed-inputs '[{"id": "baxter-burrow"}]'

⏳ Creating input set...
{
  "app_id": "uncanny-rodent",
  "created_at": "2026-07-27T02:27:42.738745Z",
  "description": "",
  "id": "input-set-0xekoniz",
  "input_ids": [],
  "name": "input-set-0xekoniz",
  "updated_at": "2026-07-27T02:27:42.738745Z",
  "inputs": [
    {
      "id": "baxter-burrow",
      "name": "The managed input of Baxter's Burrow",
      "description": ""
    }
  ]
}

The command above will create a random ID, and use the same identifier for input set's name. The name of the input set is used as a human-readable You can use the --input-set-id and/or --name options to specify a custom ID and name for the input set. For example:

BashOutput

nextmv cloud input-set create --app-id uncanny-rodent \
    --managed-inputs '[{"id": "baxter-burrow"}]' \
    --input-set-id impressive-rabbit \
    --name "Input set for an impressive rabbit"

⏳ Creating input set...
{
  "app_id": "uncanny-rodent",
  "created_at": "2026-07-27T02:29:31.360687Z",
  "description": "",
  "id": "impressive-rabbit",
  "input_ids": [],
  "name": "Input set for an impressive rabbit",
  "updated_at": "2026-07-27T02:29:31.360687Z",
  "inputs": [
    {
      "id": "baxter-burrow",
      "name": "The managed input of Baxter's Burrow",
      "description": ""
    }
  ]
}

Get an input set¶

You can get an input set using the nextmv cloud input-set get command.

BashOutput

nextmv cloud input-set get --app-id uncanny-rodent --input-set-id impressive-rabbit

⏳ Getting input set...
{
  "app_id": "uncanny-rodent",
  "created_at": "2026-07-27T02:29:31.360687Z",
  "description": "",
  "id": "impressive-rabbit",
  "input_ids": [],
  "name": "Input set for an impressive rabbit",
  "updated_at": "2026-07-27T02:29:31.360687Z",
  "inputs": [
    {
      "id": "baxter-burrow",
      "name": "The managed input of Baxter's Burrow",
      "description": ""
    }
  ]
}

You can list all input sets in the application using the nextmv cloud input-set list command.

BashOutput

nextmv cloud input-set list --app-id uncanny-rodent

⏳ Listing input sets...
[
  {
    "app_id": "uncanny-rodent",
    "created_at": "2026-07-27T02:29:31.360687Z",
    "description": "",
    "id": "impressive-rabbit",
    "input_ids": [],
    "name": "Input set for an impressive rabbit",
    "updated_at": "2026-07-27T02:29:31.360687Z",
    "inputs": [
      {
        "id": "baxter-burrow",
        "name": "The managed input of Baxter's Burrow",
        "description": ""
      }
    ]
  },
  ...
  {
    "app_id": "uncanny-rodent",
    "created_at": "2026-07-27T02:23:10.267370Z",
    "description": "",
    "id": "input-set-q6fquyks",
    "input_ids": [
      "production-QVT7PxEvg",
      "production-wfqnEbEvg",
      "production-KyzVPbEvR"
    ],
    "name": "input-set-q6fquyks",
    "updated_at": "2026-07-27T02:23:10.267370Z",
    "inputs": []
  }
]

Update an input set¶

You can update attributes of an input set with the nextmv cloud input-set update command, such as its:

Name
Description
Managed inputs

Please use the --help option on the nextmv cloud input-set update command to see all the available options for updating an input set.

You cannot update the ID of an input set. It is possible to update the managed inputs of an input set through the --managed-inputs option. If an input set was created with runs, and it has input_ids defined on it, you cannot update these at this moment. If you do attempt to update an input set, by passing managed inputs, and it has input_ids defined, the latter will be removed from the input set.

BashOutput

nextmv cloud input-set update \
    --app-id uncanny-rodent \
    --input-set-id impressive-rabbit \
    --name "Updated Input Set Name" \
    --description "Updated description for the input set"

✅ Input set impressive-rabbit updated successfully in application uncanny-rodent.
{
  "app_id": "uncanny-rodent",
  "created_at": "2026-07-27T02:42:42.379973Z",
  "description": "Updated description for the input set",
  "id": "impressive-rabbit",
  "input_ids": [],
  "name": "Updated Input Set Name",
  "updated_at": "2026-07-27T02:43:11.302011Z",
  "inputs": [
    {
      "id": "baxter-burrow",
      "name": "The managed input of Baxter's Burrow",
      "description": ""
    }
  ]
}

Delete an input set¶

Warning

Deleting an input set is irreversible. All the data associated with the input set will be permanently deleted.

Delete an input set using the nextmv cloud input-set delete command. The CLI will prompt you to confirm deletion but you can override it with the --yes option.

BashOutput

nextmv cloud input-set delete --app-id uncanny-rodent --input-set-id impressive-rabbit

Are you sure you want to delete input set impressive-rabbit from application uncanny-rodent? This action cannot be undone.
💡 Confirm Yes
✅ Input set impressive-rabbit deleted successfully from application uncanny-rodent.