Application

Creación

Crea un nuevo nodo en el clúster (denominado nodo perimetral) e instala una aplicación en ese nodo.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

Método URI de la solicitud
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

En el ejemplo siguiente se muestra el cuerpo de la solicitud para instalar aplicaciones en un clúster de HDInsight basado en Linux.

{  
  
    "name": "clusterName / applicationName"  
        "type": "Microsoft.HDInsight/clusters/applications",  
    "properties": {  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "edgenode",  
                    "targetInstanceCount": 1,  
                    "hardwareProfile": {  
                        "vmSize": "Standard_D3"  
                    }  
                }  
            ]  
        },  
        "installScriptActions": [  
            {  
                "name": "hue-install",  
                "uri": "https://publicEndpoint-bash-file.sh",  
                "parameters": "",  
                "roles": ["edgenode"]  
            }  
        ],  
        "uninstallScriptActions": [  
            {  
                "name": "hue-uninstall",  
                "uri": "https://publicEndpoint-bash-file.sh",  
                "parameters": "",  
                "roles": ["edgenode"]  
            }  
        ],  
        "httpsEndpoints": [  
            {  
                "subDomainSuffix": "abc",  
                "destinationPort": 8888,  
                "accessModes": ["WebPage"]  
            },  
            {  
                "subDomainSuffix": "was",  
                "destinationPort": 50073,  
                "accessModes": ["WebPage"]  
            }  
        ],  
        "applicationType": "CustomApplication"  
    }  
}  
  
Nombre del elemento Obligatorio Tipo Descripción
name String Especifica el nombre de la aplicación. El nombre debe especificarse como clusterName/applicationName. El nombre de la aplicación debe ser único por clúster.
type String Especifica el tipo del recurso.
Propiedades Tipo complejo Especifica las propiedades del clúster.

Propiedades

Nombre del elemento Obligatorio Tipo Descripción
computeProfile Tipo complejo Describe la máquina virtual en la que se ejecutará la aplicación.
InstallScriptActions Tipo complejo Describe las acciones de script de instalación para la aplicación. Se debe especificar al menos un script y los scripts deben ser idempotentes, lo que significa que se puede llamar a los scripts repetidamente mientras se produce el mismo resultado.
UninstallScriptActions No Tipo complejo Describe las acciones de script de desinstalación para la aplicación. Este parámetro es opcional, pero las acciones de script de desinstalación especificadas deben ser idempotentes (lo que significa que se puede llamar a los scripts repetidamente mientras se produce el mismo resultado).
HttpEndpoint No Tipo complejo Describe qué puntos de conexión de la aplicación deben ser direccionables desde Internet.
applicationType String Este elemento siempre tiene el valor "CustomApplication".

computeProfile

Este elemento debe contener exactamente un rol

Nombre del elemento Obligatorio Tipo Descripción
role Tipo complejo Especifica información sobre los roles del clúster.
Rol
Nombre del elemento Obligatorio Tipo Descripción
name String El nombre debe especificarse como "edgenode".
targetInstanceCount Entero Este elemento debe establecerse en 1
hardwareProfile Tipo complejo Especifica información sobre el perfil de hardware para el nodo perimetral.
hardwareProfile
Nombre del elemento Obligatorio Tipo Descripción
vmSize String Especifica el tamaño de la máquina virtual. Consulte Opciones de configuración de HDInsight (una vez en este vínculo, desplácese hacia abajo hasta Planes de tarifa de Node) para ver los tamaños válidos.

InstallScriptActions

Nombre del elemento Obligatorio Tipo Descripción
Nombre String Especifica el nombre de la acción de script. Debe ser único en todas las acciones de script persistentes en el clúster.
Identificador URI String Ubicación de acceso público del script. Todos los scripts especificados deben ser idempotentes, lo que significa que se puede llamar a los scripts repetidamente mientras se produce el mismo resultado.
Parámetros No String Conjunto opcional de parámetros que se pasan al script
Roles Matriz de cadenas Describe el rol en el que se ejecutará el script. Los valores válidos son: headnode, workernode, zookeepernode y edgenode. edgenode es el rol que hospeda la aplicación y donde se ejecutará la aplicación.

UninstallScriptActions

Nombre del elemento Obligatorio Tipo Descripción
Nombre String Especifica el nombre de la acción de script.
Identificador URI String Ubicación de acceso público del script. Los scripts especificados deben ser idempotentes, lo que significa que se puede llamar a los scripts repetidamente mientras se produce el mismo resultado.
Parámetros No String Conjunto opcional de parámetros que se pasan al script
Roles Matriz de cadenas Describe el rol en el que se ejecutará el script. Los valores válidos son: headnode, workernode, zookeepernode y edgenode. edgenode es el rol que hospeda la aplicación y donde se ejecutará la aplicación.

HttpEndpoint

Nombre del elemento Obligatorio Tipo Descripción
subDomainSuffix String Cadena alfanumérica de tres caracteres que se usa para compilar el nombre DNS que se usa para acceder a la aplicación. El nombre DNS tendrá el formato : * .apps.azurehdinsight.net. Este nombre debe ser único por clúster.
destinationPort Entero Puerto al que se reenviará el tráfico HTTP en el nodo perimetral que hospeda la aplicación.
accessModes No Matriz de cadenas Metadatos sobre el punto de conexión. Si el punto de conexión hospeda una página web, especifique la página web como modo de acceso. De lo contrario, la matriz debe estar vacía o no estar presente en la carga. Este elemento permite al Azure Portal mostrar vínculos directos a la aplicación.

Response

Si se completa la validación y se acepta la solicitud, la operación devolverá 200 (correcto).

Código de estado: 200 Ok

Obtener

Obtiene detalles sobre una aplicación de HDInsight.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

Método URI de solicitud
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Response

El cuerpo de la respuesta es una matriz de detalles de la aplicación de HDInsight o un solo detalle de aplicación de HDInsight si se proporciona applicationName. A continuación se muestra un ejemplo de detalle de la aplicación.

Código de respuesta: HTTP 200 (correcto) al finalizar correctamente la operación.

Respuesta de ejemplo:

{  
    "value": [  
        {  
            "id": "resourceId",
            "name": "clusterName / applicationName",
            "type": "Microsoft.HDInsight/clusters/applications",  
            "etag": "etagValue",
            "tags": null,  
            "properties": {  
                "computeProfile": {  
                    "roles": [  
                        {  
                            "name": "edgenode",  
                            "targetInstanceCount": 1,  
                            "hardwareProfile": {  
                                "vmSize": "Standard_D3"  
                            }  
                        }  
                    ]  
                },  
                "installScriptActions": [  
                    {  
                        "name": "hue-install",  
                        "uri": "https://publicEndpoint-bash-file.sh",  
                        "parameters": "",  
                        "roles": ["edgenode"]  
                    }  
                ],  
                "uninstallScriptActions": [  
                    {  
                        "name": "hue-uninstall",  
                        "uri": "https://publicEndpoint-bash-file.sh",  
                        "parameters": "",  
                        "roles": ["edgenode"]  
                    }  
                ],  
                "httpsEndpoints": [  
                    {  
                        "subDomainSuffix": "abc",  
                        "destinationPort": 8888,  
                        "accessModes": ["WebPage"]  
                    },  
                    {  
                        "subDomainSuffix": "was",  
                        "destinationPort": 50073,  
                        "accessModes": ["WebPage"]  
                    }  
                ],  
                "provisioningState": "Succeeded",  
                "applicationState": "Running",  
                "createdDate": "CreatedDate",  
                "applicationType": "CustomApplication",  
                "marketplaceIdentifier": "HueV1"  
            }  
        ]  
    }  
  

Quitar

Quita una aplicación de HDInsight del clúster.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

Método URI de solicitud
Delete https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Response

La operación devolverá 202 (aceptado) si la solicitud se completa correctamente.

Código de estado: 202 Aceptado.