Udostępnij przez

Interfejs API REST aplikacji w usłudze Azure HDInsight

Utwórz

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

Żądanie

Zobacz Typowe parametry i nagłówki, aby zapoznać się z nagłówkami i parametrami używanymi przez klastry.

Metoda Żądanie URI
POŁÓŻ https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

W poniższym przykładzie przedstawiono 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 Required Typ Opis
nazwa Tak Sznurek Określa nazwę aplikacji. Nazwa musi być określona jako clusterName/applicationName. Nazwa aplikacji musi być unikatowa dla każdego klastra.
typ Tak Sznurek 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 Required Typ Opis
computeProfile (profil obliczeniowy) Tak Typ złożony Opisuje maszynę wirtualną, na której aplikacja będzie działać
InstallScriptActions Tak Typ złożony Opisuje akcje skryptu instalacyjnego dla aplikacji. Należy określić co najmniej jeden skrypt, a skrypty muszą być idempotentne, co oznacza, że skrypty mogą być wywoływane wielokrotnie, generując ten sam wynik.
UninstallScriptActions Nie. Typ złożony Opisuje akcje skryptu odinstalowywania dla aplikacji. Ten parametr jest opcjonalny, ale wszystkie określone akcje skryptu odinstalowywania muszą być idempotentne (co oznacza, że skrypty mogą być wywoływane wielokrotnie, generując ten sam wynik).
Punkt końcowy httpEndpoint Nie. Typ złożony Opisuje, które punkty końcowe w aplikacji powinny być adresowalne do Internetu.
Typ aplikacji Tak Sznurek Ten element ma zawsze wartość "CustomApplication"

computeProfile (profil obliczeniowy)

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

Nazwa elementu Required Typ Opis
rola Tak Typ złożony Określa informacje o rolach w klastrze
rola
Nazwa elementu Required Typ Opis
nazwa Tak Sznurek Nazwa musi być określona jako "edgenode"
targetInstanceCount (liczba) Tak Integer Ten element musi być ustawiony na wartość 1
Profil sprzętowy Tak Typ złożony Określa informacje o profilu sprzętowym węzła edgenode
Profil sprzętowy
Nazwa elementu Required Typ Opis
vmSize Tak Sznurek Określa rozmiar maszyny wirtualnej. Zapoznaj się z opcjami konfiguracji usługi HDInsight (po kliknięciu tego linku przewiń w dół do pozycji Warstwy cenowe węzłów), aby uzyskać prawidłowe rozmiary

InstallScriptActions

Nazwa elementu Required Typ Opis
Nazwa Tak Sznurek Określa nazwę akcji skryptu. Musi być unikatowa dla wszystkich utrwalonych akcji skryptu w klastrze
Uri Tak Sznurek Publicznie dostępna lokalizacja skryptu. Wszystkie określone skrypty muszą być idempotentne, co oznacza, że skrypty mogą być wywoływane wielokrotnie, generując ten sam wynik.
Parametry Nie. Sznurek Opcjonalny zestaw parametrów do przekazania do skryptu
Role Tak Tablica ciągów Opisuje rolę, na której ma być uruchamiany skrypt. Prawidłowe wartości to: headnode, workernode, zookeepernode i edgenode. edgenode to rola hostująca aplikację i miejsce, w którym aplikacja będzie działać.

UninstallScriptActions

Nazwa elementu Required Typ Opis
Nazwa Tak Sznurek Określa nazwę akcji skryptu.
Uri Tak Sznurek Publicznie dostępna lokalizacja skryptu. Wszystkie określone skrypty muszą być idempotentne, co oznacza, że skrypty mogą być wywoływane wielokrotnie podczas generowania tego samego wyniku.
Parametry Nie. Sznurek Opcjonalny zestaw parametrów do przekazania do skryptu
Role Tak Tablica ciągów Opisuje rolę, na której ma być uruchamiany skrypt. Prawidłowe wartości to: headnode, workernode, zookeepernode i edgenode. edgenode to rola hostująca aplikację i miejsce, w którym aplikacja będzie działać.

Punkt końcowy httpEndpoint

Nazwa elementu Required Typ Opis
subDomainSuffix Tak Sznurek Trzyznakowy ciąg alfanumeryczny używany do tworzenia nazwy DNS używanej do uzyskiwania dostępu do aplikacji. Nazwa DNS będzie miała format: *.apps.azurehdinsight.net. Ta nazwa musi być unikatowa dla każdego klastra.
portport docelowy Tak Integer Port, do którego ma być przekazywany ruch HTTP w węźle edgenode hostującym aplikację.
accessModes Nie. Tablica ciągów Metadane dotyczące punktu końcowego. Jeśli punkt końcowy obsługuje stronę sieci Web, określ stronę internetową jako tryb dostępu. W przeciwnym razie tablica powinna być pusta lub nie powinna być obecna w ładunku. Ten element umożliwia Azure Portal wyświetlanie bezpośrednich linków do aplikacji.

Odpowiedź

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

Kod stanu: 200 OK

Pobierz

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

Żądanie

Zobacz Typowe parametry i nagłówki, aby zapoznać się z nagłówkami i parametrami używanymi przez klastry.

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

Odpowiedź

Treść odpowiedzi to tablica szczegółów aplikacji usługi HDInsight lub pojedynczy szczegół aplikacji usługi HDInsight, jeśli podano applicationName. Poniżej znajduje się przykładowy szczegół 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, aby zapoznać się z nagłówkami i parametrami używanymi przez klastry.

Metoda Żądanie URI
USUŃ https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Odpowiedź

Operacja zwróci wartość 202 (Zaakceptowano), jeśli żądanie zostanie ukończone pomyślnie

Kod stanu: 202 Zaakceptowano.

  • Last updated on