Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Создайте
Создает кластер в указанной подписке.
Просьба
Общие параметры и заголовки приведены в разделе Общие параметры и параметры, используемые кластерами.
| Метод | Запрос 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
Текст ответа аналогичен параметру Создать кластер.