Dela via

KLUSTER-REST API i Azure HDInsight

  • Artikel

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.