Sdílet prostřednictvím

Rozhraní REST API clusteru ve službě Azure HDInsight

  • Článek

Vytvořit

Vytvoří cluster v zadaném předplatném.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Následující příklad ukazuje text požadavku pro vytvoření clusteru hadoop založeného na Linuxu. Příklady vytváření clusterů jinými způsoby najdete níže v části Příklady.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
Název elementu Požaduje se Typ Description
id Ano Řetězec Určuje identifikátor prostředku clusteru.
name Ano Řetězec Určuje název clusteru.
typ Ano Řetězec Určuje typ clusteru.
location Ano Řetězec Určuje podporované umístění Azure, ve kterém se má cluster vytvořit. Další informace najdete v tématu Seznam všech dostupných geografických umístění.
tags No Řetězec Určuje značky, které budou přiřazeny ke clusteru. Další informace o používání značek najdete v tématu Použití značek k uspořádání prostředků Azure.
Vlastnosti Yes Komplexní typ Určuje vlastnosti clusteru.

Vlastnosti

Název elementu Požaduje se Typ Description
clusterVersion Ano Řetězec Určuje verzi clusteru.
osType Ano Řetězec Určuje operační systém pro cluster.

Platné hodnoty jsou Linux a Windows.
clusterDefinition Yes Komplexní typ Určuje informace o typu clusteru a konfiguraci.
computeProfile Yes Komplexní typ Určuje informace o topologii clusteru a přidružených vlastnostech role.

clusterDefinition

Název elementu Požaduje se Typ Description
Druhu Ano Řetězec Určuje typ clusteru.

Platné hodnoty jsou hadoop, hbase, storm & Spark.
Konfigurace Yes Slovník Tento prvek je slovníkem typu konfigurace a jeho přidruženým slovníkem hodnot.

Typ konfigurace brány slouží ke konfiguraci uživatele HTTP, který se používá pro připojení k webovým rozhraním API a portálu Ambari.

Typ konfigurace core-site slouží ke konfiguraci výchozího účtu úložiště pro cluster.

computeProfile

Název elementu Požaduje se Typ Description
clusterVersion Ano Řetězec Určuje verzi clusteru.
Roli Yes Pole komplexního typu (role) Určuje informace o rolích v clusteru.

role

Název elementu Požaduje se Typ Description
name Ano Řetězec Určuje název role.
targetInstanceCount Yes Integer Určuje počet cílových instancí pro roli.
hardwareProfile Yes Komplexní typ Určuje informace o hardwarovém profilu pro roli.
osProfile Yes Komplexní typ Určuje informace o profilu operačního systému pro roli.

hardwareProfile

Název elementu Požaduje se Typ Description
vmSize Ano Řetězec Určuje velikost virtuálního počítače. Platné velikosti najdete v tématu Možnosti konfigurace SLUŽBY HDInsight (jednou na tomto odkazu se posuňte dolů na Cenové úrovně Node).

osProfile

Název elementu Požaduje se Typ Description
linuxOperatingSystemProfile No Komplexní typ Určuje nastavení související s operačním systémem Linux.
windowsOperatingSystemProfile No Komplexní typ Určuje nastavení související s operačním systémem Windows.
virtualNetworkProfile No Komplexní typ Určuje nastavení související s virtuální sítí, pokud se cluster nasazuje ve virtuální síti v předplatném uživatele.
scriptActions No Pole komplexního typu Seznam akcí skriptu, které se mají provést v clusteru

linuxOperatingSystemProfile

Název elementu Požaduje se Typ Description
Uživatelské jméno Ano Řetězec Uživatelské jméno SSH
sshProfile No Komplexní typ Určuje klíč SSH.

Vyžaduje se jeden z sshProfile nebo Heslo.
Heslo No Řetězec Určuje heslo SSH.

Vyžaduje se jeden z sshProfile nebo Heslo.

sshProfile

Název elementu Požaduje se Typ Description
publicKeys Yes Pole Obsahuje seznam objektů certificateData. Hodnota je veřejný klíč ssh-rsa.

windowsOperatingSystemProfile

Název elementu Požaduje se Typ Description
rdpSettings No Komplexní typ Určuje nastavení protokolu RDP pro clustery Windows.

rdpSettings

Název elementu Požaduje se Typ Description
username Ano Řetězec Určuje uživatelské jméno protokolu RDP.
heslo Ano Řetězec Určuje heslo pro uživatele protokolu RDP.
expiryDate Yes Datum Datum vypršení platnosti přihlašovacích údajů RDP

virtualNetworkProfile

Název elementu Požaduje se Typ Description
id Ano Řetězec ID prostředku Virtual Network
podsíť Ano Řetězec Určuje název podsítě.

skriptovací akce

Název elementu Požaduje se Typ Description
name Ano Řetězec Popisný název akce skriptu
Uri Ano Řetězec Adresa URL souboru akce skriptu
parameters No Řetězec Argumenty, které se mají předat při provádění souboru akce skriptu

Odpověď

Pokud je ověření dokončeno a požadavek je přijat, operace vrátí hodnotu 200 (OK).

Stavový kód: 200 OK

Text odpovědi pro cluster s Linuxem se vytvoří pomocí klíče 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"  
                    }  
                }  
            ]  
        }  
    }  
}
Název elementu Typ Description
provisioningState Řetězec Označuje aktuální stav zřizování.
clusterState Řetězec Označuje podrobnější stav clusteru HDInsight během zřizování.
datum vytvoření Datum Datum a čas přijetí žádosti o vytvoření clusteru
quotaInfo Komplexní typ Určuje počet jaderpoužilých clusterem.
chyby Pole chybových zpráv Obsahuje chybovou zprávu, pokud provisioningState = 'failed"
připojeníEndpointy Komplexní typ Určuje veřejné koncové body pro cluster.

připojeníEndpointy

Název elementu Typ Description
name Řetězec Popisný název koncového bodu připojení
Protokol Řetězec Určuje protokol, který se má použít (příklad: HTTPS, SSH).
location Řetězec Určuje adresu URL pro připojení.
port int Určuje port pro připojení.

Vytvoření clusteru HDInsight úrovně Premium připojeného k doméně (pouze Linux, Preview)

Vytvořte cluster připojený k doméně úrovně Premium pomocí Apache Rangeru. Aby uživatel vytvořil zabezpečený cluster, musí v textu požadavku zadat SecurityProfile.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Následující příklad ukazuje text požadavku na vytvoření clusteru Hadoop s Linuxem úrovně Premium připojeného k doméně.

{
	"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"
						}
					}
				}
			]
		}
	}
}
Název elementu Požaduje se Typ Description
id Ano Řetězec Určuje identifikátor prostředku clusteru.
name Ano Řetězec Určuje název clusteru.
typ Ano Řetězec Určuje typ clusteru.
location Ano Řetězec Určuje podporované umístění Azure, ve kterém se má cluster vytvořit. Další informace najdete v tématu Seznam všech dostupných geografických umístění.
tags No Řetězec Určuje značky, které budou přiřazeny ke clusteru. Další informace o používání značek najdete v tématu Použití značek k uspořádání prostředků Azure.
Vlastnosti Yes Komplexní typ Určuje vlastnosti clusteru.

Vlastnosti

Název elementu Požaduje se Typ Description
clusterVersion Ano Řetězec Určuje verzi clusteru.
osType Ano Řetězec Určuje operační systém pro cluster.

Platná hodnota je Linux, protože k Azure AD doméně se můžou připojit jenom typy clusterů s Linuxem.
tier No Řetězec Výchozí hodnota je standardní. Platné hodnoty jsou Standard a Premium. Pokud není zadána žádná hodnota, předpokládá se, že hodnota je standardní. Určuje úroveň clusteru. Clustery připojené k doméně se podporují jenom na úrovni Premium.
clusterDefinition Yes Komplexní typ Určuje informace o typu clusteru a konfiguraci.
computeProfile Yes Komplexní typ Určuje informace o topologii clusteru a přidružených vlastnostech role.
securityProfile No Komplexní typ Pokud se vytváří zabezpečený cluster připojený k doméně, tento prvek určuje nastavení související se službou Active Directory.

clusterDefinition

Název elementu Požaduje se Typ Description
Druhu Ano Řetězec Určuje typ clusteru.

Platné hodnoty jsou hadoop, hbase, storm & Spark.
Konfigurace Yes Slovník Tento prvek je slovníkem typu konfigurace a jeho přidruženým slovníkem hodnot.

Typ konfigurace brány slouží ke konfiguraci uživatele HTTP, který se používá pro připojení k webovým rozhraním API a portálu Ambari.

Typ konfigurace core-site slouží ke konfiguraci výchozího účtu úložiště pro cluster.

computeProfile

Název elementu Požaduje se Typ Description
clusterVersion Ano Řetězec Určuje verzi clusteru.
Roli Yes Pole komplexního typu (role) Určuje informace o rolích v clusteru.

securityProfile

Název elementu Požaduje se Typ Description
directoryType Ano Řetězec Typ adresáře LDAP, který se používá. V současné době je jedinou podporovanou hodnotou ActiveDirectory.
doména Ano Řetězec Doména služby Active Directory pro cluster
organizationalUnitDN Ano Řetězec Rozlišující název organizační jednotky ve službě Active Directory, kde se budou vytvářet uživatelské účty a účty počítačů
ldapsUrls Yes Pole řetězců Adresy URL jednoho nebo více serverů LDAPS pro službu Active Directory
doménaUserName Ano Řetězec Účet uživatele domény s dostatečnými oprávněními pro vytvoření clusteru. Měl by být ve formátu user@domain .
doménaUserPassword Ano Řetězec Heslo k uživatelskému účtu domény
clusterUsersGroupDNS No Pole řetězců Rozlišující názvy skupin Active Directory, které budou k dispozici v Ambari a Apache Rangeru

role

Název elementu Požaduje se Typ Description
name Ano Řetězec Určuje název role.
targetInstanceCount Yes Integer Určuje počet cílových instancí pro roli.
hardwareProfile Yes Komplexní typ Určuje informace o hardwarovém profilu pro roli.
osProfile Yes Komplexní typ Určuje informace o profilu operačního systému pro roli.

hardwareProfile

Název elementu Požaduje se Typ Description
vmSize Ano Řetězec Určuje velikost virtuálního počítače. Platné velikosti najdete v tématu Možnosti konfigurace SLUŽBY HDInsight (jednou na tomto odkazu se posuňte dolů na Cenové úrovně Node).

osProfile

Název elementu Požaduje se Typ Description
linuxOperatingSystemProfile No Komplexní typ Určuje nastavení související s operačním systémem Linux.
virtualNetworkProfile No Komplexní typ Určuje nastavení související s virtuální sítí, pokud se cluster nasazuje ve virtuální síti v předplatném uživatele.
scriptActions No Pole komplexního typu Seznam akcí skriptu, které se mají provést v clusteru

linuxOperatingSystemProfile

Název elementu Požaduje se Typ Description
Uživatelské jméno Ano Řetězec Uživatelské jméno SSH
sshProfile No Komplexní typ Určuje klíč SSH.

Vyžaduje se jeden z sshProfile nebo Heslo.
Heslo No Řetězec Určuje heslo SSH.

Vyžaduje se jeden z sshProfile nebo Heslo.

sshProfile

Název elementu Požaduje se Typ Description
publicKeys Yes Pole Obsahuje seznam objektů certificateData. Hodnota je veřejný klíč ssh-rsa.

virtualNetworkProfile

Název elementu Požaduje se Typ Description
id Ano Řetězec ID prostředku Virtual Network
podsíť Ano Řetězec Určuje název podsítě.

scriptActions

Název elementu Požaduje se Typ Description
name Ano Řetězec Popisný název akce skriptu
Uri Ano Řetězec Adresa URL souboru akce skriptu
parameters No Řetězec Argumenty, které se mají předat při provádění souboru akce skriptu

Odpověď

Pokud je ověření dokončeno a požadavek je přijat, operace vrátí hodnotu 200 (OK).

Stavový kód: 200 OK

Text odpovědi pro cluster s Linuxem se vytvoří pomocí klíče 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"  
                    }  
                }  
            ]  
        }  
    }  
}
Název elementu Typ Description
provisioningState Řetězec Označuje aktuální stav zřizování.
clusterState Řetězec Označuje podrobnější stav clusteru HDInsight během zřizování.
createdDate Datum Datum a čas přijetí žádosti o vytvoření clusteru
quotaInfo Komplexní typ Určuje jádra použádaná clusterem.
chyby Pole chybových zpráv Obsahuje chybovou zprávu, pokud provisioningState = 'failed"
připojeníEndpointy Komplexní typ Určuje veřejné koncové body pro cluster.

připojeníEndpointy

Název elementu Typ Description
name Řetězec Popisný název koncového bodu připojení
Protokol Řetězec Určuje protokol, který se má použít (příklad: HTTPS, SSH).
location Řetězec Určuje adresu URL pro připojení.
port int Určuje port, který se má připojit.

Vytvoření clusteru s azure Data Lake Store jako výchozím systémem souborů

Vytvoří cluster v zadaném předplatném s Azure Data Lake Store jako výchozím systémem souborů. V textu požadavku zadejte objekt ClusterIdentity a nakonfigurujte vlastnost default-filesystem s příslušnou adresou URL Data Lake Store.

Azure Data Lake je možné nakonfigurovat jako výchozí systém souborů pro verze clusteru od verze 3.5 včetně.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

Následující příklad ukazuje text požadavku na vytvoření clusteru Hadoop se systémem Linux pomocí služby Azure Data Lake Store jako výchozího systému souborů pro cluster.

{
	"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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
Název elementu Požaduje se Typ Description
id Ano Řetězec Určuje identifikátor prostředku clusteru.
name Ano Řetězec Určuje název clusteru.
typ Ano Řetězec Určuje typ clusteru.
location Ano Řetězec Určuje podporované umístění Azure, ve kterém se má cluster vytvořit. Další informace najdete v tématu Seznam všech dostupných geografických umístění.
tags No Řetězec Určuje značky, které budou přiřazeny ke clusteru. Další informace o používání značek najdete v tématu Použití značek k uspořádání prostředků Azure.
Vlastnosti Yes Komplexní typ Určuje vlastnosti clusteru.

Vlastnosti

Název elementu Požaduje se Typ Description
clusterVersion Ano Řetězec Určuje verzi clusteru.
osType Ano Řetězec Určuje operační systém pro cluster.

Platná hodnota je Linux.
tier No Řetězec Určuje úroveň clusteru. Platné hodnoty jsou Standard a Premium. Pokud není zadaná úroveň, cluster bude úrovně Standard.
clusterDefinition Yes Komplexní typ Určuje informace o typu clusteru a konfiguraci.
computeProfile Yes Komplexní typ Určuje informace o topologii clusteru a přidružených vlastnostech role.

clusterDefinition

Název elementu Požaduje se Typ Description
Druhu Ano Řetězec Určuje typ clusteru.

Platné hodnoty jsou hadoop, hbase, storm & Spark.
Konfigurace Yes Slovník Tento prvek je slovníkem typu konfigurace a jeho přidruženým slovníkem hodnot.

Typ konfigurace brány slouží ke konfiguraci uživatele HTTP, který se používá pro připojení k webovým rozhraním API a portálu Ambari.

Typ konfigurace core-site slouží ke konfiguraci výchozího účtu úložiště pro cluster.

computeProfile

Název elementu Požaduje se Typ Description
clusterVersion Ano Řetězec Určuje verzi clusteru.
Roli Yes Pole komplexního typu (role) Určuje informace o rolích v clusteru.

role

Název elementu Požaduje se Typ Description
name Ano Řetězec Určuje název role.
targetInstanceCount Yes Integer Určuje počet cílových instancí pro roli.
hardwareProfile Yes Komplexní typ Určuje informace o hardwarovém profilu pro roli.
osProfile Yes Komplexní typ Určuje informace o profilu operačního systému pro roli.

hardwareProfile

Název elementu Požaduje se Typ Description
vmSize Ano Řetězec Určuje velikost virtuálního počítače. Platné velikosti najdete v tématu Možnosti konfigurace SLUŽBY HDInsight (jednou na tomto odkazu se posuňte dolů na Cenové úrovně Node).

osProfile

Název elementu Požaduje se Typ Description
linuxOperatingSystemProfile No Komplexní typ Určuje nastavení související s operačním systémem Linux.
virtualNetworkProfile No Komplexní typ Určuje nastavení související s virtuální sítí, pokud se cluster nasazuje ve virtuální síti v předplatném uživatele.
scriptActions No Pole komplexního typu Seznam akcí skriptu, které se mají provést v clusteru

linuxOperatingSystemProfile

Název elementu Požaduje se Typ Description
Uživatelské jméno Ano Řetězec Uživatelské jméno SSH
sshProfile No Komplexní typ Určuje klíč SSH.

Vyžaduje se jeden z sshProfile nebo Heslo.
Heslo No Řetězec Určuje heslo SSH.

Vyžaduje se jeden z sshProfile nebo Heslo.

sshProfile

Název elementu Požaduje se Typ Description
publicKeys Yes Pole Obsahuje seznam objektů certificateData. Hodnota je veřejný klíč ssh-rsa.

virtualNetworkProfile

Název elementu Požaduje se Typ Description
id Ano Řetězec ID prostředku Virtual Network
podsíť Ano Řetězec Určuje název podsítě.

scriptActions

Název elementu Požaduje se Typ Description
name Ano Řetězec Popisný název akce skriptu
Uri Ano Řetězec Adresa URL souboru akce skriptu
parameters No Řetězec Argumenty, které se mají předat při provádění souboru akce skriptu

Odpověď

Pokud je ověření dokončeno a požadavek je přijat, operace vrátí hodnotu 200 (OK).

Stavový kód: 200 OK

Text odpovědi pro cluster s Linuxem se vytvoří pomocí klíče 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"
	}
}
Název elementu Typ Description
provisioningState Řetězec Označuje aktuální stav zřizování.
clusterState Řetězec Označuje podrobnější stav clusteru HDInsight během zřizování.
createdDate Datum Datum a čas přijetí žádosti o vytvoření clusteru
quotaInfo Komplexní typ Určuje jádra použádaná clusterem.
chyby Pole chybových zpráv Obsahuje chybovou zprávu, pokud provisioningState = 'failed"
připojeníEndpointy Komplexní typ Určuje veřejné koncové body pro cluster.

připojeníEndpointy

Název elementu Typ Description
name Řetězec Popisný název koncového bodu připojení
Protokol Řetězec Určuje protokol, který se má použít (příklad: HTTPS, SSH).
location Řetězec Určuje adresu URL pro připojení.
port int Určuje port, který se má připojit.

Odstranit

Odstraní cluster HDInsight.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Odpověď

HTTP 202 (přijato) značí, že se operace dokončí asynchronně. Asynchronní dotazování vrátí po úspěšném dokončení operace hodnotu 204 (NoContent).

Poznámky

Pokud chcete sledovat průběh žádosti o odstranění clusteru, přečtěte si téma Asynchronní operace (202 Accepted a Location header).

Get

Získá podrobnosti nebo vlastnosti zadaného clusteru.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Odpověď

Operace vrátí hodnotu 200 (OK), pokud se žádost úspěšně dokončí.

Stavový kód: 200 OK

Text odpovědi je stejný jako vytvoření clusteru.

Text odpovědi pro podrobnosti o clusteru s Linuxem

{  
    "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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
Název elementu Typ Description
provisioningState Řetězec Označuje aktuální stav zřizování.
clusterState Řetězec Označuje podrobnější stav clusteru HDInsight během zřizování.
createdDate Datum Datum a čas přijetí žádosti o vytvoření clusteru
quotaInfo Komplexní typ Určuje jádra použádaná clusterem.
chyby Pole chybových zpráv Obsahuje chybovou zprávu, pokud provisioningState = 'failed"
připojeníEndpointy Komplexní typ Určuje veřejné koncové body pro cluster.

připojeníEndpointy

Název elementu Typ Description
name Řetězec Popisný název koncového bodu připojení
Protokol Řetězec Určuje protokol, který se má použít (příklad: HTTPS, SSH).
location Řetězec Určuje adresu URL pro připojení.
port int Určuje port, který se má připojit.

Výpis konfigurací

Načte všechny podrobnosti o konfiguraci clusteru (včetně citlivých informací).

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Odpověď

HTTP 200 (OK) po úspěšném dokončení operace.

Příklad odpovědi:

"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"  
      }  
}
Název elementu Typ Description
Konfigurace Slovník Tento prvek je slovníkem typu konfigurace a jeho přidruženým slovníkem hodnot.
Typ konfigurace brány slouží ke konfiguraci uživatele HTTP, který se používá pro připojení k webovým rozhraním API a portálu Ambari.
Typ konfigurace core-site slouží ke konfiguraci výchozího účtu úložiště pro cluster.

Získání konfigurace

Získá podrobnosti o jednom typu konfigurace (vynechá citlivé hodnoty).

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Odpověď

HTTP 200 (OK) po úspěšném dokončení operace.

Příklad odpovědi:

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

Získání nastavení brány

Tato operace načte přihlašovací údaje HTTP brány clusteru.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Odpověď

HTTP 200 (OK) po úspěšném dokončení operace.

Příklad odpovědi:

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

Aktualizace nastavení brány

Tato operace umožňuje uživatelům změnit přihlašovací údaje HTTP brány clusteru.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
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!"  
}

Odpověď

HTTP 202 (přijato) po úspěšném dokončení operace.

Změna nastavení připojení (ZASTARALÉ)

Tato operace umožňuje uživatelům povolit nebo zakázat připojení HTTPS ke clusteru.

Místo toho použijte updateGatewaySettings .

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Povolení připojení

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

Seznam podle skupiny prostředků

Seznamy všechny clustery v předplatném uživatele v zadané skupině prostředků.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
GET https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Odpověď

Pokud se požadavek úspěšně dokončí, operace vrátí hodnotu 200 (OK).

Stavový kód: 200 OK

Text odpovědi je pole podrobností clusteru. Další informace najdete v tématu Získání vlastností clusteru.

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

Výpis podle předplatného

Seznamy všechny clustery v předplatném uživatele.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
GET https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Odpověď

Pokud se požadavek úspěšně dokončí, operace vrátí hodnotu 200 (OK).

Stavový kód: 200 OK

Text odpovědi je pole podrobností clusteru.

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

Zakázání připojení

{  
   "restAuthCredential.isEnabled": false  
}
Název elementu Požaduje se Typ Description
restAuthCredential.isEnabled Yes Logická hodnota Určuje, jestli se má povolit nebo zakázat připojení.
restAuthCredential.username No Řetězec Povinné, pokud isEnabled=true
Určuje uživatelské jméno pro nastavení připojení.
restAuthCredential.password No Řetězec Povinné, pokud isEnabled=true
Určuje heslo pro nastavení připojení.

Odpověď

HTTP 202 (přijato) značí, že se operace dokončí asynchronně. Asynchronní dotazování vrátí po úspěšném dokončení operace hodnotu 204 (NoContent).

Poznámky

Pokud chcete sledovat průběh žádosti o odstranění clusteru, přečtěte si téma Asynchronní operace (akceptované 202 a hlavička Umístění).

Změna nastavení protokolu RDP (jenom cluster s Windows)

Tato operace umožňuje uživateli povolit nebo zakázat protokol RDP. Platí pro clustery se systémem Windows.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

Text požadavku

Povolení protokolu RDP

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

Zakázání protokolu RDP

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

osProfile

Název elementu Požaduje se Typ Description
windowsOperatingSystemProfile No Komplexní typ Určuje nastavení související s operačním systémem Windows.

windowsOperatingSystemProfile

Název elementu Požaduje se Typ Description
rdpSettings No Komplexní typ Určuje nastavení protokolu RDP pro clustery s Windows.

rdpSettings

Název elementu Požaduje se Typ Description
username Ano Řetězec Určuje uživatelské jméno RDP.
heslo Ano Řetězec Určuje heslo pro uživatele protokolu RDP.
datum_ukončení_platnosti Yes Datum Datum vypršení platnosti přihlašovacích údajů RDP

Odpověď

Pokud se požadavek úspěšně dokončí, operace vrátí hodnotu 200 (OK).

Stavový kód: 200 OK

Text odpovědi je stejný jako text vytvoření clusteru.

Spouštění akcí skriptů ve spuštěném clusteru (jenom cluster s Linuxem)

Spusťte akci skriptu ve spuštěném clusteru.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

Text požadavku

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

skriptovací akce

Název elementu Požaduje se Typ Description
name Ano Řetězec Určuje název akce skriptu.
Uri Ano Řetězec Určuje identifikátor URI akce skriptu.
parameters Ano Řetězec Určuje parametry vyžadované akcí skriptu.
Role Yes Pole řetězců Určuje cílové role, na které se akce skriptu spustí.
persistOnSuccess Yes Logická hodnota Určuje, jestli se akce skriptu zachovají i po úspěšných spuštěních.

Odpověď

Pokud je ověření dokončeno a požadavek je přijat, operace vrátí 202 (přijato).

Stavový kód: 202 (přijato)

Výpis všech trvalých akcí skriptů pro cluster (jenom cluster s Linuxem)

Tato operace vrátí všechny trvalé akce skriptů zadaného clusteru.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

Odpověď

HTTP 200 (OK) po úspěšném dokončení operace.

Stavový kód: 200 OK

Příklad odpovědi:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
Název elementu Typ Description
name Řetězec Určuje název akce skriptu.
Uri Řetězec Určuje identifikátor URI akce skriptu.
parameters Řetězec Určuje parametry vyžadované akcí skriptu.
Role Pole řetězců Určuje cílové role, pro které se akce skriptu spustí.
applicationName Řetězec Určuje odpovídající aplikaci, ke které je skript přidružený. applicationName má hodnotu null, pokud skript poskytují uživatelé.

Odebrání trvalé akce skriptu pro cluster (jenom cluster s Linuxem)

Tato operace odebere akci trvalého skriptu HDInsight pro cluster.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

Odpověď

  • HTTP 200 (OK) označuje, že akce skriptu byla odebrána ze seznamu trvalých akcí skriptu.

  • HTTP 404 (Nenalezeno) značí, že neexistuje žádná trvalá akce skriptu s odpovídajícím názvem skriptu.

Získání spuštění akce skriptu z historie (jenom clustery s Linuxem)

Tato operace vrátí nejnovější spuštění akce skriptů zadaného clusteru nebo podrobnosti o spuštění jednotlivých skriptů.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají clustery.

Metoda Identifikátor URI žádosti
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}

Odpověď

Pokud se požadavek úspěšně dokončí, operace vrátí hodnotu 200 (OK). Text odpovědi je pole podrobností o spuštění skriptu nebo podrobnosti o spuštění jednoho skriptu, pokud je k dispozici scriptExecutionId. Níže je uveden příklad podrobností o spuštění skriptu.

Stavový kód: 200 (OK)

Příklad odpovědi:

{  
  "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"  
}
Název elementu Typ Description
scriptExecutionId Dlouhé Určuje ID spuštění akce skriptu.
name Řetězec Určuje název akce skriptu.
applicationName Řetězec Určuje odpovídající aplikaci, ke které je skript přidružen. applicationName má hodnotu null, pokud je skript poskytnutý uživateli.
Uri Řetězec Určuje identifikátor URI akce skriptu.
parameters Řetězec Určuje parametry vyžadované akcí skriptu.
Role Pole řetězců Určuje cílové role, na které se akce skriptu spustí.
startTime DateTime Určuje čas spuštění akce skriptu.
endTime DateTime Určuje čas ukončení provádění akce skriptu.
status Řetězec Určuje stav provádění akce skriptu.
operation Řetězec Určuje důvod spuštění akce skriptu. ScaleUp například znamená, že se akce skriptu spustila během vertikálního navýšení kapacity clusteru.
executionSummary Pole komplexního typu Určuje souhrn spuštění z hlediska počtu úspěšných hostitelů a počtu hostitelů, kteří selhali při spuštění skriptu.
debugInformation Řetězec Určuje podrobné informace o ladění pro skript. debugInformation je vrácen pouze v případech, kdy je v požadavku k dispozici scriptExecutionId.

executionSummary

Název elementu Typ Description
status Řetězec Určuje stav provádění na jednotlivých hostitelích.
instanceCount Int Určuje počet spuštění s odpovídajícím stavem.

Zvýšení úrovně skriptu z historie spouštění akcí skriptu na trvalé (jenom cluster s Linuxem)

Tato operace podporuje zachování skriptu HDInsight z historie spouštění skriptů.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
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}

Odpověď

  • HTTP 200 (OK) označuje, že akce skriptu byla povýšena.

  • HTTP 404 (NotFound) označuje, že neexistuje spuštění akce skriptu s odpovídající scriptExecutionId.

Změna velikosti

Změní velikost existujícího clusteru HDInsight.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
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}

Následující příklad ukazuje žádost o aktualizaci značek pro cluster

{  
    "targetInstanceCount": 10  
}
Název elementu Požaduje se Typ Description
targetInstanceCount Yes Int Určuje počet nových instancí pro roli.

Odpověď

HTTP 202 (přijato) značí, že se operace dokončí asynchronně. Asynchronní dotazování vrátí po úspěšném dokončení operace hodnotu 204 (NoContent).

Poznámky

Pokud chcete sledovat průběh žádosti o odstranění clusteru, přečtěte si téma Asynchronní operace (202 Accepted a Location header).

Aktualizace

Aktualizace značky clusteru.

Všechny ostatní aktualizace jsou samostatné akce popsané samostatně.

Žádost

Viz Běžné parametry a hlavičky pro hlavičky a parametry používané clustery.

Metoda Identifikátor URI žádosti
OPRAVA https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Následující příklad ukazuje žádost o aktualizaci značek pro cluster

{   
    "tags": {"department": "finance"}  
}
Název elementu Požaduje se Typ Description
tags Ano Řetězec Určuje značky, které budou přiřazeny ke clusteru. Další informace o používání značek najdete v tématu Použití značek k uspořádání prostředků Azure.

Odpověď

Operace vrátí hodnotu 200 (OK), pokud se požadavek úspěšně dokončí.

Stavový kód: 200 OK

Text odpovědi je stejný jako Vytvoření clusteru.