Compartir a través de

Application

  • Artículo

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.