Partager via


API REST de cluster dans Azure HDInsight

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.