Udostępnij za pośrednictwem

Aplikacja

  • Artykuł

Utwórz

Tworzy nowy węzeł w klastrze (nazywany węzłem krawędzi) i instaluje aplikację w tym węźle.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Poniższy przykład przedstawia treść żądania instalowania aplikacji w klastrze usługi HDInsight opartym na systemie 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"  
	}  
}
Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Określa nazwę aplikacji. Nazwa musi być określona jako nazwa_klastra/nazwa_aplikacji. Nazwa aplikacji musi być unikatowa dla klastra.
typ Tak Ciąg Określa typ zasobu.
Właściwości Tak Typ złożony Określa właściwości klastra.

Właściwości

Nazwa elementu Wymagany Typ Opis
computeProfile Tak Typ złożony W tym artykule opisano maszynę wirtualną uruchamianą przez aplikację
InstallScriptActions Tak Typ złożony Opisuje akcje skryptu instalacji dla aplikacji. Należy określić co najmniej jeden skrypt, a skrypty muszą być idempotentne, co oznacza, że skrypty mogą być wywoływane wielokrotnie podczas generowania tego samego wyniku.
UninstallScriptActions Nie Typ złożony Opisuje akcje skryptu dezinstalacji dla aplikacji. Ten parametr jest opcjonalny, ale wszystkie określone akcje skryptu dezinstalacji muszą być idempotentne (co oznacza, że skrypty mogą być wywoływane wielokrotnie podczas generowania tego samego wyniku).
HttpEndpoint Nie Typ złożony Opisuje, które punkty końcowe w aplikacji powinny być adresowalne z Internetu.
applicationType Tak Ciąg Ten element jest zawsze wartością "CustomApplication"

computeProfile

Ten element powinien zawierać dokładnie jedną rolę

Nazwa elementu Wymagany Typ Opis
Roli Tak Typ złożony Określa informacje o rolach w klastrze
role (rola)
Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Nazwa musi być określona jako "edgenode"
targetInstanceCount Tak Liczba całkowita Ten element musi być ustawiony na 1
hardwareProfile Tak Typ złożony Określa informacje o profilu sprzętu dla węzła brzegowego
hardwareProfile
Nazwa elementu Wymagany Typ Opis
vmSize Tak Ciąg Określa rozmiar maszyny wirtualnej. Zapoznaj się z opcjami konfiguracji usługi HDInsight (po kliknięciu tego linku przewiń w dół do warstw cenowych środowiska Node), aby uzyskać prawidłowe rozmiary

InstallScriptActions

Nazwa elementu Wymagany Typ Opis
Nazwa Tak Ciąg Określa nazwę akcji skryptu. Musi być unikatowa we wszystkich utrwalonej akcji skryptu w klastrze
Identyfikator uri Tak Ciąg Publicznie dostępna lokalizacja skryptu. Wszystkie określone skrypty muszą być idempotentne, co oznacza, że skrypty mogą być wywoływane wielokrotnie podczas tworzenia tego samego wyniku.
Parametry Nie Ciąg Opcjonalny zestaw parametrów do przekazania do skryptu
Role Tak Tablica ciągów Opisuje rolę skryptu do uruchomienia. Prawidłowe wartości to: headnode, workernode, zookeepernode i edgenode. edgenode to rola hostująca aplikację i miejsce, w którym zostanie uruchomiona aplikacja.

UninstallScriptActions

Nazwa elementu Wymagany Typ Opis
Nazwa Tak Ciąg Określa nazwę akcji skryptu.
Identyfikator uri Tak Ciąg Publicznie dostępna lokalizacja skryptu. Wszystkie określone skrypty muszą być idempotentne, co oznacza, że skrypty mogą być wywoływane wielokrotnie podczas tworzenia tego samego wyniku.
Parametry Nie Ciąg Opcjonalny zestaw parametrów do przekazania do skryptu
Role Tak Tablica ciągów Opisuje rolę skryptu do uruchomienia. Prawidłowe wartości to: headnode, workernode, zookeepernode i edgenode. edgenode to rola hostująca aplikację i miejsce, w którym zostanie uruchomiona aplikacja.

HttpEndpoint

Nazwa elementu Wymagany Typ Opis
subDomainSuffix Tak Ciąg Trzyznaczny ciąg alfanumeryczny używany do tworzenia nazwy DNS używanej do uzyskiwania dostępu do aplikacji. Nazwa DNS będzie mieć format : *.apps.azurehdinsight.net. Ta nazwa musi być unikatowa dla klastra.
destinationPort Tak Liczba całkowita Port do przekazywania ruchu HTTP do węzła brzegowego obsługującego aplikację.
accessModes Nie Tablica ciągów Metadane dotyczące punktu końcowego. Jeśli punkt końcowy hostuje stronę sieci Web, określ stronę internetową jako tryb dostępu. W przeciwnym razie tablica powinna być pusta lub nie znajduje się w ładunku. Ten element umożliwia Azure Portal wyświetlanie bezpośrednich linków do aplikacji.

Reakcja

Jeśli walidacja zostanie ukończona i żądanie zostanie zaakceptowane, operacja zwróci 200 (OK).

Kod stanu: 200 OK

Get

Pobiera szczegółowe informacje o aplikacji usługi HDInsight.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Reakcja

Treść odpowiedzi to tablica szczegółów aplikacji usługi HDInsight lub pojedynczy szczegół aplikacji usługi HDInsight, jeśli podano wartość applicationName. Poniżej przedstawiono przykład szczegółów aplikacji.

Kod odpowiedzi: HTTP 200 (OK) po pomyślnym zakończeniu operacji.

Przykładowa odpowiedź:

{  
	"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"  
			}  
		]  
	}

Usuń

Usuwa aplikację usługi HDInsight z klastra.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Reakcja

Operacja zwróci 202 (zaakceptowane), jeśli żądanie zostało ukończone pomyślnie

Kod stanu: Zaakceptowano 202.