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

Создайте

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

Просьба

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

Метод Запрос URI
ПОСТАВИТЬ 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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}  
  
Имя элемента Обязательно Тип Описание
id Да Струна Указывает идентификатор ресурса кластера.
имя Да Струна Указывает имя кластера.
тип Да Струна Указывает тип кластера.
расположение Да Струна Указывает поддерживаемое расположение Azure, в котором должен быть создан кластер. Дополнительные сведения см. в разделе Список всех доступных географических расположений.
Теги нет Струна Указывает теги, которые будут назначены кластеру. Дополнительные сведения об использовании тегов см. в статье Использование тегов для организации ресурсов Azure.
Свойства Да Сложный тип Задает свойства кластера.

Свойства

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

Допустимые значения: Linux и Windows
clusterDefinition Да Сложный тип Указывает сведения о типе и конфигурациях кластера
computeProfile Да Сложный тип Указывает сведения о топологии кластера и связанных с ним свойствах ролей

clusterDefinition

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

Допустимые значения: hadoop, hbase, storm и spark
конфигурации Да Словарь Этот элемент представляет собой словарь типа конфигурации и связанного с ним словаря значений.

тип конфигурации шлюза используется для настройки пользователя HTTP, используемого для подключения к веб-API и порталу Ambari

Тип конфигурации core-site используется для настройки учетной записи хранения по умолчанию для кластера

computeProfile

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

роль

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

hardwareProfile

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

osProfile

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

Профиль операционной системы

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

Требуется один из sshProfile или Password.
Пароль нет Струна Указывает пароль SSH

Требуется один из sshProfile или Password.

sshProfile

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

windowsOperatingSystemProfile

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

rdpНастройки

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

virtualNetworkProfile

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

scriptActions

Имя элемента Обязательно Тип Описание
имя Да Струна Понятное имя действия скрипта
УРИ Да Струна URL для файла действий скрипта
Параметры нет Струна Аргументы, передаваемые при выполнении файла действий скрипта

Ответ

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

Код состояния: 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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  
Имя элемента Тип Описание
Состояние обеспечения Струна Указывает текущее состояние подготовки.
clusterState Струна Указывает более подробное состояние кластера HDInsight во время подготовки.
дата создания Дата Дата и время получения запроса на создание кластера
quotaInfo Сложный тип Указывает coresUsed для кластера
Ошибки Массив сообщений об ошибках Содержит сообщение об ошибке, если provisioningState = 'failed"
connectivityКонечные точки Сложный тип Указывает общедоступные конечные точки для кластера

connectivityКонечные точки

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

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

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

Просьба

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

Метод Запрос URI
ПОСТАВИТЬ 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"
						}
					}
				}
			]
		}
	}
}  
  
Имя элемента Обязательно Тип Описание
id Да Струна Указывает идентификатор ресурса кластера.
имя Да Струна Указывает имя кластера.
тип Да Струна Указывает тип кластера.
расположение Да Струна Указывает поддерживаемое расположение Azure, в котором должен быть создан кластер. Дополнительные сведения см. в разделе Список всех доступных географических расположений.
Теги нет Струна Указывает теги, которые будут назначены кластеру. Дополнительные сведения об использовании тегов см. в статье Использование тегов для организации ресурсов Azure.
Свойства Да Сложный тип Задает свойства кластера.

Свойства

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

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

clusterDefinition

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

Допустимые значения: hadoop, hbase, storm и spark
конфигурации Да Словарь Этот элемент представляет собой словарь типа конфигурации и связанного с ним словаря значений.

тип конфигурации шлюза используется для настройки пользователя HTTP, используемого для подключения к веб-API и порталу Ambari

Тип конфигурации core-site используется для настройки учетной записи хранения по умолчанию для кластера

computeProfile

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

securityProfile

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

роль

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

hardwareProfile

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

osProfile

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

Профиль операционной системы

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

Требуется один из sshProfile или Password.
Пароль нет Струна Указывает пароль SSH

Требуется один из sshProfile или Password.

sshProfile

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

virtualNetworkProfile

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

scriptActions

Имя элемента Обязательно Тип Описание
имя Да Струна Понятное имя действия скрипта
УРИ Да Струна URL для файла действий скрипта
Параметры нет Струна Аргументы, передаваемые при выполнении файла действий скрипта

Ответ

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

Код состояния: 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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  
Имя элемента Тип Описание
Состояние обеспечения Струна Указывает текущее состояние подготовки.
clusterState Струна Указывает более подробное состояние кластера HDInsight во время подготовки.
дата создания Дата Дата и время получения запроса на создание кластера
quotaInfo Сложный тип Указывает coresUsed для кластера
Ошибки Массив сообщений об ошибках Содержит сообщение об ошибке, если provisioningState = 'failed"
connectivityКонечные точки Сложный тип Указывает общедоступные конечные точки для кластера

connectivityКонечные точки

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

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

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

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

Просьба

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

Метод Запрос URI
ПОСТАВИТЬ 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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}  

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

Свойства

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

Допустимое значение — Linux
ярус нет Струна Указывает уровень кластера. Допустимыми значениями являются стандартные и премиальные. Если уровень не указан, кластер будет иметь стандартный уровень.
clusterDefinition Да Сложный тип Указывает сведения о типе и конфигурациях кластера
computeProfile Да Сложный тип Указывает сведения о топологии кластера и связанных с ним свойствах ролей

clusterDefinition

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

Допустимые значения: hadoop, hbase, storm и spark
конфигурации Да Словарь Этот элемент представляет собой словарь типа конфигурации и связанного с ним словаря значений.

тип конфигурации шлюза используется для настройки пользователя HTTP, используемого для подключения к веб-API и порталу Ambari

Тип конфигурации core-site используется для настройки учетной записи хранения по умолчанию для кластера

computeProfile

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

роль

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

hardwareProfile

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

osProfile

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

Профиль операционной системы

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

Требуется один из sshProfile или Password.
Пароль нет Струна Указывает пароль SSH

Требуется один из sshProfile или Password.

sshProfile

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

virtualNetworkProfile

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

scriptActions

Имя элемента Обязательно Тип Описание
имя Да Струна Понятное имя действия скрипта
УРИ Да Струна URL для файла действий скрипта
Параметры нет Струна Аргументы, передаваемые при выполнении файла действий скрипта

Ответ

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

Код состояния: 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"
	}
}  
Имя элемента Тип Описание
Состояние обеспечения Струна Указывает текущее состояние подготовки.
clusterState Струна Указывает более подробное состояние кластера HDInsight во время подготовки.
дата создания Дата Дата и время получения запроса на создание кластера
quotaInfo Сложный тип Указывает coresUsed для кластера
Ошибки Массив сообщений об ошибках Содержит сообщение об ошибке, если provisioningState = 'failed"
connectivityКонечные точки Сложный тип Указывает общедоступные конечные точки для кластера

connectivityКонечные точки

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

Удалить

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

Просьба

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

Метод Запрос URI
Удалить 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 and Location)

Получить

Получает сведения/свойства указанного кластера.

Просьба

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

Метод Запрос URI
ПОЛУЧАЙ https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Ответ

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

Код состояния: 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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}  
  
Имя элемента Тип Описание
Состояние обеспечения Струна Указывает текущее состояние подготовки.
clusterState Струна Указывает более подробное состояние кластера HDInsight во время подготовки.
дата создания Дата Дата и время получения запроса на создание кластера
quotaInfo Сложный тип Указывает coresUsed для кластера
Ошибки Массив сообщений об ошибках Содержит сообщение об ошибке, если provisioningState = 'failed"
connectivityКонечные точки Сложный тип Указывает общедоступные конечные точки для кластера

connectivityКонечные точки

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

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

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

Просьба

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

Метод Запрос URI
ПОСТ https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Ответ

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

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

"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
ПОЛУЧАЙ 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 (OK) при успешном завершении операции.

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

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

Получение настроек шлюза

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

Просьба

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

Метод Запрос URI
ПОСТ https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Ответ

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

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

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

Обновление настроек шлюза

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

Просьба

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

Метод Запрос URI
ПОСТ 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
ПОСТ 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
ПОЛУЧАЙ https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Ответ

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

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

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

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

Список по подпискам

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

Просьба

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

Метод Запрос URI
ПОЛУЧАЙ https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Ответ

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

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

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

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

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

{  
   "restAuthCredential.isEnabled": false  
}  
  
Имя элемента Обязательно Тип Описание
restAuthCredential.isEnabled Да Boolean Указывает, следует ли включать или отключать подключение
restAuthCredential.имя_пользователя нет Струна Обязательно, если isEnabled=true
Указывает имя пользователя для настроек подключения
restAuthCredential.password нет Струна Обязательно, если isEnabled=true
Указывает пароль для настроек подключения

Ответ

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

Замечания

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

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

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

Просьба

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

Метод Запрос URI
ПОСТ 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

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

rdpНастройки

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

Ответ

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

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

Текст ответа аналогичен параметру Создать кластер.

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

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

Просьба

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

Метод Запрос URI
ПОСТ 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

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

Ответ

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

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

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

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

Просьба

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

Метод Запрос URI
ПОЛУЧАЙ 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  
  },  
  ...  
]  
}  
Имя элемента Тип Описание
имя Струна Указывает имя действия скрипта.
УРИ Струна Указывает универсальный код ресурса (URI) действия скрипта.
Параметры Струна Указывает параметры, необходимые для действия скрипта
Роли Массив строк Указывает целевые роли, для которых выполняется действие скрипта.
название приложения Струна Указывает соответствующее приложение, с которым связан сценарий. applicationName имеет значение null, если скрипт предоставлен пользователями

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

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

Просьба

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

Метод Запрос URI
Удалить 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 (OK) для указания на то, что действие сценария было удалено из списка сохраненных действий сценария.

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

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

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

Просьба

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

Метод Запрос URI
ПОЛУЧАЙ 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 (OK), если запрос будет выполнен успешно. Тело ответа — это массив сведений о выполнении скрипта или один экземпляр выполнения скрипта, если указан 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 Длинный Указывает идентификатор выполнения действия скрипта.
имя Струна Указывает имя действия скрипта.
название приложения Струна Указывает соответствующее приложение, с которым связан сценарий. applicationName имеет значение null, если скрипт предоставлен пользователями
УРИ Струна Указывает универсальный код ресурса (URI) действия скрипта.
Параметры Струна Указывает параметры, необходимые для действия скрипта
Роли Массив строк Указывает целевые роли, для которых выполняется действие скрипта.
Время начала дата и время Указывает время начала выполнения действия скрипта
время окончания дата и время Указывает время окончания выполнения действия скрипта
статус Струна Указывает статус выполнения действия скрипта
Операция Струна Указывает причину, по которой было выполнено действие скрипта. Например, ScaleUp означает, что действие скрипта было выполнено во время вертикального масштабирования кластера.
выполнениеРезюме Массив сложного типа Указывает сводку выполнения с точки зрения того, сколько узлов удалось выполнить и скольких узлов не удалось выполнить сценарий.
debugИнформация Струна Указывает подробную отладочную информацию для скрипта. debugInformation возвращается только в том случае, если в запросе указан scriptExecutionId.

выполнениеРезюме

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

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

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

Просьба

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

Метод Запрос URI
ПОСТ 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 (OK) для указания на то, что действие скрипта было повышено.

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

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

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

Просьба

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

Метод Запрос URI
ПОСТ 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)

Обновление

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

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

Просьба

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

Метод Запрос URI
патч https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

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

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

Ответ

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

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

Текст ответа аналогичен параметру Создать кластер.