Condividi tramite

Cluster REST API in Azure HDInsight

  • Articolo

Crea

Crea un cluster nella sottoscrizione specificata.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Nell'esempio seguente viene illustrato il corpo della richiesta per la creazione di un cluster hadoop basato su Linux. Per esempi di creazione di cluster in altri modi, vedere la sezione Esempi di seguito.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
Nome dell'elemento Obbligatoria Tipo Descrizione
id Sì string Specifica l'identificatore della risorsa del cluster.
name Sì string Specifica il nome del cluster.
tipo Sì string Specifica il tipo del cluster.
posizione Sì string Specifica il percorso di Azure supportato in cui deve essere creato il cluster. Per altre informazioni, vedere Elencare tutte le posizioni geografiche disponibili.
tags No string Specifica i tag che verranno assegnati al cluster. Per altre informazioni sull'uso dei tag, vedere Uso di tag per organizzare le risorse di Azure.
Proprietà Sì Tipo complesso Specifica le proprietà del cluster.

Proprietà

Nome dell'elemento Obbligatoria Tipo Descrizione
clusterVersion Sì string Specifica la versione del cluster
osType Sì string Specifica il sistema operativo per il cluster.

I valori validi sono Linux e Windows
clusterDefinition Sì Tipo complesso Specifica informazioni sul tipo e le configurazioni del cluster
computeProfile Sì Tipo complesso Specifica informazioni sulla topologia del cluster e sulle proprietà del ruolo associate

clusterDefinition

Nome dell'elemento Obbligatoria Tipo Descrizione
kind Sì string Specifica il tipo di cluster.

I valori validi sono hadoop, hbase, storm & spark
configurazioni Sì Dizionario Questo elemento è un dizionario del tipo di configurazione e il relativo dizionario valori associato.

Il tipo di configurazione del gateway viene usato per configurare l'utente http usato per la connessione alle API Web e al portale di Ambari

Il tipo di configurazione core-site viene usato per configurare l'account di archiviazione predefinito per il cluster

computeProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
clusterVersion Sì string Specifica la versione del cluster
ruolo Sì Matrice di tipo complesso (ruolo) Specifica informazioni sui ruoli nel cluster

ruolo

Nome dell'elemento Obbligatoria Tipo Descrizione
name Sì string Specifica il nome del ruolo
targetInstanceCount Sì Integer Specifica il numero di istanze di destinazione per il ruolo
hardwareProfile Sì Tipo complesso Specifica informazioni sul profilo hardware per il ruolo
osProfile Sì Tipo complesso Specifica informazioni sul profilo del sistema operativo per il ruolo

hardwareProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
vmSize Sì string Specifica le dimensioni della macchina virtuale. Fare riferimento alle opzioni di configurazione di HDInsight (una volta su questo collegamento, scorrere verso il basso fino ai piani tariffari di Node) per le dimensioni valide

osProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
linuxOperatingSystemProfile No Tipo complesso Specifica le impostazioni correlate al sistema operativo Linux
windowsOperatingSystemProfile No Tipo complesso Specifica le impostazioni correlate al sistema operativo windows
virtualNetworkProfile No Tipo complesso Specifica le impostazioni correlate alla rete virtuale se il cluster viene distribuito in una rete virtuale nella sottoscrizione dell'utente
scriptActions No Matrice di tipo complesso Elenco di azioni script da eseguire nel cluster

linuxOperatingSystemProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
Username Sì string SSH user name
sshProfile No Tipo complesso Specifica la chiave SSH.

È necessario uno di sshProfile o Password.
Password No string Specifica la password SSH

È necessario uno di sshProfile o Password.

sshProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
publicKeys Sì Array Contiene un elenco di oggetti certificateData. Il valore è una chiave pubblica ssh-rsa

windowsOperatingSystemProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
rdpSettings No Tipo complesso Specifica le impostazioni RDP per i cluster windows

rdpSettings

Nome dell'elemento Obbligatoria Tipo Descrizione
username Sì string Specifica il nome utente RDP
password Sì string Specifica la password per l'utente RDP
expiryDate Sì Data Data di scadenza per le credenziali RDP

virtualNetworkProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
id Sì string ID risorsa Rete virtuale
Subnet Sì string Specifica il nome della subnet

scriptActions

Nome dell'elemento Obbligatoria Tipo Descrizione
name Sì string Nome descrittivo per l'azione script
Uri Sì string URL del file di azione script
parameters No string Argomenti da passare durante l'esecuzione del file di azione script

Risposta

Se la convalida è completa e la richiesta viene accettata, l'operazione restituirà 200 (OK).

Codice di stato: 200 OK

Il corpo della risposta per un cluster Linux crea usando la chiave SSH:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}
Nome dell'elemento Type Descrizione
provisioningState string Indica lo stato di provisioning corrente.
clusterState string Indica lo stato del cluster HDInsight più dettagliato durante il provisioning.
createdDate Data Data/ora in cui è stata ricevuta la richiesta di creazione del cluster
quotaInfo Tipo complesso Specifica i coreusati dal cluster
errori Matrice di messaggi di errore Contiene il messaggio di errore se provisioningState = 'failed'
connectivityEndpoints Tipo complesso Specifica gli endpoint pubblici per il cluster

connectivityEndpoints

Nome dell'elemento Type Descrizione
name string Nome descrittivo per l'endpoint di connettività
protocol string Specifica il protocollo da usare (ad esempio: HTTPS, SSH)
posizione string Specifica l'URL da connettere
port INT Specifica la porta da connettere

Creare un cluster HDInsight premium aggiunto al dominio (solo Linux, anteprima)

Creare un cluster aggiunto a un dominio Premium con Apache Ranger. L'utente deve fornire SecurityProfile nel corpo della richiesta per creare un cluster sicuro.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

L'esempio seguente mostra il corpo della richiesta per la creazione di un cluster Hadoop basato su Linux, Premium e aggiunto a un dominio.

{
	"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"
						}
					}
				}
			]
		}
	}
}
Nome dell'elemento Obbligatoria Tipo Descrizione
id Sì string Specifica l'identificatore della risorsa del cluster.
name Sì string Specifica il nome del cluster.
tipo Sì string Specifica il tipo del cluster.
posizione Sì string Specifica il percorso di Azure supportato in cui deve essere creato il cluster. Per altre informazioni, vedere Elencare tutte le posizioni geografiche disponibili.
tags No string Specifica i tag che verranno assegnati al cluster. Per altre informazioni sull'uso dei tag, vedere Uso di tag per organizzare le risorse di Azure.
Proprietà Sì Tipo complesso Specifica le proprietà del cluster.

Proprietà

Nome dell'elemento Obbligatoria Tipo Descrizione
clusterVersion Sì string Specifica la versione del cluster
osType Sì string Specifica il sistema operativo per il cluster.

Il valore valido è Linux perché solo i tipi di cluster Linux possono aggiungere un dominio di Azure AD.
Livello No string Il valore predefinito è standard. I valori validi sono standard e Premium. Se non viene specificato alcun valore, si presuppone che il valore sia standard. Specifica il livello per il cluster. I cluster aggiunti al dominio sono supportati solo nel livello Premium
clusterDefinition Sì Tipo complesso Specifica informazioni sul tipo e le configurazioni del cluster
computeProfile Sì Tipo complesso Specifica informazioni sulla topologia del cluster e sulle proprietà del ruolo associate
securityProfile No Tipo complesso Se viene creato un cluster protetto, aggiunto a un dominio, questo elemento specifica le impostazioni correlate ad Active Directory

clusterDefinition

Nome dell'elemento Obbligatoria Tipo Descrizione
kind Sì string Specifica il tipo di cluster.

I valori validi sono hadoop, hbase, storm & spark
configurazioni Sì Dizionario Questo elemento è un dizionario del tipo di configurazione e il relativo dizionario valori associato.

Il tipo di configurazione del gateway viene usato per configurare l'utente http usato per la connessione alle API Web e al portale di Ambari

Il tipo di configurazione core-site viene usato per configurare l'account di archiviazione predefinito per il cluster

computeProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
clusterVersion Sì string Specifica la versione del cluster
ruolo Sì Matrice di tipo complesso (ruolo) Specifica informazioni sui ruoli nel cluster

securityProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
directoryType Sì string Tipo di directory LDAP usata. Attualmente "ActiveDirectory" è l'unico valore supportato.
dominio Sì string Dominio Active Directory per il cluster
organizzazioneUnitDN Sì string Nome distinto dell'unità organizzativa in Active Directory in cui verranno creati gli account utente e computer
ldapsUrls Sì Matrice di stringhe URL di uno o più server LDAPS per Active Directory
domainUserName Sì string Un account utente di dominio con autorizzazioni sufficienti per la creazione del cluster. Deve essere in formato user@domain
domainUserPassword Sì string Password per l'account utente del dominio
clusterUsersGroupDNS No Matrice di stringhe Nomi distinti dei gruppi di Active Directory disponibili in Ambari e Apache Ranger

ruolo

Nome dell'elemento Obbligatoria Tipo Descrizione
name Sì string Specifica il nome del ruolo
targetInstanceCount Sì Integer Specifica il numero di istanze di destinazione per il ruolo
hardwareProfile Sì Tipo complesso Specifica informazioni sul profilo hardware per il ruolo
osProfile Sì Tipo complesso Specifica informazioni sul profilo del sistema operativo per il ruolo

hardwareProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
vmSize Sì string Specifica le dimensioni della macchina virtuale. Fare riferimento alle opzioni di configurazione di HDInsight (una volta su questo collegamento, scorrere verso il basso fino ai piani tariffari di Node) per le dimensioni valide

osProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
linuxOperatingSystemProfile No Tipo complesso Specifica le impostazioni correlate al sistema operativo Linux
virtualNetworkProfile No Tipo complesso Specifica le impostazioni correlate alla rete virtuale se il cluster viene distribuito in una rete virtuale nella sottoscrizione dell'utente
scriptActions No Matrice di tipo complesso Elenco di azioni script da eseguire nel cluster

linuxOperatingSystemProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
Username Sì string SSH user name
sshProfile No Tipo complesso Specifica la chiave SSH.

È necessario uno di sshProfile o Password.
Password No string Specifica la password SSH

È necessario uno di sshProfile o Password.

sshProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
publicKeys Sì Array Contiene un elenco di oggetti certificateData. Il valore è una chiave pubblica ssh-rsa

virtualNetworkProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
id Sì string id risorsa Rete virtuale
Subnet Sì string Specifica il nome della subnet

scriptActions

Nome dell'elemento Obbligatoria Tipo Descrizione
name Sì string Nome descrittivo per l'azione script
Uri Sì string URL del file di azione dello script
parameters No string Argomenti da passare durante l'esecuzione del file di azione script

Risposta

Se la convalida è completata e la richiesta viene accettata, l'operazione restituirà 200 (OK).

Codice di stato: 200 OK

Il corpo della risposta per un cluster Linux crea usando la chiave SSH:

{  
    "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"  
                    }  
                }  
            ]  
        }  
    }  
}
Nome dell'elemento Type Descrizione
provisioningState string Indica lo stato di provisioning corrente.
clusterState string Indica lo stato del cluster HDInsight più dettagliato durante il provisioning.
createdDate Data Datetime quando è stata ricevuta la richiesta di creazione del cluster
quotaInfo Tipo complesso Specifica i coreusati dal cluster
errori Matrice di messaggi di errore Contiene il messaggio di errore se provisioningState = 'failed"
connectivityEndpoints Tipo complesso Specifica gli endpoint pubblici per il cluster

connectivityEndpoints

Nome dell'elemento Type Descrizione
name string Nome descrittivo per l'endpoint di connettività
protocol string Specifica il protocollo da usare (ad esempio: HTTPS, SSH)
posizione string Specifica l'URL da connettere
port INT Specifica la porta da connettere

Creare un cluster con Azure Data Lake Store come file system predefinito

Crea un cluster nella sottoscrizione specificata con Azure Data Lake Store come file system predefinito. Specificare un oggetto ClusterIdentity nel corpo della richiesta e configurare la proprietà default-file system con l'URL appropriato di Data Lake Store.

Azure Data Lake può essere configurato come file system predefinito per le versioni del cluster a partire dalla versione 3.5 inclusiva.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Nell'esempio seguente viene illustrato il corpo della richiesta per la creazione di un cluster Hadoop basato su Linux usando Azure Data Lake Store come file system predefinito per il cluster.

{
	"id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",
	"name": "mycluster",
	"type": "Microsoft.HDInsight/clusters",
	"location": "location-name",
	"tags": {
		"tag1": "value1",
		"tag2": "value2"
	},
	"properties": {
		"clusterVersion": "3.5",
		"osType": "Linux",
		"tier": "Standard",
		"clusterDefinition": {
			"kind": "hadoop",
			"configurations": {
				"gateway": {
					"restAuthCredential.isEnabled": true,
					"restAuthCredential.username": "http-user",
					"restAuthCredential.password": "password"
				},
				"clusterIdentity": {
					"clusterIdentity.applicationId": "applicationId",
					"clusterIdentity.certificate": "certificate-contents-in-base64-encoding",
					"clusterIdentity.aadTenantId": "aad-tenant-id",
					"clusterIdentity.resourceUri": "https://KonaCompute.net/",
					"clusterIdentity.certificatePassword": "certificate-password"
				},
				"core-site": {
					"fs.defaultFS": "adl://home",
					"dfs.adls.home.hostname": "yourstorageaccount.azuredatalakestore.net",
					"dfs.adls.home.mountpoint": "/path/to/cluster/root"
				}
			}
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 1,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": " ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "zookeepernode",
					"targetInstanceCount": 3,
					"hardwareProfile": {
						"vmSize": "Small"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
Nome dell'elemento Obbligatoria Tipo Descrizione
id Sì string Specifica l'identificatore della risorsa del cluster.
name Sì string Specifica il nome del cluster.
tipo Sì string Specifica il tipo del cluster.
posizione Sì string Specifica il percorso di Azure supportato in cui deve essere creato il cluster. Per altre informazioni, vedere Elencare tutte le posizioni geografiche disponibili.
tags No string Specifica i tag che verranno assegnati al cluster. Per altre informazioni sull'uso dei tag, vedere Uso di tag per organizzare le risorse di Azure.
Proprietà Sì Tipo complesso Specifica le proprietà del cluster.

Proprietà

Nome dell'elemento Obbligatoria Tipo Descrizione
clusterVersion Sì string Specifica la versione del cluster
osType Sì string Specifica il sistema operativo per il cluster.

Il valore valido è Linux
Livello No string Specifica il livello per il cluster. I valori validi sono standard e Premium. Se il livello non è specificato, il cluster sarà di livello standard.
clusterDefinition Sì Tipo complesso Specifica informazioni sul tipo e le configurazioni del cluster
computeProfile Sì Tipo complesso Specifica informazioni sulla topologia del cluster e sulle proprietà del ruolo associate

clusterDefinition

Nome dell'elemento Obbligatoria Tipo Descrizione
kind Sì string Specifica il tipo di cluster.

I valori validi sono hadoop, hbase, storm & spark
configurazioni Sì Dizionario Questo elemento è un dizionario di tipo di configurazione e il dizionario dei valori associato.

Il tipo di configurazione del gateway viene usato per configurare l'utente HTTP usato per la connessione alle API Web e al portale di Ambari

Il tipo di configurazione core-site viene usato per configurare l'account di archiviazione predefinito per il cluster

computeProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
clusterVersion Sì string Specifica la versione del cluster
ruolo Sì Matrice di tipo complesso (ruolo) Specifica informazioni sui ruoli nel cluster

ruolo

Nome dell'elemento Obbligatoria Tipo Descrizione
name Sì string Specifica il nome del ruolo
targetInstanceCount Sì Integer Specifica il numero di istanze di destinazione per il ruolo
hardwareProfile Sì Tipo complesso Specifica informazioni sul profilo hardware per il ruolo
osProfile Sì Tipo complesso Specifica informazioni sul profilo del sistema operativo per il ruolo

hardwareProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
vmSize Sì string Specifica le dimensioni della macchina virtuale. Per informazioni sulle dimensioni valide, vedere Opzioni di configurazione di HDInsight (una volta su questo collegamento, scorrere verso il basso fino ai piani tariffari di Node)

osProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
linuxOperatingSystemProfile No Tipo complesso Specifica le impostazioni relative al sistema operativo Linux
virtualNetworkProfile No Tipo complesso Specifica le impostazioni relative alla rete virtuale se il cluster viene distribuito in una rete virtuale nella sottoscrizione dell'utente
scriptActions No Matrice di tipo complesso Elenco di azioni script da eseguire nel cluster

linuxOperatingSystemProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
Username Sì string SSH user name
sshProfile No Tipo complesso Specifica la chiave SSH.

È necessario uno di sshProfile o Password.
Password No string Specifica la password SSH

È necessario uno di sshProfile o Password.

sshProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
publicKeys Sì Array Contiene un elenco di oggetti certificateData. Il valore è una chiave pubblica ssh-rsa

virtualNetworkProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
id Sì string id risorsa Rete virtuale
Subnet Sì string Specifica il nome della subnet

scriptActions

Nome dell'elemento Obbligatoria Tipo Descrizione
name Sì string Nome descrittivo per l'azione script
Uri Sì string URL del file di azione dello script
parameters No string Argomenti da passare durante l'esecuzione del file di azione script

Risposta

Se la convalida è completata e la richiesta viene accettata, l'operazione restituirà 200 (OK).

Codice di stato: 200 OK

Il corpo della risposta per un cluster Linux crea usando la chiave SSH:

{
	"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"
	}
}
Nome dell'elemento Type Descrizione
provisioningState string Indica lo stato di provisioning corrente.
clusterState string Indica lo stato del cluster HDInsight più dettagliato durante il provisioning.
createdDate Data Datetime quando è stata ricevuta la richiesta di creazione del cluster
quotaInfo Tipo complesso Specifica i coreusati dal cluster
errori Matrice di messaggi di errore Contiene il messaggio di errore se provisioningState = 'failed"
connectivityEndpoints Tipo complesso Specifica gli endpoint pubblici per il cluster

connectivityEndpoints

Nome dell'elemento Type Descrizione
name string Nome descrittivo per l'endpoint di connettività
protocol string Specifica il protocollo da usare (ad esempio: HTTPS, SSH)
posizione string Specifica l'URL da connettere
port INT Specifica la porta da connettere

Elimina

Elimina un cluster HDInsight.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

HTTP 202 (accettato) per indicare che l'operazione verrà completata in modo asincrono. Il polling asincrono restituirà un valore 204 (NoContent) al termine dell'operazione.

Commenti

Per tenere traccia dello stato di avanzamento di una richiesta di eliminazione del cluster, vedere Operazioni asincrone (intestazione Accettata e Posizione 202)

Get

Ottiene i dettagli o le proprietà del cluster specificato.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

L'operazione restituirà 200 (OK) se la richiesta viene completata correttamente

Codice di stato: 200 OK

Il corpo della risposta è uguale a quello di creazione del cluster.

Corpo della risposta per i dettagli del cluster Linux

{  
    "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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
Nome dell'elemento Type Descrizione
provisioningState string Indica lo stato di provisioning corrente.
clusterState string Indica lo stato del cluster HDInsight più dettagliato durante il provisioning.
createdDate Data Data/ora in cui è stata ricevuta la richiesta di creazione del cluster
quotaInfo Tipo complesso Specifica i coreusati dal cluster
errori Matrice di messaggi di errore Contiene il messaggio di errore se provisioningState = 'failed'
connectivityEndpoints Tipo complesso Specifica gli endpoint pubblici per il cluster

connectivityEndpoints

Nome dell'elemento Type Descrizione
name string Nome descrittivo per l'endpoint di connettività
protocol string Specifica il protocollo da usare (ad esempio: HTTPS, SSH)
posizione string Specifica l'URL da connettere
port INT Specifica la porta da connettere

Elencare le configurazioni

Recupera tutti i dettagli di configurazione del cluster (incluse le informazioni riservate).

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

HTTP 200 (OK) al completamento dell'operazione.

Esempio di risposta:

"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"  
      }  
}
Nome dell'elemento Type Descrizione
configurazioni Dizionario Questo elemento è un dizionario di tipo di configurazione e il dizionario dei valori associato.
Il tipo di configurazione del gateway viene usato per configurare l'utente HTTP usato per la connessione alle API Web e al portale di Ambari
Il tipo di configurazione core-site viene usato per configurare l'account di archiviazione predefinito per il cluster

Ottenere la configurazione

Ottiene i dettagli su un singolo tipo di configurazione (omette i valori sensibili).

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

HTTP 200 (OK) al completamento dell'operazione.

Esempio di risposta:

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

Ottenere le impostazioni del gateway

Questa operazione recupera le credenziali HTTP del gateway del cluster.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

HTTP 200 (OK) al completamento dell'operazione.

Esempio di risposta:

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

Aggiornare le impostazioni del gateway

Questa operazione consente agli utenti di modificare le credenziali HTTP del gateway del cluster.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

Metodo URI richiesta
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!"  
}

Risposta

HTTP 202 (accettato) al completamento dell'operazione.

Modificare le impostazioni di connettività (DEPRECATO)

Questa operazione consente agli utenti di abilitare/disabilitare la connettività HTTPS al cluster.

Usare invece updateGatewaySettings .

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Per abilitare la connettività

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

Elenco per gruppo di risorse

Elenchi tutti i cluster nella sottoscrizione dell'utente nel gruppo di risorse specificato.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

Se la richiesta viene completata correttamente, l'operazione restituirà 200 (OK).

Codice di stato: 200 OK

Il corpo della risposta è una matrice di dettagli del cluster. Per altre informazioni, vedere Ottenere le proprietà del cluster.

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

Elenco per sottoscrizione

Elenchi tutti i cluster nella sottoscrizione dell'utente.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

Se la richiesta viene completata correttamente, l'operazione restituirà 200 (OK).

Codice di stato: 200 OK

Il corpo della risposta è una matrice di dettagli del cluster.

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

Per disabilitare la connettività

{  
   "restAuthCredential.isEnabled": false  
}
Nome dell'elemento Obbligatoria Tipo Descrizione
restAuthCredential.isEnabled Sì Boolean Specifica se la connettività deve essere abilitata o disabilitata
restAuthCredential.username No string Obbligatorio se isEnabled=true
Specifica il nome utente per le impostazioni di connettività
restAuthCredential.password No string Obbligatorio se isEnabled=true
Specifica la password per le impostazioni di connettività

Risposta

HTTP 202 (accettato) per indicare che l'operazione verrà completata in modo asincrono. Il polling asincrono restituirà un valore 204 (NoContent) al termine dell'operazione.

Commenti

Per tenere traccia dello stato di avanzamento di una richiesta di eliminazione del cluster, vedere Operazioni asincrone (intestazione Accettata e Posizione 202)

Modificare le impostazioni RDP (solo cluster Windows)

Questa operazione consente a un utente di abilitare/disabilitare RDP. Si applica ai cluster basati su Windows.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Corpo della richiesta

Per abilitare RDP

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

Per disabilitare RDP

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

osProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
windowsOperatingSystemProfile No Tipo complesso Specifica le impostazioni relative al sistema operativo Windows

windowsOperatingSystemProfile

Nome dell'elemento Obbligatoria Tipo Descrizione
rdpSettings No Tipo complesso Specifica le impostazioni RDP per i cluster Windows

rdpSettings

Nome dell'elemento Obbligatoria Tipo Descrizione
username Sì string Specifica il nome utente RDP
password Sì string Specifica la password per l'utente RDP
expiryDate Sì Data Data di scadenza per le credenziali RDP

Risposta

L'operazione restituirà 200 (OK) se la richiesta viene completata correttamente

Codice di stato: 200 OK

Il corpo della risposta è uguale a Creare un cluster.

Eseguire azioni script in un cluster in esecuzione (solo cluster Linux)

Eseguire l'azione Script in un cluster in esecuzione.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Corpo della richiesta

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

scriptActions

Nome dell'elemento Obbligatoria Tipo Descrizione
name Sì string Specifica il nome dell'azione script
Uri Sì string Specifica l'URI dell'azione script
parametri Sì string Specifica i parametri richiesti dall'azione script
Ruoli Sì Matrice di stringhe Specifica i ruoli di destinazione su cui viene eseguita l'azione script
persistOnSuccess Sì Boolean Specifica se le azioni script verranno mantenute dopo l'esecuzione corretta

Risposta

Se la convalida è completa e la richiesta viene accettata, l'operazione restituirà il 202 (accettato).

Codice di stato: 202 (accettato)

Elencare tutte le azioni script persistenti per un cluster (solo cluster Linux)

Questa operazione restituisce tutte le azioni script persistenti del cluster specificato.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

HTTP 200 (OK) al completamento dell'operazione.

Codice di stato: 200 OK

Esempio di risposta:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
Nome dell'elemento Type Descrizione
name string Specifica il nome dell'azione script.
Uri string Specifica l'URI dell'azione script.
parametri string Specifica i parametri richiesti dall'azione script
Ruoli Matrice di stringhe Specifica i ruoli di destinazione su cui viene eseguita l'azione script.
applicationName string Specifica l'applicazione corrispondente a cui è associato lo script. applicationName è Null se lo script viene fornito dagli utenti

Rimuovere un'azione script persistente per un cluster (solo cluster Linux)

Questa operazione rimuove un'azione script persistente di HDInsight per un cluster.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Risposta

  • HTTP 200 (OK) per indicare che l'azione script è stata rimossa dall'elenco di azioni script persistenti.

  • HTTP 404 (NotFound) per indicare che non esiste alcuna azione script persistente esistente con il nome script corrispondente.

Ottenere l'esecuzione dell'azione script dalla cronologia (solo cluster Linux)

Questa operazione restituisce l'esecuzione dell'azione degli script più recente del cluster o dei dettagli di esecuzione specificati per una singola esecuzione di script.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

Metodo URI richiesta
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}

Risposta

Se la richiesta viene completata correttamente, l'operazione restituirà 200 (OK). Il corpo della risposta è una matrice di dettagli di esecuzione dello script o un singolo dettaglio di esecuzione dello script se viene specificato scriptExecutionId. Di seguito è riportato un esempio di dettaglio dell'esecuzione dello script.

Codice di stato: 200 (OK)

Esempio di risposta:

{  
  "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"  
}
Nome dell'elemento Type Descrizione
scriptExecutionId long Specifica l'ID di esecuzione dell'azione script.
name string Specifica il nome dell'azione script.
applicationName string Specifica l'applicazione corrispondente a cui è associato lo script. applicationName è Null se lo script viene fornito dagli utenti
Uri string Specifica l'URI dell'azione script.
parametri string Specifica i parametri richiesti dall'azione script
Ruoli Matrice di stringhe Specifica i ruoli di destinazione su cui viene eseguita l'azione script.
startTime Datetime Specifica l'ora di inizio dell'esecuzione dell'azione script
endTime Datetime Specifica l'ora di fine dell'esecuzione dell'azione script
status string Specifica lo stato dell'esecuzione dell'azione script
operation string Specifica il motivo per cui è stata eseguita l'azione script. Ad esempio, ScaleUp indica che l'azione script è stata eseguita durante l'aumento delle prestazioni del cluster.
executionSummary Matrice di tipo complesso Specifica il riepilogo dell'esecuzione in termini di numero di host riusciti e il numero di host non riusciti a eseguire lo script.
debugInformation string Specifica informazioni di debug dettagliate per lo script. debugInformation viene restituito solo quando nella richiesta viene fornito uno scriptExecutionId.

executionSummary

Nome dell'elemento Type Descrizione
status string Specifica lo stato dell'esecuzione in singoli host.
instanceCount Int Specifica il numero di esecuzioni con lo stato corrispondente.

Alzare di livello uno script dalla cronologia di esecuzione dell'azione script per renderlo persistente (solo cluster Linux)

Questa operazione promuove uno script HDInsight dalla cronologia di esecuzione dello script da rendere persistente.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

Metodo URI richiesta
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}

Risposta

  • HTTP 200 (OK) per indicare che l'azione script è stata promossa.

  • HTTP 404 (NotFound) per indicare che non esiste alcuna esecuzione di azioni script esistenti con scriptExecutionId corrispondente.

Ridimensionamento

Ridimensiona un cluster HDInsight esistente.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

Metodo URI richiesta
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}

Di seguito viene illustrata una richiesta di esempio di aggiornamento dei tag per un cluster

{  
    "targetInstanceCount": 10  
}
Nome dell'elemento Obbligatoria Tipo Descrizione
targetInstanceCount Sì Int Specifica il numero di nuove istanze per il ruolo

Risposta

HTTP 202 (accettato) per indicare che l'operazione verrà completata in modo asincrono. Il polling asincrono restituirà un valore 204 (NoContent) al termine dell'operazione.

Commenti

Per tenere traccia dello stato di avanzamento di una richiesta di eliminazione del cluster, vedere Operazioni asincrone (intestazione Accettata e Posizione 202)

Aggiornamento

Aggiornamenti tag per un cluster.

Tutti gli altri aggiornamenti sono azioni separate descritte separatamente.

Richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati dai cluster.

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

Di seguito viene illustrata una richiesta di esempio di aggiornamento dei tag per un cluster

{   
    "tags": {"department": "finance"}  
}
Nome dell'elemento Obbligatoria Tipo Descrizione
tags Sì string Specifica i tag che verranno assegnati al cluster. Per altre informazioni sull'uso dei tag, vedere Uso di tag per organizzare le risorse di Azure.

Risposta

L'operazione restituirà 200 (OK) se la richiesta viene completata correttamente.

Codice di stato: 200 OK

Il corpo della risposta è uguale a Crea un cluster.