Compartir a través de


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 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 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 String Este elemento siempre es 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 del edgenode.
hardwareProfile
Nombre del elemento Obligatorio Tipo Descripción
vmSize 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 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 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 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 String Especifica el nombre de la acción de script.
Identificador URI 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 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 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 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.