advanced commands
The group advanced commands contains those commands which deals with the permissions and the variables residing on projects. For now, all the commands has been grouped to the settings commands as below,
settings
settings command contains two different subcommands which changes the permissions and variables on projects.
Commands available in settings commands are,
Permission
permission command helps you to list, update and delete any existing permissions on any projects.
Note: You must have necessary permission to manage permissions of users on the projects
permission command can be further divided to,
list
list sub-command helps you to list all the users which has permissions on project.
arguments
$ zocli project settings permission list [<:id>|<:name>]
If projectID or projectName is supplied as an argument then, list command will fetch all the permissions for the specific project.
flags
Expect the global flags, there are couple of flags which are available in list sub-command scope. And they are: help, id, name and output. Documentation for each of the flags can be found below.
This flag is available for every commands and sub-commands and this prints the help menu for that specific command, and this flag can be used as,
$ zocli project settings permission list [--help | -h]
Note: If help flag is supplied then, any other flags or arguments will be ignored
If you are not providing project id from the arguments then, you can start the --id flag, and provide the project id to fetch permission details about that specific one. And this exactly works as same as while provided from argument.
Example:
$ zocli project settings permission list [--id | -i] 1
If you are not providing project name from the arguments then, you can start the --name flag, and provide the project name to fetch permission details about that specific project. And this exactly works as same as while provided from argument.
Example:
$ zocli project settings permission list [--name | -n] test
Output flag with format, will trigger the zocli to print the output in the desired format like, JSON and this flag can be used in combination with any other flags. This can be helpful if you want to automate works in 01cloud using any other 3rd party tools (like, jq). And as of right now, zocli supports 2 formats i.e. JSON and YAML.
You can use the output flag as,
$ zocli project settings permission list 2454 -o [json | yaml]
Example:
$ zocli project settings permission list 2454 -o yaml
id: 111
createdat: 2000-00-00T00:00:00.00000Z
...
user:
...
userid: 111
userrole:
id: 3
...
userroleid: 3
projectid: 2454
...
delete
delete command will delete the permission of specific users on any project. NOTE: You must have privilege (permission) to remove the user.
arguments
$ zocli project settings permission delete [<:projectID>|<:projectName>]
If projectID or projectName is supplied as an argument then, list command will fetch all the permissions for the specific project.
flags
This flag is available for every commands and sub-commands and this prints the help menu for that specific command, and this flag can be used as,
$ zocli project settings permission delete [--help | -h]
Note: If help flag is supplied then, any other flags or arguments will be ignored
id
This flag is use to provide the project id to the commannd, which then fetches all the permissions
available on this specific project. This flag can be used as,
zocli project settings permission delete [-i | --id] <:projectId>
name
This flag is use to provide the project name to the commannd, which then fetches all the permissions
available on this specific project. This flag can be used as,
zocli project settings permission delete [-n | --name] <:projectName>
permissionID
This flag is use to provide the permission id to the commannd, which then deletes that specific
permission. This flag can be used as,
zocli project settings permission delete [-p | --pid] <:permissionID>
update
Update users permissions on projects.
arguments
zocli project settings permission update [<:projectID>|<:projectName>]
flags
This flag is available for every commands and sub-commands and this prints the help menu for that specific command, and this flag can be used as,
$ zocli project settings permission update [--help | -h]
Note: If help flag is supplied then, any other flags or arguments will be ignored
id
This flag is use to provide the project id to the commannd, which then fetches all the permissions
available on this specific project. This flag can be used as,
zocli project settings permission update [-i | --id] <:projectId>
name
This flag is use to provide the project name to the commannd, which then fetches all the permissions
available on this specific project. This flag can be used as,
zocli project settings permission update [-n | --name] <:projectName>
permissionID
This flag is use to provide the permission id to the commannd, which then deletes that specific
permission. This flag can be used as,
zocli project settings permission update [-p | --pid] <:permissionID>
Variables
List, update, add or delete any variables in the project scope
Sub-commands available in vars command are,
delete
Delete variables in the project scope
arguments
zocli project settings vars delete [<:projectID>|<:projectName>]
flags
This flag is available for every commands and sub-commands and this prints the help menu for that specific command, and this flag can be used as,
$ zocli project settings vars delete [--help | -h]
Note: If help flag is supplied then, any other flags or arguments will be ignored
id
This flag is use to provide the project id to the commannd, which then fetches all the variables
available on this specific project. This flag can be used as,
zocli project settings vars delete [-i | --id] <:projectId>
name
This flag is use to provide the project name to the commannd, which then fetches all the variables
available on this specific project. This flag can be used as,
zocli project settings vars delete [-n | --name] <:projectName>
variableID
This flag is use to provide the variable id to the commannd, which then helps delete that specific
variable. This flag can be used as,
zocli project settings vars delete [-I | --vid] <:variableID>
variableKey
This flag is use to provide the variable key to the commannd, which then helps delete that specific
variable. This flag can be used as,
zocli project settings vars delete [-k | --key] <:variableKey>
show
This flag helps to print the secret variable in plain text on the console.
zocli project settings vars delete [-s | show]
get
List variables in the project scope
arguments
zocli project settings vars get [<:projectID>|<:projectName>]
flags
This flag is available for every commands and sub-commands and this prints the help menu for that specific command, and this flag can be used as,
$ zocli project settings vars get [--help | -h]
Note: If help flag is supplied then, any other flags or arguments will be ignored
id
This flag is use to provide the project id to the commannd, which then fetches all the variables
available on this specific project. This flag can be used as,
zocli project settings vars get [-i | --id] <:projectId>
name
This flag is use to provide the project name to the commannd, which then fetches all the variables
available on this specific project. This flag can be used as,
zocli project settings vars get [-n | --name] <:projectName>
Output flag with format, will trigger the zocli to print the output in the desired format like, JSON and this flag can be used in combination with any other flags. This can be helpful if you want to automate works in 01cloud using any other 3rd party tools (like, jq). And as of right now, zocli supports 2 formats i.e. JSON and YAML.
You can use the output flag as,
$ zocli project settings vars get 1 -o [json | yaml]
Example:
$ zocli project settings vars get 1 -o yaml
id: 0
key: test
type: normal
value: this is a dummy secret
show
This flag helps to print the secret variable in plain text on the console.
zocli project settings vars get [-s | show]
update
Update project scoped variables
arguments
zocli project settings vars get [<:id>|<:name>]
flags
This flag is available for every commands and sub-commands and this prints the help menu for that specific command, and this flag can be used as,
$ zocli project settings vars update [--help | -h]
Note: If help flag is supplied then, any other flags or arguments will be ignored
id
This flag is use to provide the project id to the commannd, which then fetches all the variables
available on this specific project. This flag can be used as,
zocli project settings vars update [-i | --id] <:projectId>
name
This flag is use to provide the project name to the commannd, which then fetches all the variables
available on this specific project. This flag can be used as,
zocli project settings vars update [-n | --name] <:projectName>
variableID
This flag is use to provide the variable id to the commannd, which then helps update that specific
variable. This flag can be used as,
zocli project settings vars update [-I | --vid] <:variableID>
show
This flag helps to print the secret variable in plain text on the console.
zocli project settings vars update [-s | show]