Delen via

Cluster REST API in Azure HDInsight

  • Artikel

Maken

Hiermee maakt u een cluster in het opgegeven abonnement.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

In het volgende voorbeeld ziet u de aanvraagbody voor het maken van een Hadoop-cluster op basis van Linux. Zie de sectie Voorbeelden hieronder voor voorbeelden van het maken van clusters op andere manieren.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
Elementnaam Vereist Type Beschrijving
id Ja Tekenreeks Hiermee geeft u de resource-id van het cluster.
naam Ja Tekenreeks Hiermee geeft u de naam van het cluster.
type Ja Tekenreeks Hiermee geeft u het type van het cluster op.
location Ja Tekenreeks Hiermee geeft u de ondersteunde Azure-locatie op waar het cluster moet worden gemaakt. Zie Alle beschikbare geografische locaties weergeven voor meer informatie.
tags Nee Tekenreeks Hiermee geeft u de tags op die worden toegewezen aan het cluster. Zie Tags gebruiken om uw Azure-resources te organiseren voor meer informatie over het gebruik van tags.
Eigenschappen Yes Complex Type Hiermee geeft u de eigenschappen van het cluster op.

Eigenschappen

Elementnaam Vereist Type Description
clusterVersion Ja Tekenreeks Hiermee geeft u de clusterversie op
osType Ja Tekenreeks Hiermee geeft u het besturingssysteem voor het cluster.

Geldige waarden zijn Linux en Windows
clusterDefinition Yes Complex Type Hiermee geeft u informatie over het clustertype en configuraties op
computeProfile Yes Complex Type Hiermee geeft u informatie op over de clustertopologie en de bijbehorende roleigenschappen

clusterDefinition

Elementnaam Vereist Type Description
Soort Ja Tekenreeks Hiermee geeft u het clustertype op.

Geldige waarden zijn hadoop, hbase, storm & spark
Configuraties Yes Woordenlijst Dit element is een woordenlijst van het configuratietype en de bijbehorende waardewoordenlijst.

gatewayconfiguratietype wordt gebruikt om de HTTP-gebruiker te configureren die wordt gebruikt om verbinding te maken met web-API's en de Ambari-portal

het configuratietype core-site wordt gebruikt om het standaardopslagaccount voor het cluster te configureren

computeProfile

Elementnaam Vereist Type Description
clusterVersion Ja Tekenreeks Hiermee geeft u de clusterversie op
Role Yes Matrix van complex type (rol) Hiermee geeft u informatie over rollen in het cluster op

role

Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Hiermee geeft u de rolnaam op
targetInstanceCount Ja Geheel getal Hiermee geeft u het aantal doelexemplaren voor de rol op
hardwareProfile Yes Complex Type Hiermee geeft u informatie op over het hardwareprofiel voor de rol
osProfile Yes Complex Type Hiermee geeft u informatie op over het besturingssysteemprofiel voor de rol

hardwareProfile

Elementnaam Vereist Type Description
vmSize Ja Tekenreeks Hiermee geeft u de grootte van de VM op. Raadpleeg HDInsight-configuratieopties (schuif eenmaal op deze koppeling omlaag naar Knooppunt-prijscategorieën) voor geldige grootten

osProfile

Elementnaam Vereist Type Description
linuxOperatingSystemProfile No Complex Type Hiermee geeft u de instellingen voor het Linux-besturingssysteem op
windowsOperatingSystemProfile No Complex Type Hiermee geeft u instellingen voor het windows-besturingssysteem op
virtualNetworkProfile No Complex Type Hiermee geeft u instellingen voor virtuele netwerken op als het cluster wordt geïmplementeerd in een virtueel netwerk in het abonnement van de gebruiker
scriptActions No Matrix van complex type Lijst met scriptacties die moeten worden uitgevoerd op het cluster

linuxOperatingSystemProfile

Elementnaam Vereist Type Description
Gebruikersnaam Ja Tekenreeks SSH-gebruikersnaam
sshProfile No Complex Type Hiermee geeft u de SSH-sleutel.

Een van sshProfile of Password is vereist.
Wachtwoord Nee Tekenreeks Hiermee geeft u het SSH-wachtwoord op

Een van sshProfile of Password is vereist.

sshProfile

Elementnaam Vereist Type Description
publicKeys Ja Matrix Bevat een lijst met certificateData-objecten. De waarde is een openbare ssh-rsa-sleutel

windowsOperatingSystemProfile

Elementnaam Vereist Type Description
rdpSettings No Complex Type RDP-instellingen voor Windows-clusters opgeven

rdpSettings

Elementnaam Vereist Type Description
gebruikersnaam Ja Tekenreeks Hiermee geeft u de RDP-gebruikersnaam op
wachtwoord Ja Tekenreeks Hiermee geeft u het wachtwoord voor de RDP-gebruiker op
vervaldatumdatum Ja Date Vervaldatum voor de RDP-referenties

virtualNetworkProfile

Elementnaam Vereist Type Beschrijving
id Ja Tekenreeks resource-id Virtual Network
subnet Ja Tekenreeks Hiermee geeft u de subnetnaam op

scriptActions

Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Beschrijvende naam voor de scriptactie
Uri Ja Tekenreeks URL naar het scriptactiebestand
parameters Nee Tekenreeks Argumenten die moeten worden doorgegeven bij het uitvoeren van het scriptactiebestand

Antwoord

Als de validatie is voltooid en de aanvraag wordt geaccepteerd, retourneert de bewerking 200 (OK).

Statuscode: 200 OK

Antwoordtekst voor een Linux-cluster dat wordt gemaakt met behulp van de SSH-sleutel:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}
Elementnaam Type Description
provisioningState Tekenreeks Geeft de huidige inrichtingsstatus aan.
clusterState Tekenreeks Geeft de gedetailleerdere status van het HDInsight-cluster aan terwijl het inrichten wordt uitgevoerd.
createdDate Date Datum/tijd waarop de aanvraag voor het maken van het cluster is ontvangen
quotaInfo Complex Type Hiermee geeft u de kernen die door het cluster worden gebruikt
fouten Matrix met foutberichten Bevat het foutbericht als provisioningState = 'failed'
connectivityEndpoints Complex Type Hiermee geeft u de openbare eindpunten voor het cluster op

connectivityEndpoints

Elementnaam Type Beschrijving
naam Tekenreeks Beschrijvende naam voor het connectiviteitseindpunt
protocol Tekenreeks Hiermee geeft u het protocol te gebruiken (voorbeeld: HTTPS, SSH)
location Tekenreeks Hiermee geeft u de URL om verbinding te maken
poort int Hiermee geeft u de poort om verbinding te maken

Een Premium HDInsight-cluster maken dat lid is van een domein (alleen Linux, preview)

Maak een Premium-cluster dat lid is van een domein met Apache Ranger. De gebruiker moet SecurityProfile opgeven in de aanvraagbody om een beveiligd cluster te maken.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

In het volgende voorbeeld ziet u de aanvraagbody voor het maken van een Hadoop-cluster op basis van Linux, premium, dat lid is van een domein.

{
	"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"
						}
					}
				}
			]
		}
	}
}
Elementnaam Vereist Type Beschrijving
id Ja Tekenreeks Hiermee geeft u de resource-id van het cluster.
naam Ja Tekenreeks Hiermee geeft u de naam van het cluster.
type Ja Tekenreeks Hiermee geeft u het type van het cluster op.
location Ja Tekenreeks Hiermee geeft u de ondersteunde Azure-locatie op waar het cluster moet worden gemaakt. Zie Alle beschikbare geografische locaties weergeven voor meer informatie.
tags Nee Tekenreeks Hiermee geeft u de tags op die aan het cluster worden toegewezen. Zie Tags gebruiken om uw Azure-resources te ordenen voor meer informatie over het gebruik van tags.
Eigenschappen Yes Complex Type Hiermee geeft u de eigenschappen van het cluster op.

Eigenschappen

Elementnaam Vereist Type Description
clusterVersion Ja Tekenreeks Hiermee geeft u de clusterversie op
osType Ja Tekenreeks Hiermee geeft u het besturingssysteem voor het cluster.

Geldige waarde is Linux omdat alleen Linux-clustertypen lid kunnen worden van een Azure AD domein.
laag Nee Tekenreeks De standaardwaarde is standaard. Geldige waarden zijn Standard en Premium. Als er geen waarde is opgegeven, wordt ervan uitgegaan dat de waarde standaard is. Hiermee geeft u de laag voor het cluster op. Clusters die lid zijn van een domein worden alleen ondersteund in de Premium-laag
clusterDefinition Yes Complex Type Hiermee geeft u informatie op over het clustertype en de configuraties
computeProfile Yes Complex Type Hiermee geeft u informatie op over de clustertopologie en de bijbehorende roleigenschappen
securityProfile No Complex Type Als er een beveiligd cluster wordt gemaakt dat lid is van een domein, geeft dit element de active directory-gerelateerde instellingen op

clusterDefinition

Elementnaam Vereist Type Description
Soort Ja Tekenreeks Hiermee geeft u het clustertype op.

Geldige waarden zijn hadoop, hbase, storm & spark
Configuraties Yes Woordenlijst Dit element is een woordenlijst van het configuratietype en de bijbehorende waardewoordenlijst.

gatewayconfiguratietype wordt gebruikt om de HTTP-gebruiker te configureren die wordt gebruikt om verbinding te maken met web-API's en de Ambari-portal

core-site-configuratietype wordt gebruikt om het standaardopslagaccount voor het cluster te configureren

computeProfile

Elementnaam Vereist Type Description
clusterVersion Ja Tekenreeks Hiermee geeft u de clusterversie op
Role Yes Matrix van complex type (rol) Hiermee geeft u informatie op over rollen in het cluster

securityProfile

Elementnaam Vereist Type Description
directoryType Ja Tekenreeks Type LDAP-directory dat wordt gebruikt. Momenteel is 'ActiveDirectory' de enige ondersteunde waarde.
domein Ja Tekenreeks Active Directory-domein voor het cluster
organizationalUnitDN Ja Tekenreeks DN-naam van de organisatie-eenheid in de Active Directory waar gebruikers- en computeraccounts worden gemaakt
ldapsUrls Yes Matrix van tekenreeks URL's van een of meer LDAPS-servers voor de Active Directory
domainUserName Ja Tekenreeks Een domeingebruikersaccount met voldoende machtigingen voor het maken van het cluster. De indeling moet user@domain hebben
domainUserPassword Ja Tekenreeks Wachtwoord voor het domeingebruikersaccount
clusterUsersGroupDNS No Matrix van tekenreeks DN-namen van de Active Directory-groepen die beschikbaar zijn in Ambari en Apache Ranger

role

Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Hiermee geeft u de rolnaam op
targetInstanceCount Ja Geheel getal Hiermee geeft u het aantal doelexemplaren voor de rol op
hardwareProfile Yes Complex Type Hiermee geeft u informatie op over het hardwareprofiel voor de rol
osProfile Yes Complex Type Hiermee geeft u informatie op over het besturingssysteemprofiel voor de rol

hardwareProfile

Elementnaam Vereist Type Description
vmSize Ja Tekenreeks Hiermee geeft u de grootte van de VM op. Raadpleeg HDInsight-configuratieopties (schuif op deze koppeling omlaag naar Node-prijscategorieën) voor geldige grootten

osProfile

Elementnaam Vereist Type Description
linuxOperatingSystemProfile No Complex Type Hiermee geeft u de instellingen voor het Linux-besturingssysteem op
virtualNetworkProfile No Complex Type Hiermee geeft u instellingen voor virtuele netwerken op als het cluster wordt geïmplementeerd in een virtueel netwerk in het abonnement van de gebruiker
scriptActions No Matrix van complex type Lijst met scriptacties die moeten worden uitgevoerd op het cluster

linuxOperatingSystemProfile

Elementnaam Vereist Type Description
Gebruikersnaam Ja Tekenreeks SSH-gebruikersnaam
sshProfile No Complex Type Hiermee geeft u de SSH-sleutel.

Een van sshProfile of Wachtwoord is vereist.
Wachtwoord Nee Tekenreeks Hiermee geeft u het SSH-wachtwoord op

Een van sshProfile of Wachtwoord is vereist.

sshProfile

Elementnaam Vereist Type Description
publicKeys Ja Matrix Bevat een lijst met certificateData-objecten. De waarde is een openbare ssh-rsa-sleutel

virtualNetworkProfile

Elementnaam Vereist Type Beschrijving
id Ja Tekenreeks resource-id Virtual Network
subnet Ja Tekenreeks Hiermee geeft u de subnetnaam op

scriptActions

Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Beschrijvende naam voor de scriptactie
Uri Ja Tekenreeks URL naar het scriptactiebestand
parameters Nee Tekenreeks Argumenten die moeten worden doorgegeven bij het uitvoeren van het scriptactiebestand

Antwoord

Als de validatie is voltooid en de aanvraag wordt geaccepteerd, retourneert de bewerking 200 (OK).

Statuscode: 200 OK

Antwoordtekst voor een Linux-cluster dat wordt gemaakt met behulp van de SSH-sleutel:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}
Elementnaam Type Description
provisioningState Tekenreeks Geeft de huidige inrichtingsstatus aan.
clusterState Tekenreeks Geeft de gedetailleerdere status van het HDInsight-cluster aan terwijl het inrichten wordt uitgevoerd.
createdDate Date Datum/tijd waarop de aanvraag voor het maken van het cluster is ontvangen
quotaInfo Complex Type Hiermee geeft u de kernen die door het cluster worden gebruikt
fouten Matrix met foutberichten Bevat het foutbericht als provisioningState = 'failed'
connectivityEndpoints Complex Type Hiermee geeft u de openbare eindpunten voor het cluster op

connectivityEndpoints

Elementnaam Type Beschrijving
naam Tekenreeks Beschrijvende naam voor het connectiviteitseindpunt
protocol Tekenreeks Hiermee geeft u het protocol te gebruiken (voorbeeld: HTTPS, SSH)
location Tekenreeks Hiermee geeft u de URL om verbinding te maken
poort int Hiermee geeft u de poort om verbinding te maken

Een cluster maken met Azure Data Lake Store als het standaardbestandssysteem

Hiermee maakt u een cluster in het opgegeven abonnement met Azure Data Lake Store als het standaardbestandssysteem. Geef een ClusterIdentity-object op in de aanvraagbody en configureer de eigenschap default-filesystem met de juiste Data Lake Store-URL.

Azure Data Lake kan worden geconfigureerd als het standaardbestandssysteem voor clusterversies vanaf 3.5.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

In het volgende voorbeeld ziet u de aanvraagbody voor het maken van een Hadoop-cluster op basis van Linux met Behulp van Azure Data Lake Store als het standaardbestandssysteem voor het 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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
Elementnaam Vereist Type Beschrijving
id Ja Tekenreeks Hiermee geeft u de resource-id van het cluster.
naam Ja Tekenreeks Hiermee geeft u de naam van het cluster.
type Ja Tekenreeks Hiermee geeft u het type van het cluster op.
location Ja Tekenreeks Hiermee geeft u de ondersteunde Azure-locatie op waar het cluster moet worden gemaakt. Zie Alle beschikbare geografische locaties weergeven voor meer informatie.
tags Nee Tekenreeks Hiermee geeft u de tags op die worden toegewezen aan het cluster. Zie Tags gebruiken om uw Azure-resources te organiseren voor meer informatie over het gebruik van tags.
Eigenschappen Yes Complex Type Hiermee geeft u de eigenschappen van het cluster op.

Eigenschappen

Elementnaam Vereist Type Description
clusterVersion Ja Tekenreeks Hiermee geeft u de clusterversie op
osType Ja Tekenreeks Hiermee geeft u het besturingssysteem voor het cluster.

Geldige waarde is Linux
laag Nee Tekenreeks Hiermee geeft u de laag voor het cluster op. Geldige waarden zijn Standard en Premium. Als de laag niet is opgegeven, heeft het cluster de standard-laag.
clusterDefinition Yes Complex Type Hiermee geeft u informatie op over het clustertype en de configuraties
computeProfile Yes Complex Type Hiermee geeft u informatie op over de clustertopologie en de bijbehorende roleigenschappen

clusterDefinition

Elementnaam Vereist Type Description
Soort Ja Tekenreeks Hiermee geeft u het clustertype op.

Geldige waarden zijn hadoop, hbase, storm & spark
Configuraties Yes Woordenlijst Dit element is een woordenlijst van het configuratietype en de bijbehorende waardewoordenlijst.

gatewayconfiguratietype wordt gebruikt om de HTTP-gebruiker te configureren die wordt gebruikt om verbinding te maken met web-API's en de Ambari-portal

core-site-configuratietype wordt gebruikt om het standaardopslagaccount voor het cluster te configureren

computeProfile

Elementnaam Vereist Type Description
clusterVersion Ja Tekenreeks Hiermee geeft u de clusterversie op
Role Yes Matrix van complex type (rol) Hiermee geeft u informatie op over rollen in het cluster

role

Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Hiermee geeft u de rolnaam op
targetInstanceCount Ja Geheel getal Hiermee geeft u het aantal doelexemplaren voor de rol op
hardwareProfile Yes Complex Type Hiermee geeft u informatie op over het hardwareprofiel voor de rol
osProfile Yes Complex Type Hiermee geeft u informatie op over het besturingssysteemprofiel voor de rol

hardwareProfile

Elementnaam Vereist Type Description
vmSize Ja Tekenreeks Hiermee geeft u de grootte van de VM op. Raadpleeg HDInsight-configuratieopties (schuif eenmaal op deze koppeling omlaag naar Knooppunt-prijscategorieën) voor geldige grootten

osProfile

Elementnaam Vereist Type Description
linuxOperatingSystemProfile No Complex Type Hiermee geeft u de instellingen voor het Linux-besturingssysteem op
virtualNetworkProfile No Complex Type Hiermee geeft u instellingen voor virtuele netwerken op als het cluster wordt geïmplementeerd in een virtueel netwerk in het abonnement van de gebruiker
scriptActions No Matrix van complex type Lijst met scriptacties die moeten worden uitgevoerd op het cluster

linuxOperatingSystemProfile

Elementnaam Vereist Type Description
Gebruikersnaam Ja Tekenreeks SSH-gebruikersnaam
sshProfile No Complex Type Hiermee geeft u de SSH-sleutel.

Een van sshProfile of Password is vereist.
Wachtwoord Nee Tekenreeks Hiermee geeft u het SSH-wachtwoord op

Een van sshProfile of Password is vereist.

sshProfile

Elementnaam Vereist Type Description
publicKeys Ja Matrix Bevat een lijst met certificateData-objecten. De waarde is een openbare ssh-rsa-sleutel

virtualNetworkProfile

Elementnaam Vereist Type Beschrijving
id Ja Tekenreeks Virtual Network resource-id
subnet Ja Tekenreeks Hiermee geeft u de naam van het subnet op

scriptActions

Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Beschrijvende naam voor de scriptactie
Uri Ja Tekenreeks URL naar het scriptactiebestand
parameters Nee Tekenreeks Argumenten die moeten worden doorgegeven bij het uitvoeren van het scriptactiebestand

Antwoord

Als de validatie is voltooid en de aanvraag wordt geaccepteerd, retourneert de bewerking 200 (OK).

Statuscode: 200 OK

Antwoordtekst voor een Linux-cluster dat wordt gemaakt met behulp van de SSH-sleutel:

{
	"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"
	}
}
Elementnaam Type Description
provisioningState Tekenreeks Geeft de huidige inrichtingsstatus aan.
clusterState Tekenreeks Geeft de gedetailleerdere status van het HDInsight-cluster aan terwijl de inrichting wordt uitgevoerd.
createdDate Date Datum/tijd waarop de aanvraag voor het maken van het cluster is ontvangen
quotaInfo Complex Type Hiermee geeft u de kernen op die door het cluster worden gebruikt
fouten Matrix met foutberichten Bevat het foutbericht als provisioningState = 'failed'
connectivityEndpoints Complex Type Hiermee geeft u de openbare eindpunten voor het cluster op

connectivityEndpoints

Elementnaam Type Beschrijving
naam Tekenreeks Beschrijvende naam voor het connectiviteitseindpunt
protocol Tekenreeks Hiermee geeft u het protocol dat moet worden gebruikt (bijvoorbeeld: HTTPS, SSH)
location Tekenreeks Hiermee geeft u de URL op om verbinding te maken
poort int Hiermee geeft u de poort om verbinding te maken

Verwijderen

Hiermee verwijdert u een HDInsight-cluster.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Antwoord

HTTP 202 (geaccepteerd) om aan te geven dat de bewerking asynchroon wordt voltooid. Asynchrone polling retourneert een 204 (NoContent) zodra de bewerking is voltooid.

Opmerkingen

Zie Asynchrone bewerkingen (202 Geaccepteerd en Locatieheader) als u de voortgang van een aanvraag voor het verwijderen van een cluster wilt bijhouden

Ophalen

Hiermee haalt u de details/eigenschappen van het opgegeven cluster op.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Antwoord

De bewerking retourneert 200 (OK) als de aanvraag is voltooid

Statuscode: 200 OK

De antwoordtekst is hetzelfde als het maken van een cluster.

Antwoordtekst voor linux-clusterdetails

{  
    "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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
Elementnaam Type Description
provisioningState Tekenreeks Geeft de huidige inrichtingsstatus aan.
clusterState Tekenreeks Geeft de gedetailleerdere status van het HDInsight-cluster aan terwijl de inrichting wordt uitgevoerd.
createdDate Date Datum/tijd waarop de aanvraag voor het maken van het cluster is ontvangen
quotaInfo Complex Type Hiermee geeft u de kernen op die door het cluster worden gebruikt
fouten Matrix met foutberichten Bevat het foutbericht als provisioningState = 'failed'
connectivityEndpoints Complex Type Hiermee geeft u de openbare eindpunten voor het cluster op

connectivityEndpoints

Elementnaam Type Beschrijving
naam Tekenreeks Beschrijvende naam voor het connectiviteitseindpunt
protocol Tekenreeks Hiermee geeft u het protocol dat moet worden gebruikt (bijvoorbeeld: HTTPS, SSH)
location Tekenreeks Hiermee geeft u de URL op om verbinding te maken
poort int Hiermee geeft u de poort om verbinding te maken

Lijstconfiguraties

Hiermee worden alle details van de clusterconfiguratie (inclusief gevoelige informatie) opgehaald.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Antwoord

HTTP 200 (OK) na voltooiing van de bewerking.

Voorbeeld van een reactie:

"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"  
      }  
}
Elementnaam Type Description
Configuraties Woordenlijst Dit element is een woordenlijst van het configuratietype en de bijbehorende waardewoordenlijst.
gatewayconfiguratietype wordt gebruikt om de HTTP-gebruiker te configureren die wordt gebruikt om verbinding te maken met web-API's en de Ambari-portal
core-site-configuratietype wordt gebruikt om het standaardopslagaccount voor het cluster te configureren

Configuratie ophalen

Hiermee haalt u details op over één configuratietype (gevoelige waarden worden weggelaten).

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Antwoord

HTTP 200 (OK) na voltooiing van de bewerking.

Voorbeeld van een reactie:

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

Gateway-instellingen ophalen

Met deze bewerking worden HTTP-referenties voor de clustergateway opgehaald.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Antwoord

HTTP 200 (OK) na voltooiing van de bewerking.

Voorbeeld van een reactie:

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

Gateway-instellingen bijwerken

Met deze bewerking kunnen gebruikers de HTTP-referenties van de clustergateway wijzigen.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/updateGatewaySettings?api-version={api-version} 
{  
     "restAuthCredential.isEnabled": true,  
     "restAuthCredential.username": "username",  
     "restAuthCredential.password": "Password123!"  
}

Antwoord

HTTP 202 (geaccepteerd) na het voltooien van de bewerking.

Connectiviteitsinstellingen wijzigen (AFGESCHAFT)

Met deze bewerking kunnen gebruikers de HTTPS-connectiviteit met het cluster in-/uitschakelen.

Gebruik in plaats daarvan updateGatewaySettings .

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Connectiviteit inschakelen

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

Lijst per resourcegroep

Lijsten alle clusters in het abonnement van de gebruiker in de opgegeven resourcegroep.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Antwoord

De bewerking retourneert 200 (OK) als de aanvraag is voltooid.

Statuscode: 200 OK

Antwoordtekst is een matrix met clusterdetails. Zie Clustereigenschappen ophalen voor meer informatie.

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

Lijst per abonnement

Lijsten alle clusters in het abonnement van de gebruiker.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
GET https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Antwoord

De bewerking retourneert 200 (OK) als de aanvraag is voltooid.

Statuscode: 200 OK

Antwoordtekst is een matrix met clusterdetails.

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

Connectiviteit uitschakelen

{  
   "restAuthCredential.isEnabled": false  
}
Elementnaam Vereist Type Description
restAuthCredential.isEnabled Ja Booleaans Hiermee geeft u op of connectiviteit moet worden in- of uitgeschakeld
restAuthCredential.username Nee Tekenreeks Vereist als isEnabled=true
Hiermee geeft u de gebruikersnaam voor connectiviteitsinstellingen op
restAuthCredential.password Nee Tekenreeks Vereist als isEnabled=true
Hiermee geeft u het wachtwoord voor connectiviteitsinstellingen op

Antwoord

HTTP 202 (geaccepteerd) om aan te geven dat de bewerking asynchroon wordt voltooid. Asynchrone polling retourneert een 204 (NoContent) zodra de bewerking is voltooid.

Opmerkingen

Zie Asynchrone bewerkingen (202 geaccepteerd en locatieheader) als u de voortgang van een aanvraag voor het verwijderen van een cluster wilt bijhouden

RDP-instellingen wijzigen (alleen Windows-cluster)

Met deze bewerking kan een gebruiker RDP in-/uitschakelen. Het is van toepassing op Windows-clusters.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

Aanvraagbody

RDP inschakelen

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

RDP uitschakelen

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

osProfile

Elementnaam Vereist Type Description
windowsOperatingSystemProfile No Complex Type Hiermee geeft u instellingen op die betrekking hebben op het Windows-besturingssysteem

windowsOperatingSystemProfile

Elementnaam Vereist Type Description
rdpSettings No Complex Type Hiermee geeft u RDP-instellingen voor Windows-clusters op

rdpSettings

Elementnaam Vereist Type Description
gebruikersnaam Ja Tekenreeks Hiermee geeft u de RDP-gebruikersnaam op
wachtwoord Ja Tekenreeks Hiermee geeft u het wachtwoord voor de RDP-gebruiker op
vervaldatumdatum Ja Date Vervaldatum voor de RDP-referenties

Antwoord

De bewerking retourneert 200 (OK) als de aanvraag is voltooid

Statuscode: 200 OK

De antwoordtekst is hetzelfde als Een cluster maken.

Scriptacties uitvoeren op een actief cluster (alleen Linux-cluster)

Voer de scriptactie uit op een actief cluster.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

Aanvraagbody

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

scriptActions

Elementnaam Vereist Type Beschrijving
naam Ja Tekenreeks Hiermee geeft u de naam van de scriptactie op
Uri Ja Tekenreeks Hiermee geeft u de URI van de scriptactie op
parameters Ja Tekenreeks Hiermee geeft u de parameters op die vereist zijn voor de scriptactie
rollen Yes Matrix van tekenreeks Hiermee geeft u de doelrollen op waarop de scriptactie wordt uitgevoerd
persistOnSuccess Ja Booleaans Hiermee geeft u op of de scriptacties behouden blijven na geslaagde uitvoeringen

Antwoord

Als de validatie is voltooid en de aanvraag wordt geaccepteerd, retourneert de bewerking 202 (Geaccepteerd).

Statuscode: 202 (geaccepteerd)

Alle persistente scriptacties voor een cluster weergeven (alleen Linux-cluster)

Met deze bewerking worden alle persistente scripts van het opgegeven cluster geretourneerd.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

Antwoord

HTTP 200 (OK) na voltooiing van de bewerking.

Statuscode: 200 OK

Voorbeeld van een reactie:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
Elementnaam Type Beschrijving
naam Tekenreeks Hiermee geeft u de naam van de scriptactie.
Uri Tekenreeks Hiermee geeft u de URI van de scriptactie op.
parameters Tekenreeks Hiermee geeft u de parameters op die vereist zijn voor de scriptactie
rollen Matrix van tekenreeks Hiermee geeft u de doelrollen op waarop de scriptactie wordt uitgevoerd.
applicationName Tekenreeks Hiermee geeft u de bijbehorende toepassing waaraan het script is gekoppeld. applicationName is null als het script wordt geleverd door gebruikers

Een permanente scriptactie verwijderen voor een cluster (alleen Linux-cluster)

Met deze bewerking wordt een persistente HDInsight-scriptactie voor een cluster verwijderd.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

Antwoord

  • HTTP 200 (OK) om aan te geven dat de scriptactie is verwijderd uit de lijst met persistente scriptacties.

  • HTTP 404 (NotFound) om aan te geven dat er geen bestaande persistente scriptactie met bijbehorende scriptName is.

Uitvoering van scriptactie ophalen uit de geschiedenis (alleen Linux-clusters)

Deze bewerking retourneert de meest recente uitvoering van de scriptactie van het opgegeven cluster of uitvoeringsdetails voor een afzonderlijke scriptuitvoering.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptExecutionHistory/{script Execution Id}?api-version={api-version}

Antwoord

De bewerking retourneert 200 (OK) als de aanvraag is voltooid. Antwoordtekst is een matrix met details van de uitvoering van scripts of één scriptuitvoeringsdetails als scriptExecutionId is opgegeven. Hieronder ziet u een voorbeeld van een detail voor de uitvoering van een script.

Statuscode: 200 (OK)

Voorbeeld van een reactie:

{  
  "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"  
}
Elementnaam Type Description
scriptExecutionId Lange Hiermee geeft u de uitvoerings-id van de scriptactie.
naam Tekenreeks Hiermee geeft u de naam van de scriptactie.
applicationName Tekenreeks Hiermee geeft u de bijbehorende toepassing waaraan het script is gekoppeld. applicationName is null als het script wordt geleverd door gebruikers
Uri Tekenreeks Hiermee geeft u de URI van de scriptactie.
parameters Tekenreeks Hiermee geeft u de parameters vereist voor de scriptactie
rollen Matrix van tekenreeks Hiermee geeft u de doelrollen op waarop de scriptactie wordt uitgevoerd.
startTime DateTime Hiermee geeft u de begintijd van de uitvoering van de scriptactie op
endTime DateTime Hiermee geeft u de eindtijd van de uitvoering van de scriptactie op
status Tekenreeks Hiermee geeft u de status van de uitvoering van de scriptactie op
bewerking Tekenreeks Hiermee geeft u de reden op waarom de scriptactie is uitgevoerd. ScaleUp betekent bijvoorbeeld dat de scriptactie is uitgevoerd tijdens het omhoog schalen van het cluster.
executionSummary Matrix van complex type Hiermee geeft u de samenvatting van de uitvoering in termen van het aantal hosts geslaagd en het aantal hosts niet om het script uit te voeren.
foutopsporinginformatie Tekenreeks Hiermee geeft u gedetailleerde foutopsporingsinformatie voor het script op. foutopsporingInformatie wordt alleen geretourneerd wanneer een scriptExecutionId is opgegeven in de aanvraag.

executionSummary

Elementnaam Type Description
status Tekenreeks Hiermee geeft u de status van de uitvoering op afzonderlijke hosts.
instanceCount Int Hiermee geeft u het aantal uitvoeringen met de bijbehorende status.

Een script promoveren vanuit de uitvoeringsgeschiedenis van scriptactie om te behouden (alleen Linux-cluster)

Met deze bewerking wordt een HDInsight-script uit de uitvoeringsgeschiedenis van het script opgeslagen.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptExecutionHistory/{script Execution Id}/promote?api-version={api-version}

Antwoord

  • HTTP 200 (OK) om aan te geven dat de scriptactie is gepromoveerd.

  • HTTP 404 (NotFound) om aan te geven dat er geen bestaande scriptactie wordt uitgevoerd met de bijbehorende scriptExecutionId.

Formaat wijzigen

Hiermee wijzigt u de grootte van een bestaand HDInsight-cluster.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/roles/{role name}/resize?api-version={api-version}

Hieronder ziet u een voorbeeldaanvraag voor het bijwerken van tags voor een cluster

{  
    "targetInstanceCount": 10  
}
Elementnaam Vereist Type Description
targetInstanceCount Yes Int Hiermee geeft u het aantal nieuwe exemplaren voor de rol op

Antwoord

HTTP 202 (geaccepteerd) om aan te geven dat de bewerking asynchroon wordt voltooid. Asynchrone polling retourneert een 204 (NoContent) zodra de bewerking is voltooid.

Opmerkingen

Zie Asynchrone bewerkingen (202 geaccepteerd en locatieheader) als u de voortgang van een aanvraag voor het verwijderen van een cluster wilt bijhouden

Bijwerken

Updates tags voor een cluster.

Alle andere updates zijn afzonderlijke acties die afzonderlijk worden beschreven.

Aanvraag

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door clusters.

Methode Aanvraag-URI
PATCH https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Hieronder ziet u een voorbeeldaanvraag voor het bijwerken van tags voor een cluster

{   
    "tags": {"department": "finance"}  
}
Elementnaam Vereist Type Description
tags Ja Tekenreeks Hiermee geeft u de tags op die worden toegewezen aan het cluster. Zie Tags gebruiken om uw Azure-resources te organiseren voor meer informatie over het gebruik van tags.

Antwoord

De bewerking retourneert 200 (OK) als de aanvraag is voltooid.

Statuscode: 200 OK

De antwoordtekst is hetzelfde als Een cluster maken.