az hdinsight application

Manage HDInsight applications.

Commands

az hdinsight application create

Create an application for a HDInsight cluster.

az hdinsight application delete

Deletes the specified application on the HDInsight cluster.

az hdinsight application list

Lists all of the applications for the HDInsight cluster.

az hdinsight application show

Gets properties of the specified application.

az hdinsight application wait

Place the CLI in a waiting state until an operation is complete.

az hdinsight application create

Create an application for a HDInsight cluster.

az hdinsight application create --cluster-name
                                --name
                                --resource-group
                                --script-action-name
                                --script-uri
                                [--access-mode]
                                [--destination-port]
                                [--disable-gateway-auth {false, true}]
                                [--edgenode-size]
                                [--marketplace-id]
                                [--no-validation-timeout]
                                [--script-parameters]
                                [--ssh-password]
                                [--ssh-public-key]
                                [--ssh-user]
                                [--sub-domain-suffix]
                                [--subnet]
                                [--subscription]
                                [--tags]
                                [--type {CustomApplication, RServer}]
                                [--vnet-name]

Examples

Create an application with a script URI.

az hdinsight application create -g MyResourceGroup -n MyApplication \
--cluster-name MyCluster \
--script-uri https://hdiconfigactions.blob.core.windows.net/linuxhueconfigactionv02/install-hue-uber-v02.sh \
--script-action-name MyScriptAction \
--script-parameters '"-version latest -port 20000"'

Create an application with a script URI and specified edge node size.

az hdinsight application create -g MyResourceGroup -n MyApplication \
--cluster-name MyCluster \
--script-uri https://hdiconfigactions.blob.core.windows.net/linuxhueconfigactionv02/install-hue-uber-v02.sh \
--script-action-name MyScriptAction \
--script-parameters "-version latest -port 20000" \
--edgenode-size Standard_D4_v2

Create an application with HTTPS Endpoint.

az hdinsight application create -g MyResourceGroup -n MyApplication \
--cluster-name MyCluster \
--script-uri https://hdiconfigactions.blob.core.windows.net/linuxhueconfigactionv02/install-hue-uber-v02.sh \
--script-action-name MyScriptAction \
--script-parameters "-version latest -port 20000" \
--destination-port 8888 \
--sub-domain-suffix was

Required Parameters

--cluster-name

The name of the cluster.

--name -n

The constant value for the application name.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--script-action-name

The name of the script action.

--script-uri

The URI to the script.

Optional Parameters

--access-mode

The access mode for the application.

default value: WebPage
--destination-port

The destination port to connect to.

default value: 8080
--disable-gateway-auth

Indicates whether to disable gateway authentication. Default is to enable gateway authentication. Default: false.

accepted values: false, true
--edgenode-size
--marketplace-id

The marketplace identifier.

--no-validation-timeout

Permit timeout error during argument validation phase. If omitted, validation timeout error will be permitted.

--script-parameters

The parameters for the script.

--ssh-password -P

SSH password for the cluster nodes.

--ssh-public-key -K

SSH public key for the cluster nodes.

--ssh-user -U

SSH username for the cluster nodes.

default value: sshuser
--sub-domain-suffix

The subdomain suffix of the application.

--subnet

The name or ID of subnet. If name is supplied, --vnet-name must be supplied.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--type -t

The application type.

accepted values: CustomApplication, RServer
default value: CustomApplication
--vnet-name

The name of a virtual network.

az hdinsight application delete

Deletes the specified application on the HDInsight cluster.

az hdinsight application delete --cluster-name
                                --name
                                --resource-group
                                [--no-wait]
                                [--subscription]
                                [--yes]

Required Parameters

--cluster-name

The name of the cluster.

--name -n

The constant value for the application name.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--yes -y

Do not prompt for confirmation.

az hdinsight application list

Lists all of the applications for the HDInsight cluster.

az hdinsight application list --cluster-name
                              --resource-group
                              [--query-examples]
                              [--subscription]

Required Parameters

--cluster-name

The name of the cluster.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

az hdinsight application show

Gets properties of the specified application.

az hdinsight application show --cluster-name
                              --name
                              --resource-group
                              [--query-examples]
                              [--subscription]

Required Parameters

--cluster-name

The name of the cluster.

--name -n

The constant value for the application name.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

az hdinsight application wait

Place the CLI in a waiting state until an operation is complete.

az hdinsight application wait --cluster-name
                              --name
                              --resource-group
                              [--created]
                              [--custom]
                              [--deleted]
                              [--exists]
                              [--interval]
                              [--subscription]
                              [--timeout]
                              [--updated]

Required Parameters

--cluster-name

The name of the cluster.

--name -n

The constant value for the application name.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--created

Wait until created with 'provisioningState' at 'Succeeded'.

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

--exists

Wait until the resource exists.

--interval

Polling interval in seconds.

default value: 30
--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--timeout

Maximum wait in seconds.

default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.