Cluster-REST-API in Azure HDInsight

Erstellen

Erstellt einen Cluster im angegebenen Abonnement.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Das folgende Beispiel zeigt den Anforderungstext zum Erstellen eines Linux-basierten Hadoop-Clusters. Beispiele für das Erstellen von Clustern auf andere Weise finden Sie im Abschnitt Beispiele weiter unten.

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

Eigenschaften

clusterDefinition

computeProfile

Rolle

HardwareProfil

osProfile

linuxOperatingSystemProfil

sshProfil

windowsOperatingSystemProfil

rdpEinstellungen

virtualNetworkProfil

scriptActions

Antwort

Wenn die Überprüfung abgeschlossen ist und die Anforderung akzeptiert wird, gibt der Vorgang 200 (OK) zurück.

Statuscode: 200 OK

Antworttext für einen Linux-Cluster, der mit dem SSH-Schlüssel erstellt wird:

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

KonnektivitätEndpunkte

Erstellen eines in die Domäne eingebundenen HDInsight-Premiumclusters (nur Linux, Vorschau)

Erstellen Sie mit Apache Ranger einen in Premium-Domänen eingebundenen Cluster. Der Benutzer muss SecurityProfile im Anforderungstext angeben, um einen sicheren Cluster zu erstellen.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Das folgende Beispiel zeigt den Anforderungstext zum Erstellen eines Linux-basierten, in die Domäne eingebundenen Premium-Hadoop-Clusters.

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

Eigenschaften

clusterDefinition

computeProfile

securityProfile

Rolle

HardwareProfil

osProfile

linuxOperatingSystemProfil

sshProfil

virtualNetworkProfil

scriptActions

Antwort

Wenn die Überprüfung abgeschlossen ist und die Anforderung akzeptiert wird, gibt der Vorgang 200 (OK) zurück.

Statuscode: 200 OK

Antworttext für einen Linux-Cluster, der mit dem SSH-Schlüssel erstellt wird:

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

KonnektivitätEndpunkte

Erstellen eines Clusters mit Azure Data Lake Store als Standarddateisystem

Erstellt einen Cluster im angegebenen Abonnement mit Azure Data Lake Store als Standarddateisystem. Geben Sie ein ClusterIdentity-Objekt im Anforderungstext an, und konfigurieren Sie die default-filesystem-Eigenschaft mit der entsprechenden Data Lake Store-URL.

Azure Data Lake kann als Standarddateisystem für Clusterversionen ab 3.5 konfiguriert werden.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Das folgende Beispiel zeigt den Anforderungstext zum Erstellen eines Linux-basierten Hadoop-Clusters mit Azure Data Lake Store als Standarddateisystem für den 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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}  

Eigenschaften

clusterDefinition

computeProfile

Rolle

HardwareProfil

osProfile

linuxOperatingSystemProfil

sshProfil

virtualNetworkProfil

scriptActions

Antwort

Wenn die Überprüfung abgeschlossen ist und die Anforderung akzeptiert wird, gibt der Vorgang 200 (OK) zurück.

Statuscode: 200 OK

Antworttext für einen Linux-Cluster, der mit dem SSH-Schlüssel erstellt wird:

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

KonnektivitätEndpunkte

Löschen

Löscht einen HDInsight-Cluster.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

HTTP 202 (Akzeptiert), um anzugeben, dass der Vorgang asynchron abgeschlossen wird. Der asynchrone Abruf gibt 204 (NoContent) zurück, sobald der Vorgang erfolgreich abgeschlossen wurde.

Bemerkungen

Informationen zum Nachverfolgen des Fortschritts einer Löschclusteranforderung finden Sie unter Asynchrone Vorgänge (202 Accepted und Location Header)

Herunterladen

Ruft die Details/Eigenschaften des angegebenen Clusters ab.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

Der Vorgang gibt 200 (OK) zurück, wenn die Anforderung erfolgreich abgeschlossen wurde

Statuscode: 200 OK

Der Antworttext ist identisch mit dem zum Erstellen eines Clusters.

Details zum Antworttext für Linux-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.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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}  
  

KonnektivitätEndpunkte

Konfigurationen auflisten

Ruft alle Details zur Clusterkonfiguration (einschließlich vertraulicher Informationen) ab.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

HTTP 200 (OK) nach erfolgreichem Abschluss des Vorgangs.

Beispielantwort:

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

Konfiguration abrufen

Ruft Details zu einem einzelnen Konfigurationstyp ab (vertrauliche Werte werden ausgelassen).

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

HTTP 200 (OK) nach erfolgreichem Abschluss des Vorgangs.

Beispielantwort:

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

Abrufen von Gatewayeinstellungen

Dieser Vorgang ruft die HTTP-Anmeldeinformationen des Clustergateways ab.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

HTTP 200 (OK) nach erfolgreichem Abschluss des Vorgangs.

Beispielantwort:

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

Aktualisieren der Gateway-Einstellungen

Dieser Vorgang ermöglicht es Benutzern, die HTTP-Anmeldeinformationen des Clustergateways zu ändern.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

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

Antwort

HTTP 202 (Akzeptiert) nach erfolgreichem Abschluss des Vorgangs.

Ändern der Konnektivitätseinstellungen (VERALTET)

Dieser Vorgang ermöglicht es Benutzern, die HTTPS-Konnektivität mit dem Cluster zu aktivieren/deaktivieren.

Verwenden Sie stattdessen updateGatewaySettings .

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

So aktivieren Sie Konnektivität

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

Auflistung nach Ressourcengruppe

Listet alle Cluster im Abonnement des Benutzers in der angegebenen Ressourcengruppe auf.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

Der Vorgang gibt 200 (OK) zurück, wenn die Anforderung erfolgreich abgeschlossen wurde.

Statuscode: 200 OK

Der Antworttext ist ein Array von Clusterdetails. Weitere Informationen finden Sie unter Abrufen von Clustereigenschaften.

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

Nach Abonnement auflisten

Listet alle Cluster im Abonnement des Benutzers auf.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

Der Vorgang gibt 200 (OK) zurück, wenn die Anforderung erfolgreich abgeschlossen wurde.

Statuscode: 200 OK

Der Antworttext ist ein Array von Clusterdetails.

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

So deaktivieren Sie die Konnektivität

{  
   "restAuthCredential.isEnabled": false  
}  
  

Antwort

HTTP 202 (Akzeptiert), um anzugeben, dass der Vorgang asynchron abgeschlossen wird. Der asynchrone Abruf gibt 204 (NoContent) zurück, sobald der Vorgang erfolgreich abgeschlossen wurde.

Bemerkungen

Informationen zum Nachverfolgen des Fortschritts einer Löschclusteranforderung finden Sie unter Asynchrone Vorgänge (202 Accepted und Location Header)

Ändern der RDP-Einstellungen (nur Windows-Cluster)

Dieser Vorgang ermöglicht es einem Benutzer, RDP zu aktivieren/deaktivieren. Sie gilt für Windows-basierte Cluster.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Anforderungstext

So aktivieren Sie RDP

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

So deaktivieren Sie RDP

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

osProfile

windowsOperatingSystemProfil

rdpEinstellungen

Antwort

Der Vorgang gibt 200 (OK) zurück, wenn die Anforderung erfolgreich abgeschlossen wurde

Statuscode: 200 OK

Der Antworttext ist identisch mit dem Erstellen eines Clusters.

Ausführen von Skriptaktionen auf einem ausgeführten Cluster (nur Linux-Cluster)

Ausführen der Skriptaktion auf einem ausgeführten Cluster.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Anforderungstext

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

scriptActions

Antwort

Wenn die Überprüfung abgeschlossen ist und die Anforderung akzeptiert wird, gibt der Vorgang 202 (Akzeptiert) zurück.

Statuscode: 202 (Akzeptiert)

Auflisten aller persistenten Skriptaktionen für einen Cluster (nur Linux-Cluster)

Dieser Vorgang gibt alle Aktionen des persistenten Skripts des angegebenen Clusters zurück.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

HTTP 200 (OK) nach erfolgreichem Abschluss des Vorgangs.

Statuscode: 200 OK

Beispielantwort:

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

Entfernen einer persistenten Skriptaktion für einen Cluster (nur Linux-Cluster)

Mit diesem Vorgang wird eine persistente HDInsight-Skriptaktion für einen Cluster entfernt.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

• HTTP 200 (OK), um anzugeben, dass die Skriptaktion aus der Liste der persistenten Skriptaktionen entfernt wurde.

• HTTP 404 (NotFound), um anzugeben, dass keine persistente Skriptaktion mit entsprechendem scriptName vorhanden ist.

Abrufen der Ausführung von Skriptaktionen aus dem Verlauf (nur Linux-Cluster)

Dieser Vorgang gibt die Ausführung der letzten Skriptaktionen des angegebenen Clusters oder Ausführungsdetails für eine einzelne Skriptausführung zurück.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

Der Vorgang gibt 200 (OK) zurück, wenn die Anforderung erfolgreich abgeschlossen wurde. Der Antworttext ist ein Array von Details zur Skriptausführung oder Details zur einzelnen Skriptausführung, wenn scriptExecutionId angegeben wird. Nachfolgend finden Sie ein Beispiel für ein Detail zur Skriptausführung.

Statuscode: 200 (OK)

Beispielantwort:

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

executionZusammenfassung

Heraufstufen eines Skripts aus dem Ausführungsverlauf der Skriptaktion, das beibehalten wird (nur Linux-Cluster)

Dieser Vorgang stuft ein HDInsight-Skript aus dem Skriptausführungsverlauf herauf, das beibehalten werden soll.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Antwort

• HTTP 200 (OK), um anzugeben, dass die Skriptaktion heraufgestuft wurde.

• HTTP 404 (NotFound), um anzugeben, dass keine Skriptaktionsausführung mit der entsprechenden scriptExecutionId vorhanden ist.

Größe ändern

Ändert die Größe eines vorhandenen HDInsight-Clusters.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Im Folgenden sehen Sie ein Beispiel für eine Anforderung zum Aktualisieren von Tags für einen Cluster

{  
    "targetInstanceCount": 10  
}  

Antwort

HTTP 202 (Akzeptiert), um anzugeben, dass der Vorgang asynchron abgeschlossen wird. Der asynchrone Abruf gibt 204 (NoContent) zurück, sobald der Vorgang erfolgreich abgeschlossen wurde.

Bemerkungen

Informationen zum Nachverfolgen des Fortschritts einer Löschclusteranforderung finden Sie unter Asynchrone Vorgänge (202 Accepted und Location Header)

Aktualisierung

Aktualisiert Tags für einen Cluster.

Alle anderen Updates sind separate Aktionen, die separat beschrieben werden.

Anfrage

Unter Allgemeine Parameter und Header finden Sie Header und Parameter, die von Clustern verwendet werden.

Im Folgenden sehen Sie ein Beispiel für eine Anforderung zum Aktualisieren von Tags für einen Cluster

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

Antwort

Der Vorgang gibt 200 (OK) zurück, wenn die Anforderung erfolgreich abgeschlossen wurde.

Statuscode: 200 OK

Der Antworttext ist identisch mit dem Erstellen eines Clusters.