application or app

-appId <applicationId>

Specifies the ID of the application to operate on

-appStates <states>

Works with -list to filter applications based on a comma-separated list of application states. Valid application states are: ALL, NEW, NEW_SAVING, SUBMITTED, ACCEPTED, RUNNING, FINISHED, FAILED, KILLED

-appTags <tags>

Works with -list to filter applications based on a comma-separated list of application tags

-appTags <types>

Works with -list to filter applications based on a comma-separated list of application types

-changeQueue <queue_name>

Moves application to a new queue. ApplicationId can be passed using the -appId flag. The -movetoqueue action is deprecated, this new flag changeQueue performs the same functionality

-component <component_name> <count>

Works with the -flex flag to change the number of components/containers running for an application or a long-running service. Supports absolute or relative changes, such as +1, 2, or -3

-components <components>

Works with the -upgrade flag to trigger the upgrade of specified components of the application. Multiple components should be separated by commas

-decomission <application_name>

Decommissions component instances for an application or a long-running service. Requires the -instances option. Supports the -appTypes option to specify the client implementation to use

-destroy <application_name>

Destroys a saved application specification and removes all application data permanently. Supports the -appTypes option to specify which client implementation to use

-enableFastLaunch

Uploads AM dependencies to HDFS to make future launches faster. Supports the -appTypes option to specify which client implementation to use

-flex <application_name/ID>

Changes the number of running containers for a component of an application or a long-running service. Requires the -component option. If a name is provided, appType must be provided unless it is the default yarn-service. If an ID is provided, the appType will be looked up. Supports the -appTypes option to specify which client implementation to use

-help

Displays help for all commands

-instances <component_instances>

Works with the -upgrade option to trigger the upgrade of the specified component instances of the application. Also works with the -decomission option to decommission specified component instances. Multiple instances should be separated by commas

-kill <application_ID>

Kills the application. Multiple applications can be provided separated with a space

-launch <application_name> <file_name>

Launches the application from specification file (saves specification and starts application). Options -updateLifetime and -changeQueue can be specified to alter the values provided in the file. Supports the -appTypes option to specify which client implementation to use

-list

Lists applications. Supports optional use of -appTypes to filter applications based on applications type, -appStates to filter applications based on application state and -appTags to filter applications based on application tag

-movetoqueue <application_ID>

Deprecated. Moves the application to a different queue. Use the -changeQueue option instead

-queue <queue_name>

Works with the -movetoqueue flag to specify the queue to move an application to

-save <application_name> <file_name>

Saves specification file for an application. Options -updateLifetime and -changeQueue can be specified to alter the values provided in the file. Supports the -appTypes option to specify which client implementation to use

-start <application_name>

Starts a previously saved application. Supports the -appTypes option to specify which client implementation to use

-status <application_name/ID>

Prints the application status. If an ID is provided, prints the generic YARN application status. If a name is provided, prints the application specific status based on app’s own implementation, and the -appTypes option must be specified unless it is the default yarn-service type

-stop <application_name/ID>

Stops application gracefully (may be started again later). If a name is provided, -appType must be provided unless it is the default yarn-service. If an ID is provided, the -appType will be looked up. Supports the -appTypes option to specify which client implementation to use

-updateLifetime <timeout>

Updates the timeout of an application from now. An application ID can be passed using the -appId option. The timeout value is in seconds

-updatePriority <priority>

Updates the priority of an application. An application ID can be passed using the -appId option