Tag Commands

These commands will allow you to interact with the IMS provier tagging service. The IBM Global Search and Tagging API can be used to interact with both the GHOST provider and IMS provider. The GHOST provider will handle tags for things outside of the Classic Infrastructure (aka SoftLayer) space.

tags list

List Tags.

tags list [OPTIONS]

Options

-d, --detail

Show information about the resources using this tag.

tags set

Set Tags.

tags set [OPTIONS]

Options

-t, --tags <tags>

Required Comma seperated list of tags, enclosed in quotes. “tag1, tag2”

-k, --key-name <key_name>

Required Key name of a tag type e.g. GUEST, HARDWARE. See slcli tags taggable output.

-r, --resource-id <resource_id>

Required ID of the object being tagged

tags details

Get details for a Tag. Identifier can be either a name or tag-id

tags details [OPTIONS] IDENTIFIER

Options

--name

Assume identifier is a tag name. Useful if your tag name is a number.

Arguments

IDENTIFIER

Required argument

tags delete

Delete a Tag. Tag names that contain spaces need to be encased in quotes

tags delete [OPTIONS] IDENTIFIER

Options

--name

Assume identifier is a tag name. Useful if your tag name is a number.

Arguments

IDENTIFIER

Required argument

tags taggable

List everything that could be tagged.

tags taggable [OPTIONS]

tags cleanup

Removes all empty tags.

tags cleanup [OPTIONS]

Options

-d, --dry-run

Don’t delete, just show what will be deleted.