REST API кластера в Azure HDInsight

Создать

Создает кластер в указанной подписке.

Запрос

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

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

В следующем примере показан текст запроса для создания кластера hadoop под управлением Linux. Примеры создания кластеров другими способами см. в разделе Примеры ниже.

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
        "clusterDefinition": {  
            "kind": "hadoop",  
  
            "configurations": {  
                "gateway": {  
                    "restAuthCredential.isEnabled": true,  
                    "restAuthCredential.username": "http-user",  
                    "restAuthCredential.password": "password"  
                },  
  
                "core-site": {  
                    "fs.defaultFS": "wasb://container@storageaccount.blob.core.windows.net",  
                    "fs.azure.account.key.storageaccount.blob.core.windows.net": storage-account-key"  
                }  
            }  
        },
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
  
                    "osProfile": {  
                        "linuxOperatingSystemProfile": {  
                            "username": "username",  
                            "sshProfile": {  
                                "publicKeys": [   
                                    { "certificateData": "ssh-rsa key" }  
                                ]  
                            }  
                        }  
                    }  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
  
                    "osProfile": {  
                        "linuxOperatingSystemProfile": {  
                            "username": "username",  
                            "sshProfile": {  
                                "publicKeys": [  
                                    { "certificateData": " ssh-rsa key" }  
                                ]  
                            }  
                        }  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    },  
  
                    "osProfile": {  
                        "linuxOperatingSystemProfile": {  
                            "username": "username",  
                            "sshProfile": {  
                                "publicKeys": [   
                                    { "certificateData": "ssh-rsa key" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Имя элемента	Обязательно	Тип	Описание
идентификатор	Да	Строка	Указывает идентификатор ресурса кластера.
name	Да	Строка	Указывает имя кластера.
тип	Да	Строка	Указывает тип кластера.
location	Да	Строка	Указывает поддерживаемую папку Azure, в которой должен быть создан кластер. Дополнительные сведения см. в статье Перечисление всех доступных географических расположений.
tags	нет	Строка	Указывает теги, которые будут назначены кластеру. Дополнительные сведения об использовании тегов см. в статье Использование тегов для упорядочения ресурсов Azure.
Свойства	Да	Сложный тип	Указывает свойства кластера.

Свойства

Имя элемента	Обязательно	Тип	Описание
clusterVersion	Да	Строка	Указывает версию кластера.
osType	Да	Строка	Указывает операционную систему для кластера. Допустимые значения: Linux и Windows.
clusterDefinition	Да	Сложный тип	Указывает сведения о типе и конфигурациях кластера.
computeProfile	Да	Сложный тип	Указывает сведения о топологии кластера и связанных свойствах роли.

clusterDefinition

Имя элемента	Обязательно	Тип	Описание
kind	Да	Строка	Указывает тип кластера. Допустимые значения: hadoop, hbase, storm & spark.
конфигурации	Да	Словарь	Этот элемент представляет собой словарь типа конфигурации и связанный с ним словарь значений. Тип конфигурации шлюза используется для настройки пользователя HTTP, используемого для подключения к веб-API и порталу Ambari. Тип конфигурации core-site используется для настройки учетной записи хранения по умолчанию для кластера.

computeProfile

Имя элемента	Обязательно	Тип	Описание
clusterVersion	Да	Строка	Указывает версию кластера.
role	Да	Массив сложного типа (роль)	Указывает сведения о ролях в кластере.

роль

Имя элемента	Обязательно	Тип	Описание
name	Да	Строка	Указывает имя роли.
targetInstanceCount	Да	Целое число	Указывает число целевых экземпляров для роли.
hardwareProfile	Да	Сложный тип	Указывает сведения о профиле оборудования для роли.
osProfile	Да	Сложный тип	Указывает сведения о профиле ос для роли.

hardwareProfile

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

osProfile

Имя элемента	Обязательно	Тип	Описание
linuxOperatingSystemProfile	Нет	Сложный тип	Указывает параметры, связанные с ОС Linux.
windowsOperatingSystemProfile	Нет	Сложный тип	Задает параметры, связанные с ОС Windows
virtualNetworkProfile	Нет	Сложный тип	Указывает параметры, связанные с виртуальной сетью, если кластер развертывается в виртуальной сети в подписке пользователя.
scriptActions	Нет	Массив сложного типа	Список действий скрипта для выполнения в кластере

linuxOperatingSystemProfile

Имя элемента	Обязательно	Тип	Описание
Имя пользователя	Да	Строка	Имя пользователя SSH
sshProfile	Нет	Сложный тип	Указывает ключ SSH. Требуется один из sshProfile или Password.
Пароль	Нет	Строка	Указывает пароль SSH. Требуется один из sshProfile или Password.

sshProfile

Имя элемента	Обязательно	Тип	Описание
publicKeys	Да	Array	Содержит список объектов certificateData. Значением является открытый ключ ssh-rsa.

windowsOperatingSystemProfile

Имя элемента	Обязательно	Тип	Описание
rdpSettings	Нет	Сложный тип	Задает параметры RDP для кластеров Windows

rdpSettings

Имя элемента	Обязательно	Тип	Описание
username	Да	Строка	Указывает имя пользователя RDP.
password	Да	Строка	Указывает пароль для пользователя RDP.
expiryDate	Да	Дата	Дата истечения срока действия учетных данных RDP

virtualNetworkProfile

Имя элемента	Обязательно	Тип	Описание
идентификатор	Да	Строка	Идентификатор ресурса виртуальная сеть
подсеть	Да	Строка	Указывает имя подсети.

scriptActions

Имя элемента	Обязательно	Тип	Описание
name	Да	Строка	Понятное имя для действия скрипта
uri	Да	Строка	URL-адрес файла действия скрипта
parameters	Нет	Строка	Аргументы для передачи при выполнении файла действия скрипта

Ответ

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

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

Текст ответа для кластера Linux создается с помощью ключа SSH:

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Имя элемента	Тип	Описание
provisioningState	Строка	Указывает текущее состояние подготовки.
clusterState	Строка	Указывает более подробное состояние кластера HDInsight во время подготовки.
createdDate	Дата	Дата и время получения запроса на создание кластера
quotaInfo	Сложный тип	Указывает ядра, которые использует кластер.
ошибки	Массив сообщений об ошибках	Содержит сообщение об ошибке, если provisioningState = "failed"
connectivityEndpoints	Сложный тип	Указывает общедоступные конечные точки для кластера.

connectivityEndpoints

Имя элемента	Тип	Описание
name	Строка	Понятное имя конечной точки подключения
protocol	Строка	Указывает используемый протокол (например, HTTPS, SSH).
location	Строка	Указывает URL-адрес для подключения.
порт	INT	Указывает порт для подключения.

Создание кластера HDInsight уровня "Премиум", присоединенного к домену (только Linux, предварительная версия)

Создайте присоединенный к домену кластер уровня "Премиум" с помощью Apache Ranger. Чтобы создать безопасный кластер, пользователь должен указать SecurityProfile в тексте запроса.

Запрос

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

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

В следующем примере показан текст запроса для создания присоединенного к домену кластера Hadoop на основе Linux уровня "Премиум".

{
	"id": "/subscriptions/{ subscription-id }/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/ clusters/mycluster ", "
	name "
	: "mycluster",
	"type": "Microsoft.HDInsight/clusters",
	"location": "location-name",
	"tags": {
		"tag1": "value1",
		"tag2": "value2"
	},
	"properties": {
		"clusterVersion": "3.5",
		"osType": "Linux",
		"tier": "premium",
		"clusterDefinition": {
			"kind": "hadoop",
			"configurations": {
				"gateway": {
					"restAuthCredential.isEnabled": true,
					"restAuthCredential.username": "http-user",
					"restAuthCredential.password": "password"
				},
				"core-site": {
					"fs.defaultFS": "wasb://container@storageaccount.blob.core.windows.net",
					"fs.azure.account.key.storageaccount.blob.core.windows.net": "storage-account-key"
				}
			}
		},
		"securityProfile": {
			"directoryType": "ActiveDirectory",
			"domain": "mydomain.com",
			"organizationalUnitDN": "OU=Hadoop,DC=mydomain,DC=COM",
			"ldapsUrls": ["ldaps://mydomain.com:636"],
			"domainUsername": "clusteradmin@mydomain.com",
			"domainUserPassword": "password",
			"clusterUsersGroupDNs": ["ADGroup1", "ADGroup2"]
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					},
					"virtualNetworkProfile": {
						"id": "/subscriptions/mysubscriptionid/resourceGroups/myrresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork",
						"subnet": "/subscriptions/mysubscriptionid /resourceGroups/myresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork/subnets/mysubnet"
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 1,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": " ssh-rsa key"
									}
								]
							}
						}
					},
					"virtualNetworkProfile": {
						"id": "/subscriptions/mysubscriptionid/resourceGroups/myrresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork",
						"subnet": "/subscriptions/mysubscriptionid /resourceGroups/myresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork/subnets/mysubnet"
					}
				},
				{
					"name": "zookeepernode",
					"targetInstanceCount": 3,
					"hardwareProfile": {
						"vmSize": "Small"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						},
						"virtualNetworkProfile": {
							"id": "/subscriptions/mysubscriptionid/resourceGroups/myrresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork",
							"subnet": "/subscriptions/mysubscriptionid /resourceGroups/myresourcegroup/providers/Microsoft.Network/virtualNetworks/myvirtualnetwork/subnets/mysubnet"
						}
					}
				}
			]
		}
	}
}  
  

Имя элемента	Обязательно	Тип	Описание
идентификатор	Да	Строка	Указывает идентификатор ресурса кластера.
name	Да	Строка	Указывает имя кластера.
тип	Да	Строка	Указывает тип кластера.
location	Да	Строка	Указывает поддерживаемую папку Azure, в которой должен быть создан кластер. Дополнительные сведения см. в статье Перечисление всех доступных географических расположений.
tags	нет	Строка	Указывает теги, которые будут назначены кластеру. Дополнительные сведения об использовании тегов см. в статье Использование тегов для упорядочения ресурсов Azure.
Свойства	Да	Сложный тип	Указывает свойства кластера.

Свойства

Имя элемента	Обязательно	Тип	Описание
clusterVersion	Да	Строка	Указывает версию кластера.
osType	Да	Строка	Указывает операционную систему для кластера. Допустимое значение — Linux, так как к домену Azure AD могут присоединяться только типы кластеров Linux.
Уровень	нет	Строка	Значение по умолчанию — стандартное. Допустимые значения: standard и premium. Если значение не указано, предполагается, что значение является стандартным. Указывает уровень для кластера. Кластеры, присоединенные к домену, поддерживаются только на уровне "Премиум"
clusterDefinition	Да	Сложный тип	Указывает сведения о типе и конфигурациях кластера.
computeProfile	Да	Сложный тип	Указывает сведения о топологии кластера и связанных свойствах роли.
securityProfile	Нет	Сложный тип	Если создается безопасный кластер, присоединенный к домену, этот элемент задает параметры, связанные с Active Directory.

clusterDefinition

Имя элемента	Обязательно	Тип	Описание
kind	Да	Строка	Указывает тип кластера. Допустимые значения: hadoop, hbase, storm & spark.
конфигурации	Да	Словарь	Этот элемент представляет собой словарь типа конфигурации и связанный с ним словарь значений. Тип конфигурации шлюза используется для настройки пользователя HTTP, используемого для подключения к веб-API и порталу Ambari. Тип конфигурации core-site используется для настройки учетной записи хранения по умолчанию для кластера.

computeProfile

Имя элемента	Обязательно	Тип	Описание
clusterVersion	Да	Строка	Указывает версию кластера.
role	Да	Массив сложного типа (роль)	Указывает сведения о ролях в кластере.

securityProfile

Имя элемента	Обязательно	Тип	Описание
directoryType	Да	Строка	Тип используемого каталога LDAP. В настоящее время единственным поддерживаемым значением является ActiveDirectory.
домен	Да	Строка	Домен Active Directory для кластера
organizationalUnitDN	Да	Строка	Различающееся имя подразделения в Active Directory, в котором будут созданы учетные записи пользователей и компьютеров.
ldapsUrls	Да	Массив строк	URL-адреса одного или нескольких серверов LDAPS для Active Directory
domainUserName	Да	Строка	Учетная запись пользователя домена с достаточными разрешениями для создания кластера. Он должен быть в формате user@domain
domainUserPassword	Да	Строка	Пароль для учетной записи пользователя домена
clusterUsersGroupDNS	Нет	Массив строк	Различающиеся имена групп Active Directory, которые будут доступны в Ambari и Apache Ranger

роль

Имя элемента	Обязательно	Тип	Описание
name	Да	Строка	Указывает имя роли.
targetInstanceCount	Да	Целое число	Указывает число целевых экземпляров для роли.
hardwareProfile	Да	Сложный тип	Указывает сведения о профиле оборудования для роли.
osProfile	Да	Сложный тип	Указывает сведения о профиле ос для роли.

hardwareProfile

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

osProfile

Имя элемента	Обязательно	Тип	Описание
linuxOperatingSystemProfile	Нет	Сложный тип	Указывает параметры, связанные с ОС Linux.
virtualNetworkProfile	Нет	Сложный тип	Указывает параметры, связанные с виртуальной сетью, если кластер развертывается в виртуальной сети в подписке пользователя.
scriptActions	Нет	Массив сложного типа	Список действий скрипта, выполняемых в кластере

linuxOperatingSystemProfile

Имя элемента	Обязательно	Тип	Описание
Имя пользователя	Да	Строка	Имя пользователя SSH
sshProfile	Нет	Сложный тип	Указывает ключ SSH. Требуется один из SshProfile или Password.
Пароль	Нет	Строка	Указывает пароль SSH. Требуется один из SshProfile или Password.

sshProfile

Имя элемента	Обязательно	Тип	Описание
publicKeys	Да	Array	Содержит список объектов certificateData. Значением является открытый ключ ssh-rsa.

virtualNetworkProfile

Имя элемента	Обязательно	Тип	Описание
идентификатор	Да	Строка	Идентификатор ресурса виртуальная сеть
подсеть	Да	Строка	Указывает имя подсети.

scriptActions

Имя элемента	Обязательно	Тип	Описание
name	Да	Строка	Понятное имя для действия скрипта
uri	Да	Строка	URL-адрес файла действия скрипта
parameters	Нет	Строка	Аргументы для передачи при выполнении файла действия скрипта

Ответ

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

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

Текст ответа для кластера Linux создается с помощью ключа SSH:

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Имя элемента	Тип	Описание
provisioningState	Строка	Указывает текущее состояние подготовки.
clusterState	Строка	Указывает более подробное состояние кластера HDInsight во время подготовки.
createdDate	Дата	Дата и время получения запроса на создание кластера
quotaInfo	Сложный тип	Указывает ядра, которые использует кластер.
ошибки	Массив сообщений об ошибках	Содержит сообщение об ошибке, если provisioningState = "failed"
connectivityEndpoints	Сложный тип	Указывает общедоступные конечные точки для кластера.

connectivityEndpoints

Имя элемента	Тип	Описание
name	Строка	Понятное имя конечной точки подключения
protocol	Строка	Указывает используемый протокол (например, HTTPS, SSH).
location	Строка	Указывает URL-адрес для подключения.
порт	INT	Указывает порт для подключения.

Создание кластера с Azure Data Lake Store в качестве файловой системы по умолчанию

Создает кластер в указанной подписке с Azure Data Lake Store в качестве файловой системы по умолчанию. Укажите объект ClusterIdentity в тексте запроса и настройте свойство файловой системы по умолчанию с соответствующим URL-адресом Data Lake Store.

Azure Data Lake можно настроить в качестве файловой системы по умолчанию для версий кластера, начиная с версии 3.5 включительно.

Запрос

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

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

В следующем примере показан текст запроса для создания кластера Hadoop под управлением Linux с использованием Azure Data Lake Store в качестве файловой системы по умолчанию для кластера.

{
	"id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",
	"name": "mycluster",
	"type": "Microsoft.HDInsight/clusters",
	"location": "location-name",
	"tags": {
		"tag1": "value1",
		"tag2": "value2"
	},
	"properties": {
		"clusterVersion": "3.5",
		"osType": "Linux",
		"tier": "Standard",
		"clusterDefinition": {
			"kind": "hadoop",
			"configurations": {
				"gateway": {
					"restAuthCredential.isEnabled": true,
					"restAuthCredential.username": "http-user",
					"restAuthCredential.password": "password"
				},
				"clusterIdentity": {
					"clusterIdentity.applicationId": "applicationId",
					"clusterIdentity.certificate": "certificate-contents-in-base64-encoding",
					"clusterIdentity.aadTenantId": "aad-tenant-id",
					"clusterIdentity.resourceUri": "https://KonaCompute.net/",
					"clusterIdentity.certificatePassword": "certificate-password"
				},
				"core-site": {
					"fs.defaultFS": "adl://home",
					"dfs.adls.home.hostname": "yourstorageaccount.azuredatalakestore.net",
					"dfs.adls.home.mountpoint": "/path/to/cluster/root"
				}
			}
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 1,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": " ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "zookeepernode",
					"targetInstanceCount": 3,
					"hardwareProfile": {
						"vmSize": "Small"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}  

Имя элемента	Обязательно	Тип	Описание
идентификатор	Да	Строка	Указывает идентификатор ресурса кластера.
name	Да	Строка	Указывает имя кластера.
тип	Да	Строка	Указывает тип кластера.
location	Да	Строка	Указывает поддерживаемую папку Azure, в которой должен быть создан кластер. Дополнительные сведения см. в статье Перечисление всех доступных географических расположений.
tags	нет	Строка	Указывает теги, которые будут назначены кластеру. Дополнительные сведения об использовании тегов см. в статье Использование тегов для упорядочения ресурсов Azure.
Свойства	Да	Сложный тип	Указывает свойства кластера.

Свойства

Имя элемента	Обязательно	Тип	Описание
clusterVersion	Да	Строка	Указывает версию кластера.
osType	Да	Строка	Указывает операционную систему для кластера. Допустимое значение — Linux.
Уровень	нет	Строка	Указывает уровень для кластера. Допустимые значения: standard и premium. Если уровень не указан, кластер будет иметь уровень "Стандартный".
clusterDefinition	Да	Сложный тип	Указывает сведения о типе и конфигурациях кластера.
computeProfile	Да	Сложный тип	Указывает сведения о топологии кластера и связанных свойствах роли.

clusterDefinition

Имя элемента	Обязательно	Тип	Описание
kind	Да	Строка	Указывает тип кластера. Допустимые значения: hadoop, hbase, storm & spark.
конфигурации	Да	Словарь	Этот элемент представляет собой словарь типа конфигурации и связанный с ним словарь значений. Тип конфигурации шлюза используется для настройки пользователя HTTP, используемого для подключения к веб-API и порталу Ambari. Тип конфигурации core-site используется для настройки учетной записи хранения по умолчанию для кластера.

computeProfile

Имя элемента	Обязательно	Тип	Описание
clusterVersion	Да	Строка	Указывает версию кластера.
role	Да	Массив сложного типа (роль)	Указывает сведения о ролях в кластере.

роль

Имя элемента	Обязательно	Тип	Описание
name	Да	Строка	Указывает имя роли.
targetInstanceCount	Да	Целое число	Указывает число целевых экземпляров для роли.
hardwareProfile	Да	Сложный тип	Указывает сведения о профиле оборудования для роли.
osProfile	Да	Сложный тип	Указывает сведения о профиле ос для роли.

hardwareProfile

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

osProfile

Имя элемента	Обязательно	Тип	Описание
linuxOperatingSystemProfile	Нет	Сложный тип	Указывает параметры, связанные с ОС Linux.
virtualNetworkProfile	Нет	Сложный тип	Указывает параметры, связанные с виртуальной сетью, если кластер развертывается в виртуальной сети в подписке пользователя.
scriptActions	Нет	Массив сложного типа	Список действий скрипта, выполняемых в кластере

linuxOperatingSystemProfile

Имя элемента	Обязательно	Тип	Описание
Имя пользователя	Да	Строка	Имя пользователя SSH
sshProfile	Нет	Сложный тип	Указывает ключ SSH. Требуется один из SshProfile или Password.
Пароль	Нет	Строка	Указывает пароль SSH. Требуется один из SshProfile или Password.

sshProfile

Имя элемента	Обязательно	Тип	Описание
publicKeys	Да	Array	Содержит список объектов certificateData. Значением является открытый ключ ssh-rsa.

virtualNetworkProfile

Имя элемента	Обязательно	Тип	Описание
идентификатор	Да	Строка	Идентификатор ресурса виртуальная сеть
подсеть	Да	Строка	Указывает имя подсети.

scriptActions

Имя элемента	Обязательно	Тип	Описание
name	Да	Строка	Понятное имя для действия скрипта
uri	Да	Строка	URL-адрес файла действия скрипта
parameters	Нет	Строка	Аргументы для передачи при выполнении файла действия скрипта

Ответ

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

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

Текст ответа для кластера Linux создается с помощью ключа SSH:

{
	"id": "/subscriptions/{subscription ID}/resourceGroups/rg1/providers/Microsoft.HDInsightCurrent/clusters/mycluster",
	"name": "mycluster",
	"type": "Microsoft.HDInsightCurrent/clusters",
	"location": "East Asia",
	"etag": "{value}",
	"tags": null,
	"properties": {
		"clusterVersion": "3.5.1000.0",
		"osType": "Linux",
		"clusterDefinition": {
			"kind": "hadoop"
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Standard_D3"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "myuser"
						}
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Standard_D3"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "myuser"
						}
					}
				}
			]
		},
		"provisioningState": "InProgress",
		"clusterState": "Accepted",
		"createdDate": "2016-11-15T09:21:47.61",
		"quotaInfo": {
			"coresUsed": 16
		},
		"tier": "standard"
	}
}  

Имя элемента	Тип	Описание
provisioningState	Строка	Указывает текущее состояние подготовки.
clusterState	Строка	Указывает более подробное состояние кластера HDInsight во время подготовки.
createdDate	Дата	Дата и время получения запроса на создание кластера
quotaInfo	Сложный тип	Указывает ядра, которые использует кластер.
ошибки	Массив сообщений об ошибках	Содержит сообщение об ошибке, если provisioningState = "failed"
connectivityEndpoints	Сложный тип	Указывает общедоступные конечные точки для кластера.

connectivityEndpoints

Имя элемента	Тип	Описание
name	Строка	Понятное имя конечной точки подключения
protocol	Строка	Указывает используемый протокол (например, HTTPS, SSH).
location	Строка	Указывает URL-адрес для подключения.
порт	INT	Указывает порт для подключения.

Удалить

Удаляет кластер HDInsight.

Запрос

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

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

Ответ

HTTP 202 (принято), чтобы указать, что операция будет выполнена асинхронно. После успешного завершения операции асинхронный опрос вернет значение 204 (NoContent).

Комментарии

Чтобы отслеживать ход выполнения запроса на удаление кластера, см . асинхронные операции (202 Accepted и Location header)

Get

Возвращает сведения или свойства указанного кластера.

Запрос

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

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

Ответ

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

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

Текст ответа совпадает с текстом создания кластера.

Текст ответа для сведений о кластере Linux

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    },  
  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}  
  

Имя элемента	Тип	Описание
provisioningState	Строка	Указывает текущее состояние подготовки.
clusterState	Строка	Указывает более подробное состояние кластера HDInsight во время подготовки.
createdDate	Дата	Дата и время получения запроса на создание кластера
quotaInfo	Сложный тип	Указывает ядра, которые использует кластер.
ошибки	Массив сообщений об ошибках	Содержит сообщение об ошибке, если provisioningState = "failed"
connectivityEndpoints	Сложный тип	Указывает общедоступные конечные точки для кластера.

connectivityEndpoints

Имя элемента	Тип	Описание
name	Строка	Понятное имя конечной точки подключения
protocol	Строка	Указывает используемый протокол (например, HTTPS, SSH).
location	Строка	Указывает URL-адрес для подключения.
порт	INT	Указывает порт для подключения.

Список конфигураций

Извлекает все сведения о конфигурации кластера (включая конфиденциальную информацию).

Запрос

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

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

Ответ

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

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

"configurations":   
{  
     "gateway": {  
          "restAuthCredential.isEnabled": true,  
          "restAuthCredential.username": "username",  
          "restAuthCredential.password": "Password123!"     
      },  
  
      "core-site": {  
           "fs.defaultFS": "wasbs://mycontainter@mystorageaccount.blob.core.windows.net",
	   "fs.azure.account.key.mystorageaccount.blob.core.windows.net": "storagekey1value"  
      }  
}  
  

Имя элемента	Тип	Описание
конфигурации	Словарь	Этот элемент представляет собой словарь типа конфигурации и связанный с ним словарь значений. Тип конфигурации шлюза используется для настройки пользователя HTTP, используемого для подключения к веб-API и порталу Ambari. Тип конфигурации core-site используется для настройки учетной записи хранения по умолчанию для кластера.

Получение конфигурации

Возвращает сведения об одном типе конфигурации (пропускает конфиденциальные значения).

Запрос

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

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

Ответ

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

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

{
     "core-site": {  
          "fs.defaultFS": "wasbs://mycontainter@mystorageaccount.blob.core.windows.net",
	  "fs.azure.account.key.mystorageaccount.blob.core.windows.net": ""
     }
}
  

Получение параметров шлюза

Эта операция получает учетные данные HTTP шлюза кластера.

Запрос

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

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

Ответ

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

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

{  
     "restAuthCredential.isEnabled": true,  
     "restAuthCredential.username": "username",  
     "restAuthCredential.password": "Password123!"  
}  

Обновление параметров шлюза

Эта операция позволяет пользователям изменять учетные данные HTTP шлюза кластера.

Запрос

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

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

{  
     "restAuthCredential.isEnabled": true,  
     "restAuthCredential.username": "username",  
     "restAuthCredential.password": "Password123!"  
}  

Ответ

HTTP 202 (принято) при успешном завершении операции.

Изменение параметров подключения (НЕ РЕКОМЕНДУЕТСЯ)

Эта операция позволяет пользователям включать или отключать HTTPS-подключение к кластеру.

Вместо этого используйте updateGatewaySettings .

Запрос

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

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

Включение подключения

{  	
   "restAuthCredential.isEnabled": true,  	
   "restAuthCredential.username": "user",  	
   "restAuthCredential.password": "password here"  
}

Перечисление по группе ресурсов

Списки все кластеры в подписке пользователя в указанной группе ресурсов.

Запрос

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

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

Ответ

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

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

Текст ответа — это массив сведений о кластере. Дополнительные сведения см. в разделе Получение свойств кластера.

{  
  "value": [  
		{ Cluster details }  
    ]  
}  
  

Список по подписке

Списки все кластеры в подписке пользователя.

Запрос

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

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

Ответ

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

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

Текст ответа — это массив сведений о кластере.

{  
  "value": [  
		{ Cluster details }  
    ]  
}  

Отключение подключения

{  
   "restAuthCredential.isEnabled": false  
}  
  

Имя элемента	Обязательно	Тип	Описание
restAuthCredential.isEnabled	Да	Логическое	Указывает, следует ли включать или отключать подключение.
restAuthCredential.username	нет	Строка	Обязательный параметр, если isEnabled=true Указывает имя пользователя для параметров подключения.
restAuthCredential.password	нет	Строка	Обязательный параметр, если isEnabled=true Указывает пароль для параметров подключения.

Ответ

HTTP 202 (принято), чтобы указать, что операция будет выполнена асинхронно. После успешного завершения операции асинхронный опрос вернет значение 204 (NoContent).

Комментарии

Чтобы отслеживать ход выполнения запроса на удаление кластера, см . асинхронные операции (202 Accepted и Location header)

Изменение параметров RDP (только для кластера Windows)

Эта операция позволяет пользователю включить или отключить протокол RDP. Это относится к кластерам под управлением Windows.

Запрос

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

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

Текст запроса

Включение RDP

{  
	"osProfile": {  
        "windowsOperatingSystemProfile": {  
        	"rdpSettings": {  
        	      "username": "username",  
            	      "password": "password here",  
            	      "expiryDate": "YYYY-MM-DD"  
        	}  
        }  
    }  
}  

Отключение RDP

{  
	"osProfile": {  
        "windowsOperatingSystemProfile": {  
        	"rdpSettings": null  
        }  
    }  
}  

osProfile

Имя элемента	Обязательно	Тип	Описание
windowsOperatingSystemProfile	Нет	Сложный тип	Указывает параметры, связанные с ОС Windows

windowsOperatingSystemProfile

Имя элемента	Обязательно	Тип	Описание
rdpSettings	Нет	Сложный тип	Задает параметры RDP для кластеров Windows.

rdpSettings

Имя элемента	Обязательно	Тип	Описание
username	Да	Строка	Указывает имя пользователя RDP.
password	Да	Строка	Указывает пароль для пользователя RDP.
expiryDate	Да	Дата	Дата истечения срока действия учетных данных RDP

Ответ

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

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

Текст ответа такой же, как Создание кластера.

Выполнение действий скрипта в работающем кластере (только для кластера Linux)

Выполнение действия скрипта в работающем кластере.

Запрос

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

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

Текст запроса

{  
  "scriptActions": [  
    {  
      "name": "script-name",  
      "uri": "script-uri",  
      "parameters": "script-parameters",  
      "roles": [  
        "headnode",  
        "workernode"  
      ]  
    },  
    ...  
  ],  
  "persistOnSuccess": true  
}  
  

scriptActions

Имя элемента	Обязательно	Тип	Описание
name	Да	Строка	Указывает имя действия скрипта.
uri	Да	Строка	Указывает универсальный код ресурса (URI) действия скрипта.
параметры	Да	Строка	Указывает параметры, необходимые для действия скрипта.
Роли	Да	Массив строк	Указывает целевые роли, с которыми выполняется действие скрипта.
persistOnSuccess	Да	Логическое	Указывает, будут ли действия скрипта сохраняться после успешного выполнения.

Ответ

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

Код состояния: 202 (принято)

Вывод списка всех сохраненных действий скрипта для кластера (только для кластера Linux)

Эта операция возвращает все сохраненные действия скриптов указанного кластера.

Запрос

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

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

Ответ

HTTP 200 (OK) при успешном завершении операции.

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

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

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}  

Имя элемента	Тип	Описание
name	Строка	Указывает имя действия скрипта.
uri	Строка	Указывает универсальный код ресурса (URI) действия скрипта.
параметры	Строка	Указывает параметры, необходимые для действия скрипта.
Роли	Массив строк	Указывает целевые роли, с которыми выполняется действие скрипта.
applicationName	Строка	Указывает соответствующее приложение, с которым связан скрипт. applicationName имеет значение NULL, если скрипт предоставлен пользователями

Удаление сохраненного действия скрипта для кластера (только для кластера Linux)

Эта операция удаляет действие сохраненного скрипта HDInsight для кластера.

Запрос

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

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

Ответ

• HTTP 200 (ОК), чтобы указать, что действие скрипта было удалено из списка сохраненных действий скрипта.

• HTTP 404 (NotFound) — указывает на отсутствие существующего действия сохраняемого скрипта с соответствующим scriptName.

Получение выполнения действия скрипта из журнала (только для кластеров Linux)

Эта операция возвращает последние действия скриптов для выполнения указанного кластера или сведения о выполнении отдельного скрипта.

Запрос

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

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

Ответ

Операция вернет 200 (ОК), если запрос выполнен успешно. Текст ответа — это массив сведений о выполнении скрипта или одиночный элемент, если указан параметр scriptExecutionId. Ниже приведен пример сведений о выполнении скрипта.

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

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

{  
  "scriptExecutionId":script-execution-id,  
  "name":"script-name",  
  "applicationName":null,  
  "uri":"script-uri",  
  "parameters":"script-parameters",  
  "roles":["headnode","workernode"],  
  "startTime":"2016-02-26T23:49:13.0773637Z",  
  "endTime":"2016-02-26T23:49:33.4964725Z",  
  "status":"Succeeded",  
  "operation":"PostClusterCreateScriptActionRequest",  
  "executionSummary":  
	[{"status":"COMPLETED",  
	 "instanceCount":4}],  
  "debugInformation": "debug-information"  
}  
  

Имя элемента	Тип	Описание
scriptExecutionId	Long	Указывает идентификатор выполнения действия скрипта.
name	Строка	Указывает имя действия скрипта.
applicationName	Строка	Указывает соответствующее приложение, с которым связан скрипт. applicationName имеет значение NULL, если скрипт предоставлен пользователями
uri	Строка	Указывает универсальный код ресурса (URI) действия скрипта.
параметры	Строка	Указывает параметры, необходимые для действия скрипта.
Роли	Массив строк	Указывает целевые роли, с которыми выполняется действие скрипта.
startTime	Дата и время	Указывает время начала выполнения действия скрипта.
endTime	Дата и время	Указывает время окончания выполнения действия скрипта.
status	Строка	Указывает состояние выполнения действия скрипта.
операции	Строка	Указывает причину выполнения действия скрипта. Например, ScaleUp означает, что действие скрипта было выполнено во время увеличения масштаба кластера.
executionSummary	Массив сложного типа	Указывает сводку по выполнению с точки зрения того, сколько узлов успешно выполнено и сколько узлов не удалось выполнить скрипт.
debugInformation	Строка	Указывает подробные отладочные сведения для скрипта. DebugInformation возвращается только в том случае, если в запросе указан параметр scriptExecutionId.

executionSummary

Имя элемента	Тип	Описание
status	Строка	Указывает состояние выполнения на отдельных узлах.
instanceCount	Int	Указывает количество выполнений с соответствующим состоянием.

Повышение уровня скрипта из журнала выполнения действия скрипта для сохранения (только кластер Linux)

Эта операция повышает уровень сохранения скрипта HDInsight из журнала выполнения скрипта.

Запрос

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

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

Ответ

• HTTP 200 (ОК), чтобы указать, что действие скрипта было повышено.

• HTTP 404 (NotFound) — указывает на отсутствие существующего выполнения действия скрипта с соответствующим scriptExecutionId.

Изменить размер

Изменяет размер существующего кластера HDInsight.

Запрос

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

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

Ниже показан пример запроса на обновление тегов для кластера.

{  
    "targetInstanceCount": 10  
}  

Имя элемента	Обязательно	Тип	Описание
targetInstanceCount	Да	Int	Указывает число новых экземпляров для роли.

Ответ

HTTP 202 (принято), чтобы указать, что операция будет завершена асинхронно. После успешного завершения операции асинхронный опрос вернет значение 204 (NoContent).

Комментарии

Сведения о ходе выполнения запроса на удаление кластера см. в разделе Асинхронные операции (202 Accepted and Location header)

Update

Обновления тегов для кластера.

Все остальные обновления — это отдельные действия, описанные отдельно.

Запрос

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

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

Ниже показан пример запроса на обновление тегов для кластера.

{   
    "tags": {"department": "finance"}  
}  
  

Имя элемента	Обязательно	Тип	Описание
tags	Да	Строка	Указывает теги, которые будут назначены кластеру. Дополнительные сведения об использовании тегов см. в статье Использование тегов для упорядочения ресурсов Azure.

Ответ

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

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

Текст ответа такой же, как Создание кластера.