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.

L’exemple suivant illustre le corps de la demande de création d’un cluster hadoop basé sur 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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Propriétés

clusterDefinition

calculProfile

rôle

matérielProfil

osProfile

linuxOperatingSystemProfile

sshProfile

windowsOperatingSystemProfile

rdpSettings

virtualNetworkProfile

scriptActions

Réponse

Si la validation est terminée et que la demande est acceptée, l’opération renverra 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/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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

connectivitéPoints de terminaison

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

Créez un cluster joint à un domaine premium 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.

L’exemple suivant illustre le corps de la demande de création d’un cluster Hadoop Premium basé sur Linux, 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"
						}
					}
				}
			]
		}
	}
}  
  

Propriétés

clusterDefinition

calculProfile

securityProfile

rôle

matérielProfil

osProfile

linuxOperatingSystemProfile

sshProfile

virtualNetworkProfile

scriptActions

Réponse

Si la validation est terminée et que la demande est acceptée, l’opération renverra 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/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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

connectivitéPoints de terminaison

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é comme système de fichiers par défaut pour les versions de cluster à partir de la version 3.5 incluse.

Requête

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

L’exemple suivant montre le corps de la demande de création d’un cluster Hadoop basé sur 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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}  

Propriétés

clusterDefinition

calculProfile

rôle

matérielProfil

osProfile

linuxOperatingSystemProfile

sshProfile

virtualNetworkProfile

scriptActions

Réponse

Si la validation est terminée et que la demande est acceptée, l’opération renverra 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"
	}
}  

connectivitéPoints de terminaison

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.

Réponse

HTTP 202 (Accepté) pour indiquer que l’opération se terminera de manière asynchrone. L’interrogation asynchrone renvoie la 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 (en-tête 202 Accepted et Location)

Obtenir

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.

Réponse

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

Code d’état : 200 OK

Le corps de la réponse est le même que 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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}  
  

connectivitéPoints de terminaison

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.

Réponse

HTTP 200 (OK) à la fin 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"  
      }  
}  
  

Obtenir une configuration

Obtient des détails sur un seul type de configuration (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.

Réponse

HTTP 200 (OK) à la fin 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.

Réponse

HTTP 200 (OK) à la fin 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.

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

Réponse

HTTP 202 (Accepté) à la fin de l’opération.

Modifier les paramètres de connectivité (OBSOLÈTE)

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.

Pour activer la connectivité

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

Lister par groupe de ressources

Répertorie 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.

Réponse

L’opération renverra 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 du cluster. Pour plus d’informations, consultez Obtenir les propriétés du cluster.

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

Lister par abonnement

Répertorie 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.

Réponse

L’opération renverra 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 du cluster.

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

Pour désactiver la connectivité

{  
   "restAuthCredential.isEnabled": false  
}  
  

Réponse

HTTP 202 (Accepté) pour indiquer que l’opération se terminera de manière asynchrone. L’interrogation asynchrone renvoie la 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 (en-tête 202 Accepted et Location)

Modifier les paramètres RDP (cluster Windows uniquement)

Cette opération permet à un utilisateur d’activer/désactiver RDP. Il s’applique aux clusters basés sur 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.

Corps de la demande

Pour activer RDP

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

Pour désactiver RDP

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

osProfile

windowsOperatingSystemProfile

rdpSettings

Réponse

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

Code d’état : 200 OK

Le corps de la réponse est le même que celui de la création d’un cluster.

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

Exécuter l’action 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.

Corps de la demande

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

scriptActions

Réponse

Si la validation est terminée et que la demande est acceptée, l’opération renverra 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.

Réponse

HTTP 200 (OK) à la fin 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  
  },  
  ...  
]  
}  

Suppression d’une action de script persistante pour un cluster (cluster Linux uniquement)

Cette opération supprime une action de script persistante 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.

Réponse

• 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 renvoie la dernière exécution de l’action de script du cluster spécifié ou les détails d’exécution d’un script individuel.

Requête

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

Réponse

L’opération renverra 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. Vous trouverez ci-dessous 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"  
}  
  

exécutionRésumé

Promouvoir un script à partir de l’historique d’exécution de l’action de script pour qu’il soit conservé (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.

Réponse

• HTTP 200 (OK) pour indiquer que l’action de script a été promue.

• HTTP 404 (NotFound) pour indiquer qu’il n’y a pas d’exécution d’action de script existante 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.

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

{  
    "targetInstanceCount": 10  
}  

Réponse

HTTP 202 (Accepté) pour indiquer que l’opération se terminera de manière asynchrone. L’interrogation asynchrone renvoie la 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 (en-tête 202 Accepted et Location)

Mise à jour

Met à jour les balises d’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.

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

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

Réponse

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

Code d’état : 200 OK

Le corps de la réponse est le même que celui de la création d’un cluster.