# tag ## tag create **Usage** ```none usage: symp tag create [-h] [-f {adaptive_table,json,shell,table,value,yaml}] [-c COLUMN] [--max-width ] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] [-m [NAME=VALUE [NAME=VALUE ...]]] [--description DESCRIPTION] [--scope SCOPE] [--project-id PROJECT_ID] tag ``` **Description** Create a new tag. A tag has a name. The tag can be created as a public tag which is visible to all projects. The tag may also be created by an admin for a project. **Returns** Returns dict: Tag **Mandatory** ```none positional arguments: tag Name of tag ``` **Optional** ```none optional arguments: -h, --help show this help message and exit --description DESCRIPTION Description of tag --scope SCOPE Public or private --project-id PROJECT_ID Project ID for the tag ``` ## tag get **Usage** ```none usage: symp tag get [-h] [-f {adaptive_table,json,shell,table,value,yaml}] [-c COLUMN] [--max-width ] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] [-m [NAME=VALUE [NAME=VALUE ...]]] tag ``` **Description** Get the details of a tag. **Returns** Returns dict: Tag **Mandatory** ```none positional arguments: tag Name of tag ``` **Optional** ```none optional arguments: -h, --help show this help message and exit ``` ## tag list **Usage** ```none usage: symp tag list [-h] [-f {adaptive_table,csv,json,table,value,yaml}] [-c COLUMN] [--max-width ] [--fit-width] [--print-empty] [--noindent] [--quote {all,minimal,none,nonnumeric}] [-m [NAME=VALUE [NAME=VALUE ...]]] [--sort-column SORT_COLUMN] [--type TYPE] [--obj-id OBJ_ID] [--project-id PROJECT_ID] ``` **Description** Get the list of tags. **Returns** Returns list: List of tags **Optional** ```none optional arguments: -h, --help show this help message and exit --type TYPE Type of object (compute, node, image, volume, or snapshot) --obj-id OBJ_ID ID of object to query --project-id PROJECT_ID Project ID of object to query ``` ## tag remove **Usage** ```none usage: symp tag remove [-h] [-f {adaptive_table,json,shell,table,value,yaml}] [-c COLUMN] [--max-width ] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] [-m [NAME=VALUE [NAME=VALUE ...]]] [--project-id PROJECT_ID] tag ``` **Description** Delete a tag. **Mandatory** ```none positional arguments: tag Name of tag ``` **Optional** ```none optional arguments: -h, --help show this help message and exit --project-id PROJECT_ID Project ID for the tag ``` ## tag update **Usage** ```none usage: symp tag update [-h] [-f {adaptive_table,json,shell,table,value,yaml}] [-c COLUMN] [--max-width ] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] [-m [NAME=VALUE [NAME=VALUE ...]]] [--new-tag NEW_TAG] [--new-description NEW_DESCRIPTION] [--new-scope NEW_SCOPE] [--project-id PROJECT_ID] tag ``` **Description** Update the tag parameters: name, scope, description. **Returns** Returns dict: Tag **Mandatory** ```none positional arguments: tag Name of tag ``` **Optional** ```none optional arguments: -h, --help show this help message and exit --new-tag NEW_TAG New name for tag --new-description NEW_DESCRIPTION New description of tag --new-scope NEW_SCOPE Can only be changed from private to public --project-id PROJECT_ID Project ID for the tag ```