Cluster REST API in Azure HDInsight

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.