openstack-manuals/doc/cli-reference/source/senlin.rst

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.5.0.

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>] [--profile HMAC_KEY]
              <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]

--profile HMAC_KEY

HMAC key to use for encrypting context data for performance profiling of operation. This key should be the value of HMAC key configured in osprofiler middleware in senlin, it is specified in the paste deploy configuration (/etc/senlin/api-paste.ini). Without the key, profiling will not be triggered even if osprofiler is enabled on server side.

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 appended 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 appended 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 appended 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 appended 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 appended 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 appended 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 appended 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 appended 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.