Change-Id: I70344c4bedae824b347d78651801576693da5f37
32 KiB
Clustering service command-line client
The senlin client is the command-line interface (CLI) for the Clustering service API and its extensions.
This chapter documents senlin
version 0.4.1
.
For help on a specific senlin
command, enter:
$ senlin help COMMAND
senlin usage
usage: senlin [--version] [-d] [-v] [--api-timeout API_TIMEOUT]
[--senlin-api-version SENLIN_API_VERSION]
[--os-auth-plugin AUTH_PLUGIN] [--os-auth-url AUTH_URL]
[--os-project-id PROJECT_ID] [--os-project-name PROJECT_NAME]
[--os-tenant-id TENANT_ID] [--os-tenant-name TENANT_NAME]
[--os-domain-id DOMAIN_ID] [--os-domain-name DOMAIN_NAME]
[--os-project-domain-id PROJECT_DOMAIN_ID]
[--os-project-domain-name PROJECT_DOMAIN_NAME]
[--os-user-domain-id USER_DOMAIN_ID]
[--os-user-domain-name USER_DOMAIN_NAME]
[--os-username USERNAME] [--os-user-id USER_ID]
[--os-password PASSWORD] [--os-trust-id TRUST_ID]
[--os-cacert CA_BUNDLE_FILE | --verify | --insecure]
[--os-token TOKEN] [--os-access-info ACCESS_INFO]
[--os-api-name <service>=<name>]
[--os-api-region <service>=<region>]
[--os-api-version <service>=<version>]
[--os-api-interface <service>=<interface>]
<subcommand> ...
Subcommands:
action-list
-
List actions.
action-show
-
Show detailed info about the specified action.
build-info
-
Retrieve build information.
cluster-check
-
Check the cluster(s).
cluster-create
-
Create the cluster.
cluster-delete
-
Delete the cluster(s).
cluster-list
-
List the user's clusters.
cluster-node-add
-
Add specified nodes to cluster.
cluster-node-del
-
Delete specified nodes from cluster.
cluster-node-list
-
List nodes from cluster.
cluster-policy-attach
-
Attach policy to cluster.
cluster-policy-detach
-
Detach policy from cluster.
cluster-policy-list
-
List policies from cluster.
cluster-policy-show
-
Show a specific policy that is bound to the specified cluster.
cluster-policy-update
-
Update a policy's properties on a cluster.
cluster-recover
-
Recover the cluster(s).
cluster-resize
-
Resize a cluster.
cluster-scale-in
-
Scale in a cluster by the specified number of nodes.
cluster-scale-out
-
Scale out a cluster by the specified number of nodes.
cluster-show
-
Show details of the cluster.
cluster-update
-
Update the cluster.
event-list
-
List events.
event-show
-
Describe the event.
node-check
-
Check the node(s).
node-create
-
Create the node.
node-delete
-
Delete the node(s).
node-list
-
Show list of nodes.
node-recover
-
Recover the node(s).
node-show
-
Show detailed info about the specified node.
node-update
-
Update the node.
policy-create
-
Create a policy.
policy-delete
-
Delete policy(s).
policy-list
-
List policies that meet the criteria.
policy-show
-
Show the policy details.
policy-type-list
-
List the available policy types.
policy-type-show
-
Get the details about a policy type.
policy-update
-
Update a policy.
profile-create
-
Create a profile.
profile-delete
-
Delete profile(s).
profile-list
-
List profiles that meet the criteria.
profile-show
-
Show the profile details.
profile-type-list
-
List the available profile types.
profile-type-show
-
Get the details about a profile type.
profile-update
-
Update a profile.
receiver-create
-
Create a receiver.
receiver-delete
-
Delete receiver(s).
receiver-list
-
List receivers that meet the criteria.
receiver-show
-
Show the receiver details.
bash-completion
-
Prints all of the commands and options to stdout.
help
-
Display help about this program or one of its subcommands.
senlin optional arguments
--version
-
Shows the client version and exits.
-d, --debug
-
Defaults to
env[SENLINCLIENT_DEBUG]
. -v, --verbose
-
Print more verbose output.
--api-timeout API_TIMEOUT
-
Number of seconds to wait for an API response, defaults to system socket timeout
--senlin-api-version SENLIN_API_VERSION
-
Version number for Senlin API to use, Default to "1".
--os-auth-plugin AUTH_PLUGIN
-
Authentication plugin, default to
env[OS_AUTH_PLUGIN]
--os-auth-url AUTH_URL
-
Defaults to
env[OS_AUTH_URL]
--os-project-id PROJECT_ID
-
Defaults to
env[OS_PROJECT_ID]
. --os-project-name PROJECT_NAME
-
Defaults to
env[OS_PROJECT_NAME]
. --os-tenant-id TENANT_ID
-
Defaults to
env[OS_TENANT_ID]
. --os-tenant-name TENANT_NAME
-
Defaults to
env[OS_TENANT_NAME]
. --os-domain-id DOMAIN_ID
-
Domain ID for scope of authorization, defaults to
env[OS_DOMAIN_ID]
. --os-domain-name DOMAIN_NAME
-
Domain name for scope of authorization, defaults to
env[OS_DOMAIN_NAME]
. --os-project-domain-id PROJECT_DOMAIN_ID
-
Project domain ID for scope of authorization, defaults to
env[OS_PROJECT_DOMAIN_ID]
. --os-project-domain-name PROJECT_DOMAIN_NAME
-
Project domain name for scope of authorization, defaults to
env[OS_PROJECT_DOMAIN_NAME]
. --os-user-domain-id USER_DOMAIN_ID
-
User domain ID for scope of authorization, defaults to
env[OS_USER_DOMAIN_ID]
. --os-user-domain-name USER_DOMAIN_NAME
-
User domain name for scope of authorization, defaults to
env[OS_USER_DOMAIN_NAME]
. --os-username USERNAME
-
Defaults to
env[OS_USERNAME]
. --os-user-id USER_ID
-
Defaults to
env[OS_USER_ID]
. --os-password PASSWORD
-
Defaults to
env[OS_PASSWORD]
--os-trust-id TRUST_ID
-
Defaults to
env[OS_TRUST_ID]
--os-cacert CA_BUNDLE_FILE
-
Path of CA TLS certificate(s) used to verify the remote server's certificate. Without this option senlin looks for the default system CA certificates.
--verify
-
Verify server certificate (default)
--insecure
-
Explicitly allow senlinclient to perform "insecure SSL" (HTTPS) requests. The server's certificate will not be verified against any certificate authorities. This option should be used with caution.
--os-token TOKEN
-
A string token to bootstrap the Keystone database, defaults to
env[OS_TOKEN]
--os-access-info ACCESS_INFO
-
Access info, defaults to
env[OS_ACCESS_INFO]
--os-api-name <service>=<name>
-
Desired API names, defaults to
env[OS_API_NAME]
--os-api-region <service>=<region>
-
Desired API region, defaults to
env[OS_API_REGION]
--os-api-version <service>=<version>
-
Desired API versions, defaults to
env[OS_API_VERSION]
--os-api-interface <service>=<interface>
-
Desired API interface, defaults to
env[OS_INTERFACE]
senlin action-list
usage: senlin action-list [-f <KEY1=VALUE1;KEY2=VALUE2...>] [-o <KEY:DIR>]
[-l <LIMIT>] [-m <ID>] [-F]
List actions.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned actions. This can be specified multiple times, or once with parameters separated by a semicolon.
-o <KEY:DIR>, --sort <KEY:DIR>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of actions returned.
-m <ID>, --marker <ID>
-
Only return actions that appear after the given node ID.
-F, --full-id
-
Print full IDs in list.
senlin action-show
usage: senlin action-show <ACTION>
Show detailed info about the specified action.
Positional arguments:
<ACTION>
-
Name or ID of the action to show the details for.
senlin build-info
usage: senlin build-info
Retrieve build information. :param sc: Instance of senlinclient. :param args: Additional command line arguments, if any.
senlin cluster-check
usage: senlin cluster-check <CLUSTER> [<CLUSTER> ...]
Check the cluster(s).
Positional arguments:
<CLUSTER>
-
ID or name of cluster(s) to operate on.
senlin cluster-create
usage: senlin cluster-create -p <PROFILE> [-n <MIN-SIZE>] [-m <MAX-SIZE>]
[-c <DESIRED-CAPACITY>] [-t <TIMEOUT>]
[-M <KEY1=VALUE1;KEY2=VALUE2...>]
<CLUSTER_NAME>
Create the cluster.
Positional arguments:
<CLUSTER_NAME>
-
Name of the cluster to create.
Optional arguments:
-p <PROFILE>, --profile <PROFILE>
-
Profile Id used for this cluster.
-n <MIN-SIZE>, --min-size <MIN-SIZE>
-
Min size of the cluster. Default to 0.
-m <MAX-SIZE>, --max-size <MAX-SIZE>
-
Max size of the cluster. Default to -1, means unlimited.
-c <DESIRED-CAPACITY>, --desired-capacity <DESIRED-CAPACITY>
-
Desired capacity of the cluster. Default to min_size if min_size is specified else 0.
-t <TIMEOUT>, --timeout <TIMEOUT>
-
Cluster creation timeout in seconds.
-M <KEY1=VALUE1;KEY2=VALUE2...>, --metadata <KEY1=VALUE1;KEY2=VALUE2...>
-
Metadata values to be attached to the cluster. This can be specified multiple times, or once with key-value pairs separated by a semicolon.
senlin cluster-delete
usage: senlin cluster-delete <CLUSTER> [<CLUSTER> ...]
Delete the cluster(s).
Positional arguments:
<CLUSTER>
-
Name or ID of cluster(s) to delete.
senlin cluster-list
usage: senlin cluster-list [-f <KEY1=VALUE1;KEY2=VALUE2...>] [-o <KEY:DIR>]
[-l <LIMIT>] [-m <ID>] [-g] [-F]
List the user's clusters.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned clusters. This can be specified multiple times, or once with parameters separated by a semicolon.
-o <KEY:DIR>, --sort <KEY:DIR>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of clusters returned.
-m <ID>, --marker <ID>
-
Only return clusters that appear after the given cluster ID.
-g, --global-project
-
Indicate that the cluster list should include clusters from all projects. This option is subject to access policy checking. Default is False.
-F, --full-id
-
Print full IDs in list.
senlin cluster-node-add
usage: senlin cluster-node-add -n <NODES> <CLUSTER>
Add specified nodes to cluster.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to operate on.
Optional arguments:
-n <NODES>, --nodes <NODES>
-
ID of nodes to be added; multiple nodes can be separated with ","
senlin cluster-node-del
usage: senlin cluster-node-del -n <NODES> <CLUSTER>
Delete specified nodes from cluster.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to operate on.
Optional arguments:
-n <NODES>, --nodes <NODES>
-
ID of nodes to be deleted; multiple nodes can be separated with ",".
senlin cluster-node-list
usage: senlin cluster-node-list [-f <KEY1=VALUE1;KEY2=VALUE2...>] [-l <LIMIT>]
[-m <ID>] [-F]
<CLUSTER>
List nodes from cluster.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to nodes from.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned nodes. This can be specified multiple times, or once with parameters separated by a semicolon.
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of nodes returned.
-m <ID>, --marker <ID>
-
Only return nodes that appear after the given node ID.
-F, --full-id
-
Print full IDs in list.
senlin cluster-policy-attach
usage: senlin cluster-policy-attach -p <POLICY> [-e] <NAME or ID>
Attach policy to cluster.
Positional arguments:
<NAME or ID>
-
Name or ID of cluster to operate on.
Optional arguments:
-p <POLICY>, --policy <POLICY>
-
ID or name of policy to be attached.
-e, --enabled
-
Whether the policy should be enabled once attached. Default to enabled.
senlin cluster-policy-detach
usage: senlin cluster-policy-detach -p <POLICY> <NAME or ID>
Detach policy from cluster.
Positional arguments:
<NAME or ID>
-
Name or ID of cluster to operate on.
Optional arguments:
-p <POLICY>, --policy <POLICY>
-
ID or name of policy to be detached.
senlin cluster-policy-list
usage: senlin cluster-policy-list [-f <KEY1=VALUE1;KEY2=VALUE2...>]
[-o <SORT_STRING>] [-F]
<CLUSTER>
List policies from cluster.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to query on.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned results. This can be specified multiple times, or once with parameters separated by a semicolon.
-o <SORT_STRING>, --sort <SORT_STRING>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-F, --full-id
-
Print full IDs in list.
senlin cluster-policy-show
usage: senlin cluster-policy-show -p <POLICY> <CLUSTER>
Show a specific policy that is bound to the specified cluster.
Positional arguments:
<CLUSTER>
-
ID or name of the cluster to query on.
Optional arguments:
-p <POLICY>, --policy <POLICY>
-
ID or name of the policy to query on.
senlin cluster-policy-update
usage: senlin cluster-policy-update -p <POLICY> [-e <BOOLEAN>] <NAME or ID>
Update a policy's properties on a cluster.
Positional arguments:
<NAME or ID>
-
Name or ID of cluster to operate on.
Optional arguments:
-p <POLICY>, --policy <POLICY>
-
ID or name of policy to be updated.
-e <BOOLEAN>, --enabled <BOOLEAN>
-
Whether the policy should be enabled.
senlin cluster-recover
usage: senlin cluster-recover <CLUSTER> [<CLUSTER> ...]
Recover the cluster(s).
Positional arguments:
<CLUSTER>
-
ID or name of cluster(s) to operate on.
senlin cluster-resize
usage: senlin cluster-resize [-c <CAPACITY>] [-a <ADJUSTMENT>]
[-p <PERCENTAGE>] [-t <MIN_STEP>] [-s] [-n MIN]
[-m MAX]
<CLUSTER>
Resize a cluster.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to operate on.
Optional arguments:
-c <CAPACITY>, --capacity <CAPACITY>
-
The desired number of nodes of the cluster.
-a <ADJUSTMENT>, --adjustment <ADJUSTMENT>
-
A positive integer meaning the number of nodes to add, or a negative integer indicating the number of nodes to remove.
-p <PERCENTAGE>, --percentage <PERCENTAGE>
-
A value that is interpreted as the percentage of size adjustment. This value can be positive or negative.
-t <MIN_STEP>, --min-step <MIN_STEP>
-
An integer specifying the number of nodes for adjustment when <PERCENTAGE> is specified.
-s, --strict A
-
boolean specifying whether the resize should be performed on a best-effort basis when the new capacity may go beyond size constraints.
-n MIN, --min-size MIN
-
New lower bound of cluster size.
-m MAX, --max-size MAX
-
New upper bound of cluster size. A value of -1 indicates no upper limit on cluster size.
senlin cluster-scale-in
usage: senlin cluster-scale-in [-c <COUNT>] <CLUSTER>
Scale in a cluster by the specified number of nodes.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to operate on.
Optional arguments:
-c <COUNT>, --count <COUNT>
-
Number of nodes to be deleted from the specified cluster.
senlin cluster-scale-out
usage: senlin cluster-scale-out [-c <COUNT>] <CLUSTER>
Scale out a cluster by the specified number of nodes.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to operate on.
Optional arguments:
-c <COUNT>, --count <COUNT>
-
Number of nodes to be added to the specified cluster.
senlin cluster-show
usage: senlin cluster-show <CLUSTER>
Show details of the cluster.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to show.
senlin cluster-update
usage: senlin cluster-update [-p <PROFILE>] [-t <TIMEOUT>]
[-M <KEY1=VALUE1;KEY2=VALUE2...>] [-n <NAME>]
<CLUSTER>
Update the cluster.
Positional arguments:
<CLUSTER>
-
Name or ID of cluster to be updated.
Optional arguments:
-p <PROFILE>, --profile <PROFILE>
-
ID of new profile to use.
-t <TIMEOUT>, --timeout <TIMEOUT>
-
New timeout (in seconds) value for the cluster.
-M <KEY1=VALUE1;KEY2=VALUE2...>, --metadata <KEY1=VALUE1;KEY2=VALUE2...>
-
Metadata values to be attached to the cluster. This can be specified multiple times, or once with key-value pairs separated by a semicolon.
-n <NAME>, --name <NAME>
-
New name for the cluster to update.
senlin event-list
usage: senlin event-list [-f <KEY1=VALUE1;KEY2=VALUE2...>] [-l <LIMIT>]
[-m <ID>] [-o <KEY:DIR>] [-g] [-F]
List events.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned events. This can be specified multiple times, or once with parameters separated by a semicolon.
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of events returned.
-m <ID>, --marker <ID>
-
Only return events that appear after the given event ID.
-o <KEY:DIR>, --sort <KEY:DIR>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-g, --global-project
-
Whether events from all projects should be listed. Default to False. Setting this to True may demand for an admin privilege.
-F, --full-id
-
Print full IDs in list.
senlin event-show
usage: senlin event-show <EVENT>
Describe the event.
Positional arguments:
<EVENT>
-
ID of event to display details for.
senlin node-check
usage: senlin node-check <NODE> [<NODE> ...]
Check the node(s).
Positional arguments:
<NODE>
-
ID of node(s) to check.
senlin node-create
usage: senlin node-create -p <PROFILE> [-c <CLUSTER>] [-r <ROLE>]
[-M <KEY1=VALUE1;KEY2=VALUE2...>]
<NODE_NAME>
Create the node.
Positional arguments:
<NODE_NAME>
-
Name of the node to create.
Optional arguments:
-p <PROFILE>, --profile <PROFILE>
-
Profile Id used for this node.
-c <CLUSTER>, --cluster <CLUSTER>
-
Cluster Id for this node.
-r <ROLE>, --role <ROLE>
-
Role for this node in the specific cluster.
-M <KEY1=VALUE1;KEY2=VALUE2...>, --metadata <KEY1=VALUE1;KEY2=VALUE2...>
-
Metadata values to be attached to the node. This can be specified multiple times, or once with key-value pairs separated by a semicolon.
senlin node-delete
usage: senlin node-delete <NODE> [<NODE> ...]
Delete the node(s).
Positional arguments:
<NODE>
-
Name or ID of node(s) to delete.
senlin node-list
usage: senlin node-list [-c <CLUSTER>] [-f <KEY1=VALUE1;KEY2=VALUE2...>]
[-o <KEY:DIR>] [-l <LIMIT>] [-m <ID>] [-g] [-F]
Show list of nodes.
Optional arguments:
-c <CLUSTER>, --cluster <CLUSTER>
-
ID or name of cluster from which nodes are to be listed.
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned nodes. This can be specified multiple times, or once with parameters separated by a semicolon.
-o <KEY:DIR>, --sort <KEY:DIR>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of nodes returned.
-m <ID>, --marker <ID>
-
Only return nodes that appear after the given node ID.
-g, --global-project
-
Indicate that this node list should include nodes from all projects. This option is subject to access policy checking. Default is False.
-F, --full-id
-
Print full IDs in list.
senlin node-recover
usage: senlin node-recover <NODE> [<NODE> ...]
Recover the node(s).
Positional arguments:
<NODE>
-
ID of node(s) to recover.
senlin node-show
usage: senlin node-show [-D] <NODE>
Show detailed info about the specified node.
Positional arguments:
<NODE>
-
Name or ID of the node to show the details for.
Optional arguments:
-D, --details
-
Include physical object details.
senlin node-update
usage: senlin node-update [-n <NAME>] [-p <PROFILE ID>] [-r <ROLE>]
[-M <KEY1=VALUE1;KEY2=VALUE2...>]
<NODE>
Update the node.
Positional arguments:
<NODE>
-
Name or ID of node to update.
Optional arguments:
-n <NAME>, --name <NAME>
-
New name for the node.
-p <PROFILE ID>, --profile <PROFILE ID>
-
ID of new profile to use.
-r <ROLE>, --role <ROLE>
-
Role for this node in the specific cluster.
-M <KEY1=VALUE1;KEY2=VALUE2...>, --metadata <KEY1=VALUE1;KEY2=VALUE2...>
-
Metadata values to be attached to the node. Metadata can be specified multiple times, or once with key-value pairs separated by a semicolon.
senlin policy-create
usage: senlin policy-create -s <SPEC_FILE> <NAME>
Create a policy.
Positional arguments:
<NAME>
-
Name of the policy to create.
Optional arguments:
-s <SPEC_FILE>, --spec-file <SPEC_FILE>
-
The spec file used to create the policy.
senlin policy-delete
usage: senlin policy-delete <POLICY> [<POLICY> ...]
Delete policy(s).
Positional arguments:
<POLICY>
-
Name or ID of policy(s) to delete.
senlin policy-list
usage: senlin policy-list [-f <KEY1=VALUE1;KEY2=VALUE2...>] [-l <LIMIT>]
[-m <ID>] [-o <KEY:DIR>] [-g] [-F]
List policies that meet the criteria.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned policies. This can be specified multiple times, or once with parameters separated by a semicolon.
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of policies returned.
-m <ID>, --marker <ID>
-
Only return policies that appear after the given ID.
-o <KEY:DIR>, --sort <KEY:DIR>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-g, --global-project
-
Indicate that the list should include policies from all projects. This option is subject to access policy checking. Default is False.
-F, --full-id
-
Print full IDs in list.
senlin policy-show
usage: senlin policy-show <POLICY>
Show the policy details.
Positional arguments:
<POLICY>
-
Name of the policy to be updated.
senlin policy-type-list
usage: senlin policy-type-list
List the available policy types.
senlin policy-type-show
usage: senlin policy-type-show [-F <FORMAT>] <TYPE_NAME>
Get the details about a policy type.
Positional arguments:
<TYPE_NAME>
-
Policy type to retrieve.
Optional arguments:
-F <FORMAT>, --format <FORMAT>
-
The template output format, one of: yaml, json.
senlin policy-update
usage: senlin policy-update [-n <NAME>] <POLICY>
Update a policy.
Positional arguments:
<POLICY>
-
Name of the policy to be updated.
Optional arguments:
-n <NAME>, --name <NAME>
-
New name of the policy to be updated.
senlin profile-create
usage: senlin profile-create -s <SPEC FILE> [-M <KEY1=VALUE1;KEY2=VALUE2...>]
<PROFILE_NAME>
Create a profile.
Positional arguments:
<PROFILE_NAME>
-
Name of the profile to create.
Optional arguments:
-s <SPEC FILE>, --spec-file <SPEC FILE>
-
The spec file used to create the profile.
-M <KEY1=VALUE1;KEY2=VALUE2...>, --metadata <KEY1=VALUE1;KEY2=VALUE2...>
-
Metadata values to be attached to the profile. This can be specified multiple times, or once with key-value pairs separated by a semicolon.
senlin profile-delete
usage: senlin profile-delete <PROFILE> [<PROFILE> ...]
Delete profile(s).
Positional arguments:
<PROFILE>
-
Name or ID of profile(s) to delete.
senlin profile-list
usage: senlin profile-list [-f <KEY1=VALUE1;KEY2=VALUE2...>] [-l <LIMIT>]
[-m <ID>] [-o <KEY:DIR>] [-g] [-F]
List profiles that meet the criteria.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned profiles. This can be specified multiple times, or once with parameters separated by a semicolon.
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of profiles returned.
-m <ID>, --marker <ID>
-
Only return profiles that appear after the given ID.
-o <KEY:DIR>, --sort <KEY:DIR>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-g, --global-project
-
Indicate that the list should include profiles from all projects. This option is subject to access policy checking. Default is False.
-F, --full-id
-
Print full IDs in list.
senlin profile-show
usage: senlin profile-show <PROFILE>
Show the profile details.
Positional arguments:
<PROFILE>
-
Name or ID of profile to show.
senlin profile-type-list
usage: senlin profile-type-list
List the available profile types. :param sc: Instance of senlinclient. :param args: Additional command line arguments, if any.
senlin profile-type-show
usage: senlin profile-type-show [-F <FORMAT>] <TYPE_NAME>
Get the details about a profile type.
Positional arguments:
<TYPE_NAME>
-
Profile type to retrieve.
Optional arguments:
-F <FORMAT>, --format <FORMAT>
-
The template output format, one of: yaml, json.
senlin profile-update
usage: senlin profile-update [-n <NAME>] [-M <KEY1=VALUE1;KEY2=VALUE2...>]
<PROFILE_ID>
Update a profile.
Positional arguments:
<PROFILE_ID>
-
Name or ID of the profile to update.
Optional arguments:
-n <NAME>, --name <NAME>
-
The new name for the profile.
-M <KEY1=VALUE1;KEY2=VALUE2...>, --metadata <KEY1=VALUE1;KEY2=VALUE2...>
-
Metadata values to be attached to the profile. This can be specified multiple times, or once with key-value pairs separated by a semicolon.
senlin receiver-create
usage: senlin receiver-create [-t <TYPE>] -c <CLUSTER> -a <ACTION>
[-P <KEY1=VALUE1;KEY2=VALUE2...>]
<NAME>
Create a receiver.
Positional arguments:
<NAME>
-
Name of the receiver to create.
Optional arguments:
-t <TYPE>, --type <TYPE>
-
Type of the receiver to create.
-c <CLUSTER>, --cluster <CLUSTER>
-
Targeted cluster for this receiver.
-a <ACTION>, --action <ACTION>
-
Name or ID of the targeted action to be triggered.
-P <KEY1=VALUE1;KEY2=VALUE2...>, --params <KEY1=VALUE1;KEY2=VALUE2...>
-
A dictionary of parameters that will be passed to target action when the receiver is triggered.
senlin receiver-delete
usage: senlin receiver-delete <RECEIVER> [<RECEIVER> ...]
Delete receiver(s).
Positional arguments:
<RECEIVER>
-
Name or ID of receiver(s) to delete.
senlin receiver-list
usage: senlin receiver-list [-f <KEY1=VALUE1;KEY2=VALUE2...>] [-l <LIMIT>]
[-m <ID>] [-o <KEY:DIR>] [-g] [-F]
List receivers that meet the criteria.
Optional arguments:
-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>
-
Filter parameters to apply on returned receivers. This can be specified multiple times, or once with parameters separated by a semicolon.
-l <LIMIT>, --limit <LIMIT>
-
Limit the number of receivers returned.
-m <ID>, --marker <ID>
-
Only return receivers that appear after the given ID.
-o <KEY:DIR>, --sort <KEY:DIR>
-
Sorting option which is a string containing a list of keys separated by commas. Each key can be optionally appened by a sort direction (:asc or :desc)
-g, --global-project
-
Indicate that the list should include receivers from all projects. This option is subject to access policy checking. Default is False.
-F, --full-id
-
Print full IDs in list.
senlin receiver-show
usage: senlin receiver-show <RECEIVER>
Show the receiver details.
Positional arguments:
<RECEIVER>
-
Name or ID of the receiver to show.