Skip to content

ilab-cli.md

Latest commit

 

History

History
810 lines (554 loc) · 29.6 KB

ilab-cli.md

File metadata and controls

810 lines (554 loc) · 29.6 KB
copyright
years
2025
lastupdated 2025-10-09
keywords instructlab, cli, plugin
content-type cli-docs

{{site.data.keyword.attribute-definition-list}}

{{site.data.keyword.instructlab_short}} CLI

{: #ilab-cli}

Globals

{: #ilab-globals}

Options

{: #ilab-global-options}

--project-id (string) : The {{site.data.keyword.instructlab_short}} project ID.

--output (string) : Choose an output format - can be 'json', 'yaml', or 'table'. Defaults to 'table'.

-j, --jmes-query (string) : Provide a JMESPath query to customize output.

-q, --quiet : Suppresses verbose messages.

-v, --version : Prints the plug-in version.

Example

{: #ilab-global-options-example}

ibmcloud ilab
    --project-id=project_id \
    --output=json \
    --jmes-query="[:10]" \
    --quiet

{: pre}

Note: This example only demonstrates the global options available to all sub-commands and is not a valid command itself.

Config

{: #ilab-cli-config-command}

Global parameters can also be stored in persistent configuration so that they do not need to be manually specified each time the plug-in is invoked. Each parameter can be configured with the config command and its subcommands.

ibmcloud ilab config

ibmcloud ilab config set

{: #ilab-cli-config-set-command}

Set a new config value for a specific option. Each subcommand of the set command maps to a global option. Each subcommand accepts a single argument, the string representation of the value to store for the option.

ibmcloud ilab config set <option> <value>

Examples

{: #ilab-config-set-command-examples}

ibmcloud ilab config get

{: #ilab-cli-config-get-command}

Print out the currently set value for a specific option. Each subcommand of the get command maps to a global option.

ibmcloud ilab config get <option>

Examples

{: #ilab-config-get-command-examples}

ibmcloud ilab config unset

{: #ilab-cli-config-unset-command}

Unset the currently set value for a specific option. Each subcommand of the unset command maps to a global option.

The subcommands available for this service are: .

ibmcloud ilab config unset <option>

Examples

{: #ilab-config-unset-command-examples}

ibmcloud ilab config list

{: #ilab-cli-config-list-command}

List out all the currently set config values.

ibmcloud ilab config list

Examples

{: #ilab-config-list-command-examples}

ibmcloud ilab config list

{: pre}

Taxonomy

{: #ilab-taxonomy-cli}

Operations to manage taxonomies.

ibmcloud ilab taxonomy --help

ibmcloud ilab taxonomy add

{: #ilab-cli-taxonomy-add-command}

Add a taxonomy to your Cloud Object Storage bucket.

ibmcloud ilab taxonomy add --name NAME [--taxonomy-path TAXONOMY-PATH] [--taxonomy-path-cos TAXONOMY-PATH-COS] [--cos-bucket-information COS-BUCKET-INFORMATION | --cos-id COS-ID --cos-bucket COS-BUCKET --cos-endpoint COS-ENDPOINT] [--secrets-manager-config SECRETS-MANAGER-CONFIG | --secrets-manager-git-url SECRETS-MANAGER-GIT-URL --secrets-manager-git-id SECRETS-MANAGER-GIT-ID]

Command options

{: #ilab-taxonomy-add-cli-options}

--name (string) : The name you want to give your taxonomy. Required.

The maximum length is `32` characters. The minimum length is `1` character. The value must match regular expression `/^[a-zA-Z0-9]([_-]?[a-zA-Z0-9]+)*$/`.

--taxonomy-path (string) : The absolute or relative path to the taxonomy.tar.gz file on your local machine. For example 'Downloads/taxonomy.tar.gz'.

The maximum length is `100` characters. The minimum length is `10` characters. The value must match regular expression `/^(?:[a-zA-Z]:\\\\|\\.{0,2}[\\\/]|\/)?(?:[^\\\/:*?"<>|\\r\\n]+[\\\/])*[^\\\/:*?"<>|\\r\\n]*$/`.

--taxonomy-path-cos (string) : The path in your Cloud Object Storage bucket where you want to store your taxonomy. By default, taxonomies are stored at 'taxonomies/taxonomy-<current_time>.tar.gz'.

The maximum length is `100` characters. The minimum length is `20` characters. The value must match regular expression `/^([-_.\/a-zA-Z0-9][a-zA-Z0-9]+)*[^\/]$/`.

--cos-bucket-information (CosBucketInformationPrototype) : Cloud Object Storage bucket information. This JSON option can instead be provided by setting individual fields with other options. It is mutually exclusive with those options.

Provide a JSON string option or specify a JSON file to read from by providing a filepath option that begins with a `@`, e.g. `--cos-bucket-information=@path/to/file.json`.

--secrets-manager-config (SecretsManagerConfigPrototype) : Secrets Manager configuration details. This JSON option can instead be provided by setting individual fields with other options. It is mutually exclusive with those options.

Provide a JSON string option or specify a JSON file to read from by providing a filepath option that begins with a `@`, e.g. `--secrets-manager-config=@path/to/file.json`.

--cos-id (string) : Your Cloud Object Storage instance ID. This option is only required when you want {{site.data.keyword.instructlab_short}} to automatically create a bucket in your Object Storage instance. This option provides a value for a sub-field of the JSON option 'cos-bucket-information'. It is mutually exclusive with that option.

The maximum length is `100` characters. The minimum length is `20` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

-b, --cos-bucket (string) : The Cloud Object Storage bucket where you want to storage your taxonomy.tar.gz. This option provides a value for a sub-field of the JSON option 'cos-bucket-information'. It is mutually exclusive with that option.

The maximum length is `63` characters. The minimum length is `3` characters. The value must match regular expression `/^[a-zA-Z0-9]([.-]?[a-zA-Z0-9]+)*$/`.

-e, --cos-endpoint (string) : The endpoint to the Cloud Object Storage bucket. This option provides a value for a sub-field of the JSON option 'cos-bucket-information'. It is mutually exclusive with that option.

The maximum length is `300` characters. The minimum length is `13` characters. The value must match regular expression `/^https:\/\/([a-zA-Z0-9-]+\\.)*cloud-object-storage(?:\\.test)?\\.appdomain\\.cloud$/`.

--secrets-manager-git-url (string) : The URL to a Secrets Manager instance to retrieve your user-defined secrets. The credentials in your Secrets Manager instance are used to retrieve the knowledge documents that are referenced in your taxonomy from the repository where they're stored. This option provides a value for a sub-field of the JSON option 'secrets-manager-config'. It is mutually exclusive with that option.

The maximum length is `300` characters. The minimum length is `13` characters. The value must match regular expression `/^https:\/\/([a-zA-Z0-9-]+\\.)*secrets-manager(?:\\.test)?\\.appdomain\\.cloud$/`.

--secrets-manager-git-id (string) : The Secrets Manager ID that points to your personal authorization token and URL in JSON format. The credentials in your Secrets Manager instance are used to retrieve the knowledge documents that are referenced in your taxonomy from the repository where they're stored. This option provides a value for a sub-field of the JSON option 'secrets-manager-config'. It is mutually exclusive with that option.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Examples

{: #ilab-taxonomy-add-examples}

ibmcloud ilab taxonomy add \
    --name example-taxonomy-1 \
    --taxonomy-path exampleString \
    --taxonomy-path-cos taxonomies/taxonomy.tar.gz \
    --cos-bucket-information '{"service_instance_id": "628e4348-2183-42fa-a03a-6f0f78453530", "bucket": "example-bucket-1", "endpoint": "https://s3.us-east.cloud-object-storage.appdomain.cloud"}' \
    --secrets-manager-config '{"url": "https://12345678-abcd-1234-5678-abcdefghijkl.us-east.secrets-manager.appdomain.cloud", "git_id": "d9428888-122b-11e1-b85c-61cd3cbb3210"}'

{: pre}

Alternatively, granular options are available for the sub-fields of JSON string options:

ibmcloud ilab taxonomy add \
    --name example-taxonomy-1 \
    --taxonomy-path exampleString \
    --taxonomy-path-cos taxonomies/taxonomy.tar.gz \
    --cos-id 628e4348-2183-42fa-a03a-6f0f78453530 \
    --cos-bucket example-bucket-1 \
    --cos-endpoint https://s3.us-east.cloud-object-storage.appdomain.cloud \
    --secrets-manager-git-url https://12345678-abcd-1234-5678-abcdefghijkl.us-east.secrets-manager.appdomain.cloud \
    --secrets-manager-git-id d9428888-122b-11e1-b85c-61cd3cbb3210

{: pre}

ibmcloud ilab taxonomy list

{: #ilab-cli-taxonomy-list-command}

Lists the details of a collection of taxonomy resources.

ibmcloud ilab taxonomy list

Example

{: #ilab-taxonomy-list-examples}

ibmcloud ilab taxonomy list

{: pre}

Default JMESPath

{: #ilab-taxonomy-list-default-jmespath}

A JMESPath query will be applied to this output of this command by default, if one is not provided by the user. The exact query will depend on the scenario and the output format requested. You can see the condition for each default JMESPath query in the following table:

Response Output Query
Success Default -
Table taxonomies[].{id:id,name:name,taxonomy_path_cos:taxonomy_path_cos,created_at:created_at,state:state,status:status}
{: caption="Default JMESPath" caption-side="bottom"}

If a custom JMESPath query is provided, it will replace any of the JMESPath in the table above.

ibmcloud ilab taxonomy get

{: #ilab-cli-taxonomy-get-command}

Gets the details of a taxonomy resource.

ibmcloud ilab taxonomy get --id ID

Command options

{: #ilab-taxonomy-get-cli-options}

--id (string) : Unique Identifier to a taxonomy. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-taxonomy-get-examples}

ibmcloud ilab taxonomy get \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

Default JMESPath

{: #ilab-taxonomy-get-default-jmespath}

A JMESPath query will be applied to this output of this command by default, if one is not provided by the user. The exact query will depend on the scenario and the output format requested. You can see the condition for each default JMESPath query in the following table:

Response Output Query
Success Default -
Table {id:id,name:name,project_id:project_id,taxonomy_path_cos:taxonomy_path_cos,created_at:created_at,state:state,status:status}
{: caption="Default JMESPath" caption-side="bottom"}

If a custom JMESPath query is provided, it will replace any of the JMESPath in the table above.

ibmcloud ilab taxonomy delete

{: #ilab-cli-taxonomy-delete-command}

Deletes a taxonomy resource.

ibmcloud ilab taxonomy delete --id ID

Command options

{: #ilab-taxonomy-delete-cli-options}

--id (string) : Unique Identifier to a taxonomy. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-taxonomy-delete-examples}

ibmcloud ilab taxonomy delete \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

Data

{: #ilab-data-cli}

Operations to manage data.

ibmcloud ilab data --help

ibmcloud ilab data generate

{: #ilab-cli-data-generate-command}

Generates data against a specified taxonomy resource.

ibmcloud ilab data generate --name NAME [--taxonomy-id TAXONOMY-ID] [--data-destination DATA-DESTINATION | --output-cos-bucket OUTPUT-COS-BUCKET --output-cos-endpoint OUTPUT-COS-ENDPOINT] [--data-sources DATA-SOURCES | --internal-ids INTERNAL-IDS --skills-paths SKILLS-PATHS --knowledge-paths KNOWLEDGE-PATHS --skills-knowledge-cos-bucket SKILLS-KNOWLEDGE-COS-BUCKET --skills-knowledge-cos-endpoint SKILLS-KNOWLEDGE-COS-ENDPOINT --data-sources-user-provided-paths DATA-SOURCES-USER-PROVIDED-PATHS]

Command options

{: #ilab-data-generate-cli-options}

--name (string) : The name to give a data resource. Required.

The maximum length is `32` characters. The minimum length is `1` character. The value must match regular expression `/^[a-zA-Z0-9]([_-]?[a-zA-Z0-9]+)*$/`.

--taxonomy-id (string) : The taxonomy ID that was used for synthetic data generation. In model training, this value is used for validating the data ID. This value is available only after the model training job is accepted by an agent.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

--data-destination (DataDestinationPrototype) : Output Cloud Object Storage bucket information. This JSON option can instead be provided by setting individual fields with other options. It is mutually exclusive with those options.

Provide a JSON string option or specify a JSON file to read from by providing a filepath option that begins with a `@`, e.g. `--data-destination=@path/to/file.json`.

--data-sources (DataSourcesPrototype) : Data sources associated with the taxonomy. This JSON option can instead be provided by setting individual fields with other options. It is mutually exclusive with those options.

Provide a JSON string option or specify a JSON file to read from by providing a filepath option that begins with a `@`, e.g. `--data-sources=@path/to/file.json`.

--output-cos-bucket (string) : The Cloud Object Storage that the output will be stored in. This option provides a value for a sub-field of the JSON option 'data-destination'. It is mutually exclusive with that option.

The maximum length is `63` characters. The minimum length is `3` characters. The value must match regular expression `/^[a-zA-Z0-9]([.-]?[a-zA-Z0-9]+)*$/`.

--output-cos-endpoint (string) : The endpoint to the output Cloud Object Storage bucket. This option provides a value for a sub-field of the JSON option 'data-destination'. It is mutually exclusive with that option.

The maximum length is `300` characters. The minimum length is `13` characters. The value must match regular expression `/^https:\/\/([a-zA-Z0-9-]+\\.)*cloud-object-storage(?:\\.test)?\\.appdomain\\.cloud$/`.

--internal-ids ([]strfmt.UUID) : List of internal UUIDs referencing data sources. This option provides a value for a sub-field of the JSON option 'data-sources'. It is mutually exclusive with that option.

The list items must match regular expression `/^[a-z0-9-]+$/`. The maximum length is `20` items. The minimum length is `0` items.

--skills-paths ([]string) : A set of user provided skills json files present in an authorized Cloud Object Storage bucket containing curated data for fine-tuning. Each file must not exceed 100 GB in size. The accumulative size of all the skills and knowledge json files (including the files from internal ids, if provided) must not exceed 400 GB. This option provides a value for a sub-field of the JSON option 'data-sources'. It is mutually exclusive with that option.

The list items must match regular expression `/^([-_.\/a-zA-Z0-9][a-zA-Z0-9]+)*[^\/]$/`. The maximum length is `20` items. The minimum length is `0` items.

--knowledge-paths ([]string) : A set of user provided knowledge json files present in an authorized Cloud Object Storage bucket containing curated data for fine-tuning. Each file must not exceed 100 GB in size. The accumulative size of all the skills and knowledge json files (including the files from internal ids, if provided) must not exceed 400 GB. This option provides a value for a sub-field of the JSON option 'data-sources'. It is mutually exclusive with that option.

The list items must match regular expression `/^([-_.\/a-zA-Z0-9][a-zA-Z0-9]+)*[^\/]$/`. The maximum length is `20` items. The minimum length is `0` items.

--skills-knowledge-cos-bucket (string) : The Cloud Object Storage bucket where skills/knowledge jsonl is stored. This option provides a value for a sub-field of the JSON option 'data-sources'. It is mutually exclusive with that option.

The maximum length is `63` characters. The minimum length is `3` characters. The value must match regular expression `/^[a-zA-Z0-9]([.-]?[a-zA-Z0-9]+)*$/`.

--skills-knowledge-cos-endpoint (string) : The endpoint to the Cloud Object Storage bucket. This option provides a value for a sub-field of the JSON option 'data-sources'. It is mutually exclusive with that option.

The maximum length is `300` characters. The minimum length is `13` characters. The value must match regular expression `/^https:\/\/([a-zA-Z0-9-]+\\.)*cloud-object-storage(?:\\.test)?\\.appdomain\\.cloud$/`.

--data-sources-user-provided-paths (UserProvidedPathsPrototype) : User-provided file paths for skills and knowledge training data. Each file must not exceed 100 GB in size. The accumulative size of all the skills and knowledge json files (including the files from internal ids, if provided) must not exceed 400 GB. This option provides a value for a sub-field of the JSON option 'data-sources'. It is mutually exclusive with that option.

Provide a JSON string option or specify a JSON file to read from by providing a filepath option that begins with a `@`, e.g. `--data-sources-user-provided-paths=@path/to/file.json`.

Examples

{: #ilab-data-generate-examples}

ibmcloud ilab data generate \
    --name example-data-1 \
    --taxonomy-id 202a03c4-dcf1-432a-82b7-abecb2e019f7 \
    --data-destination '{"bucket": "example-bucket-1", "endpoint": "https://s3.us-east.cloud-object-storage.appdomain.cloud"}' \
    --data-sources '{"internal_ids": ["9e0a5988-0c7d-44de-ba48-465aef67baee","9e0a5988-0c7d-44de-ba48-465aef67baee"], "skills": ["user_provided_path/skills/skills_1.jsonl","user_provided_path/skills/skills_1.jsonl"], "knowledge": ["user_provided_path/knowledge/knowledge1.jsonl","user_provided_path/knowledge/knowledge1.jsonl"], "bucket": "example-bucket-1", "endpoint": "https://s3.us-east.cloud-object-storage.appdomain.cloud", "user_provided_paths": {"skills": ["user_provided_path/skills/skills_1.jsonl","user_provided_path/skills/skills_1.jsonl"], "knowledge": ["user_provided_path/knowledge/knowledge1.jsonl","user_provided_path/knowledge/knowledge1.jsonl"], "cos_bucket_information": {"bucket": "example-bucket-1", "endpoint": "https://s3.us-east.cloud-object-storage.appdomain.cloud"}}}'

{: pre}

Alternatively, granular options are available for the sub-fields of JSON string options:

ibmcloud ilab data generate \
    --name example-data-1 \
    --taxonomy-id 202a03c4-dcf1-432a-82b7-abecb2e019f7 \
    --output-cos-bucket example-bucket-1 \
    --output-cos-endpoint https://s3.us-east.cloud-object-storage.appdomain.cloud \
    --internal-ids 9e0a5988-0c7d-44de-ba48-465aef67baee,9e0a5988-0c7d-44de-ba48-465aef67baee \
    --skills-paths user_provided_path/skills/skills_1.jsonl,user_provided_path/skills/skills_1.jsonl \
    --knowledge-paths user_provided_path/knowledge/knowledge1.jsonl,user_provided_path/knowledge/knowledge1.jsonl \
    --skills-knowledge-cos-bucket example-bucket-1 \
    --skills-knowledge-cos-endpoint https://s3.us-east.cloud-object-storage.appdomain.cloud \
    --data-sources-user-provided-paths userProvidedPathsPrototype

{: pre}

ibmcloud ilab data list

{: #ilab-cli-data-list-command}

Lists the details of a collection of data resources.

ibmcloud ilab data list

Example

{: #ilab-data-list-examples}

ibmcloud ilab data list

{: pre}

Default JMESPath

{: #ilab-data-list-default-jmespath}

A JMESPath query will be applied to this output of this command by default, if one is not provided by the user. The exact query will depend on the scenario and the output format requested. You can see the condition for each default JMESPath query in the following table:

Response Output Query
Success Default -
Table data[].{id:id,name:name,state:state,status:status,created_at:created_at,completed_at:completed_at}
{: caption="Default JMESPath" caption-side="bottom"}

If a custom JMESPath query is provided, it will replace any of the JMESPath in the table above.

ibmcloud ilab data get

{: #ilab-cli-data-get-command}

Gets the details of a data resource.

ibmcloud ilab data get --id ID

Command options

{: #ilab-data-get-cli-options}

--id (string) : Unique Identifier to data run. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-data-get-examples}

ibmcloud ilab data get \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

Default JMESPath

{: #ilab-data-get-default-jmespath}

A JMESPath query will be applied to this output of this command by default, if one is not provided by the user. The exact query will depend on the scenario and the output format requested. You can see the condition for each default JMESPath query in the following table:

Response Output Query
Success Default -
Table {id:id,name:name,project_id:project_id,state:state,status:status,created_at:created_at,completed_at:completed_at}
{: caption="Default JMESPath" caption-side="bottom"}

If a custom JMESPath query is provided, it will replace any of the JMESPath in the table above.

ibmcloud ilab data delete

{: #ilab-cli-data-delete-command}

Deletes a data resource.

ibmcloud ilab data delete --id ID

Command options

{: #ilab-data-delete-cli-options}

--id (string) : Unique Identifier to data run. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-data-delete-examples}

ibmcloud ilab data delete \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

ibmcloud ilab data cancel

{: #ilab-cli-data-cancel-command}

Cancels the generation of synthetic data.

ibmcloud ilab data cancel --id ID

Command options

{: #ilab-data-cancel-cli-options}

--id (string) : Unique Identifier to data run. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-data-cancel-examples}

ibmcloud ilab data cancel \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

Model

{: #ilab-model-cli}

Operations to manage models.

ibmcloud ilab model --help

ibmcloud ilab model train

{: #ilab-cli-model-train-command}

Trains a model against the specified synthetic data.

ibmcloud ilab model train --name NAME --data-id DATA-ID

Command options

{: #ilab-model-train-cli-options}

--name (string) : The name to give a model resource. Required.

The maximum length is `32` characters. The minimum length is `1` character. The value must match regular expression `/^[a-zA-Z0-9]([_-]?[a-zA-Z0-9]+)*$/`.

--data-id (string) : The ID of the synthetic data generation (SDG) run. You can use this ID to monitor the data generation process. After SDG is complete, your can this ID to retrieve the synthetic data. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-model-train-examples}

ibmcloud ilab model train \
    --name example-model-1 \
    --data-id add785e6-a8c3-4f5f-ab89-c506a3f115da

{: pre}

ibmcloud ilab model list

{: #ilab-cli-model-list-command}

Lists your model resources.

ibmcloud ilab model list

Example

{: #ilab-model-list-examples}

ibmcloud ilab model list

{: pre}

Default JMESPath

{: #ilab-model-list-default-jmespath}

A JMESPath query will be applied to this output of this command by default, if one is not provided by the user. The exact query will depend on the scenario and the output format requested. You can see the condition for each default JMESPath query in the following table:

Response Output Query
Success Default -
Table models[].{created_at:created_at,completed_at:completed_at,id:id,name:name,state:state,status:status}
{: caption="Default JMESPath" caption-side="bottom"}

If a custom JMESPath query is provided, it will replace any of the JMESPath in the table above.

ibmcloud ilab model get

{: #ilab-cli-model-get-command}

Gets the details of a model.

ibmcloud ilab model get --id ID

Command options

{: #ilab-model-get-cli-options}

--id (string) : Unique Identifier to a model training run. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-model-get-examples}

ibmcloud ilab model get \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

Default JMESPath

{: #ilab-model-get-default-jmespath}

A JMESPath query will be applied to this output of this command by default, if one is not provided by the user. The exact query will depend on the scenario and the output format requested. You can see the condition for each default JMESPath query in the following table:

Response Output Query
Success Default -
Table {base_model:base_model,created_at:created_at,completed_at:completed_at,data_id:data_id,id:id,name:name,project_id:project_id,state:state,status:status}
{: caption="Default JMESPath" caption-side="bottom"}

If a custom JMESPath query is provided, it will replace any of the JMESPath in the table above.

ibmcloud ilab model delete

{: #ilab-cli-model-delete-command}

Delete a model.

ibmcloud ilab model delete --id ID

Command options

{: #ilab-model-delete-cli-options}

--id (string) : Unique Identifier to a model training run. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-model-delete-examples}

ibmcloud ilab model delete \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

ibmcloud ilab model cancel

{: #ilab-cli-model-cancel-command}

Cancels the training of a model.

ibmcloud ilab model cancel --id ID

Command options

{: #ilab-model-cancel-cli-options}

--id (string) : Unique Identifier to a model training run. Required.

The maximum length is `36` characters. The minimum length is `36` characters. The value must match regular expression `/^[a-z0-9-]+$/`.

Example

{: #ilab-model-cancel-examples}

ibmcloud ilab model cancel \
    --id 817bc95a-fef0-4039-b936-e0b6fb17b723

{: pre}

Schema examples

{: #ilab-schema-examples}

The following schema examples represent the data that you need to specify for a command option. These examples model the data structure and include placeholder values for the expected value type. When you run a command, replace these values with the values that apply to your environment as appropriate.

CosBucketInformationPrototype

{: #cli-cos-bucket-information-prototype-example-schema}

The following example shows the format of the CosBucketInformationPrototype object.

{
  "service_instance_id" : "628e4348-2183-42fa-a03a-6f0f78453530",
  "bucket" : "example-bucket-1",
  "endpoint" : "https://s3.us-east.cloud-object-storage.appdomain.cloud"
}

{: codeblock}

DataDestinationPrototype

{: #cli-data-destination-prototype-example-schema}

The following example shows the format of the DataDestinationPrototype object.

{
  "bucket" : "example-bucket-1",
  "endpoint" : "https://s3.us-east.cloud-object-storage.appdomain.cloud"
}

{: codeblock}

DataSourcesPrototype

{: #cli-data-sources-prototype-example-schema}

The following example shows the format of the DataSourcesPrototype object.

{
  "internal_ids" : [ "9e0a5988-0c7d-44de-ba48-465aef67baee", "9e0a5988-0c7d-44de-ba48-465aef67baee" ],
  "skills" : [ "user_provided_path/skills/skills_1.jsonl", "user_provided_path/skills/skills_1.jsonl" ],
  "knowledge" : [ "user_provided_path/knowledge/knowledge1.jsonl", "user_provided_path/knowledge/knowledge1.jsonl" ],
  "bucket" : "example-bucket-1",
  "endpoint" : "https://s3.us-east.cloud-object-storage.appdomain.cloud",
  "user_provided_paths" : {
    "skills" : [ "user_provided_path/skills/skills_1.jsonl", "user_provided_path/skills/skills_1.jsonl" ],
    "knowledge" : [ "user_provided_path/knowledge/knowledge1.jsonl", "user_provided_path/knowledge/knowledge1.jsonl" ],
    "cos_bucket_information" : {
      "bucket" : "example-bucket-1",
      "endpoint" : "https://s3.us-east.cloud-object-storage.appdomain.cloud"
    }
  }
}

{: codeblock}

SecretsManagerConfigPrototype

{: #cli-secrets-manager-config-prototype-example-schema}

The following example shows the format of the SecretsManagerConfigPrototype object.

{
  "url" : "https://12345678-abcd-1234-5678-abcdefghijkl.us-east.secrets-manager.appdomain.cloud",
  "git_id" : "d9428888-122b-11e1-b85c-61cd3cbb3210"
}

{: codeblock}

UserProvidedPathsPrototype

{: #cli-user-provided-paths-prototype-example-schema}

The following example shows the format of the UserProvidedPathsPrototype object.

{
  "bucket" : "example-bucket-1",
  "endpoint" : "https://s3.us-east.cloud-object-storage.appdomain.cloud"
}

{: codeblock}