Megosztás a következőn keresztül:

Fürt REST API-ja az Azure HDInsightban

  • Cikk

Létrehozás

Létrehoz egy fürtöt a megadott előfizetésben.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Az alábbi példa egy Linux-alapú Hadoop-fürt létrehozására vonatkozó kérelemtörzset mutatja be. A fürtök más módon történő létrehozására vonatkozó példákért tekintse meg az alábbi Példák szakaszt.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
Elem neve Kötelező Típus Description
id Igen Sztring Megadja a fürt erőforrás-azonosítóját.
name Igen Sztring Megadja a fürt nevét.
típus Igen Sztring Megadja a fürt típusát.
location Igen Sztring Megadja azt a támogatott Azure-helyet, ahol a fürtöt létre kell hozni. További információ: Az összes elérhető földrajzi hely listázása.
tags Nem Sztring Megadja a fürthöz hozzárendelendő címkéket. További információ a címkék használatáról: Címkék használata az Azure-erőforrások rendszerezéséhez.
Tulajdonságok Yes Összetett típus Megadja a fürt tulajdonságait.

Tulajdonságok

Elem neve Kötelező Típus Description
clusterVersion Igen Sztring A fürtverziót adja meg
osType Igen Sztring Megadja a fürt operációs rendszerét.

Az érvényes értékek a Linux és a Windows
clusterDefinition Yes Összetett típus A fürt típusával és konfigurációival kapcsolatos információkat adja meg
computeProfile Yes Összetett típus A fürttopológiával és a társított szerepkörtulajdonságokkal kapcsolatos információkat adja meg

clusterDefinition

Elem neve Kötelező Típus Description
Fajta Igen Sztring A fürt típusát adja meg.

Érvényes értékek: hadoop, hbase, storm & spark
Konfigurációk Yes Szótár Ez az elem egy konfigurációs típusú szótár és a hozzá tartozó értékszótár.

az átjáró konfigurációs típusa a webes API-khoz és az Ambari-portálhoz való csatlakozáshoz használt HTTP-felhasználó konfigurálására szolgál

A core-site konfigurációs típus a fürt alapértelmezett tárfiókjának konfigurálására szolgál

computeProfile

Elem neve Kötelező Típus Description
clusterVersion Igen Sztring A fürtverziót adja meg
Szerepet Yes Komplex típusú tömb (szerepkör) A fürt szerepköreivel kapcsolatos információkat adja meg

Szerepet

Elem neve Kötelező Típus Description
name Igen Sztring Megadja a szerepkör nevét
targetInstanceCount Yes Egész szám Meghatározza a szerepkör célpéldányainak számát
hardwareProfile Yes Összetett típus A szerepkör hardverprofiljára vonatkozó információkat adja meg
osProfile Yes Összetett típus A szerepkör operációsrendszer-profiljával kapcsolatos információkat adja meg

hardwareProfile

Elem neve Kötelező Típus Description
vmSize Igen Sztring A virtuális gép méretét adja meg. Az érvényes méretekért tekintse meg a HDInsight konfigurációs beállításait (a hivatkozás után görgessen le a Node tarifacsomagjaihoz)

osProfile

Elem neve Kötelező Típus Description
linuxOperatingSystemProfile No Összetett típus A linuxos operációs rendszerrel kapcsolatos beállítások megadása
windowsOperatingSystemProfile No Összetett típus A Windows operációs rendszerrel kapcsolatos beállítások megadása
virtualNetworkProfile No Összetett típus Megadja a virtuális hálózattal kapcsolatos beállításokat, ha a fürt egy virtuális hálózaton van üzembe helyezve a felhasználó előfizetésében
scriptActions No Komplex típusú tömb A fürtön végrehajtandó szkriptműveletek listája

linuxOperatingSystemProfile

Elem neve Kötelező Típus Description
Felhasználónév Igen Sztring SSH-felhasználónév
sshProfile No Összetett típus Megadja az SSH-kulcsot.

Az sshProfile vagy a Jelszó egyikére van szükség.
Jelszó Nem Sztring Megadja az SSH-jelszót

Az sshProfile vagy a Jelszó egyikére van szükség.

sshProfile

Elem neve Kötelező Típus Description
publicKeys Yes Tömb A certificateData objektumok listáját tartalmazza. Az érték egy ssh-rsa nyilvános kulcs

windowsOperatingSystemProfile

Elem neve Kötelező Típus Description
rdpSettings No Összetett típus RdP-beállítások megadása Windows-fürtökhöz

rdpSettings

Elem neve Kötelező Típus Description
username Igen Sztring Megadja az RDP-felhasználónevet
jelszó Igen Sztring Megadja az RDP-felhasználó jelszavát
expiryDate Yes Dátum Az RDP-hitelesítő adatok lejárati dátuma

virtualNetworkProfile

Elem neve Kötelező Típus Description
id Igen Sztring Virtual Network erőforrás-azonosító
alhálózat Igen Sztring Az alhálózat nevét adja meg

scriptActions

Elem neve Kötelező Típus Description
name Igen Sztring A szkriptművelet rövid neve
Uri Igen Sztring A szkriptműveletfájl URL-címe
parameters Nem Sztring A szkriptműveletfájl végrehajtásakor átadandó argumentumok

Reagálás

Ha az ellenőrzés befejeződött, és a kérés elfogadva, a művelet 200 (OK) értéket ad vissza.

Állapotkód: 200 OK

A linuxos fürt választörzse ssh-kulccsal jön létre:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}
Elem neve Típus Description
provisioningState Sztring Az aktuális kiépítési állapotot jelzi.
clusterState Sztring A részletesebb HDInsight-fürt állapotát jelzi a kiépítés folyamatban van.
createdDate Dátum A fürtlétrehozási kérelem fogadásának dátuma
quotaInfo Összetett típus Meghatározza a fürt általhasznált magokat
Hibák Hibaüzenetek tömbje A hibaüzenetet tartalmazza, ha a provisioningState = "failed"
connectivityEndpoints Összetett típus Meghatározza a fürt nyilvános végpontjait

connectivityEndpoints

Elem neve Típus Description
name Sztring A kapcsolati végpont rövid neve
Protokoll Sztring Meghatározza a használni kívánt protokollt (például: HTTPS, SSH)
location Sztring Megadja a csatlakoztatni kívánt URL-címet
port int Meghatározza a csatlakoztatni kívánt portot

Prémium szintű, tartományhoz csatlakoztatott HDInsight-fürt létrehozása (csak Linuxon, előzetes verzió)

Hozzon létre egy prémium tartományhoz csatlakoztatott fürtöt az Apache Rangerrel. A felhasználónak meg kell adnia a SecurityProfile-t a kérelem törzsében egy biztonságos fürt létrehozásához.

Kérés

Lásd: A fürtök által használt fejlécek és paraméterek gyakori paraméterei és fejlécei .

Metódus Kérés URI-ja
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Az alábbi példa egy Linux-alapú, prémium szintű, tartományhoz csatlakoztatott Hadoop-fürt létrehozására szolgáló kérelemtörzset mutatja be.

{
	"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"
						}
					}
				}
			]
		}
	}
}
Elem neve Kötelező Típus Description
id Igen Sztring Megadja a fürt erőforrás-azonosítóját.
name Igen Sztring Megadja a fürt nevét.
típus Igen Sztring Megadja a fürt típusát.
location Igen Sztring Megadja azt a támogatott Azure-helyet, ahol a fürtöt létre kell hozni. További információ: Az összes elérhető földrajzi hely listázása.
tags Nem Sztring Megadja a fürthöz hozzárendelendő címkéket. További információ a címkék használatáról: Címkék használata az Azure-erőforrások rendszerezéséhez.
Tulajdonságok Yes Összetett típus Megadja a fürt tulajdonságait.

Tulajdonságok

Elem neve Kötelező Típus Description
clusterVersion Igen Sztring A fürtverziót adja meg
osType Igen Sztring Megadja a fürt operációs rendszerét.

Az érvényes érték Linux, mert csak Linux-fürttípusok csatlakozhatnak egy Azure AD tartományhoz.
tier Nem Sztring Az alapértelmezett érték standard. Az érvényes értékek standard és prémium szintűek. Ha nincs megadva érték, a rendszer azt feltételezi, hogy az érték standard. Megadja a fürt rétegét. A tartományhoz csatlakoztatott fürtök csak prémium szinten támogatottak
clusterDefinition Yes Összetett típus A fürt típusával és konfigurációival kapcsolatos információkat adja meg
computeProfile Yes Összetett típus A fürttopológiával és a társított szerepkörtulajdonságokkal kapcsolatos információkat adja meg
securityProfile No Összetett típus Biztonságos, tartományhoz csatlakoztatott fürt létrehozásakor ez az elem határozza meg az Active Directoryval kapcsolatos beállításokat

clusterDefinition

Elem neve Kötelező Típus Description
Fajta Igen Sztring A fürt típusát adja meg.

Érvényes értékek: hadoop, hbase, storm & spark
Konfigurációk Yes Szótár Ez az elem egy konfigurációs típusú szótár és a hozzá tartozó értékszótár.

az átjáró konfigurációs típusa a webes API-khoz és az Ambari-portálhoz való csatlakozáshoz használt HTTP-felhasználó konfigurálására szolgál

A core-site konfigurációs típus a fürt alapértelmezett tárfiókjának konfigurálására szolgál

computeProfile

Elem neve Kötelező Típus Description
clusterVersion Igen Sztring A fürtverziót adja meg
Szerepet Yes Komplex típusú tömb (szerepkör) A fürt szerepköreivel kapcsolatos információkat adja meg

securityProfile

Elem neve Kötelező Típus Description
directoryType Igen Sztring A használt LDAP-könyvtár típusa. Jelenleg az "ActiveDirectory" az egyetlen támogatott érték.
domain Igen Sztring Active Directory-tartomány a fürthöz
organizationalUnitDN Igen Sztring A felhasználói és számítógépfiókokat létrehozó Active Directoryban található szervezeti egység megkülönböztető neve
ldapsUrls Yes Sztringtömb Egy vagy több LDAPS-kiszolgáló URL-címei az Active Directoryhoz
domainUserName Igen Sztring A fürt létrehozásához szükséges engedélyekkel rendelkező tartományi felhasználói fiók. User@domain formátumban kell lennie
domainUserPassword Igen Sztring A tartományi felhasználói fiók jelszava
clusterUsersGroupDNS No Sztringtömb Az Ambariban és az Apache Rangerben elérhető Active Directory-csoportok megkülönböztető nevei

Szerepet

Elem neve Kötelező Típus Description
name Igen Sztring Megadja a szerepkör nevét
targetInstanceCount Yes Egész szám Meghatározza a szerepkör célpéldányainak számát
hardwareProfile Yes Összetett típus Megadja a szerepkör hardverprofiljának adatait
osProfile Yes Összetett típus A szerepkör operációsrendszer-profiljával kapcsolatos információk megadása

hardwareProfile

Elem neve Kötelező Típus Description
vmSize Igen Sztring A virtuális gép méretét adja meg. Érvényes méretekért tekintse meg a HDInsight konfigurációs beállításait (ezen a hivatkozáson egyszer görgessen le a Node tarifacsomagjaihoz)

osProfile

Elem neve Kötelező Típus Description
linuxOperatingSystemProfile No Összetett típus A linux operációs rendszerrel kapcsolatos beállítások megadása
virtualNetworkProfile No Összetett típus Megadja a virtuális hálózattal kapcsolatos beállításokat, ha a fürt egy virtuális hálózaton van üzembe helyezve a felhasználó előfizetésében
scriptActions No Komplex típusú tömb A fürtön végrehajtandó szkriptműveletek listája

linuxOperatingSystemProfile

Elem neve Kötelező Típus Description
Felhasználónév Igen Sztring SSH-felhasználónév
sshProfile No Összetett típus Megadja az SSH-kulcsot.

Az sshProfile vagy a Password egyikére van szükség.
Jelszó Nem Sztring Az SSH-jelszó megadása

Az sshProfile vagy a Password egyikére van szükség.

sshProfile

Elem neve Kötelező Típus Description
publicKeys Yes Tömb A certificateData-objektumok listáját tartalmazza. Az érték egy ssh-rsa nyilvános kulcs

virtualNetworkProfile

Elem neve Kötelező Típus Description
id Igen Sztring Virtual Network erőforrás-azonosító
alhálózat Igen Sztring Az alhálózat nevét adja meg

scriptActions

Elem neve Kötelező Típus Description
name Igen Sztring A szkriptművelet rövid neve
Uri Igen Sztring A szkriptműveletfájl URL-címe
parameters Nem Sztring A szkriptműveletfájl végrehajtásakor átadandó argumentumok

Reagálás

Ha az ellenőrzés befejeződött, és a kérelem elfogadva, a művelet 200 (OK) értéket ad vissza.

Állapotkód: 200 OK

Egy Linux-fürt választörzse ssh-kulccsal jön létre:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}
Elem neve Típus Description
provisioningState Sztring Az aktuális kiépítési állapotot jelzi.
clusterState Sztring A részletesebb HDInsight-fürt állapotát jelzi, miközben a kiépítés folyamatban van.
createdDate Dátum A fürtlétrehozási kérelem fogadásának dátuma
quotaInfo Összetett típus A fürt általhasznált magokat adja meg
Hibák Hibaüzenetek tömbje Azt a hibaüzenetet tartalmazza, ha a provisioningState = "failed"
connectivityEndpoints Összetett típus Megadja a fürt nyilvános végpontját

connectivityEndpoints

Elem neve Típus Description
name Sztring A kapcsolati végpont rövid neve
Protokoll Sztring Megadja a használni kívánt protokollt (például: HTTPS, SSH)
location Sztring Megadja a csatlakoztatni kívánt URL-címet
port int Megadja a csatlakoztatni kívánt portot

Fürt létrehozása alapértelmezett fájlrendszerként az Azure Data Lake Store-ral

Létrehoz egy fürtöt a megadott előfizetésben az Azure Data Lake Store-ral alapértelmezett fájlrendszerként. Adjon meg egy ClusterIdentity objektumot a kérelem törzsében, és konfigurálja az alapértelmezett fájlrendszer tulajdonságot a megfelelő Data Lake Store URL-címmel.

Az Azure Data Lake a fürtverziók alapértelmezett fájlrendszereként konfigurálható a 3.5-től kezdődően.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

Az alábbi példa egy Linux-alapú Hadoop-fürt létrehozására vonatkozó kéréstörzset mutatja be, amely az Azure Data Lake Store-t használja a fürt alapértelmezett fájlrendszereként.

{
	"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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
Elem neve Kötelező Típus Description
id Igen Sztring Megadja a fürt erőforrás-azonosítóját.
name Igen Sztring Megadja a fürt nevét.
típus Igen Sztring Megadja a fürt típusát.
location Igen Sztring Megadja azt a támogatott Azure-helyet, ahol a fürtöt létre kell hozni. További információ: Az összes elérhető földrajzi hely listázása.
tags Nem Sztring Megadja a fürthöz hozzárendelendő címkéket. További információ a címkék használatáról: Címkék használata az Azure-erőforrások rendszerezéséhez.
Tulajdonságok Yes Összetett típus Megadja a fürt tulajdonságait.

Tulajdonságok

Elem neve Kötelező Típus Description
clusterVersion Igen Sztring A fürtverziót adja meg
osType Igen Sztring Megadja a fürt operációs rendszerét.

Az érvényes érték Linux
tier Nem Sztring Megadja a fürt szintjét. Az érvényes értékek standard és prémium szintűek. Ha nincs megadva szint, a fürt standard szintű lesz.
clusterDefinition Yes Összetett típus A fürt típusával és konfigurációival kapcsolatos információkat adja meg
computeProfile Yes Összetett típus A fürttopológiával és a társított szerepkörtulajdonságokkal kapcsolatos információkat adja meg

clusterDefinition

Elem neve Kötelező Típus Description
Fajta Igen Sztring A fürt típusát adja meg.

Érvényes értékek: hadoop, hbase, storm & spark
Konfigurációk Yes Szótár Ez az elem egy konfigurációs típusú szótár és a hozzá tartozó értékszótár.

az átjáró konfigurációs típusa a webes API-khoz és az Ambari-portálhoz való csatlakozáshoz használt HTTP-felhasználó konfigurálására szolgál

A core-site konfigurációs típus a fürt alapértelmezett tárfiókjának konfigurálására szolgál

computeProfile

Elem neve Kötelező Típus Description
clusterVersion Igen Sztring A fürtverziót adja meg
Szerepet Yes Komplex típusú tömb (szerepkör) A fürt szerepköreivel kapcsolatos információkat adja meg

Szerepet

Elem neve Kötelező Típus Description
name Igen Sztring Megadja a szerepkör nevét
targetInstanceCount Yes Egész szám Meghatározza a szerepkör célpéldányainak számát
hardwareProfile Yes Összetett típus A szerepkör hardverprofiljára vonatkozó információkat adja meg
osProfile Yes Összetett típus A szerepkör operációsrendszer-profiljával kapcsolatos információkat adja meg

hardwareProfile

Elem neve Kötelező Típus Description
vmSize Igen Sztring A virtuális gép méretét adja meg. Az érvényes méretekért tekintse meg a HDInsight konfigurációs beállításait (a hivatkozás után görgessen le a Node tarifacsomagjaihoz)

osProfile

Elem neve Kötelező Típus Description
linuxOperatingSystemProfile No Összetett típus A linuxos operációs rendszerrel kapcsolatos beállítások megadása
virtualNetworkProfile No Összetett típus Megadja a virtuális hálózattal kapcsolatos beállításokat, ha a fürt egy virtuális hálózaton van üzembe helyezve a felhasználó előfizetésében
scriptActions No Komplex típusú tömb A fürtön végrehajtandó szkriptműveletek listája

linuxOperatingSystemProfile

Elem neve Kötelező Típus Description
Felhasználónév Igen Sztring SSH-felhasználónév
sshProfile No Összetett típus Megadja az SSH-kulcsot.

Az sshProfile vagy a Jelszó egyikére van szükség.
Jelszó Nem Sztring Megadja az SSH-jelszót

Az sshProfile vagy a Jelszó egyikére van szükség.

sshProfile

Elem neve Kötelező Típus Description
publicKeys Yes Tömb A certificateData objektumok listáját tartalmazza. Az érték egy ssh-rsa nyilvános kulcs

virtualNetworkProfile

Elem neve Kötelező Típus Description
id Igen Sztring Virtual Network erőforrás-azonosító
alhálózat Igen Sztring Megadja az alhálózat nevét

scriptActions

Elem neve Kötelező Típus Description
name Igen Sztring A szkriptművelet rövid neve
Uri Igen Sztring A szkriptműveletfájl URL-címe
parameters Nem Sztring A szkriptműveletfájl végrehajtásakor átadandó argumentumok

Reagálás

Ha az ellenőrzés befejeződött, és a kérelem elfogadva, a művelet 200 (OK) értéket ad vissza.

Állapotkód: 200 OK

Egy Linux-fürt választörzse ssh-kulccsal jön létre:

{
	"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"
	}
}
Elem neve Típus Description
provisioningState Sztring Az aktuális kiépítési állapotot jelzi.
clusterState Sztring A részletesebb HDInsight-fürt állapotát jelzi, miközben a kiépítés folyamatban van.
createdDate Dátum A fürtlétrehozási kérelem fogadásának dátuma
quotaInfo Összetett típus A fürt általhasznált magokat adja meg
Hibák Hibaüzenetek tömbje Azt a hibaüzenetet tartalmazza, ha a provisioningState = "failed"
connectivityEndpoints Összetett típus Megadja a fürt nyilvános végpontját

connectivityEndpoints

Elem neve Típus Description
name Sztring A kapcsolati végpont rövid neve
Protokoll Sztring Megadja a használni kívánt protokollt (például: HTTPS, SSH)
location Sztring Megadja a csatlakoztatni kívánt URL-címet
port int Megadja a csatlakoztatni kívánt portot

Törlés

Töröl egy HDInsight-fürtöt.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Reagálás

HTTP 202 (Elfogadva) jelzi, hogy a művelet aszinkron módon fog befejeződni. Az aszinkron lekérdezés 204-et (NoContent) ad vissza, ha a művelet sikeresen befejeződött.

Megjegyzések

A fürttörlési kérések előrehaladásának nyomon követéséhez lásd: Aszinkron műveletek (202 Elfogadva és Hely fejléc)

Lekérés

Lekéri a megadott fürt adatait/tulajdonságait.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Reagálás

A művelet 200 (OK) értéket ad vissza, ha a kérés sikeresen befejeződött

Állapotkód: 200 OK

A válasz törzse megegyezik a fürt létrehozásával.

Választörzs a Linux-fürt részleteihez

{  
    "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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
Elem neve Típus Description
provisioningState Sztring Az aktuális kiépítési állapotot jelzi.
clusterState Sztring A részletesebb HDInsight-fürt állapotát jelzi, miközben a kiépítés folyamatban van.
createdDate Dátum A fürtlétrehozási kérelem fogadásának dátuma
quotaInfo Összetett típus A fürt általhasznált magokat adja meg
Hibák Hibaüzenetek tömbje Azt a hibaüzenetet tartalmazza, ha a provisioningState = "failed"
connectivityEndpoints Összetett típus Megadja a fürt nyilvános végpontját

connectivityEndpoints

Elem neve Típus Description
name Sztring A kapcsolati végpont rövid neve
Protokoll Sztring Megadja a használni kívánt protokollt (például: HTTPS, SSH)
location Sztring Megadja a csatlakoztatni kívánt URL-címet
port int Megadja a csatlakoztatni kívánt portot

Konfigurációk listázása

Lekéri az összes fürtkonfigurációs adatot (beleértve a bizalmas adatokat is).

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Reagálás

HTTP 200 (OK) a művelet sikeres befejezéséhez.

Példaválasz:

"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"  
      }  
}
Elem neve Típus Description
Konfigurációk Szótár Ez az elem egy konfigurációs típusú szótár és a hozzá tartozó értékszótár.
az átjáró konfigurációs típusa a webes API-khoz és az Ambari-portálhoz való csatlakozáshoz használt HTTP-felhasználó konfigurálására szolgál
A core-site konfigurációs típus a fürt alapértelmezett tárfiókjának konfigurálására szolgál

Konfiguráció lekérése

Egyetlen konfigurációtípus részleteinek lekérdezése (kihagyja a bizalmas értékeket).

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Reagálás

HTTP 200 (OK) a művelet sikeres befejezéséhez.

Példaválasz:

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

Átjáróbeállítások lekérése

Ez a művelet lekéri a fürtátjáró HTTP-hitelesítő adatait.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Reagálás

HTTP 200 (OK) a művelet sikeres befejezéséhez.

Példaválasz:

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

Átjáróbeállítások frissítése

Ezzel a művelettel a felhasználók módosíthatják a fürtátjáró HTTP-hitelesítő adatait.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
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!"  
}

Reagálás

HTTP 202 (elfogadva) a művelet sikeres befejezéséről.

Kapcsolati beállítások módosítása (ELAVULT)

Ez a művelet lehetővé teszi, hogy a felhasználók engedélyezhessék/letilthassák a fürt https-kapcsolatát.

Használja helyette az updateGatewaySettings parancsot .

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Kapcsolat engedélyezése

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

Lista erőforráscsoport szerint

Listák a felhasználó előfizetésében lévő összes fürtöt a megadott erőforráscsoportban.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
GET https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Reagálás

A művelet 200 (OK) értéket ad vissza, ha a kérés sikeresen befejeződött.

Állapotkód: 200 OK

A választörzs a fürt részleteinek tömbje. További információ: Fürttulajdonságok lekérése.

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

Listázás előfizetés szerint

Listák a felhasználó előfizetésében lévő összes fürtöt.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
GET https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Reagálás

A művelet 200 (OK) értéket ad vissza, ha a kérés sikeresen befejeződött.

Állapotkód: 200 OK

A választörzs a fürt részleteinek tömbje.

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

A kapcsolat letiltása

{  
   "restAuthCredential.isEnabled": false  
}
Elem neve Kötelező Típus Description
restAuthCredential.isEnabled Yes Logikai Meghatározza, hogy engedélyezve vagy letiltva legyen-e a kapcsolat
restAuthCredential.username Nem Sztring Kötelező, ha isEnabled=true
Megadja a kapcsolati beállítások felhasználónevét
restAuthCredential.password Nem Sztring Kötelező, ha isEnabled=true
Megadja a csatlakozási beállítások jelszavát

Reagálás

HTTP 202 (Elfogadva) jelzi, hogy a művelet aszinkron módon fog befejeződni. Az aszinkron lekérdezés 204-et (NoContent) ad vissza, ha a művelet sikeresen befejeződött.

Megjegyzések

A fürttörlési kérések előrehaladásának nyomon követéséhez lásd: Aszinkron műveletek (202 Elfogadva és Hely fejléc)

RDP-beállítások módosítása (csak Windows-fürt esetén)

Ez a művelet lehetővé teszi a felhasználó számára az RDP engedélyezését/letiltását. Windows-alapú fürtökre vonatkozik.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

Kérelem törzse

RDP engedélyezése

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

Az RDP letiltása

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

osProfile

Elem neve Kötelező Típus Description
windowsOperatingSystemProfile No Összetett típus A Windows operációs rendszerrel kapcsolatos beállítások megadása

windowsOperatingSystemProfile

Elem neve Kötelező Típus Description
rdpSettings No Összetett típus RdP-beállítások megadása Windows-fürtökhöz

rdpSettings

Elem neve Kötelező Típus Description
username Igen Sztring Megadja az RDP-felhasználónevet
jelszó Igen Sztring Megadja az RDP-felhasználó jelszavát
expiryDate Yes Dátum Az RDP-hitelesítő adatok lejárati dátuma

Reagálás

A művelet 200 (OK) értéket ad vissza, ha a kérés sikeresen befejeződött

Állapotkód: 200 OK

A választörzs ugyanaz, mint a Fürt létrehozása.

Szkriptműveletek futtatása futó fürtön (csak Linux-fürtön)

Szkriptművelet végrehajtása futó fürtön.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

Kérelem törzse

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

scriptActions

Elem neve Kötelező Típus Description
name Igen Sztring A szkriptművelet nevét adja meg
Uri Igen Sztring A szkriptművelet URI-ját adja meg
parameters Igen Sztring Megadja a szkriptművelethez szükséges paramétereket
szerepkörök Yes Sztringtömb Megadja azokat a célszerepköröket, amelyeken a szkriptművelet végrehajtja
persistOnSuccess Yes Logikai Meghatározza, hogy a szkriptműveletek megmaradnak-e a sikeres végrehajtás után

Reagálás

Ha az ellenőrzés befejeződött, és a kérelem elfogadva, a művelet a 202-et (Elfogadva) adja vissza.

Állapotkód: 202 (elfogadva)

Egy fürt összes megőrzött szkriptműveletének listázása (csak Linux-fürt esetén)

Ez a művelet a megadott fürt összes megőrzött szkriptműveletét visszaadja.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

Reagálás

HTTP 200 (OK) a művelet sikeres befejezéséhez.

Állapotkód: 200 OK

Példaválasz:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
Elem neve Típus Description
name Sztring Megadja a szkriptművelet nevét.
Uri Sztring Megadja a szkriptművelet URI-ját.
parameters Sztring Megadja a szkriptművelethez szükséges paramétereket
szerepkörök Sztringtömb Meghatározza azokat a célszerepköröket, amelyeken a szkriptművelet végrehajtja a parancsprogramot.
applicationName Sztring Megadja azt az alkalmazást, amelyhez a szkript társítva van. az applicationName null értékű, ha a szkriptet a felhasználók biztosítják

Fürtön megőrzött szkriptművelet eltávolítása (csak Linux-fürt esetén)

Ez a művelet eltávolítja a fürtök HDInsight által megőrzött szkriptműveleteit.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

Reagálás

  • HTTP 200 (OK) annak jelzésére, hogy a szkriptművelet el lett távolítva a megőrzött szkriptműveletek listájából.

  • HTTP 404 (NotFound), amely azt jelzi, hogy nincs meglévő, megőrzött szkriptművelet a megfelelő scriptName paranccsal.

Szkriptművelet végrehajtásának lekérése az előzményekből (csak Linux-fürtök esetén)

Ez a művelet visszaadja a megadott fürt legutóbbi szkriptművelet-végrehajtását vagy az egyes szkriptek végrehajtásának részleteit.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
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}

Reagálás

A művelet 200 (OK) értéket ad vissza, ha a kérés sikeresen befejeződött. A válasz törzse a szkript végrehajtásának részleteiből álló tömb, vagy egyetlen szkriptvégrehajtási részlet, ha a scriptExecutionId meg van adva. Az alábbiakban egy példa látható egy szkript végrehajtásának részleteire.

Állapotkód: 200 (OK)

Példaválasz:

{  
  "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"  
}
Elem neve Típus Description
scriptExecutionId Hosszú Megadja a szkriptművelet végrehajtási azonosítóját.
name Sztring Megadja a szkriptművelet nevét.
applicationName Sztring Megadja azt az alkalmazást, amelyhez a szkript társítva van. az applicationName null értékű, ha a szkriptet a felhasználók biztosítják
Uri Sztring Megadja a szkriptművelet URI-ját.
parameters Sztring Megadja a szkriptművelethez szükséges paramétereket
szerepkörök Sztringtömb Meghatározza azokat a célszerepköröket, amelyeken a szkriptművelet végrehajtja a parancsprogramot.
startTime DateTime A szkriptművelet végrehajtásának kezdési időpontját adja meg
endTime DateTime A szkriptművelet végrehajtásának befejezési időpontját adja meg
status Sztring A szkriptművelet végrehajtásának állapotát adja meg
művelet Sztring Megadja a szkriptművelet végrehajtásának okát. A ScaleUp például azt jelenti, hogy a szkriptművelet a fürt vertikális felskálázása során lett végrehajtva.
executionSummary Komplex típusú tömb A végrehajtás összegzését adja meg annak alapján, hogy hány gazdagép sikeres volt, és hány gazdagép nem tudta végrehajtani a szkriptet.
debugInformation Sztring Részletes hibakeresési információkat ad meg a szkripthez. a debugInformation csak akkor lesz visszaadva, ha a kérésben egy scriptExecutionId van megadva.

executionSummary

Elem neve Típus Description
status Sztring A végrehajtás állapotát határozza meg az egyes gazdagépeken.
instanceCount Int A megfelelő állapotú végrehajtások számát adja meg.

Szkript előléptetése a szkriptművelet végrehajtási előzményeiből, hogy megmaradjanak (csak Linux-fürt esetén)

Ez a művelet előléptet egy HDInsight-szkriptet a szkriptvégrehajtási előzményekből, hogy megmaradjanak.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
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}

Reagálás

  • HTTP 200 (OK), amely jelzi, hogy a szkriptművelet elő lett léptetve.

  • HTTP 404 (NotFound), amely azt jelzi, hogy nincs meglévő szkriptművelet-végrehajtás a megfelelő scriptExecutionId azonosítóval.

Átméretezés

Átméretez egy meglévő HDInsight-fürtöt.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
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}

Az alábbiakban egy példakérés látható egy fürt címkéinek frissítésére

{  
    "targetInstanceCount": 10  
}
Elem neve Kötelező Típus Description
targetInstanceCount Yes Int Megadja a szerepkör új példányszámát

Reagálás

HTTP 202 (Elfogadva) jelzi, hogy a művelet aszinkron módon fog befejeződni. Az aszinkron lekérdezés 204-et (NoContent) ad vissza, ha a művelet sikeresen befejeződött.

Megjegyzések

A fürttörlési kérések előrehaladásának nyomon követéséhez lásd: Aszinkron műveletek (202 Elfogadva és Hely fejléc)

Frissítés

fürt címkéinek Frissítések.

Minden más frissítés külön művelet, amelyet külön ismertetünk.

Kérés

Tekintse meg a fürtök által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Metódus Kérés URI-ja
JAVÍTÁS https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Az alábbiakban egy példakérés látható egy fürt címkéinek frissítésére

{   
    "tags": {"department": "finance"}  
}
Elem neve Kötelező Típus Description
tags Igen Sztring Megadja a fürthöz hozzárendelendő címkéket. További információ a címkék használatáról: Címkék használata az Azure-erőforrások rendszerezéséhez.

Reagálás

A művelet 200 (OK) értéket ad vissza, ha a kérés sikeresen befejeződött.

Állapotkód: 200 OK

A választörzs ugyanaz, mint a Fürt létrehozása.