API REST de cluster dans Azure HDInsight

Article
02/03/2024

Créer

Crée un cluster dans l’abonnement spécifié.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de requête
PUT	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}`

L’exemple suivant montre le corps de la demande pour la création d’un cluster hadoop linux. Pour obtenir des exemples de création de clusters d’autres manières, consultez la section Exemples ci-dessous.

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

Nom de l'élément	Obligatoire	Type	Description
id	Oui	String	Spécifie l’identificateur de ressource du cluster.
name	Oui	String	Spécifie le nom du cluster.
type	Oui	String	Spécifie le type du cluster.
location	Oui	String	Spécifie l’emplacement Azure pris en charge où le cluster doit être créé. Pour plus d’informations, consultez Lister tous les emplacements géographiques disponibles.
tags	Non	String	Spécifie les balises qui seront affectées au cluster. Pour plus d’informations sur l’utilisation des balises, consultez Utilisation de balises pour organiser vos ressources Azure.
Propriétés	Oui	Type complexe	Spécifie les propriétés du cluster.

Propriétés

Nom de l'élément	Obligatoire	Type	Description
clusterVersion	Oui	String	Spécifie la version du cluster
osType	Oui	String	Spécifie le système d’exploitation du cluster. Les valeurs valides sont Linux et Windows
clusterDefinition	Yes	Type complexe	Spécifie des informations sur le type et les configurations de cluster
computeProfile	Yes	Type complexe	Spécifie des informations sur la topologie de cluster et les propriétés de rôle associées

clusterDefinition

Nom de l'élément	Obligatoire	Type	Description
kind	Oui	String	Spécifie le type de cluster. Les valeurs valides sont hadoop, hbase, storm & spark
configurations	Oui	Dictionnaire	Cet élément est un dictionnaire de type de configuration et son dictionnaire de valeurs associé. le type de configuration de passerelle est utilisé pour configurer l’utilisateur http utilisé pour la connexion aux API web et au portail Ambari Le type de configuration de site principal est utilisé pour configurer le compte de stockage par défaut pour le cluster

computeProfile

Nom de l'élément	Obligatoire	Type	Description
clusterVersion	Oui	String	Spécifie la version du cluster
role	Yes	Tableau de type complexe (rôle)	Spécifie des informations sur les rôles dans le cluster

rôle

Nom de l'élément	Obligatoire	Type	Description
name	Oui	String	Spécifie le nom du rôle
targetInstanceCount	Oui	Integer	Spécifie le nombre de instance cibles pour le rôle
hardwareProfile	Yes	Type complexe	Spécifie des informations sur le profil matériel du rôle
osProfile	Yes	Type complexe	Spécifie des informations sur le profil de système d’exploitation pour le rôle

hardwareProfile

Nom de l'élément	Obligatoire	Type	Description
vmSize	Oui	String	Spécifie la taille de la machine virtuelle. Reportez-vous aux options de configuration HDInsight (une fois sur ce lien, faites défiler jusqu’à Niveaux tarifaires node) pour connaître les tailles valides

osProfile

Nom de l'élément	Obligatoire	Type	Description
linuxOperatingSystemProfile	No	Type complexe	Spécifie les paramètres liés au système d’exploitation Linux
windowsOperatingSystemProfile	No	Type complexe	Spécifie les paramètres liés au système d’exploitation Windows
virtualNetworkProfile	No	Type complexe	Spécifie les paramètres liés au réseau virtuel si le cluster est déployé dans un réseau virtuel dans l’abonnement de l’utilisateur
scriptActions	No	Tableau de type complexe	Liste des actions de script à exécuter sur le cluster

linuxOperatingSystemProfile

Nom de l'élément	Obligatoire	Type	Description
Nom d’utilisateur	Oui	String	Nom d'utilisateur du SSH
sshProfile	No	Type complexe	Spécifie la clé SSH. L’un des sshProfile ou Password est requis.
Mot de passe	Non	String	Spécifie le mot de passe SSH L’un des sshProfile ou Password est requis.

sshProfile

Nom de l'élément	Obligatoire	Type	Description
publicKeys	Oui	Array	Contient une liste d’objets certificateData. La valeur est une clé publique ssh-rsa

windowsOperatingSystemProfile

Nom de l'élément	Obligatoire	Type	Description
rdpSettings	No	Type complexe	Spécifie les paramètres RDP pour les clusters Windows

rdpSettings

Nom de l'élément	Obligatoire	Type	Description
username	Oui	String	Spécifie le nom d’utilisateur RDP
mot de passe	Oui	String	Spécifie le mot de passe de l’utilisateur RDP
expiryDate	Oui	Date	Date d’expiration des informations d’identification RDP

virtualNetworkProfile

Nom de l'élément	Obligatoire	Type	Description
id	Oui	String	ID de ressource Réseau virtuel
sous-réseau	Oui	String	Spécifie le nom du sous-réseau

scriptActions

Nom de l'élément	Obligatoire	Type	Description
name	Oui	String	Nom convivial de l’action de script
URI	Oui	String	URL du fichier d’action de script
parameters	Non	String	Arguments à passer lors de l’exécution du fichier d’action de script

response

Si la validation est terminée et que la demande est acceptée, l’opération retourne 200 (OK).

Code d’état : 200 OK

Le corps de la réponse d’un cluster Linux crée à l’aide de la clé 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"  
                    }  
                }  
            ]  
        }  
    }  
}

Nom de l'élément	Type	Description
provisioningState	String	Indique l’état d’approvisionnement actuel.
clusterState	String	Indique l’état du cluster HDInsight plus détaillé pendant le provisionnement en cours.
createdDate	Date	Date/heure de réception de la demande de création de cluster
quotaInfo	Type complexe	Spécifie les cœurs Utilisés par le cluster
erreurs	Tableau de messages d’erreur	Contient le message d’erreur si provisioningState = 'failed »
connectivityEndpoints	Type complexe	Spécifie les points de terminaison publics pour le cluster

connectivityEndpoints

Nom de l'élément	Type	Description
name	String	Nom convivial pour le point de terminaison de connectivité
protocol	String	Spécifie le protocole à utiliser (exemple : HTTPS, SSH)
location	String	Spécifie l’URL à connecter
port	int	Spécifie le port à connecter

Créer un cluster HDInsight premium joint à un domaine (Linux uniquement, préversion)

Créez un cluster premium joint à un domaine avec Apache Ranger. L’utilisateur doit fournir SecurityProfile dans le corps de la demande pour créer un cluster sécurisé.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de requête
PUT	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}`

L’exemple suivant montre le corps de la demande pour la création d’un cluster Hadoop linux premium joint à un domaine.

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

Nom de l'élément	Obligatoire	Type	Description
id	Oui	String	Spécifie l’identificateur de ressource du cluster.
name	Oui	String	Spécifie le nom du cluster.
type	Oui	String	Spécifie le type du cluster.
location	Oui	String	Spécifie l’emplacement Azure pris en charge où le cluster doit être créé. Pour plus d’informations, consultez Lister tous les emplacements géographiques disponibles.
tags	Non	String	Spécifie les balises qui seront affectées au cluster. Pour plus d’informations sur l’utilisation des balises, consultez Utilisation de balises pour organiser vos ressources Azure.
Propriétés	Oui	Type complexe	Spécifie les propriétés du cluster.

Propriétés

Nom de l'élément	Obligatoire	Type	Description
clusterVersion	Oui	String	Spécifie la version du cluster
osType	Oui	String	Spécifie le système d’exploitation du cluster. La valeur valide est Linux , car seuls les types de cluster Linux peuvent rejoindre un domaine Azure AD.
Niveau	Non	String	La valeur par défaut est standard. Les valeurs valides sont standard et premium. Si aucune valeur n’est spécifiée, la valeur est supposée être standard. Spécifie le niveau pour le cluster. Les clusters joints au domaine sont uniquement pris en charge dans le niveau Premium
clusterDefinition	Yes	Type complexe	Spécifie des informations sur le type et les configurations de cluster
computeProfile	Yes	Type complexe	Spécifie des informations sur la topologie de cluster et les propriétés de rôle associées
securityProfile	No	Type complexe	Si un cluster sécurisé joint à un domaine est en cours de création, cet élément spécifie les paramètres associés à Active Directory

clusterDefinition

Nom de l'élément	Obligatoire	Type	Description
kind	Oui	String	Spécifie le type de cluster. Les valeurs valides sont hadoop, hbase, storm & spark
configurations	Oui	Dictionnaire	Cet élément est un dictionnaire de type de configuration et son dictionnaire de valeurs associé. le type de configuration de passerelle est utilisé pour configurer l’utilisateur http utilisé pour la connexion aux API web et au portail Ambari Le type de configuration de site principal est utilisé pour configurer le compte de stockage par défaut pour le cluster

computeProfile

Nom de l'élément	Obligatoire	Type	Description
clusterVersion	Oui	String	Spécifie la version du cluster
role	Yes	Tableau de type complexe (rôle)	Spécifie des informations sur les rôles dans le cluster

securityProfile

Nom de l'élément	Obligatoire	Type	Description
directoryType	Oui	String	Type de répertoire LDAP utilisé. Actuellement, « ActiveDirectory » est la seule valeur prise en charge.
domaine	Oui	String	Domaine Active Directory pour le cluster
organizationalUnitDN	Oui	String	Nom unique de l’unité organisationnelle dans active directory où les comptes d’utilisateur et d’ordinateur seront créés
ldapsUrls	Yes	Tableau de chaînes	URL d’un ou plusieurs serveurs LDAPS pour Active Directory
domainUserName	Oui	String	Un compte d’utilisateur de domaine disposant d’autorisations suffisantes pour créer le cluster. Il doit être au format user@domain
domainUserPassword	Oui	String	Mot de passe du compte d’utilisateur de domaine
clusterUsersGroupDNS	No	Tableau de chaînes	Noms uniques des groupes Active Directory qui seront disponibles dans Ambari et Apache Ranger

rôle

Nom de l'élément	Obligatoire	Type	Description
name	Oui	String	Spécifie le nom du rôle
targetInstanceCount	Oui	Integer	Spécifie le nombre de instance cibles pour le rôle
hardwareProfile	Yes	Type complexe	Spécifie des informations sur le profil matériel du rôle
osProfile	Yes	Type complexe	Spécifie des informations sur le profil de système d’exploitation pour le rôle

hardwareProfile

Nom de l'élément	Obligatoire	Type	Description
vmSize	Oui	String	Spécifie la taille de la machine virtuelle. Reportez-vous aux options de configuration HDInsight (une fois sur ce lien, faites défiler jusqu’à Niveaux tarifaires node) pour connaître les tailles valides

osProfile

Nom de l'élément	Obligatoire	Type	Description
linuxOperatingSystemProfile	No	Type complexe	Spécifie les paramètres liés au système d’exploitation Linux
virtualNetworkProfile	No	Type complexe	Spécifie les paramètres liés au réseau virtuel si le cluster est déployé dans un réseau virtuel dans l’abonnement de l’utilisateur
scriptActions	No	Tableau de type complexe	Liste des actions de script à exécuter sur le cluster

linuxOperatingSystemProfile

Nom de l'élément	Obligatoire	Type	Description
Nom d’utilisateur	Oui	String	Nom d'utilisateur du SSH
sshProfile	No	Type complexe	Spécifie la clé SSH. L’un des sshProfile ou Password est requis.
Mot de passe	Non	String	Spécifie le mot de passe SSH L’un des sshProfile ou Password est requis.

sshProfile

Nom de l'élément	Obligatoire	Type	Description
publicKeys	Oui	Array	Contient une liste d’objets certificateData. La valeur est une clé publique ssh-rsa

virtualNetworkProfile

Nom de l'élément	Obligatoire	Type	Description
id	Oui	String	ID de ressource Réseau virtuel
sous-réseau	Oui	String	Spécifie le nom du sous-réseau

scriptActions

Nom de l'élément	Obligatoire	Type	Description
name	Oui	String	Nom convivial de l’action de script
URI	Oui	String	URL du fichier d’action de script
parameters	Non	String	Arguments à passer lors de l’exécution du fichier d’action de script

response

Si la validation est terminée et que la demande est acceptée, l’opération retourne 200 (OK).

Code d’état : 200 OK

Le corps de la réponse d’un cluster Linux crée à l’aide de la clé 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"  
                    }  
                }  
            ]  
        }  
    }  
}

Nom de l'élément	Type	Description
provisioningState	String	Indique l’état d’approvisionnement actuel.
clusterState	String	Indique l’état du cluster HDInsight plus détaillé pendant le provisionnement en cours.
createdDate	Date	Date/heure de réception de la demande de création de cluster
quotaInfo	Type complexe	Spécifie les cœurs Utilisés par le cluster
erreurs	Tableau de messages d’erreur	Contient le message d’erreur si provisioningState = 'failed »
connectivityEndpoints	Type complexe	Spécifie les points de terminaison publics pour le cluster

connectivityEndpoints

Nom de l'élément	Type	Description
name	String	Nom convivial pour le point de terminaison de connectivité
protocol	String	Spécifie le protocole à utiliser (exemple : HTTPS, SSH)
location	String	Spécifie l’URL à connecter
port	int	Spécifie le port à connecter

Créer un cluster avec Azure Data Lake Store comme système de fichiers par défaut

Crée un cluster dans l’abonnement spécifié avec Azure Data Lake Store comme système de fichiers par défaut. Fournissez un objet ClusterIdentity dans le corps de la demande et configurez la propriété default-filesystem avec l’URL Data Lake Store appropriée.

Azure Data Lake peut être configuré en tant que système de fichiers par défaut pour les versions de cluster à partir de la version 3.5 inclusive.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de requête
PUT	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}`

L’exemple suivant montre le corps de la demande de création d’un cluster Hadoop linux à l’aide d’Azure Data Lake Store comme système de fichiers par défaut pour le 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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}

Nom de l'élément	Obligatoire	Type	Description
id	Oui	String	Spécifie l’identificateur de ressource du cluster.
name	Oui	String	Spécifie le nom du cluster.
type	Oui	String	Spécifie le type du cluster.
location	Oui	String	Spécifie l’emplacement Azure pris en charge où le cluster doit être créé. Pour plus d’informations, consultez Répertorier tous les emplacements géographiques disponibles.
tags	Non	String	Spécifie les balises qui seront affectées au cluster. Pour plus d’informations sur l’utilisation des balises, consultez Utilisation de balises pour organiser vos ressources Azure.
Propriétés	Oui	Type complexe	Spécifie les propriétés du cluster.

Propriétés

Nom de l'élément	Obligatoire	Type	Description
clusterVersion	Oui	String	Spécifie la version du cluster
osType	Oui	String	Spécifie le système d’exploitation du cluster. La valeur valide est Linux
Niveau	Non	String	Spécifie le niveau du cluster. Les valeurs valides sont standard et premium. Si le niveau n’est pas spécifié, le cluster sera de niveau standard.
clusterDefinition	Yes	Type complexe	Spécifie des informations sur le type et les configurations de cluster
computeProfile	Yes	Type complexe	Spécifie des informations sur la topologie de cluster et les propriétés de rôle associées

clusterDefinition

Nom de l'élément	Obligatoire	Type	Description
kind	Oui	String	Spécifie le type de cluster. Les valeurs valides sont hadoop, hbase, storm & spark
configurations	Oui	Dictionnaire	Cet élément est un dictionnaire de type de configuration et son dictionnaire de valeurs associé. le type de configuration de passerelle est utilisé pour configurer l’utilisateur http utilisé pour la connexion aux API web et au portail Ambari Le type de configuration de site principal est utilisé pour configurer le compte de stockage par défaut pour le cluster

computeProfile

Nom de l'élément	Obligatoire	Type	Description
clusterVersion	Oui	String	Spécifie la version du cluster
role	Yes	Tableau de type complexe (rôle)	Spécifie des informations sur les rôles dans le cluster

rôle

Nom de l'élément	Obligatoire	Type	Description
name	Oui	String	Spécifie le nom du rôle
targetInstanceCount	Oui	Integer	Spécifie le nombre de instance cible pour le rôle
hardwareProfile	Yes	Type complexe	Spécifie des informations sur le profil matériel du rôle
osProfile	Yes	Type complexe	Spécifie des informations sur le profil du système d’exploitation pour le rôle

hardwareProfile

Nom de l'élément	Obligatoire	Type	Description
vmSize	Oui	String	Spécifie la taille de la machine virtuelle. Pour connaître les tailles valides, reportez-vous aux options de configuration HDInsight (une fois sur ce lien, faites défiler jusqu’aux niveaux tarifaires de nœud)

osProfile

Nom de l'élément	Obligatoire	Type	Description
linuxOperatingSystemProfile	No	Type complexe	Spécifie les paramètres liés au système d’exploitation Linux
virtualNetworkProfile	No	Type complexe	Spécifie les paramètres liés au réseau virtuel si le cluster est déployé dans un réseau virtuel dans l’abonnement de l’utilisateur
scriptActions	No	Tableau de type complexe	Liste des actions de script à exécuter sur le cluster

linuxOperatingSystemProfile

Nom de l'élément	Obligatoire	Type	Description
Nom d’utilisateur	Oui	String	Nom d'utilisateur du SSH
sshProfile	No	Type complexe	Spécifie la clé SSH. L’un des sshProfile ou Password est requis.
Mot de passe	Non	String	Spécifie le mot de passe SSH L’un des sshProfile ou Password est requis.

sshProfile

Nom de l'élément	Obligatoire	Type	Description
publicKeys	Oui	Array	Contient une liste d’objets certificateData. La valeur est une clé publique ssh-rsa

virtualNetworkProfile

Nom de l'élément	Obligatoire	Type	Description
id	Oui	String	ID de ressource Réseau virtuel
sous-réseau	Oui	String	Spécifie le nom du sous-réseau

scriptActions

Nom de l'élément	Obligatoire	Type	Description
name	Oui	String	Nom convivial de l’action de script
URI	Oui	String	URL du fichier d’action de script
parameters	Non	String	Arguments à passer lors de l’exécution du fichier d’action de script

response

Si la validation est terminée et que la demande est acceptée, l’opération retourne 200 (OK).

Code d’état : 200 OK

Le corps de la réponse d’un cluster Linux est créé à l’aide de la clé 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"
	}
}

Nom de l'élément	Type	Description
provisioningState	String	Indique l’état d’approvisionnement actuel.
clusterState	String	Indique l’état du cluster HDInsight plus détaillé lors de l’approvisionnement en cours.
createdDate	Date	Datetime à laquelle la demande de création de cluster a été reçue
quotaInfo	Type complexe	Spécifie les cœurs Utilisés par le cluster
erreurs	Tableau de messages d’erreur	Contient le message d’erreur si provisioningState = 'failed »
connectivityEndpoints	Type complexe	Spécifie les points de terminaison publics pour le cluster

connectivityEndpoints

Nom de l'élément	Type	Description
name	String	Nom convivial du point de terminaison de connectivité
protocol	String	Spécifie le protocole à utiliser (exemple : HTTPS, SSH)
location	String	Spécifie l’URL à connecter
port	int	Spécifie le port à connecter

Supprimer

Supprime un cluster HDInsight.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
Suppression	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}`

response

HTTP 202 (Accepté) pour indiquer que l’opération se terminera de manière asynchrone. L’interrogation asynchrone renvoie une valeur 204 (NoContent) une fois l’opération terminée.

Remarques

Pour suivre la progression d’une demande de suppression de cluster, consultez Opérations asynchrones (202 accepté et en-tête d’emplacement)

Get

Obtient les détails/propriétés du cluster spécifié.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
GET	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}`

response

L’opération retourne 200 (OK) si la demande est terminée avec succès

Code d’état : 200 OK

Le corps de la réponse est identique à celui de la création d’un cluster.

Corps de la réponse pour les détails du 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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}

Nom de l'élément	Type	Description
provisioningState	String	Indique l’état d’approvisionnement actuel.
clusterState	String	Indique l’état du cluster HDInsight plus détaillé pendant le provisionnement en cours.
createdDate	Date	Date/heure de réception de la demande de création de cluster
quotaInfo	Type complexe	Spécifie les cœurs Utilisés par le cluster
erreurs	Tableau de messages d’erreur	Contient le message d’erreur si provisioningState = 'failed »
connectivityEndpoints	Type complexe	Spécifie les points de terminaison publics pour le cluster

connectivityEndpoints

Nom de l'élément	Type	Description
name	String	Nom convivial pour le point de terminaison de connectivité
protocol	String	Spécifie le protocole à utiliser (exemple : HTTPS, SSH)
location	String	Spécifie l’URL à connecter
port	int	Spécifie le port à connecter

Répertorier les configurations

Récupère tous les détails de configuration du cluster (y compris les informations sensibles).

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
POST	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}`

response

HTTP 200 (OK) en cas de réussite de l’opération.

Exemple de réponse :

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

Nom de l'élément	Type	Description
configurations	Dictionnaire	Cet élément est un dictionnaire de type de configuration et son dictionnaire de valeurs associé. Le type de configuration de passerelle est utilisé pour configurer l’utilisateur http utilisé pour la connexion aux API web et au portail Ambari Le type de configuration de site principal est utilisé pour configurer le compte de stockage par défaut pour le cluster

Obtenir une configuration

Obtient des détails sur un type de configuration unique (omet les valeurs sensibles).

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
GET	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}`

response

HTTP 200 (OK) en cas de réussite de l’opération.

Exemple de réponse :

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

Obtenir les paramètres de la passerelle

Cette opération récupère les informations d’identification HTTP de la passerelle de cluster.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
POST	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}`

response

HTTP 200 (OK) en cas de réussite de l’opération.

Exemple de réponse :

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

Mettre à jour les paramètres de la passerelle

Cette opération permet aux utilisateurs de modifier les informations d’identification HTTP de la passerelle de cluster.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
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!"  
}

response

HTTP 202 (accepté) en cas de réussite de l’opération.

Modifier les paramètres de connectivité (DEPRECATED)

~~Cette opération permet aux utilisateurs d’activer/désactiver la connectivité HTTPS au cluster.~~

Utilisez updateGatewaySettings à la place.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
POST	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}`

Pour activer la connectivité

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

Lister par groupe de ressources

Listes tous les clusters de l’abonnement de l’utilisateur dans le groupe de ressources spécifié.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
GET	`https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}`

response

L’opération retourne 200 (OK) si la demande est terminée avec succès.

Code d’état : 200 OK

Le corps de la réponse est un tableau de détails de cluster. Pour plus d’informations, consultez Obtenir les propriétés du cluster.

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

Lister par abonnement

Listes tous les clusters de l’abonnement de l’utilisateur.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
GET	`https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}`

response

L’opération retourne 200 (OK) si la demande est terminée avec succès.

Code d’état : 200 OK

Le corps de la réponse est un tableau de détails de cluster.

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

Pour désactiver la connectivité

{  
   "restAuthCredential.isEnabled": false  
}

Nom de l'élément	Obligatoire	Type	Description
restAuthCredential.isEnabled	Oui	Boolean	Spécifie si la connectivité doit être activée ou désactivée
restAuthCredential.username	Non	String	Obligatoire si isEnabled=true Spécifie le nom d’utilisateur pour les paramètres de connectivité
restAuthCredential.password	Non	String	Obligatoire si isEnabled=true Spécifie le mot de passe pour les paramètres de connectivité

response

HTTP 202 (Accepté) pour indiquer que l’opération se terminera de manière asynchrone. L’interrogation asynchrone renvoie une valeur 204 (NoContent) une fois l’opération terminée.

Remarques

Pour suivre la progression d’une demande de suppression de cluster, consultez Opérations asynchrones (202 accepté et en-tête d’emplacement)

Modifier les paramètres RDP (cluster Windows uniquement)

Cette opération permet à un utilisateur d’activer/désactiver RDP. Elle s’applique aux clusters Windows.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
POST	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}`

Corps de la requête

Pour activer RDP

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

Pour désactiver RDP

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

osProfile

Nom de l'élément	Obligatoire	Type	Description
windowsOperatingSystemProfile	No	Type complexe	Spécifie les paramètres liés au système d’exploitation Windows

windowsOperatingSystemProfile

Nom de l'élément	Obligatoire	Type	Description
rdpSettings	No	Type complexe	Spécifie les paramètres RDP pour les clusters Windows

rdpSettings

Nom de l'élément	Obligatoire	Type	Description
username	Oui	String	Spécifie le nom d’utilisateur RDP
mot de passe	Oui	String	Spécifie le mot de passe de l’utilisateur RDP
expiryDate	Oui	Date	Date d’expiration des informations d’identification RDP

response

L’opération retourne 200 (OK) si la demande est terminée avec succès

Code d’état : 200 OK

Le corps de la réponse est identique à créer un cluster.

Exécuter des actions de script sur un cluster en cours d’exécution (cluster Linux uniquement)

Exécuter une action de script sur un cluster en cours d’exécution.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
POST	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}`

Corps de la requête

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

scriptActions

Nom de l'élément	Obligatoire	Type	Description
name	Oui	String	Spécifie le nom de l’action de script
URI	Oui	String	Spécifie l’URI de l’action de script
parameters	Oui	String	Spécifie les paramètres requis par l’action de script
roles	Yes	Tableau de chaînes	Spécifie les rôles cibles sur lequel l’action de script s’exécute
persistOnSuccess	Oui	Boolean	Spécifie si les actions de script seront conservées après des exécutions réussies

response

Si la validation est terminée et que la demande est acceptée, l’opération retourne 202 (Accepté).

Code d’état : 202 (accepté)

Répertorier toutes les actions de script persistantes pour un cluster (cluster Linux uniquement)

Cette opération retourne toutes les actions de scripts persistants du cluster spécifié.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
GET	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}`

response

HTTP 200 (OK) en cas de réussite de l’opération.

Code d’état : 200 OK

Exemple de réponse :

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

Nom de l'élément	Type	Description
name	String	Spécifie le nom de l’action de script.
URI	String	Spécifie l’URI de l’action de script.
parameters	String	Spécifie les paramètres requis par l’action de script
roles	Tableau de chaînes	Spécifie les rôles ciblés sur lequel l’action de script s’exécute.
applicationName	String	Spécifie l’application correspondante à laquelle le script est associé. applicationName a la valeur Null si le script est fourni par les utilisateurs

Supprimer une action de script persistante pour un cluster (cluster Linux uniquement)

Cette opération supprime une action de script persistant HDInsight pour un cluster.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
Suppression	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}`

response

HTTP 200 (OK) pour indiquer que l’action de script a été supprimée de la liste des actions de script persistantes.
HTTP 404 (NotFound) pour indiquer qu’il n’existe aucune action de script persistante avec scriptName correspondant.

Obtenir l’exécution de l’action de script à partir de l’historique (clusters Linux uniquement)

Cette opération retourne la dernière exécution de l’action de script du cluster spécifié ou les détails d’exécution pour une exécution de script individuelle.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
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}`

response

L’opération retourne 200 (OK) si la demande est terminée avec succès. Le corps de la réponse est un tableau de détails d’exécution de script ou un seul détail d’exécution de script si scriptExecutionId est fourni. Voici un exemple de détail d’exécution de script.

Code d’état : 200 (OK)

Exemple de réponse :

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

Nom de l'élément	Type	Description
scriptExecutionId	Long	Spécifie l’ID d’exécution de l’action de script.
name	String	Spécifie le nom de l’action de script.
applicationName	String	Spécifie l’application correspondante à laquelle le script est associé. applicationName a la valeur Null si le script est fourni par les utilisateurs
URI	String	Spécifie l’URI de l’action de script.
parameters	String	Spécifie les paramètres requis par l’action de script
roles	Tableau de chaînes	Spécifie les rôles ciblés sur lequel l’action de script s’exécute.
startTime	DateTime	Spécifie l’heure de début de l’exécution de l’action de script
endTime	DateTime	Spécifie l’heure de fin de l’exécution de l’action de script
status	String	Spécifie la status de l’exécution de l’action de script
opération	String	Spécifie la raison pour laquelle l’action de script a été exécutée. Par exemple, ScaleUp signifie que l’action de script a été exécutée pendant le scale-up du cluster.
executionSummary	Tableau de type complexe	Spécifie le résumé de l’exécution en termes du nombre d’hôtes réussis et du nombre d’hôtes qui n’ont pas pu exécuter le script.
debugInformation	String	Spécifie des informations de débogage détaillées pour le script. debugInformation est retourné uniquement lorsqu’un scriptExecutionId est fourni dans la requête.

executionSummary

Nom de l'élément	Type	Description
status	String	Spécifie le status de l’exécution sur des hôtes individuels.
instanceCount	Int	Spécifie le nombre d’exécutions avec les status correspondantes.

Promouvoir la persistance d’un script à partir de l’historique d’exécution des actions de script (cluster Linux uniquement)

Cette opération promeut la persistance d’un script HDInsight à partir de l’historique d’exécution des scripts.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
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}`

response

HTTP 200 (OK) pour indiquer que l’action de script a été promue.
HTTP 404 (NotFound) pour indiquer qu’il n’existe aucune exécution d’action de script avec scriptExecutionId correspondant.

Redimensionner

Redimensionne un cluster HDInsight existant.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
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}`

Voici un exemple de demande de mise à jour des balises pour un cluster

{  
    "targetInstanceCount": 10  
}

Nom de l'élément	Obligatoire	Type	Description
targetInstanceCount	Yes	Int	Spécifie le nouveau nombre de instance pour le rôle

response

HTTP 202 (Accepté) pour indiquer que l’opération se terminera de manière asynchrone. L’interrogation asynchrone renvoie une valeur 204 (NoContent) une fois l’opération terminée.

Remarques

Pour suivre la progression d’une demande de suppression de cluster, consultez Opérations asynchrones (202 accepté et en-tête d’emplacement)

Update

Mises à jour balises pour un cluster.

Toutes les autres mises à jour sont des actions distinctes décrites séparément.

Requête

Consultez Paramètres et en-têtes communs pour les en-têtes et les paramètres utilisés par les clusters.

Méthode	URI de demande
PATCH	`https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}`

Voici un exemple de demande de mise à jour des balises pour un cluster

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

Nom de l'élément	Obligatoire	Type	Description
tags	Oui	String	Spécifie les balises qui seront affectées au cluster. Pour plus d’informations sur l’utilisation des balises, consultez Utilisation de balises pour organiser vos ressources Azure.

response

L’opération retourne 200 (OK) si la demande est terminée avec succès.

Code d’état : 200 OK

Le corps de la réponse est identique à créer un cluster.

Partager via

API REST de cluster dans Azure HDInsight

Créer

Requête

Propriétés

clusterDefinition

computeProfile

rôle

hardwareProfile

osProfile

linuxOperatingSystemProfile

sshProfile

windowsOperatingSystemProfile

rdpSettings

virtualNetworkProfile

scriptActions

response

connectivityEndpoints

Créer un cluster HDInsight premium joint à un domaine (Linux uniquement, préversion)

Requête

Propriétés

clusterDefinition

computeProfile

securityProfile

rôle

hardwareProfile

osProfile

linuxOperatingSystemProfile

sshProfile

virtualNetworkProfile

scriptActions

response

connectivityEndpoints

Créer un cluster avec Azure Data Lake Store comme système de fichiers par défaut

Requête

Propriétés

clusterDefinition

computeProfile

rôle

hardwareProfile

osProfile

linuxOperatingSystemProfile

sshProfile

virtualNetworkProfile

scriptActions

response

connectivityEndpoints

Supprimer

Requête

response

Remarques

Get

Requête

response

connectivityEndpoints

Répertorier les configurations

Requête

response

Obtenir une configuration

Requête

response

Obtenir les paramètres de la passerelle

Requête

response

Mettre à jour les paramètres de la passerelle

Requête

response

Modifier les paramètres de connectivité (DEPRECATED)

Requête

Lister par groupe de ressources

Requête

response

Lister par abonnement

Requête

response

response

Remarques

Modifier les paramètres RDP (cluster Windows uniquement)

Requête

osProfile