Sahara CLI Commands¶
The following commands are currently supported by the Sahara CLI:
Plugins¶
dataprocessing plugin configs get
Get plugin configs
usage: dataprocessing plugin configs get [-h] [--file <file>]
<plugin> <plugin_version>
- Positional arguments:
plugin Name of the plugin to provide config information about plugin_version Version of the plugin to provide config information about - Options:
--file Destination file (defaults to a combination of plugin name and plugin version)
dataprocessing plugin list
Lists plugins
usage: dataprocessing plugin list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output
dataprocessing plugin show
Display plugin details
usage: dataprocessing plugin show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>]
[--plugin-version <plugin_version>]
<plugin>
- Positional arguments:
plugin Name of the plugin to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --plugin-version Version of the plugin to display
dataprocessing plugin update
usage: dataprocessing plugin update [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>]
<plugin> <json>
- Positional arguments:
plugin Name of the plugin to provide config information about json JSON representation of the plugin update dictionary - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
Images¶
dataprocessing image tags add
Add image tags
usage: dataprocessing image tags add [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
--tags <tag> [<tag> ...]
<image>
- Positional arguments:
image Name or id of the image - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --tags Tag(s) to add [REQUIRED]
dataprocessing image list
Lists registered images
usage: dataprocessing image list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
[--name <name-regex>]
[--tags <tag> [<tag> ...]]
[--username <username>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --name Regular expression to match image name --tags List images with specific tag(s) --username List images with specific username
dataprocessing image register
Register an image
usage: dataprocessing image register [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
--username <username>
[--description <description>]
<image>
- Positional arguments:
image Name or ID of the image to register - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --username Username of privileged user in the image [REQUIRED] --description Description of the image. If not provided, description of the image will be reset to empty
dataprocessing image tags remove
Remove image tags
usage: dataprocessing image tags remove [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--tags <tag> [<tag> ...] | --all]
<image>
- Positional arguments:
image Name or id of the image - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --tags Tag(s) to remove --all=False Remove all tags from image
dataprocessing image tags set
Set image tags (Replace current image tags with provided ones)
usage: dataprocessing image tags set [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
--tags <tag> [<tag> ...]
<image>
- Positional arguments:
image Name or id of the image - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --tags Tag(s) to set [REQUIRED]
dataprocessing image show
Display image details
usage: dataprocessing image show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>]
<image>
- Positional arguments:
image Name or id of the image to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
dataprocessing image unregister
Unregister image(s)
usage: dataprocessing image unregister [-h] <image> [<image> ...]
- Positional arguments:
image Name(s) or id(s) of the image(s) to unregister
Node Group Templates¶
dataprocessing node group template create
Creates node group template
usage: dataprocessing node group template create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>]
[--plugin <plugin>]
[--plugin-version <plugin_version>]
[--processes <processes> [<processes> ...]]
[--flavor <flavor>]
[--security-groups <security-groups> [<security-groups> ...]]
[--auto-security-group]
[--availability-zone <availability-zone>]
[--floating-ip-pool <floating-ip-pool>]
[--volumes-per-node <volumes-per-node>]
[--volumes-size <volumes-size>]
[--volumes-type <volumes-type>]
[--volumes-availability-zone <volumes-availability-zone>]
[--volumes-mount-prefix <volumes-mount-prefix>]
[--volumes-locality]
[--description <description>]
[--autoconfig]
[--proxy-gateway] [--public]
[--protected]
[--json <filename>]
[--shares <filename>]
[--configs <filename>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name Name of the node group template [REQUIRED if JSON is not provided] --plugin Name of the plugin [REQUIRED if JSON is not provided] --plugin-version Version of the plugin [REQUIRED if JSON is not provided] --processes List of the processes that will be launched on each instance [REQUIRED if JSON is not provided] --flavor Name or ID of the flavor [REQUIRED if JSON is not provided] --security-groups List of the security groups for the instances in this node group --auto-security-group=False Indicates if an additional security group should be created for the node group --availability-zone Name of the availability zone where instances will be created --floating-ip-pool ID of the floating IP pool --volumes-per-node Number of volumes attached to every node --volumes-size Size of volumes attached to node (GB). This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-type Type of the volumes. This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-availability-zone Name of the availability zone where volumes will be created. This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-mount-prefix Prefix for mount point directory. This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-locality=False If enabled, instance and attached volumes will be created on the same physical host. This parameter will be taken into account only if volumes-per-node is set and non-zero --description Description of the node group template --autoconfig=False If enabled, instances of the node group will be automatically configured --proxy-gateway=False If enabled, instances of the node group will be used to access other instances in the cluster --public=False Make the node group template public (Visible from other tenants) --protected=False Make the node group template protected --json JSON representation of the node group template. Other arguments will not be taken into account if this one is provided --shares JSON representation of the manila shares --configs JSON representation of the node group template configs
dataprocessing node group template delete
Deletes node group template
usage: dataprocessing node group template delete [-h]
<node-group-template>
[<node-group-template> ...]
- Positional arguments:
node_group_template Name(s) or id(s) of the node group template(s) to delete
dataprocessing node group template list
Lists node group templates
usage: dataprocessing node group template list [-h]
[-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>]
[--long] [--plugin <plugin>]
[--plugin-version <plugin_version>]
[--name <name-substring>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --plugin List node group templates for specific plugin --plugin-version List node group templates with specific version of the plugin --name List node group templates with specific substring in the name
dataprocessing node group template show
Display node group template details
usage: dataprocessing node group template show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
<node-group-template>
- Positional arguments:
node_group_template Name or id of the node group template to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
dataprocessing node group template update
Updates node group template
usage: dataprocessing node group template update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>]
[--plugin <plugin>]
[--plugin-version <plugin_version>]
[--processes <processes> [<processes> ...]]
[--security-groups <security-groups> [<security-groups> ...]]
[--auto-security-group-enable | --auto-security-group-disable]
[--availability-zone <availability-zone>]
[--flavor <flavor>]
[--floating-ip-pool <floating-ip-pool>]
[--volumes-per-node <volumes-per-node>]
[--volumes-size <volumes-size>]
[--volumes-type <volumes-type>]
[--volumes-availability-zone <volumes-availability-zone>]
[--volumes-mount-prefix <volumes-mount-prefix>]
[--volumes-locality-enable | --volumes-locality-disable]
[--description <description>]
[--autoconfig-enable | --autoconfig-disable]
[--proxy-gateway-enable | --proxy-gateway-disable]
[--public | --private]
[--protected | --unprotected]
[--json <filename>]
[--shares <filename>]
[--configs <filename>]
<node-group-template>
- Positional arguments:
node_group_template Name or ID of the node group template - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name New name of the node group template --plugin Name of the plugin --plugin-version Version of the plugin --processes List of the processes that will be launched on each instance --security-groups List of the security groups for the instances in this node group --auto-security-group-enable Additional security group should be created for the node group --auto-security-group-disable Additional security group should not be created for the node group --availability-zone Name of the availability zone where instances will be created --flavor Name or ID of the flavor --floating-ip-pool ID of the floating IP pool --volumes-per-node Number of volumes attached to every node --volumes-size Size of volumes attached to node (GB). This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-type Type of the volumes. This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-availability-zone Name of the availability zone where volumes will be created. This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-mount-prefix Prefix for mount point directory. This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-locality-enable Instance and attached volumes will be created on the same physical host. This parameter will be taken into account only if volumes-per-node is set and non-zero --volumes-locality-disable Instance and attached volumes creation on the same physical host will not be regulated. This parameter will be takeninto account only if volumes-per-node is set and non-zero --description Description of the node group template --autoconfig-enable Instances of the node group will be automatically configured --autoconfig-disable Instances of the node group will not be automatically configured --proxy-gateway-enable Instances of the node group will be used to access other instances in the cluster --proxy-gateway-disable Instances of the node group will not be used to access other instances in the cluster --public Make the node group template public (Visible from other tenants) --private Make the node group template private (Visible only from this tenant) --protected Make the node group template protected --unprotected Make the node group template unprotected --json JSON representation of the node group template update fields. Other arguments will not be taken into account if this one is provided --shares JSON representation of the manila shares --configs JSON representation of the node group template configs
Cluster Templates¶
dataprocessing cluster template create
Creates cluster template
usage: dataprocessing cluster template create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>]
[--node-groups <node-group:instances_count> [<node-group:instances_count> ...]]
[--anti-affinity <anti-affinity> [<anti-affinity> ...]]
[--description <description>]
[--autoconfig] [--public]
[--protected]
[--json <filename>]
[--shares <filename>]
[--configs <filename>]
[--domain-name <domain-name>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name Name of the cluster template [REQUIRED if JSON is not provided] --node-groups List of the node groups(names or IDs) and numbers of instances for each one of them [REQUIRED if JSON is not provided] --anti-affinity List of processes that should be added to an anti-affinity group --description Description of the cluster template --autoconfig=False If enabled, instances of the cluster will be automatically configured --public=False Make the cluster template public (Visible from other tenants) --protected=False Make the cluster template protected --json JSON representation of the cluster template. Other arguments will not be taken into account if this one is provided --shares JSON representation of the manila shares --configs JSON representation of the cluster template configs --domain-name Domain name for instances of this cluster template. This option is available if ‘use_designate’ config is True
dataprocessing cluster template delete
Deletes cluster template
usage: dataprocessing cluster template delete [-h]
<cluster-template>
[<cluster-template> ...]
- Positional arguments:
cluster_template Name(s) or id(s) of the cluster template(s) to delete
dataprocessing cluster template list
Lists cluster templates
usage: dataprocessing cluster template list [-h]
[-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
[--plugin <plugin>]
[--plugin-version <plugin_version>]
[--name <name-substring>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --plugin List cluster templates for specific plugin --plugin-version List cluster templates with specific version of the plugin --name List cluster templates with specific substring in the name
dataprocessing cluster template show
Display cluster template details
usage: dataprocessing cluster template show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
<cluster-template>
- Positional arguments:
cluster_template Name or id of the cluster template to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
dataprocessing cluster template update
Updates cluster template
usage: dataprocessing cluster template update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>]
[--node-groups <node-group:instances_count> [<node-group:instances_count> ...]]
[--anti-affinity <anti-affinity> [<anti-affinity> ...]]
[--description <description>]
[--autoconfig-enable | --autoconfig-disable]
[--public | --private]
[--protected | --unprotected]
[--json <filename>]
[--shares <filename>]
[--configs <filename>]
[--domain-name <domain-name>]
<cluster-template>
- Positional arguments:
cluster_template Name or ID of the cluster template [REQUIRED] - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name New name of the cluster template --node-groups List of the node groups(names or IDs) and numbers ofinstances for each one of them --anti-affinity List of processes that should be added to an anti-affinity group --description Description of the cluster template --autoconfig-enable Instances of the cluster will be automatically configured --autoconfig-disable Instances of the cluster will not be automatically configured --public Make the cluster template public (Visible from other tenants) --private Make the cluster template private (Visible only from this tenant) --protected Make the cluster template protected --unprotected Make the cluster template unprotected --json JSON representation of the cluster template. Other arguments will not be taken into account if this one is provided --shares JSON representation of the manila shares --configs JSON representation of the cluster template configs --domain-name Domain name for instances of this cluster template. This option is available if ‘use_designate’ config is True
Clusters¶
dataprocessing cluster create
Creates cluster
usage: dataprocessing cluster create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--name <name>]
[--cluster-template <cluster-template>]
[--image <image>]
[--description <description>]
[--user-keypair <keypair>]
[--neutron-network <network>]
[--count <count>] [--public]
[--protected] [--transient]
[--json <filename>] [--wait]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name Name of the cluster [REQUIRED if JSON is not provided] --cluster-template Cluster template name or ID [REQUIRED if JSON is not provided] --image Image that will be used for cluster deployment (Name or ID) [REQUIRED if JSON is not provided] --description Description of the cluster --user-keypair User keypair to get acces to VMs after cluster creation --neutron-network Instances of the cluster will get fixed IP addresses in this network. (Name or ID should be provided) --count Number of clusters to be created --public=False Make the cluster public (Visible from other tenants) --protected=False Make the cluster protected --transient=False Create transient cluster --json JSON representation of the cluster. Other arguments (except for –wait) will not be taken into account if this one is provided --wait=False Wait for the cluster creation to complete
dataprocessing cluster delete
Deletes cluster
usage: dataprocessing cluster delete [-h] [--wait] <cluster> [<cluster> ...]
- Positional arguments:
cluster Name(s) or id(s) of the cluster(s) to delete - Options:
--wait=False Wait for the cluster(s) delete to complete
dataprocessing cluster list
Lists clusters
usage: dataprocessing cluster list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
[--plugin <plugin>]
[--plugin-version <plugin_version>]
[--name <name-substring>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --plugin List clusters with specific plugin --plugin-version List clusters with specific version of the plugin --name List clusters with specific substring in the name
dataprocessing cluster scale
Scales cluster
usage: dataprocessing cluster scale [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>]
[--instances <node-group-template:instances_count> [<node-group-template:instances_count> ...]]
[--json <filename>] [--wait]
<cluster>
- Positional arguments:
cluster Name or ID of the cluster - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --instances Node group templates and number of their instances to be scale to [REQUIRED if JSON is not provided] --json JSON representation of the cluster scale object. Other arguments (except for –wait) will not be taken into account if this one is provided --wait=False Wait for the cluster scale to complete
dataprocessing cluster show
Display cluster details
usage: dataprocessing cluster show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--verification]
[--show-progress] [--full-dump-events]
<cluster>
- Positional arguments:
cluster Name or id of the cluster to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --verification=False List additional fields for verifications --show-progress=False Provides ability to show brief details of event logs. --full-dump-events=False Provides ability to make full dump with event log details.
dataprocessing cluster verification
Updates cluster
usage: dataprocessing cluster verification [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>]
[--description <description>]
[--shares <filename>]
[--public | --private]
[--protected | --unprotected]
<cluster>
- Positional arguments:
cluster Name or ID of the cluster - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name New name of the cluster --description Description of the cluster --shares JSON representation of the manila shares --public Make the cluster public (Visible from other tenants) --private Make the cluster private (Visible only from this tenant) --protected Make the cluster protected --unprotected Make the cluster unprotected
dataprocessing cluster verification
Updates cluster verifications
usage: dataprocessing cluster verification [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
(--start | --show)
<cluster>
- Positional arguments:
cluster Name or ID of the cluster - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --start Start health verification for the cluster --show=False Show health of the cluster
Data Sources¶
dataprocessing data source create
Creates data source
usage: dataprocessing data source create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] --type <type>
--url <url> [--username <username>]
[--password <password>]
[--description <description>]
[--public] [--protected]
<name>
- Positional arguments:
name Name of the data source - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --type Type of the data source (swift, hdfs, maprfs, manila) [REQUIRED]
Possible choices: swift, hdfs, maprfs, manila
--url Url for the data source [REQUIRED] --username Username for accessing the data source url --password Password for accessing the data source url --description Description of the data source --public=False Make the data source public --protected=False Make the data source protected
dataprocessing data source delete
Delete data source
usage: dataprocessing data source delete [-h]
<data-source> [<data-source> ...]
- Positional arguments:
data_source Name(s) or id(s) of the data source(s) to delete
dataprocessing data source list
Lists data sources
usage: dataprocessing data source list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
[--type <type>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --type List data sources of specific type (swift, hdfs, maprfs, manila)
Possible choices: swift, hdfs, maprfs, manila
dataprocessing data source show
Display data source details
usage: dataprocessing data source show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
<data-source>
- Positional arguments:
data_source Name or id of the data source to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
dataprocessing data source update
Update data source
usage: dataprocessing data source update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>] [--type <type>]
[--url <url>] [--username <username>]
[--password <password>]
[--description <description>]
[--public | --private]
[--protected | --unprotected]
<data-source>
- Positional arguments:
data_source Name or id of the data source - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name New name of the data source --type Type of the data source (swift, hdfs, maprfs, manila)
Possible choices: swift, hdfs, maprfs, manila
--url Url for the data source --username Username for accessing the data source url --password Password for accessing the data source url --description Description of the data source --public Make the data source public (Visible from other tenants) --private Make the data source private (Visible only from this tenant) --protected Make the data source protected --unprotected Make the data source unprotected
Job Binaries¶
dataprocessing job binary create
Creates job binary
usage: dataprocessing job binary create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>]
[--data <file> | --url <url>]
[--description <description>]
[--username <username>]
[--password <password> | --password-prompt]
[--public] [--protected]
[--json <filename>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name Name of the job binary [REQUIRED if JSON is not provided] --data File that will be stored in the internal DB [REQUIRED if JSON and URL are not provided] --url URL for the job binary [REQUIRED if JSON and file are not provided] --description Description of the job binary --username Username for accessing the job binary URL --password Password for accessing the job binary URL --password-prompt=False Prompt interactively for password --public=False Make the job binary public --protected=False Make the job binary protected --json JSON representation of the job binary. Other arguments will not be taken into account if this one is provided
dataprocessing job binary delete
Deletes job binary
usage: dataprocessing job binary delete [-h] <job-binary> [<job-binary> ...]
- Positional arguments:
job_binary Name(s) or id(s) of the job binary(ies) to delete
dataprocessing job binary download
Downloads job binary
usage: dataprocessing job binary download [-h] [--file <file>] <job-binary>
- Positional arguments:
job_binary Name or ID of the job binary to download - Options:
--file Destination file (defaults to job binary name)
dataprocessing job binary list
Lists job binaries
usage: dataprocessing job binary list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
[--name <name-substring>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --name List job binaries with specific substring in the name
dataprocessing job binary show
Display job binary details
usage: dataprocessing job binary show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
<job-binary>
- Positional arguments:
job_binary Name or ID of the job binary to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
dataprocessing job binary update
Updates job binary
usage: dataprocessing job binary update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>] [--url <url>]
[--description <description>]
[--username <username>]
[--password <password> | --password-prompt]
[--public | --private]
[--protected | --unprotected]
[--json <filename>]
<job-binary>
- Positional arguments:
job_binary Name or ID of the job binary - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name New name of the job binary --url URL for the job binary [Internal DB URL can not be updated] --description Description of the job binary --username Username for accessing the job binary URL --password Password for accessing the job binary URL --password-prompt=False Prompt interactively for password --public Make the job binary public (Visible from other tenants) --private Make the job binary private (Visible only from this tenant) --protected Make the job binary protected --unprotected Make the job binary unprotected --json JSON representation of the update object. Other arguments will not be taken into account if this one is provided
Job Types¶
dataprocessing job type configs get
Get job type configs
usage: dataprocessing job type configs get [-h] [--file <file>] <job-type>
- Positional arguments:
job_type Type of the job to provide config information about
Possible choices: Hive, Java, MapReduce, Storm, Storm.Pyleus, Pig, Shell, MapReduce.Streaming, Spark
- Options:
--file Destination file (defaults to job type)
dataprocessing job type list
Lists job types supported by plugins
usage: dataprocessing job type list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--type <type>]
[--plugin <plugin>]
[--plugin-version <plugin_version>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --type Get information about specific job type
Possible choices: Hive, Java, MapReduce, Storm, Storm.Pyleus, Pig, Shell, MapReduce.Streaming, Spark
--plugin Get only job types supported by this plugin --plugin-version Get only job types supported by specific version of the plugin. This parameter will be taken into account only if plugin is provided
Job Templates¶
dataprocessing job template create
Creates job template
usage: dataprocessing job template create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>] [--type <type>]
[--mains <main> [<main> ...]]
[--libs <lib> [<lib> ...]]
[--description <description>]
[--public] [--protected]
[--interface <filename>]
[--json <filename>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name Name of the job template [REQUIRED if JSON is not provided] --type Type of the job (Hive, Java, MapReduce, Storm, Storm.Pyleus, Pig, Shell, MapReduce.Streaming, Spark) [REQUIRED if JSON is not provided]
Possible choices: Hive, Java, MapReduce, Storm, Storm.Pyleus, Pig, Shell, MapReduce.Streaming, Spark
--mains Name(s) or ID(s) for job’s main job binary(s) --libs Name(s) or ID(s) for job’s lib job binary(s) --description Description of the job template --public=False Make the job template public --protected=False Make the job template protected --interface JSON representation of the interface --json JSON representation of the job template
dataprocessing job template delete
Deletes job template
usage: dataprocessing job template delete [-h]
<job-template> [<job-template> ...]
- Positional arguments:
job_template Name(s) or id(s) of the job template(s) to delete
dataprocessing job template list
Lists job templates
usage: dataprocessing job template list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
[--type <type>]
[--name <name-substring>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --type List job templates of specific type
Possible choices: Hive, Java, MapReduce, Storm, Storm.Pyleus, Pig, Shell, MapReduce.Streaming, Spark
--name List job templates with specific substring in the name
dataprocessing job template show
Display job template details
usage: dataprocessing job template show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
<job-template>
- Positional arguments:
job_template Name or ID of the job template to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
dataprocessing job template update
Updates job template
usage: dataprocessing job template update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--name <name>]
[--description <description>]
[--public | --private]
[--protected | --unprotected]
<job-template>
- Positional arguments:
job_template Name or ID of the job template - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --name New name of the job template --description Description of the job template --public Make the job template public (Visible from other tenants) --private Make the job_template private (Visible only from this tenant) --protected Make the job template protected --unprotected Make the job template unprotected
Jobs¶
dataprocessing job binary delete
Deletes job
usage: dataprocessing job binary delete [-h] [--wait] <job> [<job> ...]
- Positional arguments:
job ID(s) of the job(s) to delete - Options:
--wait=False Wait for the job(s) delete to complete
dataprocessing job execute
Executes job
usage: dataprocessing job execute [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>]
[--job-template <job-template>]
[--cluster <cluster>] [--input <input>]
[--output <output>]
[--params <name:value> [<name:value> ...]]
[--args <argument> [<argument> ...]]
[--public] [--protected]
[--config-json <filename> | --configs <name:value> [<name:value> ...]]
[--interface <filename>] [--json <filename>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --job-template Name or ID of the job template [REQUIRED if JSON is not provided] --cluster Name or ID of the cluster [REQUIRED if JSON is not provided] --input Name or ID of the input data source --output Name or ID of the output data source --params Parameters to add to the job --args Arguments to add to the job --public=False Make the job public --protected=False Make the job protected --config-json JSON representation of the job configs --configs Configs to add to the job --interface JSON representation of the interface --json JSON representation of the job. Other arguments will not be taken into account if this one is provided
dataprocessing job list
Lists jobs
usage: dataprocessing job list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--max-width <integer>] [--long]
[--status <status>]
- Options:
-f=table, --format=table the output format, defaults to table
Possible choices: csv, json, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --quote=nonnumeric when to include quotes, defaults to nonnumeric
Possible choices: all, minimal, none, nonnumeric
--max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --long=False List additional fields in output --status List jobs with specific status
Possible choices: done-with-error, failed, killed, pending, running, succeeded, to-be-killed
dataprocessing job binary show
Display job details
usage: dataprocessing job binary show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
<job>
- Positional arguments:
job ID of the job to display - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
dataprocessing job binary update
Updates job
usage: dataprocessing job binary update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--public | --private]
[--protected | --unprotected]
<job>
- Positional arguments:
job ID of the job to update - Options:
-f=table, --format=table the output format, defaults to table
Possible choices: json, shell, table, value, yaml
-c=[], --column=[] specify the column(s) to include, can be repeated --noindent=False whether to disable indenting the JSON --prefix= add a prefix to all variable names --max-width=0 Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --public Make the job public (Visible from other tenants) --private Make the job private (Visible only from this tenant) --protected Make the job protected --unprotected Make the job unprotected