Udostępnij za pośrednictwem

Interfejs API REST klastra w usłudze Azure HDInsight

  • Artykuł

Utwórz

Tworzy klaster w określonej subskrypcji.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

W poniższym przykładzie przedstawiono treść żądania tworzenia klastra hadoop opartego na systemie Linux. Przykłady tworzenia klastrów na inne sposoby można znaleźć w poniższej sekcji Przykłady.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
Nazwa elementu Wymagany Typ Opis
identyfikator Tak Ciąg Określa identyfikator zasobu klastra.
name Tak Ciąg Określa nazwę klastra.
typ Tak Ciąg Określa typ klastra.
location Tak Ciąg Określa obsługiwaną lokalizację platformy Azure, w której należy utworzyć klaster. Aby uzyskać więcej informacji, zobacz Wyświetlanie listy wszystkich dostępnych lokalizacji geograficznych.
tags Nie Ciąg Określa tagi, które zostaną przypisane do klastra. Aby uzyskać więcej informacji na temat używania tagów, zobacz Używanie tagów do organizowania zasobów platformy Azure.
Właściwości Tak Typ złożony Określa właściwości klastra.

Właściwości

Nazwa elementu Wymagany Typ Opis
clusterVersion Tak Ciąg Określa wersję klastra
osType Tak Ciąg Określa system operacyjny klastra.

Prawidłowe wartości to Linux i Windows
clusterDefinition Tak Typ złożony Określa informacje o typie i konfiguracjach klastra
computeProfile Tak Typ złożony Określa informacje o topologii klastra i skojarzonych właściwościach roli

clusterDefinition

Nazwa elementu Wymagany Typ Opis
Rodzaju Tak Ciąg Określa typ klastra.

Prawidłowe wartości to hadoop, hbase, storm & spark
Konfiguracji Tak Słownik Ten element jest słownikiem typu konfiguracji i skojarzonym ze nim słownikiem wartości.

typ konfiguracji bramy służy do konfigurowania użytkownika http używanego do nawiązywania połączenia z internetowymi interfejsami API i portalem Ambari

typ konfiguracji core-site służy do konfigurowania domyślnego konta magazynu dla klastra

computeProfile

Nazwa elementu Wymagany Typ Opis
clusterVersion Tak Ciąg Określa wersję klastra
Roli Tak Tablica typu złożonego (rola) Określa informacje o rolach w klastrze

role (rola)

Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Określa nazwę roli
targetInstanceCount Tak Liczba całkowita Określa liczbę wystąpień docelowych dla roli
hardwareProfile Tak Typ złożony Określa informacje o profilu sprzętowym roli
osProfile Tak Typ złożony Określa informacje o profilu systemu operacyjnego dla roli

hardwareProfile

Nazwa elementu Wymagany Typ Opis
vmSize Tak Ciąg Określa rozmiar maszyny wirtualnej. Zapoznaj się z opcjami konfiguracji usługi HDInsight (po kliknięciu tego linku przewiń w dół do warstw cenowych węzła) w celu uzyskania prawidłowych rozmiarów

osProfile

Nazwa elementu Wymagany Typ Opis
linuxOperatingSystemProfile Nie Typ złożony Określa ustawienia związane z systemem operacyjnym Linux
windowsOperatingSystemProfile Nie Typ złożony Określa ustawienia związane z systemem operacyjnym Windows
virtualNetworkProfile Nie Typ złożony Określa ustawienia związane z siecią wirtualną, jeśli klaster jest wdrażany w sieci wirtualnej w subskrypcji użytkownika
scriptActions Nie Tablica typu złożonego Lista akcji skryptu do wykonania w klastrze

linuxOperatingSystemProfile

Nazwa elementu Wymagany Typ Opis
Nazwa użytkownika Tak Ciąg Nazwa użytkownika SSH
sshProfile Nie Typ złożony Określa klucz SSH.

Wymagany jest jeden z plików sshProfile lub password.
Hasło Nie Ciąg Określa hasło SSH

Wymagany jest jeden z plików sshProfile lub password.

sshProfile

Nazwa elementu Wymagany Typ Opis
publicKeys Tak Tablica Zawiera listę obiektów certificateData. Wartość jest kluczem publicznym ssh-rsa

windowsOperatingSystemProfile

Nazwa elementu Wymagany Typ Opis
rdpSettings Nie Typ złożony Określa ustawienia protokołu RDP dla klastrów systemu Windows

rdpSettings

Nazwa elementu Wymagany Typ Opis
nazwa użytkownika Tak Ciąg Określa nazwę użytkownika protokołu RDP
hasło Tak Ciąg Określa hasło użytkownika RDP
data wygaśnięcia Tak Date Data wygaśnięcia poświadczeń protokołu RDP

virtualNetworkProfile

Nazwa elementu Wymagany Typ Opis
identyfikator Tak Ciąg identyfikator zasobu Virtual Network
podsieć Tak Ciąg Określa nazwę podsieci

scriptActions

Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Przyjazna nazwa akcji skryptu
Identyfikator uri Tak Ciąg Adres URL pliku akcji skryptu
parameters Nie Ciąg Argumenty do przekazania podczas wykonywania pliku akcji skryptu

Reakcja

Jeśli weryfikacja zostanie ukończona i żądanie zostanie zaakceptowane, operacja zwróci wartość 200 (OK).

Kod stanu: 200 OK

Treść odpowiedzi dla klastra systemu Linux tworzy się przy użyciu klucza 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"  
                    }  
                }  
            ]  
        }  
    }  
}
Nazwa elementu Typ Opis
provisioningState Ciąg Wskazuje bieżący stan aprowizacji.
clusterState Ciąg Wskazuje bardziej szczegółowy stan klastra usługi HDInsight podczas aprowizacji.
createdDate Date Data/godzina odebrania żądania utworzenia klastra
quotaInfo Typ złożony Określa rdzenieusuwane przez klaster
błędy Tablica komunikatów o błędach Zawiera komunikat o błędzie, jeśli provisioningState = "failed"
connectivityEndpoints Typ złożony Określa publiczne punkty końcowe dla klastra

connectivityEndpoints

Nazwa elementu Typ Opis
name Ciąg Przyjazna nazwa punktu końcowego łączności
Protokół Ciąg Określa protokół do użycia (na przykład: HTTPS, SSH)
location Ciąg Określa adres URL do nawiązania połączenia
port int Określa port do nawiązania połączenia

Tworzenie klastra usługi HDInsight przyłączonego do domeny w warstwie Premium (tylko system Linux, wersja zapoznawcza)

Utwórz klaster przyłączony do domeny w warstwie Premium przy użyciu platformy Apache Ranger. Użytkownik musi podać element SecurityProfile w treści żądania, aby utworzyć bezpieczny klaster.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

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

W poniższym przykładzie przedstawiono treść żądania tworzenia klastra Hadoop opartego na systemie Linux, premium i przyłączonego do domeny.

{
	"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"
						}
					}
				}
			]
		}
	}
}
Nazwa elementu Wymagany Typ Opis
identyfikator Tak Ciąg Określa identyfikator zasobu klastra.
name Tak Ciąg Określa nazwę klastra.
typ Tak Ciąg Określa typ klastra.
location Tak Ciąg Określa obsługiwaną lokalizację platformy Azure, w której ma zostać utworzony klaster. Aby uzyskać więcej informacji, zobacz Wyświetlanie listy wszystkich dostępnych lokalizacji geograficznych.
tags Nie Ciąg Określa tagi, które zostaną przypisane do klastra. Aby uzyskać więcej informacji na temat używania tagów, zobacz Organizowanie zasobów platformy Azure przy użyciu tagów.
Właściwości Tak Typ złożony Określa właściwości klastra.

Właściwości

Nazwa elementu Wymagany Typ Opis
clusterVersion Tak Ciąg Określa wersję klastra
osType Tak Ciąg Określa system operacyjny klastra.

Prawidłowa wartość to Linux, ponieważ tylko typy klastrów systemu Linux mogą dołączać do domeny Azure AD.
tier Nie Ciąg Wartość domyślna to standardowa. Prawidłowe wartości to Standardowa i Premium. Jeśli żadna wartość nie zostanie określona, przyjmuje się, że wartość jest standardowa. Określa warstwę klastra. Klastry przyłączone do domeny są obsługiwane tylko w warstwie Premium
clusterDefinition Tak Typ złożony Określa informacje o typie klastra i konfiguracjach
computeProfile Tak Typ złożony Określa informacje o topologii klastra i skojarzonych właściwościach roli
securityProfile Nie Typ złożony Jeśli tworzony jest bezpieczny klaster przyłączony do domeny, ten element określa ustawienia związane z usługą Active Directory

clusterDefinition

Nazwa elementu Wymagany Typ Opis
Rodzaju Tak Ciąg Określa typ klastra.

Prawidłowe wartości to hadoop, hbase, storm & spark
Konfiguracji Tak Słownik Ten element jest słownikiem typu konfiguracji i skojarzonym ze nim słownikiem wartości.

Typ konfiguracji bramy służy do konfigurowania użytkownika HTTP używanego do nawiązywania połączenia z internetowymi interfejsami API i portalem Ambari

Typ konfiguracji core-site służy do konfigurowania domyślnego konta magazynu dla klastra

computeProfile

Nazwa elementu Wymagany Typ Opis
clusterVersion Tak Ciąg Określa wersję klastra
Roli Tak Tablica typu złożonego (rola) Określa informacje o rolach w klastrze

securityProfile

Nazwa elementu Wymagany Typ Opis
directoryType Tak Ciąg Typ używanego katalogu LDAP. Obecnie wartość "ActiveDirectory" jest jedyną obsługiwaną wartością.
domena Tak Ciąg Domena usługi Active Directory dla klastra
organizationalUnitDN Tak Ciąg Nazwa wyróżniająca jednostki organizacyjnej w usłudze Active Directory, w której zostaną utworzone konta użytkowników i komputerów
ldapsUrls Tak Tablica ciągów Adresy URL jednego lub wielu serwerów LDAPS dla usługi Active Directory
domainUserName Tak Ciąg Konto użytkownika domeny z wystarczającymi uprawnieniami do tworzenia klastra. Powinien być w formacie user@domain
domainUserPassword Tak Ciąg Hasło do konta użytkownika domeny
clusterUsersGroupDNS Nie Tablica ciągów Nazwy wyróżniające grup usługi Active Directory, które będą dostępne w systemach Ambari i Apache Ranger

role (rola)

Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Określa nazwę roli
targetInstanceCount Tak Liczba całkowita Określa liczbę wystąpień docelowych dla roli
hardwareProfile Tak Typ złożony Określa informacje o profilu sprzętowym roli
osProfile Tak Typ złożony Określa informacje o profilu systemu operacyjnego dla roli

hardwareProfile

Nazwa elementu Wymagany Typ Opis
vmSize Tak Ciąg Określa rozmiar maszyny wirtualnej. Zapoznaj się z opcjami konfiguracji usługi HDInsight (po kliknięciu tego linku przewiń w dół do warstw cenowych węzła) w celu uzyskania prawidłowych rozmiarów

osProfile

Nazwa elementu Wymagany Typ Opis
linuxOperatingSystemProfile Nie Typ złożony Określa ustawienia związane z systemem operacyjnym Linux
virtualNetworkProfile Nie Typ złożony Określa ustawienia związane z siecią wirtualną, jeśli klaster jest wdrażany w sieci wirtualnej w subskrypcji użytkownika
scriptActions Nie Tablica typu złożonego Lista akcji skryptu do wykonania w klastrze

linuxOperatingSystemProfile

Nazwa elementu Wymagany Typ Opis
Nazwa użytkownika Tak Ciąg Nazwa użytkownika SSH
sshProfile Nie Typ złożony Określa klucz SSH.

Wymagany jest jeden z plików sshProfile lub password.
Hasło Nie Ciąg Określa hasło SSH

Wymagany jest jeden z plików sshProfile lub password.

sshProfile

Nazwa elementu Wymagany Typ Opis
publicKeys Tak Tablica Zawiera listę obiektów certificateData. Wartość jest kluczem publicznym ssh-rsa

virtualNetworkProfile

Nazwa elementu Wymagany Typ Opis
identyfikator Tak Ciąg Virtual Network identyfikator zasobu
podsieć Tak Ciąg Określa nazwę podsieci

scriptActions

Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Przyjazna nazwa akcji skryptu
Identyfikator uri Tak Ciąg Adres URL pliku akcji skryptu
parameters Nie Ciąg Argumenty do przekazania podczas wykonywania pliku akcji skryptu

Reakcja

Jeśli weryfikacja zostanie ukończona i żądanie zostanie zaakceptowane, operacja zwróci wartość 200 (OK).

Kod stanu: 200 OK

Treść odpowiedzi dla klastra systemu Linux tworzy się przy użyciu klucza 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"  
                    }  
                }  
            ]  
        }  
    }  
}
Nazwa elementu Typ Opis
provisioningState Ciąg Wskazuje bieżący stan aprowizacji.
clusterState Ciąg Wskazuje bardziej szczegółowy stan klastra usługi HDInsight podczas aprowizacji.
createdDate Date Data/godzina odebrania żądania utworzenia klastra
quotaInfo Typ złożony Określa rdzenieusuwane przez klaster
błędy Tablica komunikatów o błędach Zawiera komunikat o błędzie, jeśli provisioningState = "failed"
connectivityEndpoints Typ złożony Określa publiczne punkty końcowe dla klastra

connectivityEndpoints

Nazwa elementu Typ Opis
name Ciąg Przyjazna nazwa punktu końcowego łączności
Protokół Ciąg Określa protokół do użycia (na przykład: HTTPS, SSH)
location Ciąg Określa adres URL do nawiązania połączenia
port int Określa port do nawiązania połączenia

Tworzenie klastra za pomocą usługi Azure Data Lake Store jako domyślnego systemu plików

Tworzy klaster w określonej subskrypcji z usługą Azure Data Lake Store jako domyślnym systemem plików. Podaj obiekt ClusterIdentity w treści żądania i skonfiguruj właściwość default-filesystem przy użyciu odpowiedniego adresu URL usługi Data Lake Store.

Usługę Azure Data Lake można skonfigurować jako domyślny system plików dla wersji klastra, począwszy od 3,5 włącznie.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

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

Poniższy przykład przedstawia treść żądania tworzenia klastra Hadoop opartego na systemie Linux przy użyciu usługi Azure Data Lake Store jako domyślnego systemu plików dla klastra.

{
	"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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
Nazwa elementu Wymagany Typ Opis
identyfikator Tak Ciąg Określa identyfikator zasobu klastra.
name Tak Ciąg Określa nazwę klastra.
typ Tak Ciąg Określa typ klastra.
location Tak Ciąg Określa obsługiwaną lokalizację platformy Azure, w której ma zostać utworzony klaster. Aby uzyskać więcej informacji, zobacz Wyświetlanie listy wszystkich dostępnych lokalizacji geograficznych.
tags Nie Ciąg Określa tagi, które zostaną przypisane do klastra. Aby uzyskać więcej informacji na temat używania tagów, zobacz Organizowanie zasobów platformy Azure przy użyciu tagów.
Właściwości Tak Typ złożony Określa właściwości klastra.

Właściwości

Nazwa elementu Wymagany Typ Opis
clusterVersion Tak Ciąg Określa wersję klastra
osType Tak Ciąg Określa system operacyjny klastra.

Prawidłowa wartość to Linux
tier Nie Ciąg Określa warstwę klastra. Prawidłowe wartości to standardowa i premium. Jeśli warstwa nie zostanie określona, klaster będzie w warstwie Standardowa.
clusterDefinition Tak Typ złożony Określa informacje o typie i konfiguracjach klastra
computeProfile Tak Typ złożony Określa informacje o topologii klastra i skojarzonych właściwościach roli

clusterDefinition

Nazwa elementu Wymagany Typ Opis
Rodzaju Tak Ciąg Określa typ klastra.

Prawidłowe wartości to hadoop, hbase, storm & spark
Konfiguracji Tak Słownik Ten element jest słownikiem typu konfiguracji i skojarzonym ze nim słownikiem wartości.

typ konfiguracji bramy służy do konfigurowania użytkownika http używanego do nawiązywania połączenia z internetowymi interfejsami API i portalem Ambari

typ konfiguracji core-site służy do konfigurowania domyślnego konta magazynu dla klastra

computeProfile

Nazwa elementu Wymagany Typ Opis
clusterVersion Tak Ciąg Określa wersję klastra
Roli Tak Tablica typu złożonego (rola) Określa informacje o rolach w klastrze

role (rola)

Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Określa nazwę roli
targetInstanceCount Tak Liczba całkowita Określa liczbę wystąpień docelowych dla roli
hardwareProfile Tak Typ złożony Określa informacje o profilu sprzętowym roli
osProfile Tak Typ złożony Określa informacje o profilu systemu operacyjnego dla roli

hardwareProfile

Nazwa elementu Wymagany Typ Opis
vmSize Tak Ciąg Określa rozmiar maszyny wirtualnej. Zapoznaj się z opcjami konfiguracji usługi HDInsight (po kliknięciu tego linku przewiń w dół do warstw cenowych węzła) w celu uzyskania prawidłowych rozmiarów

osProfile

Nazwa elementu Wymagany Typ Opis
linuxOperatingSystemProfile Nie Typ złożony Określa ustawienia związane z systemem operacyjnym Linux
virtualNetworkProfile Nie Typ złożony Określa ustawienia związane z siecią wirtualną, jeśli klaster jest wdrażany w sieci wirtualnej w subskrypcji użytkownika
scriptActions Nie Tablica typu złożonego Lista akcji skryptu do wykonania w klastrze

linuxOperatingSystemProfile

Nazwa elementu Wymagany Typ Opis
Nazwa użytkownika Tak Ciąg Nazwa użytkownika SSH
sshProfile Nie Typ złożony Określa klucz SSH.

Wymagany jest jeden z plików sshProfile lub Password.
Hasło Nie Ciąg Określa hasło SSH

Wymagany jest jeden z plików sshProfile lub Password.

sshProfile

Nazwa elementu Wymagany Typ Opis
publicKeys Tak Tablica Zawiera listę obiektów certificateData. Wartość jest kluczem publicznym ssh-rsa

virtualNetworkProfile

Nazwa elementu Wymagany Typ Opis
identyfikator Tak Ciąg identyfikator zasobu Virtual Network
podsieć Tak Ciąg Określa nazwę podsieci

scriptActions

Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Przyjazna nazwa akcji skryptu
Identyfikator uri Tak Ciąg Adres URL pliku akcji skryptu
parameters Nie Ciąg Argumenty do przekazania podczas wykonywania pliku akcji skryptu

Reakcja

Jeśli weryfikacja zostanie ukończona i żądanie zostanie zaakceptowane, operacja zwróci wartość 200 (OK).

Kod stanu: 200 OK

Treść odpowiedzi dla klastra systemu Linux tworzy się przy użyciu klucza 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"
	}
}
Nazwa elementu Typ Opis
provisioningState Ciąg Wskazuje bieżący stan aprowizacji.
clusterState Ciąg Wskazuje bardziej szczegółowy stan klastra usługi HDInsight podczas aprowizacji.
createdDate Date Data/godzina odebrania żądania utworzenia klastra
quotaInfo Typ złożony Określa rdzenieusuwane przez klaster
błędy Tablica komunikatów o błędach Zawiera komunikat o błędzie, jeśli provisioningState = "failed"
connectivityEndpoints Typ złożony Określa publiczne punkty końcowe dla klastra

connectivityEndpoints

Nazwa elementu Typ Opis
name Ciąg Przyjazna nazwa punktu końcowego łączności
Protokół Ciąg Określa protokół do użycia (na przykład: HTTPS, SSH)
location Ciąg Określa adres URL do nawiązania połączenia
port int Określa port do nawiązania połączenia

Usuń

Usuwa klaster usługi HDInsight.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

Reakcja

HTTP 202 (Zaakceptowano), aby wskazać, że operacja zostanie ukończona asynchronicznie. Sondowanie asynchroniczne zwróci 204 (NoContent) po pomyślnym zakończeniu operacji.

Uwagi

Aby śledzić postęp żądania usunięcia klastra, zobacz Asynchroniczne operacje (202 Zaakceptowane i Lokalizacja)

Get

Pobiera szczegóły/właściwości określonego klastra.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

Reakcja

Operacja zwróci 200 (OK), jeśli żądanie zostało ukończone pomyślnie

Kod stanu: 200 OK

Treść odpowiedzi jest taka sama jak w przypadku tworzenia klastra.

Treść odpowiedzi dla szczegółów klastra systemu 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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
Nazwa elementu Typ Opis
provisioningState Ciąg Wskazuje bieżący stan aprowizacji.
clusterState Ciąg Wskazuje bardziej szczegółowy stan klastra usługi HDInsight podczas aprowizacji.
createdDate Date Data/godzina odebrania żądania utworzenia klastra
quotaInfo Typ złożony Określa rdzenieUsed przez klaster
błędy Tablica komunikatów o błędach Zawiera komunikat o błędzie, jeśli provisioningState = "failed"
connectivityEndpoints Typ złożony Określa publiczne punkty końcowe klastra

connectivityEndpoints

Nazwa elementu Typ Opis
name Ciąg Przyjazna nazwa punktu końcowego łączności
Protokół Ciąg Określa protokół do użycia (na przykład: HTTPS, SSH)
location Ciąg Określa adres URL do nawiązania połączenia
port int Określa port do nawiązania połączenia

Wyświetlanie listy konfiguracji

Pobiera wszystkie szczegóły konfiguracji klastra (w tym informacje poufne).

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

Reakcja

HTTP 200 (OK) po pomyślnym zakończeniu operacji.

Przykładowa odpowiedź:

"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"  
      }  
}
Nazwa elementu Typ Opis
Konfiguracji Słownik Ten element jest słownikiem typu konfiguracji i skojarzonym ze nim słownikiem wartości.
typ konfiguracji bramy służy do konfigurowania użytkownika http używanego do nawiązywania połączenia z internetowymi interfejsami API i portalem Ambari
typ konfiguracji core-site służy do konfigurowania domyślnego konta magazynu dla klastra

Uzyskiwanie konfiguracji

Pobiera szczegółowe informacje o pojedynczym typie konfiguracji (pomija poufne wartości).

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

Reakcja

HTTP 200 (OK) po pomyślnym zakończeniu operacji.

Przykładowa odpowiedź:

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

Pobieranie ustawień bramy

Ta operacja pobiera poświadczenia HTTP bramy klastra.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

Reakcja

HTTP 200 (OK) po pomyślnym zakończeniu operacji.

Przykładowa odpowiedź:

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

Aktualizowanie ustawień bramy

Ta operacja umożliwia użytkownikom zmianę poświadczeń HTTP bramy klastra.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
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!"  
}

Reakcja

HTTP 202 (Zaakceptowano) po pomyślnym zakończeniu operacji.

Zmienianie ustawień łączności (PRZESTARZAŁE)

Ta operacja umożliwia użytkownikom włączanie/wyłączanie łączności HTTPS z klastrem.

Zamiast tego użyj polecenia updateGatewaySettings .

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

Aby włączyć łączność

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

Wyświetlanie listy według grupy zasobów

Listy wszystkich klastrów w subskrypcji użytkownika w określonej grupie zasobów.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
GET https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Reakcja

Operacja zwróci wartość 200 (OK), jeśli żądanie zostanie ukończone pomyślnie.

Kod stanu: 200 OK

Treść odpowiedzi to tablica szczegółów klastra. Aby uzyskać więcej informacji, zobacz Pobieranie właściwości klastra.

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

Wyświetlanie listy według subskrypcji

Listy wszystkich klastrów w subskrypcji użytkownika.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
GET https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Reakcja

Operacja zwróci wartość 200 (OK), jeśli żądanie zostanie ukończone pomyślnie.

Kod stanu: 200 OK

Treść odpowiedzi to tablica szczegółów klastra.

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

Aby wyłączyć łączność

{  
   "restAuthCredential.isEnabled": false  
}
Nazwa elementu Wymagany Typ Opis
restAuthCredential.isEnabled Tak Wartość logiczna Określa, czy łączność powinna być włączona lub wyłączona
restAuthCredential.username Nie Ciąg Wymagane, jeśli isEnabled=true
Określa nazwę użytkownika ustawień łączności
restAuthCredential.password Nie Ciąg Wymagane, jeśli isEnabled=true
Określa hasło do ustawień łączności

Reakcja

HTTP 202 (Zaakceptowano), aby wskazać, że operacja zostanie ukończona asynchronicznie. Sondowanie asynchroniczne zwróci 204 (NoContent) po pomyślnym zakończeniu operacji.

Uwagi

Aby śledzić postęp żądania usunięcia klastra, zobacz Asynchroniczne operacje (202 Zaakceptowane i Lokalizacja)

Zmienianie ustawień protokołu RDP (tylko klaster systemu Windows)

Ta operacja umożliwia użytkownikowi włączanie/wyłączanie protokołu RDP. Dotyczy to klastrów opartych na systemie Windows.

Żądanie

Zobacz Typowe parametry i nagłówki nagłówków i parametrów używanych przez klastry.

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

Treść żądania

Aby włączyć protokół RDP

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

Aby wyłączyć protokół RDP

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

osProfile

Nazwa elementu Wymagany Typ Opis
windowsOperatingSystemProfile Nie Typ złożony Określa ustawienia związane z systemem operacyjnym Windows

windowsOperatingSystemProfile

Nazwa elementu Wymagany Typ Opis
rdpSettings Nie Typ złożony Określa ustawienia protokołu RDP dla klastrów systemu Windows

rdpSettings

Nazwa elementu Wymagany Typ Opis
nazwa użytkownika Tak Ciąg Określa nazwę użytkownika protokołu RDP
hasło Tak Ciąg Określa hasło użytkownika protokołu RDP
data wygaśnięcia Tak Date Data wygaśnięcia poświadczeń protokołu RDP

Reakcja

Operacja zwróci wartość 200 (OK), jeśli żądanie zostało ukończone pomyślnie

Kod stanu: 200 OK

Treść odpowiedzi jest taka sama jak w przypadku tworzenia klastra.

Uruchamianie akcji skryptu w uruchomionym klastrze (tylko klaster systemu Linux)

Wykonaj akcję Skrypt w uruchomionym klastrze.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

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

Treść żądania

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

scriptActions

Nazwa elementu Wymagany Typ Opis
name Tak Ciąg Określa nazwę akcji skryptu
Identyfikator uri Tak Ciąg Określa identyfikator URI akcji skryptu
parameters Tak Ciąg Określa parametry wymagane przez akcję skryptu
role Tak Tablica ciągów Określa role docelowe, na których jest wykonywana akcja skryptu
persistOnSuccess Tak Wartość logiczna Określa, czy akcje skryptu zostaną utrwalone po pomyślnym wykonaniu

Reakcja

Jeśli weryfikacja zostanie ukończona i żądanie zostanie zaakceptowane, operacja zwróci błąd 202 (Zaakceptowane).

Kod stanu: 202 (zaakceptowane)

Wyświetl listę wszystkich utrwałych akcji skryptu dla klastra (tylko klaster systemu Linux)

Ta operacja zwraca wszystkie akcje utrwałych skryptów określonego klastra.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

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

Reakcja

HTTP 200 (OK) po pomyślnym zakończeniu operacji.

Kod stanu: 200 OK

Przykładowa odpowiedź:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
Nazwa elementu Typ Opis
name Ciąg Określa nazwę akcji skryptu.
Identyfikator uri Ciąg Określa identyfikator URI akcji skryptu.
parameters Ciąg Określa parametry wymagane przez akcję skryptu
role Tablica ciągów Określa role docelowe wykonywane przez akcję skryptu.
applicationName Ciąg Określa odpowiednią aplikację, z którą jest skojarzony skrypt. applicationName ma wartość null, jeśli skrypt jest dostarczany przez użytkowników

Usuwanie utrwalonej akcji skryptu dla klastra (tylko klaster systemu Linux)

Ta operacja usuwa akcję utrwalonego skryptu usługi HDInsight dla klastra.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

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

Reakcja

  • HTTP 200 (OK), aby wskazać, że akcja skryptu została usunięta z listy utrwałych akcji skryptu.

  • HTTP 404 (NotFound), aby wskazać, że nie ma istniejącej akcji utrwalonego skryptu z odpowiednią nazwą skryptu.

Pobieranie wykonywania akcji skryptu z historii (tylko klastry systemu Linux)

Ta operacja zwraca najnowsze skrypty wykonania akcji określonego klastra lub szczegółów wykonania dla pojedynczego wykonania skryptu.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
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}

Reakcja

Operacja zwróci wartość 200 (OK), jeśli żądanie zostało ukończone pomyślnie. Treść odpowiedzi to tablica szczegółów wykonywania skryptu lub szczegóły wykonania pojedynczego skryptu, jeśli podano parametr scriptExecutionId. Poniżej znajduje się przykład szczegółów wykonywania skryptu.

Kod stanu: 200 (OK)

Przykładowa odpowiedź:

{  
  "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"  
}
Nazwa elementu Typ Opis
scriptExecutionId Długi Określa identyfikator wykonania akcji skryptu.
name Ciąg Określa nazwę akcji skryptu.
applicationName Ciąg Określa odpowiednią aplikację, z którą jest skojarzony skrypt. applicationName ma wartość null, jeśli skrypt jest dostarczany przez użytkowników
Identyfikator uri Ciąg Określa identyfikator URI akcji skryptu.
parameters Ciąg Określa parametry wymagane przez akcję skryptu
role Tablica ciągów Określa role docelowe wykonywane przez akcję skryptu.
startTime DateTime Określa godzinę rozpoczęcia wykonywania akcji skryptu
endTime DateTime Określa godzinę zakończenia wykonywania akcji skryptu
status Ciąg Określa stan wykonywania akcji skryptu
operation Ciąg Określa przyczynę wykonania akcji skryptu. Na przykład funkcja ScaleUp oznacza, że akcja skryptu została wykonana podczas skalowania klastra w górę.
executionSummary Tablica typu złożonego Określa podsumowanie wykonywania pod względem liczby hostów zakończonych powodzeniem i liczby hostów, których wykonanie skryptu nie powiodło się.
debugowanieInformation Ciąg Określa szczegółowe informacje debugowania dla skryptu. DebugInformation jest zwracany tylko wtedy, gdy w żądaniu jest podany identyfikator scriptExecutionId.

executionSummary

Nazwa elementu Typ Opis
status Ciąg Określa stan wykonywania na poszczególnych hostach.
instanceCount int Określa liczbę wykonań z odpowiednim stanem.

Podwyższanie poziomu skryptu z historii wykonywania akcji skryptu do utrwalonego (tylko klaster systemu Linux)

Ta operacja promuje skrypt usługi HDInsight z historii wykonywania skryptu do utrwalonego.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
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}

Reakcja

  • HTTP 200 (OK), aby wskazać, że akcja skryptu została podwyższona.

  • HTTP 404 (NotFound), aby wskazać, że nie ma istniejącego wykonania akcji skryptu z odpowiednim scriptExecutionId.

Zmiana rozmiaru

Zmienia rozmiar istniejącego klastra usługi HDInsight.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

Metoda Identyfikator URI żądania
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}

Poniżej przedstawiono przykładowe żądanie aktualizacji tagów dla klastra

{  
    "targetInstanceCount": 10  
}
Nazwa elementu Wymagany Typ Opis
targetInstanceCount Tak int Określa nową liczbę wystąpień dla roli

Reakcja

HTTP 202 (Zaakceptowano), aby wskazać, że operacja zostanie ukończona asynchronicznie. Sondowanie asynchroniczne zwróci błąd 204 (NoContent) po pomyślnym zakończeniu operacji.

Uwagi

Aby śledzić postęp żądania usunięcia klastra, zobacz Asynchroniczne operacje (202 Zaakceptowane i Lokalizacja)

Aktualizacja

Aktualizacje tagów dla klastra.

Wszystkie inne aktualizacje są oddzielnymi akcjami opisanymi osobno.

Żądanie

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych przez klastry.

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

Poniżej przedstawiono przykładowe żądanie aktualizacji tagów dla klastra

{   
    "tags": {"department": "finance"}  
}
Nazwa elementu Wymagany Typ Opis
tags Tak Ciąg Określa tagi, które zostaną przypisane do klastra. Aby uzyskać więcej informacji na temat używania tagów, zobacz Używanie tagów do organizowania zasobów platformy Azure.

Reakcja

Operacja zwróci wartość 200 (OK), jeśli żądanie zostanie ukończone pomyślnie.

Kod stanu: 200 OK

Treść odpowiedzi jest taka sama jak w przypadku tworzenia klastra.