KLUSTER-REST API i Azure HDInsight

Skapa

Skapar ett kluster i den angivna prenumerationen.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

I följande exempel visas begärandetexten för att skapa ett Linux-baserat hadoop-kluster. Exempel på hur du skapar kluster på andra sätt finns i avsnittet Exempel nedan.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Elementnamn	Krävs	Typ	Description
id	Ja	Sträng	Anger resursidentifieraren för klustret.
name	Ja	Sträng	Anger namnet på klustret.
typ	Ja	Sträng	Anger typen av kluster.
location	Ja	Sträng	Anger den Azure-plats som stöds där klustret ska skapas. Mer information finns i Lista alla tillgängliga geoplatser.
tags	Inga	Sträng	Anger de taggar som ska tilldelas till klustret. Mer information om hur du använder taggar finns i Använda taggar för att organisera dina Azure-resurser.
Egenskaper	Yes	Komplex typ	Anger egenskaperna för klustret.

Egenskaper

Elementnamn	Krävs	Typ	Description
clusterVersion	Ja	Sträng	Anger klusterversionen
osType	Ja	Sträng	Anger operativsystemet för klustret. Giltiga värden är Linux och Windows
clusterDefinition	Yes	Komplex typ	Anger information om klustertyp och konfigurationer
computeProfile	Yes	Komplex typ	Anger information om klustertopologin och tillhörande rollegenskaper

clusterDefinition

Elementnamn	Krävs	Typ	Description
Typ	Ja	Sträng	Anger klustertypen. Giltiga värden är hadoop, hbase, storm & spark
Konfigurationer	Yes	Ordlista	Det här elementet är en ordlista av konfigurationstyp och dess associerade värdeordlista. gatewaykonfigurationstypen används för att konfigurera http-användaren som används för att ansluta till webb-API:er och Ambari-portalen konfigurationstypen core-site används för att konfigurera standardlagringskontot för klustret

computeProfile

Elementnamn	Krävs	Typ	Description
clusterVersion	Ja	Sträng	Anger klusterversionen
Roll	Yes	Matris med komplex typ (roll)	Anger information om roller i klustret

roll

Elementnamn	Krävs	Typ	Description
name	Ja	Sträng	Anger rollnamnet
targetInstanceCount	Yes	Integer	Anger antalet målinstanser för rollen
hardwareProfile	Yes	Komplex typ	Anger information om maskinvaruprofilen för rollen
osProfile	Yes	Komplex typ	Anger information om os-profilen för rollen

hardwareProfile

Elementnamn	Krävs	Typ	Description
vmSize	Ja	Sträng	Anger storleken på den virtuella datorn. Se konfigurationsalternativ för HDInsight (en gång på den här länken bläddrar du ned till nodprisnivåer) för giltiga storlekar

osProfile

Elementnamn	Krävs	Typ	Description
linuxOperatingSystemProfile	No	Komplex typ	Anger de linux OS-relaterade inställningarna
windowsOperatingSystemProfile	No	Komplex typ	Anger windows OS-relaterade inställningar
virtualNetworkProfile	No	Komplex typ	Anger virtuella nätverksrelaterade inställningar om klustret distribueras i ett virtuellt nätverk i användarens prenumeration
scriptActions	No	Matris av komplex typ	Lista över skriptåtgärder som ska köras i klustret

linuxOperatingSystemProfile

Elementnamn	Krävs	Typ	Description
Användarnamn	Ja	Sträng	SSH-användarnamn
sshProfile	No	Komplex typ	Anger SSH-nyckeln. Ett av sshProfile eller lösenord krävs.
Lösenord	Inga	Sträng	Anger SSH-lösenordet Ett av sshProfile eller lösenord krävs.

sshProfile

Elementnamn	Krävs	Typ	Description
publicKeys	Yes	Matris	Innehåller en lista över certificateData-objekt. Värdet är en offentlig ssh-rsa-nyckel

windowsOperatingSystemProfile

Elementnamn	Krävs	Typ	Description
rdpSettings	No	Komplex typ	Anger RDP-inställningar för Windows-kluster

rdpSettings

Elementnamn	Krävs	Typ	Description
användarnamn	Ja	Sträng	Anger RDP-användarnamnet
password	Ja	Sträng	Anger lösenordet för RDP-användaren
expiryDate	Yes	Date	Förfallodatum för RDP-autentiseringsuppgifterna

virtualNetworkProfile

Elementnamn	Krävs	Typ	Description
id	Ja	Sträng	Virtual Network resurs-ID
subnet	Ja	Sträng	Anger undernätets namn

scriptActions

Elementnamn	Krävs	Typ	Description
name	Ja	Sträng	Eget namn för skriptåtgärden
Uri	Ja	Sträng	URL till skriptåtgärdsfilen
parametrar	Inga	Sträng	Argument som ska skickas när skriptåtgärdsfilen körs

Svarsåtgärder

Om valideringen är klar och begäran godkänns returnerar åtgärden 200 (OK).

Statuskod: 200 OK

Svarstext för ett Linux-kluster skapar med ssh-nyckel:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Elementnamn	Typ	Description
provisioningState	Sträng	Anger aktuellt etableringstillstånd.
clusterState	Sträng	Anger det mer detaljerade HDInsight-klustertillståndet när etablering pågår.
createdDate	Date	Datetime när begäran om att skapa klustret togs emot
quotaInfo	Komplex typ	Anger kärnorAnvänds av klustret
fel	Matris med felmeddelanden	Innehåller felmeddelandet om provisioningState = "failed"
connectivityEndpoints	Komplex typ	Anger de offentliga slutpunkterna för klustret

connectivityEndpoints

Elementnamn	Typ	Description
name	Sträng	Eget namn för anslutningsslutpunkten
Protokollet	Sträng	Anger vilket protokoll som ska användas (till exempel HTTPS, SSH)
location	Sträng	Anger url:en för att ansluta
port	int	Anger porten som ska anslutas

Skapa ett premium, domänanslutet HDInsight-kluster (endast Linux, förhandsversion)

Skapa ett premiumdomänanslutet kluster med Apache Ranger. Användaren måste ange SecurityProfile i begärandetexten för att skapa ett säkert kluster.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

I följande exempel visas begärandetexten för att skapa ett Linux-baserat, premium, domänanslutet Hadoop-kluster.

{
	"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"
						}
					}
				}
			]
		}
	}
}  
  

Elementnamn	Krävs	Typ	Description
id	Ja	Sträng	Anger resursidentifieraren för klustret.
name	Ja	Sträng	Anger namnet på klustret.
typ	Ja	Sträng	Anger typen av kluster.
location	Ja	Sträng	Anger den Azure-plats som stöds där klustret ska skapas. Mer information finns i Lista alla tillgängliga geo-platser.
tags	Inga	Sträng	Anger de taggar som ska tilldelas till klustret. Mer information om hur du använder taggar finns i Använda taggar för att organisera dina Azure-resurser.
Egenskaper	Yes	Komplex typ	Anger egenskaperna för klustret.

Egenskaper

Elementnamn	Krävs	Typ	Description
clusterVersion	Ja	Sträng	Anger klusterversionen
osType	Ja	Sträng	Anger operativsystemet för klustret. Giltigt värde är Linux eftersom endast Linux-klustertyper kan ansluta till en Azure AD domän.
nivå	Inga	Sträng	Standardvärdet är standard. Giltiga värden är standard och premium. Om inget värde anges antas värdet vara standard. Anger nivån för klustret. Domänanslutna kluster stöds bara på premiumnivå
clusterDefinition	Yes	Komplex typ	Anger information om klustertyp och konfigurationer
computeProfile	Yes	Komplex typ	Anger information om klustertopologin och tillhörande rollegenskaper
securityProfile	No	Komplex typ	Om ett säkert, domänanslutet kluster skapas anger det här elementet de Active Directory-relaterade inställningarna

clusterDefinition

Elementnamn	Krävs	Typ	Description
Typ	Ja	Sträng	Anger klustertypen. Giltiga värden är hadoop, hbase, storm & spark
Konfigurationer	Yes	Ordlista	Det här elementet är en ordlista av konfigurationstyp och dess associerade värdeordlista. gatewaykonfigurationstypen används för att konfigurera http-användaren som används för att ansluta till webb-API:er och Ambari-portalen konfigurationstypen core-site används för att konfigurera standardlagringskontot för klustret

computeProfile

Elementnamn	Krävs	Typ	Description
clusterVersion	Ja	Sträng	Anger klusterversionen
Roll	Yes	Matris av komplex typ (roll)	Anger information om roller i klustret

securityProfile

Elementnamn	Krävs	Typ	Description
directoryType	Ja	Sträng	Typ av LDAP-katalog som används. För närvarande är "ActiveDirectory" det enda värde som stöds.
domän	Ja	Sträng	Active Directory-domän för klustret
organizationalUnitDN	Ja	Sträng	Unikt namn på organisationsenheten i Active Directory där användar- och datorkonton skapas
ldapsUrls	Yes	Strängmatris	URL:er för en eller flera LDAPS-servrar för Active Directory
domainUserName	Ja	Sträng	Ett domänanvändarkonto med tillräcklig behörighet för att skapa klustret. Den ska vara i user@domain format
domainUserPassword	Ja	Sträng	Lösenord för domänanvändarkontot
clusterUsersGroupDNS	No	Strängmatris	Unika namn på de Active Directory-grupper som ska vara tillgängliga i Ambari och Apache Ranger

roll

Elementnamn	Krävs	Typ	Description
name	Ja	Sträng	Anger rollnamnet
targetInstanceCount	Yes	Integer	Anger antalet målinstanser för rollen
hardwareProfile	Yes	Komplex typ	Anger information om maskinvaruprofilen för rollen
osProfile	Yes	Komplex typ	Anger information om os-profilen för rollen

hardwareProfile

Elementnamn	Krävs	Typ	Description
vmSize	Ja	Sträng	Anger storleken på den virtuella datorn. Se konfigurationsalternativ för HDInsight (en gång på den här länken bläddrar du ned till Nodprisnivåer) för giltiga storlekar

osProfile

Elementnamn	Krävs	Typ	Description
linuxOperatingSystemProfile	No	Komplex typ	Anger de Linux OS-relaterade inställningarna
virtualNetworkProfile	No	Komplex typ	Anger inställningar för virtuellt nätverk om klustret distribueras i ett virtuellt nätverk i användarens prenumeration
scriptActions	No	Matris av komplex typ	Lista över skriptåtgärder som ska köras i klustret

linuxOperatingSystemProfile

Elementnamn	Krävs	Typ	Description
Användarnamn	Ja	Sträng	SSH-användarnamn
sshProfile	No	Komplex typ	Anger SSH-nyckeln. En av sshProfile eller lösenord krävs.
Lösenord	Inga	Sträng	Anger SSH-lösenordet En av sshProfile eller lösenord krävs.

sshProfile

Elementnamn	Krävs	Typ	Description
publicKeys	Yes	Matris	Innehåller en lista över certificateData-objekt. Värdet är en offentlig ssh-rsa-nyckel

virtualNetworkProfile

Elementnamn	Krävs	Typ	Description
id	Ja	Sträng	Virtual Network resurs-ID
subnet	Ja	Sträng	Anger undernätsnamnet

scriptActions

Elementnamn	Krävs	Typ	Description
name	Ja	Sträng	Eget namn för skriptåtgärden
Uri	Ja	Sträng	URL till skriptåtgärdsfilen
parametrar	Inga	Sträng	Argument som ska skickas när skriptåtgärdsfilen körs

Svarsåtgärder

Om verifieringen är klar och begäran godkänns returnerar åtgärden 200 (OK).

Statuskod: 200 OK

Svarstexten för ett Linux-kluster skapar med hjälp av ssh-nyckeln:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Elementnamn	Typ	Description
provisioningState	Sträng	Anger det aktuella etableringstillståndet.
clusterState	Sträng	Anger det mer detaljerade HDInsight-klustertillståndet under etableringen.
createdDate	Date	Datetime när begäran om att skapa klustret togs emot
quotaInfo	Komplex typ	Anger de kärnor som används av klustret
fel	Matris med felmeddelanden	Innehåller felmeddelandet om provisioningState = "failed"
connectivityEndpoints	Komplex typ	Anger de offentliga slutpunkterna för klustret

connectivityEndpoints

Elementnamn	Typ	Description
name	Sträng	Eget namn för anslutningsslutpunkten
Protokollet	Sträng	Anger vilket protokoll som ska användas (exempel: HTTPS, SSH)
location	Sträng	Anger url:en som ska anslutas
port	int	Anger porten som ska anslutas

Skapa ett kluster med Azure Data Lake Store som standardfilsystem

Skapar ett kluster i den angivna prenumerationen med Azure Data Lake Store som standardfilsystem. Ange ett ClusterIdentity-objekt i begärandetexten och konfigurera egenskapen default-filesystem med lämplig Data Lake Store-URL.

Azure Data Lake kan konfigureras som standardfilsystem för klusterversioner från och med 3.5.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

I följande exempel visas begärandetexten för att skapa ett Linux-baserat Hadoop-kluster med Azure Data Lake Store som standardfilsystem för klustret.

{
	"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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}  

Elementnamn	Krävs	Typ	Description
id	Ja	Sträng	Anger resursidentifieraren för klustret.
name	Ja	Sträng	Anger namnet på klustret.
typ	Ja	Sträng	Anger typen av kluster.
location	Ja	Sträng	Anger den Azure-plats som stöds där klustret ska skapas. Mer information finns i Lista alla tillgängliga geoplatser.
tags	Inga	Sträng	Anger de taggar som ska tilldelas till klustret. Mer information om hur du använder taggar finns i Använda taggar för att organisera dina Azure-resurser.
Egenskaper	Yes	Komplex typ	Anger egenskaperna för klustret.

Egenskaper

Elementnamn	Krävs	Typ	Description
clusterVersion	Ja	Sträng	Anger klusterversionen
osType	Ja	Sträng	Anger operativsystemet för klustret. Giltigt värde är Linux
nivå	Inga	Sträng	Anger nivån för klustret. Giltiga värden är standard och premium. Om nivån inte anges kommer klustret att vara på standardnivå.
clusterDefinition	Yes	Komplex typ	Anger information om klustertyp och konfigurationer
computeProfile	Yes	Komplex typ	Anger information om klustertopologin och tillhörande rollegenskaper

clusterDefinition

Elementnamn	Krävs	Typ	Description
Typ	Ja	Sträng	Anger klustertypen. Giltiga värden är hadoop, hbase, storm & spark
Konfigurationer	Yes	Ordlista	Det här elementet är en ordlista av konfigurationstyp och dess associerade värdeordlista. gatewaykonfigurationstypen används för att konfigurera http-användaren som används för att ansluta till webb-API:er och Ambari-portalen konfigurationstypen core-site används för att konfigurera standardlagringskontot för klustret

computeProfile

Elementnamn	Krävs	Typ	Description
clusterVersion	Ja	Sträng	Anger klusterversionen
Roll	Yes	Matris av komplex typ (roll)	Anger information om roller i klustret

roll

Elementnamn	Krävs	Typ	Description
name	Ja	Sträng	Anger rollnamnet
targetInstanceCount	Yes	Integer	Anger antalet målinstanser för rollen
hardwareProfile	Yes	Komplex typ	Anger information om maskinvaruprofilen för rollen
osProfile	Yes	Komplex typ	Anger information om os-profilen för rollen

hardwareProfile

Elementnamn	Krävs	Typ	Description
vmSize	Ja	Sträng	Anger storleken på den virtuella datorn. Se konfigurationsalternativ för HDInsight (en gång på den här länken bläddrar du ned till nodprisnivåer) för giltiga storlekar

osProfile

Elementnamn	Krävs	Typ	Description
linuxOperatingSystemProfile	No	Komplex typ	Anger de linux OS-relaterade inställningarna
virtualNetworkProfile	No	Komplex typ	Anger virtuella nätverksrelaterade inställningar om klustret distribueras i ett virtuellt nätverk i användarens prenumeration
scriptActions	No	Matris av komplex typ	Lista över skriptåtgärder som ska köras i klustret

linuxOperatingSystemProfile

Elementnamn	Krävs	Typ	Description
Användarnamn	Ja	Sträng	SSH-användarnamn
sshProfile	No	Komplex typ	Anger SSH-nyckeln. En av sshProfile eller lösenord krävs.
Lösenord	Inga	Sträng	Anger SSH-lösenordet En av sshProfile eller lösenord krävs.

sshProfile

Elementnamn	Krävs	Typ	Description
publicKeys	Yes	Matris	Innehåller en lista över certificateData-objekt. Värdet är en offentlig ssh-rsa-nyckel

virtualNetworkProfile

Elementnamn	Krävs	Typ	Description
id	Ja	Sträng	Virtual Network resurs-ID
subnet	Ja	Sträng	Anger undernätsnamnet

scriptActions

Elementnamn	Krävs	Typ	Description
name	Ja	Sträng	Eget namn för skriptåtgärden
Uri	Ja	Sträng	URL till skriptåtgärdsfilen
parametrar	Inga	Sträng	Argument som ska skickas när skriptåtgärdsfilen körs

Svarsåtgärder

Om verifieringen är klar och begäran godkänns returnerar åtgärden 200 (OK).

Statuskod: 200 OK

Svarstexten för ett Linux-kluster skapar med hjälp av ssh-nyckeln:

{
	"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"
	}
}  

Elementnamn	Typ	Description
provisioningState	Sträng	Anger det aktuella etableringstillståndet.
clusterState	Sträng	Anger det mer detaljerade HDInsight-klustertillståndet under etableringen.
createdDate	Date	Datetime när begäran om att skapa klustret togs emot
quotaInfo	Komplex typ	Anger de kärnor som används av klustret
fel	Matris med felmeddelanden	Innehåller felmeddelandet om provisioningState = "failed"
connectivityEndpoints	Komplex typ	Anger de offentliga slutpunkterna för klustret

connectivityEndpoints

Elementnamn	Typ	Description
name	Sträng	Eget namn för anslutningsslutpunkten
Protokollet	Sträng	Anger vilket protokoll som ska användas (exempel: HTTPS, SSH)
location	Sträng	Anger url:en som ska anslutas
port	int	Anger porten som ska anslutas

Ta bort

Tar bort ett HDInsight-kluster.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
DELETE	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Svarsåtgärder

HTTP 202 (accepterad) för att indikera att åtgärden slutförs asynkront. Async-avsökning returnerar en 204 (NoContent) när åtgärden har slutförts.

Kommentarer

Information om hur du spårar förloppet för en borttagningsklusterbegäran finns i Asynkrona åtgärder (202-rubriken Godkänd och Plats)

Hämta

Hämtar information/egenskaper för det angivna klustret.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Svarsåtgärder

Åtgärden returnerar 200 (OK) om begäran har slutförts

Statuskod: 200 OK

Svarstexten är samma som skapa kluster.

Svarstext för linux-klusterinformation

{  
    "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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}  
  

Elementnamn	Typ	Description
provisioningState	Sträng	Anger det aktuella etableringstillståndet.
clusterState	Sträng	Anger det mer detaljerade HDInsight-klustertillståndet under etableringen.
createdDate	Date	Datetime när begäran om att skapa klustret togs emot
quotaInfo	Komplex typ	Anger de kärnor som används av klustret
fel	Matris med felmeddelanden	Innehåller felmeddelandet om provisioningState = "failed"
connectivityEndpoints	Komplex typ	Anger de offentliga slutpunkterna för klustret

connectivityEndpoints

Elementnamn	Typ	Description
name	Sträng	Eget namn för anslutningsslutpunkten
Protokollet	Sträng	Anger vilket protokoll som ska användas (exempel: HTTPS, SSH)
location	Sträng	Anger url:en som ska anslutas
port	int	Anger porten som ska anslutas

Lista konfigurationer

Hämtar all klusterkonfigurationsinformation (inklusive känslig information).

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Svarsåtgärder

HTTP 200 (OK) när åtgärden har slutförts.

Exempelsvar:

"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"  
      }  
}  
  

Elementnamn	Typ	Description
Konfigurationer	Ordlista	Det här elementet är en ordlista av konfigurationstyp och dess associerade värdeordlista. gatewaykonfigurationstypen används för att konfigurera http-användaren som används för att ansluta till webb-API:er och Ambari-portalen konfigurationstypen core-site används för att konfigurera standardlagringskontot för klustret

Hämta konfiguration

Hämtar information om en enskild konfigurationstyp (utelämnar känsliga värden).

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Svarsåtgärder

HTTP 200 (OK) när åtgärden har slutförts.

Exempelsvar:

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

Hämta gatewayinställningar

Den här åtgärden hämtar HTTP-autentiseringsuppgifter för klustergatewayen.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Svarsåtgärder

HTTP 200 (OK) när åtgärden har slutförts.

Exempelsvar:

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

Uppdatera gatewayinställningar

Med den här åtgärden kan användare ändra HTTP-autentiseringsuppgifterna för klustergatewayen.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
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!"  
}  

Svarsåtgärder

HTTP 202 (godkänd) när åtgärden har slutförts.

Ändra anslutningsinställningar (INAKTUELL)

Med den här åtgärden kan användare aktivera/inaktivera HTTPS-anslutningen till klustret.

Använd updateGatewaySettings i stället.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Så här aktiverar du anslutning

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

Lista efter resursgrupp

Listor alla kluster i användarens prenumeration i den angivna resursgruppen.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
GET	https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Svarsåtgärder

Åtgärden returnerar 200 (OK) om begäran har slutförts.

Statuskod: 200 OK

Svarstexten är en matris med klusterinformation. Mer information finns i Hämta klusteregenskaper.

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

Lista efter prenumeration

Listor alla kluster i användarens prenumeration.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
GET	https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Svarsåtgärder

Åtgärden returnerar 200 (OK) om begäran har slutförts.

Statuskod: 200 OK

Svarstexten är en matris med klusterinformation.

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

Inaktivera anslutning

{  
   "restAuthCredential.isEnabled": false  
}  
  

Elementnamn	Krävs	Typ	Description
restAuthCredential.isEnabled	Yes	Boolesk	Anger om anslutningen ska vara aktiverad eller inaktiverad
restAuthCredential.username	Inga	Sträng	Krävs om isEnabled=true Anger användarnamnet för anslutningsinställningar
restAuthCredential.password	Inga	Sträng	Krävs om isEnabled=true Anger lösenordet för anslutningsinställningar

Svarsåtgärder

HTTP 202 (accepterad) för att indikera att åtgärden kommer att slutföras asynkront. Async-avsökning returnerar en 204 (NoContent) när åtgärden har slutförts.

Kommentarer

Information om hur du spårar förloppet för en borttagningsklusterbegäran finns i Asynkrona åtgärder (202-godkända och platshuvud)

Ändra RDP-inställningar (endast Windows-kluster)

Med den här åtgärden kan en användare aktivera/inaktivera RDP. Den gäller för Windows-baserade kluster.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

Begärandetext

Aktivera RDP

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

Inaktivera RDP

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

osProfile

Elementnamn	Krävs	Typ	Description
windowsOperatingSystemProfile	No	Komplex typ	Anger windows OS-relaterade inställningar

windowsOperatingSystemProfile

Elementnamn	Krävs	Typ	Description
rdpSettings	No	Komplex typ	Anger RDP-inställningar för Windows-kluster

rdpSettings

Elementnamn	Krävs	Typ	Description
användarnamn	Ja	Sträng	Anger RDP-användarnamnet
password	Ja	Sträng	Anger lösenordet för RDP-användaren
expiryDate	Yes	Date	Förfallodatum för RDP-autentiseringsuppgifterna

Svarsåtgärder

Åtgärden returnerar 200 (OK) om begäran har slutförts

Statuskod: 200 OK

Svarstexten är samma som Skapa ett kluster.

Köra skriptåtgärder på ett kluster som körs (endast Linux-kluster)

Kör skriptåtgärden på ett kluster som körs.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

Begärandetext

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

scriptActions

Elementnamn	Krävs	Typ	Description
name	Ja	Sträng	Anger namnet på skriptåtgärden
Uri	Ja	Sträng	Anger URI för skriptåtgärden
parametrar	Ja	Sträng	Anger de parametrar som krävs av skriptåtgärden
roller	Yes	Strängmatris	Anger de målroller som skriptåtgärden körs på
persistOnSuccess	Yes	Boolesk	Anger om skriptåtgärderna ska sparas efter lyckade körningar

Svarsåtgärder

Om valideringen är klar och begäran godkänns returnerar åtgärden 202 (accepterad).

Statuskod: 202 (godkänd)

Visa en lista över alla beständiga skriptåtgärder för ett kluster (endast Linux-kluster)

Den här åtgärden returnerar alla beständiga skriptåtgärder för det angivna klustret.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

Svarsåtgärder

HTTP 200 (OK) när åtgärden har slutförts.

Statuskod: 200 OK

Exempelsvar:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}  

Elementnamn	Typ	Description
name	Sträng	Anger namnet på skriptåtgärden.
Uri	Sträng	Anger URI för skriptåtgärden.
parametrar	Sträng	Anger de parametrar som krävs av skriptåtgärden
roller	Strängmatris	Anger de målroller som skriptåtgärden körs på.
applicationName	Sträng	Anger motsvarande program som skriptet är associerat med. applicationName är null om skriptet tillhandahålls av användare

Ta bort en bestående skriptåtgärd för ett kluster (endast Linux-kluster)

Den här åtgärden tar bort en beständig SKRIPTåtgärd i HDInsight för ett kluster.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
DELETE	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

Svarsåtgärder

• HTTP 200 (OK) för att ange att skriptåtgärden har tagits bort från listan över beständiga skriptåtgärder.

• HTTP 404 (NotFound) för att indikera att det inte finns någon befintlig beständig skriptåtgärd med motsvarande scriptName.

Hämta skriptåtgärdskörning från historiken (endast Linux-kluster)

Den här åtgärden returnerar den senaste skriptåtgärdskörningen av det angivna klustret eller körningsinformationen för en enskild skriptkörning.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
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}

Svarsåtgärder

Åtgärden returnerar 200 (OK) om begäran har slutförts. Svarstexten är en matris med information om skriptkörning eller en enda skriptkörningsinformation om scriptExecutionId tillhandahålls. Nedan visas ett exempel på en skriptkörningsinformation.

Statuskod: 200 (OK)

Exempelsvar:

{  
  "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"  
}  
  

Elementnamn	Typ	Description
scriptExecutionId	Lång	Anger körnings-ID för skriptåtgärden.
name	Sträng	Anger namnet på skriptåtgärden.
applicationName	Sträng	Anger motsvarande program som skriptet är associerat med. applicationName är null om skriptet tillhandahålls av användare
Uri	Sträng	Anger URI för skriptåtgärden.
parametrar	Sträng	Anger de parametrar som krävs av skriptåtgärden
roller	Strängmatris	Anger de målroller som skriptåtgärden körs på.
startTime	DateTime	Anger starttiden för skriptåtgärdskörningen
endTime	DateTime	Anger sluttiden för körningen av skriptåtgärden
status	Sträng	Anger status för körningen av skriptåtgärden
operation	Sträng	Anger orsaken till att skriptåtgärden kördes. ScaleUp innebär till exempel att skriptåtgärden kördes under klusteruppskalningen.
executionSummary	Matris av komplex typ	Anger sammanfattningen av körningen i termer av hur många värdar som lyckades och hur många värdar som inte kunde köra skriptet.
debugInformation	Sträng	Anger detaljerad felsökningsinformation för skriptet. debugInformation returneras endast när ett scriptExecutionId anges i begäran.

executionSummary

Elementnamn	Typ	Description
status	Sträng	Anger status för körningen på enskilda värdar.
instanceCount	Int	Anger antalet körningar med motsvarande status.

Flytta upp ett skript från körningshistoriken för skriptåtgärder som ska bevaras (endast Linux-kluster)

Den här åtgärden befordrar ett HDInsight-skript från skriptkörningshistoriken som ska bevaras.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
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}

Svarsåtgärder

• HTTP 200 (OK) för att ange att skriptåtgärden har befordrats.

• HTTP 404 (NotFound) för att indikera att det inte finns någon befintlig skriptåtgärdskörning med motsvarande scriptExecutionId.

Ändra storlek

Ändrar storlek på ett befintligt HDInsight-kluster.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
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}

Nedan visas en exempelbegäran om att uppdatera taggar för ett kluster

{  
    "targetInstanceCount": 10  
}  

Elementnamn	Krävs	Typ	Description
targetInstanceCount	Yes	Int	Anger det nya instansantalet för rollen

Svarsåtgärder

HTTP 202 (accepterad) för att indikera att åtgärden slutförs asynkront. Async-avsökning returnerar en 204 (NoContent) när åtgärden har slutförts.

Kommentarer

Information om hur du spårar förloppet för en borttagningsklusterbegäran finns i Asynkrona åtgärder (202-rubriken Godkänd och Plats)

Uppdatera

Uppdateringar taggar för ett kluster.

Alla andra uppdateringar är separata åtgärder som beskrivs separat.

Förfrågan

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av kluster.

Metod	URI för förfrågan
PATCH	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Nedan visas en exempelbegäran om att uppdatera taggar för ett kluster

{   
    "tags": {"department": "finance"}  
}  
  

Elementnamn	Krävs	Typ	Description
tags	Ja	Sträng	Anger de taggar som ska tilldelas till klustret. Mer information om hur du använder taggar finns i Använda taggar för att organisera dina Azure-resurser.

Svarsåtgärder

Åtgärden returnerar 200 (OK) om begäran har slutförts.

Statuskod: 200 OK

Svarstexten är samma som Skapa ett kluster.