Поделиться через

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

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