Application
Crear
Crea un nuevo nodo en el clúster (denominado nodo perimetral) e instala una aplicación en ese nodo.
Request
Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para 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 | Sí | 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 | Sí | String | Especifica el tipo del recurso. |
Propiedades | Sí | Tipo complejo | Especifica las propiedades del clúster. |
Propiedades
Nombre del elemento | Obligatorio | Tipo | Descripción |
---|---|---|---|
computeProfile | Sí | Tipo complejo | Describe la máquina virtual en la que se ejecutará la aplicación. |
InstallScriptActions | Sí | Tipo complejo | Describe las acciones de script de instalación de la aplicación. Se debe especificar al menos un script y los scripts deben ser idempotentes, lo que significa que se puede llamar repetidamente a los scripts mientras se produce el mismo resultado. |
UninstallScriptActions | No | Tipo complejo | Describe las acciones de script de desinstalación de 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 repetidamente a los scripts al generar el mismo resultado). |
HttpEndpoint | No | Tipo complejo | Describe qué puntos de conexión de la aplicación deben ser direccionables a Internet. |
applicationType | Sí | String | Este elemento siempre es el valor "CustomApplication" |
computeProfile
Este elemento debe contener exactamente un rol
Nombre del elemento | Obligatorio | Tipo | Descripción |
---|---|---|---|
role | Sí | Tipo complejo | Especifica información sobre los roles del clúster. |
rol
Nombre del elemento | Obligatorio | Tipo | Descripción |
---|---|---|---|
name | Sí | String | El nombre debe especificarse como "edgenode" |
targetInstanceCount | Sí | Entero | Este elemento debe establecerse en 1 |
hardwareProfile | Sí | Tipo complejo | Especifica información sobre el perfil de hardware del edgenode. |
hardwareProfile
Nombre del elemento | Obligatorio | Tipo | Descripción |
---|---|---|---|
vmSize | Sí | String | Especifica el tamaño de la máquina virtual. Consulte las opciones de configuración de HDInsight (una vez en este vínculo, desplácese hacia abajo hasta planes de tarifa de Node) para conocer los tamaños válidos. |
InstallScriptActions
Nombre del elemento | Obligatorio | Tipo | Descripción |
---|---|---|---|
Nombre | Sí | 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 | Sí | String | Ubicación accesible públicamente del script. Todos los scripts especificados deben ser idempotentes, lo que significa que se puede llamar repetidamente a los scripts mientras se produce el mismo resultado. |
Parámetros | No | String | Conjunto opcional de parámetros que se van a pasar al script |
Roles | Sí | Matriz de cadenas | Describe el rol en el que se va a ejecutar el script. Los valores válidos son: headnode, workernode, zookeepernode y edgenode. edgenode es el rol que hospeda la aplicación y dónde se ejecutará la aplicación. |
UninstallScriptActions
Nombre del elemento | Obligatorio | Tipo | Descripción |
---|---|---|---|
Nombre | Sí | String | Especifica el nombre de la acción de script. |
Identificador URI | Sí | String | Ubicación accesible públicamente del script. Los scripts especificados deben ser idempotentes, lo que significa que se puede llamar repetidamente a los scripts mientras se produce el mismo resultado. |
Parámetros | No | String | Conjunto opcional de parámetros que se van a pasar al script |
Roles | Sí | Matriz de cadenas | Describe el rol en el que se va a ejecutar el script. Los valores válidos son: headnode, workernode, zookeepernode y edgenode. edgenode es el rol que hospeda la aplicación y dónde se ejecutará la aplicación. |
HttpEndpoint
Nombre del elemento | Obligatorio | Tipo | Descripción |
---|---|---|---|
subDomainSuffix | Sí | String | Cadena alfanumérica de tres caracteres que se usa para compilar el nombre DNS usado para acceder a la aplicación. El nombre DNS tendrá el formato : *.apps.azurehdinsight.net. Este nombre debe ser único por clúster. |
destinationPort | Sí | Entero | Puerto al que se reenvía 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 que el Azure Portal muestre 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 Aceptar
Obtener
Obtiene detalles sobre una aplicación de HDInsight.
Request
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 único 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 completar 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.
Request
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 ha completado correctamente.
Código de estado: 202 Aceptado.