Приложение

  • Статья

Создать

Создает новый узел в кластере (называемый граничным узлом) и устанавливает на этом узле приложение.

Запрос

См. раздел Общие параметры и заголовки для заголовков и параметров, используемых кластерами.

Метод Универсальный код ресурса (URI) запроса
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

В следующем примере показан текст запроса для установки приложений в кластер HDInsight под управлением 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"  
	}  
}
Имя элемента Обязательно Тип Описание
name Да Строка Указывает имя приложения. Имя должно быть указано как clusterName/applicationName. Имя приложения должно быть уникальным для каждого кластера.
тип Да Строка Указывает тип ресурса.
Свойства Да Сложный тип Указывает свойства кластера.

Свойства

Имя элемента Обязательно Тип Описание
computeProfile Да Сложный тип Описание виртуальной машины, на котором будет выполняться приложение.
InstallScriptActions Да Сложный тип Описывает действия скрипта установки для приложения. Необходимо указать по крайней мере один скрипт, а скрипты должны быть идемпотентными. Это означает, что скрипты могут вызываться многократно при создании одного и того же результата.
UninstallScriptActions Нет Сложный тип Описывает действия скрипта удаления для приложения. Этот параметр является необязательным, но все указанные действия скрипта удаления должны быть идемпотентными (это означает, что скрипты могут вызываться многократно при создании одного и того же результата).
HttpEndpoint Нет Сложный тип Описывает, какие конечные точки в приложении должны быть адресуемыми в Интернете.
applicationType Да Строка Этот элемент всегда имеет значение CustomApplication

computeProfile

Этот элемент должен содержать ровно одну роль

Имя элемента Обязательно Тип Описание
role Да Сложный тип Указывает сведения о ролях в кластере.
роль
Имя элемента Обязательно Тип Описание
name Да Строка Имя должно быть указано как edgenode.
targetInstanceCount Да Целое число Для этого элемента должно быть задано значение 1
hardwareProfile Да Сложный тип Указывает сведения о профиле оборудования для пограничного узла.
hardwareProfile
Имя элемента Обязательно Тип Описание
vmSize Да Строка Указывает размер виртуальной машины. Сведения о допустимых размерах см. в разделе Параметры конфигурации HDInsight (прокрутите вниз до раздела Ценовые категории Node).

InstallScriptActions

Имя элемента Обязательно Тип Описание
Имя Да Строка Указывает имя действия скрипта. Должен быть уникальным для всех сохраненных действий скрипта в кластере
URI Да Строка Общедоступное расположение скрипта. Все указанные скрипты должны быть идемпотентными. Это означает, что скрипты могут вызываться несколько раз при создании одного и того же результата.
Параметры нет Строка Необязательный набор параметров для передачи в скрипт
Роли Да Массив строк Описывает роль для запуска скрипта. Допустимые значения: headnode, workernode, zookeepernode и edgenode. edgenode — это роль, в которой размещается приложение и где будет выполняться приложение.

UninstallScriptActions

Имя элемента Обязательно Тип Описание
Имя Да Строка Указывает имя действия скрипта.
URI Да Строка Общедоступное расположение скрипта. Все указанные скрипты должны быть идемпотентными. Это означает, что скрипты могут вызываться несколько раз при создании одного и того же результата.
Параметры нет Строка Необязательный набор параметров для передачи в скрипт
Роли Да Массив строк Описывает роль для запуска скрипта. Допустимые значения: headnode, workernode, zookeepernode и edgenode. edgenode — это роль, в которой размещается приложение и где будет выполняться приложение.

HttpEndpoint

Имя элемента Обязательно Тип Описание
subDomainSuffix Да Строка Трехзначная буквенно-цифровая строка, используемая для создания DNS-имени, используемого для доступа к приложению. DNS-имя будет иметь формат *.apps.azurehdinsight.net. Это имя должно быть уникальным для каждого кластера.
destinationPort Да Целое число Порт для перенаправления HTTP-трафика на edgenode, на котором размещено приложение.
accessModes Нет Массив строк Метаданные о конечной точке. Если на конечной точке размещена веб-страница, укажите веб-страницу в качестве режима доступа. В противном случае массив должен быть пустым или не присутствовать в полезных данных. Этот элемент позволяет портал Azure отображать прямые ссылки на приложение.

Ответ

Если проверка завершена и запрос принят, операция вернет значение 200 (ОК).

Код состояния: 200 OK

Получить

Возвращает сведения о приложении HDInsight.

Запрос

Заголовки и параметры, используемые кластерами, см. в разделе Общие параметры и заголовки .

Метод Универсальный код ресурса (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}

Ответ

Текст ответа — это массив сведений о приложении HDInsight или одно приложение HDInsight, если указано applicationName. Ниже приведен пример сведений о приложении.

Код ответа: HTTP 200 (ОК) при успешном завершении операции.

Пример ответа:

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

Удалить

Удаляет приложение HDInsight из кластера.

Запрос

Заголовки и параметры, используемые кластерами, см. в разделе Общие параметры и заголовки .

Метод Универсальный код ресурса (URI) запроса
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/applications/{application Name}?api-version={api-version}

Ответ

Операция вернет значение 202 (принято), если запрос успешно завершен.

Код состояния: 202 Принято.