Azure HDInsight'ta Küme REST API'si

Oluştur

Belirtilen abonelikte bir küme oluşturur.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Aşağıdaki örnekte Linux tabanlı hadoop kümesi oluşturmak için istek gövdesi gösterilmektedir. Diğer yollarla küme oluşturma örnekleri için aşağıdaki Örnekler bölümüne bakın.

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

Öğe adı	Gerekli	Tür	Description
kimlik	Evet	Dize	Kümenin kaynak tanımlayıcısını belirtir.
name	Evet	Dize	Kümenin adını belirtir.
tür	Evet	Dize	Kümenin türünü belirtir.
location	Evet	Dize	Kümenin oluşturulması gereken desteklenen Azure konumunu belirtir. Daha fazla bilgi için bkz. Kullanılabilir tüm coğrafi konumları listeleme.
etiketler	Hayır	Dize	Kümeye atanacak etiketleri belirtir. Etiketleri kullanma hakkında daha fazla bilgi için bkz. Azure kaynaklarınızı düzenlemek için etiketleri kullanma.
Özellikler	Yes	Karmaşık Tür	Kümenin özelliklerini belirtir.

Özellikler

Öğe adı	Gerekli	Tür	Description
clusterVersion	Evet	Dize	Küme sürümünü belirtir
osType	Evet	Dize	Küme için İşletim sistemini belirtir. Geçerli değerler Linux ve Windows'lardır
clusterDefinition	Yes	Karmaşık Tür	Küme türü ve yapılandırmaları hakkındaki bilgileri belirtir
computeProfile	Yes	Karmaşık Tür	Küme topolojisi ve ilişkili rol özellikleri hakkındaki bilgileri belirtir

clusterDefinition

Öğe adı	Gerekli	Tür	Description
Tür	Evet	Dize	Küme türünü belirtir. Geçerli değerler hadoop, hbase, storm & spark'tır
Yapılandırma	Yes	Sözlük	Bu öğe, yapılandırma türüne ve ilişkili değer sözlüğüne sahip bir sözlüktür. ağ geçidi yapılandırma türü, web API'lerine ve Ambari portalına bağlanmak için kullanılan http kullanıcısını yapılandırmak için kullanılır çekirdek site yapılandırma türü, küme için varsayılan depolama hesabını yapılandırmak için kullanılır

computeProfile

Öğe adı	Gerekli	Tür	Description
clusterVersion	Evet	Dize	Küme sürümünü belirtir
Rolü	Yes	Karmaşık Tür Dizisi (rol)	Kümedeki roller hakkındaki bilgileri belirtir

rol

Öğe adı	Gerekli	Tür	Description
name	Evet	Dize	Rol adını belirtir
targetInstanceCount	Yes	Tamsayı	Rol için hedef örnek sayısını belirtir
hardwareProfile	Yes	Karmaşık Tür	Rolün donanım profili hakkındaki bilgileri belirtir
osProfile	Yes	Karmaşık Tür	Rol için işletim sistemi profili hakkındaki bilgileri belirtir

hardwareProfile

Öğe adı	Gerekli	Tür	Description
vmSize	Evet	Dize	VM'nin boyutunu belirtir. Geçerli boyutlar için HDInsight yapılandırma seçeneklerine bakın (bu bağlantıya geçtikten sonra Node fiyatlandırma katmanlarına kadar aşağı kaydırın)

osProfile

Öğe adı	Gerekli	Tür	Description
linuxOperatingSystemProfile	No	Karmaşık Tür	Linux işletim sistemiyle ilgili ayarları belirtir
windowsOperatingSystemProfile	No	Karmaşık Tür	Windows işletim sistemiyle ilgili ayarları belirtir
virtualNetworkProfile	No	Karmaşık Tür	Küme kullanıcının aboneliğindeki bir sanal ağda dağıtılıyorsa sanal ağ ile ilgili ayarları belirtir
scriptActions	No	Karmaşık Tür Dizisi	Kümede yürütülecek betik eylemlerinin listesi

linuxOperatingSystemProfile

Öğe adı	Gerekli	Tür	Description
Kullanıcı adı	Evet	Dize	SSH kullanıcı adı
sshProfile	No	Karmaşık Tür	SSH anahtarını belirtir. sshProfile veya Password'lardan biri gereklidir.
Parola	Hayır	Dize	SSH parolasını belirtir sshProfile veya Password'lardan biri gereklidir.

sshProfile

Öğe adı	Gerekli	Tür	Description
publicKeys	Yes	Dizi	certificateData nesnelerinin listesini içerir. Değer bir ssh-rsa ortak anahtarıdır

windowsOperatingSystemProfile

Öğe adı	Gerekli	Tür	Description
rdpSettings	No	Karmaşık Tür	Windows kümeleri için RDP ayarlarını belirtir

rdpSettings

Öğe adı	Gerekli	Tür	Description
username	Evet	Dize	RDP kullanıcı adını belirtir
password	Evet	Dize	RDP kullanıcısının parolasını belirtir
expiryDate	Yes	Tarih	RDP kimlik bilgileri için süre sonu tarihi

virtualNetworkProfile

Öğe adı	Gerekli	Tür	Description
kimlik	Evet	Dize	Sanal Ağ Kaynak Kimliği
alt ağ	Evet	Dize	Alt ağ adını belirtir

scriptActions

Öğe adı	Gerekli	Tür	Description
name	Evet	Dize	Betik eylemi için kolay ad
Urı	Evet	Dize	Betik eylem dosyasının URL'si
parameters	Hayır	Dize	Betik eylem dosyası yürütülürken geçirilmesi gereken bağımsız değişkenler

Yanıt

Doğrulama tamamlandıysa ve istek kabul edilirse, işlem 200 döndürür (Tamam).

Durum kodu: 200 Tamam

Ssh anahtarı kullanılarak oluşturulan bir linux kümesi için yanıt gövdesi:

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

Öğe adı	Tür	Description
provisioningState	Dize	Geçerli sağlama durumunu gösterir.
clusterState	Dize	Sağlama devam ederken daha ayrıntılı HDInsight küme durumunu gösterir.
createdDate	Tarih	Küme oluşturma isteğinin alındığı tarih saat
quotaInfo	Karmaşık Tür	Küme tarafından kullanılmayan çekirdekleri belirtir
hatalar	Hata iletileri dizisi	provisioningState = 'failed" hatası iletisini içerir
connectivityEndpoints	Karmaşık Tür	Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı	Tür	Description
name	Dize	Bağlantı uç noktası için kolay ad
protokol	Dize	Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
location	Dize	Bağlanacak URL'yi belirtir
port	int	Bağlanacak bağlantı noktasını belirtir

Premium, etki alanına katılmış hdInsight kümesi oluşturma (yalnızca Linux, önizleme)

Apache Ranger ile premium etki alanına katılmış bir küme oluşturun. Kullanıcının güvenli bir küme oluşturmak için istek gövdesinde SecurityProfile sağlaması gerekir.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler.

Yöntem	İstek URI'si
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Aşağıdaki örnekte Linux tabanlı, premium, etki alanına katılmış hadoop kümesi oluşturmak için istek gövdesi gösterilmektedir.

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

Öğe adı	Gerekli	Tür	Description
kimlik	Evet	Dize	Kümenin kaynak tanımlayıcısını belirtir.
name	Evet	Dize	Kümenin adını belirtir.
tür	Evet	Dize	Kümenin türünü belirtir.
location	Evet	Dize	Kümenin oluşturulması gereken desteklenen Azure konumunu belirtir. Daha fazla bilgi için bkz. Kullanılabilir tüm coğrafi konumları listeleme.
etiketler	Hayır	Dize	Kümeye atanacak etiketleri belirtir. Etiketleri kullanma hakkında daha fazla bilgi için bkz. Azure kaynaklarınızı düzenlemek için etiketleri kullanma.
Özellikler	Yes	Karmaşık Tür	Kümenin özelliklerini belirtir.

Özellikler

Öğe adı	Gerekli	Tür	Description
clusterVersion	Evet	Dize	Küme sürümünü belirtir
osType	Evet	Dize	Küme için İşletim sistemini belirtir. Yalnızca Linux küme türleri bir Azure AD etki alanına katılabildiğinden geçerli değer Linux'tır.
tier	Hayır	Dize	Varsayılan değer standarttır. Geçerli değerler standart ve premium değerlerdir. Değer belirtilmezse, değerin standart olduğu varsayılır. Kümenin Katmanını belirtir. Etki alanına katılmış kümeler yalnızca premium katmanda desteklenir
clusterDefinition	Yes	Karmaşık Tür	Küme türü ve yapılandırmaları hakkındaki bilgileri belirtir
computeProfile	Yes	Karmaşık Tür	Küme topolojisi ve ilişkili rol özellikleri hakkındaki bilgileri belirtir
securityProfile	No	Karmaşık Tür	Güvenli, etki alanına katılmış bir küme oluşturuluyorsa, bu öğe Active Directory ile ilgili ayarları belirtir

clusterDefinition

Öğe adı	Gerekli	Tür	Description
Tür	Evet	Dize	Küme türünü belirtir. Geçerli değerler hadoop, hbase, storm & spark'tır
Yapılandırma	Yes	Sözlük	Bu öğe, yapılandırma türüne ve ilişkili değer sözlüğüne sahip bir sözlüktür. ağ geçidi yapılandırma türü, web API'lerine ve Ambari portalına bağlanmak için kullanılan http kullanıcısını yapılandırmak için kullanılır çekirdek site yapılandırma türü, küme için varsayılan depolama hesabını yapılandırmak için kullanılır

computeProfile

Öğe adı	Gerekli	Tür	Description
clusterVersion	Evet	Dize	Küme sürümünü belirtir
Rolü	Yes	Karmaşık Tür Dizisi (rol)	Kümedeki roller hakkındaki bilgileri belirtir

securityProfile

Öğe adı	Gerekli	Tür	Description
directoryType	Evet	Dize	Kullanılan LDAP dizininin türü. Şu anda desteklenen tek değer "ActiveDirectory"dir.
etki alanı	Evet	Dize	Küme için Active Directory etki alanı
organizationalUnitDN	Evet	Dize	Kullanıcı ve bilgisayar hesaplarının oluşturulacağı Active Directory'de kuruluş biriminin ayırt edici adı
ldapsUrls	Yes	Dize Dizisi	Active Directory için bir veya birden çok LDAPS sunucusu URL'leri
domainUserName	Evet	Dize	Kümeyi oluşturmak için yeterli izinlere sahip bir etki alanı kullanıcı hesabı. user@domain biçimde olmalıdır
domainUserPassword	Evet	Dize	Etki alanı kullanıcı hesabının parolası
clusterUsersGroupDNS	No	Dize Dizisi	Ambari ve Apache Ranger'da kullanılabilir olacak Active Directory gruplarının ayırt edici adları

rol

Öğe adı	Gerekli	Tür	Description
name	Evet	Dize	Rol adını belirtir
targetInstanceCount	Yes	Tamsayı	Rol için hedef örnek sayısını belirtir
hardwareProfile	Yes	Karmaşık Tür	Rolün donanım profili hakkındaki bilgileri belirtir
osProfile	Yes	Karmaşık Tür	Rolün işletim sistemi profili hakkındaki bilgileri belirtir

hardwareProfile

Öğe adı	Gerekli	Tür	Description
vmSize	Evet	Dize	VM'nin boyutunu belirtir. Geçerli boyutlar için HDInsight yapılandırma seçeneklerine bakın (bu bağlantıya geçtikten sonra Node fiyatlandırma katmanlarına kadar aşağı kaydırın)

osProfile

Öğe adı	Gerekli	Tür	Description
linuxOperatingSystemProfile	No	Karmaşık Tür	Linux işletim sistemiyle ilgili ayarları belirtir
virtualNetworkProfile	No	Karmaşık Tür	Küme kullanıcının aboneliğindeki bir sanal ağa dağıtılıyorsa sanal ağ ile ilgili ayarları belirtir
scriptActions	No	Karmaşık Tür Dizisi	Kümede yürütülecek betik eylemlerinin listesi

linuxOperatingSystemProfile

Öğe adı	Gerekli	Tür	Description
Kullanıcı adı	Evet	Dize	SSH kullanıcı adı
sshProfile	No	Karmaşık Tür	SSH anahtarını belirtir. sshProfile veya Paroladan biri gereklidir.
Parola	Hayır	Dize	SSH parolasını belirtir sshProfile veya Paroladan biri gereklidir.

sshProfile

Öğe adı	Gerekli	Tür	Description
publicKeys	Yes	Dizi	certificateData nesnelerinin listesini içerir. Değer bir ssh-rsa ortak anahtarıdır

virtualNetworkProfile

Öğe adı	Gerekli	Tür	Description
kimlik	Evet	Dize	kaynak kimliğini Sanal Ağ
alt ağ	Evet	Dize	Alt ağ adını belirtir

scriptActions

Öğe adı	Gerekli	Tür	Description
name	Evet	Dize	Betik eylemi için kolay ad
Urı	Evet	Dize	Betik eylem dosyasının URL'si
parameters	Hayır	Dize	Betik eylem dosyası yürütülürken geçirilmesi gereken bağımsız değişkenler

Yanıt

Doğrulama tamamlandıysa ve istek kabul edilirse işlem 200 (Tamam) döndürür.

Durum kodu: 200 Tamam

Linux kümesi için yanıt gövdesi ssh anahtarı kullanılarak oluşturulur:

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

Öğe adı	Tür	Description
provisioningState	Dize	Geçerli sağlama durumunu gösterir.
clusterState	Dize	Sağlama devam ederken daha ayrıntılı HDInsight küme durumunu gösterir.
createdDate	Tarih	Küme oluşturma isteğinin alındığı tarih saat
quotaInfo	Karmaşık Tür	Küme tarafından kullanılmayan çekirdekleri belirtir
hatalar	Hata iletileri dizisi	provisioningState = 'failed" ise hata iletisini içerir
connectivityEndpoints	Karmaşık Tür	Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı	Tür	Description
name	Dize	Bağlantı uç noktası için kolay ad
protokol	Dize	Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
location	Dize	Bağlanacak URL'yi belirtir
port	int	Bağlanacak bağlantı noktasını belirtir

Azure Data Lake Store'u varsayılan dosya sistemi olarak kullanarak küme oluşturma

Azure Data Lake Store varsayılan dosya sistemi olarak belirtilen abonelikte bir küme oluşturur. İstek gövdesinde bir ClusterIdentity nesnesi sağlayın ve default-filesystem özelliğini uygun Data Lake Store URL'si ile yapılandırın.

Azure Data Lake, 3.5 dahil küme sürümleri için varsayılan dosya sistemi olarak yapılandırılabilir.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

Aşağıdaki örnekte, küme için varsayılan dosya sistemi olarak Azure Data Lake Store kullanarak Linux tabanlı hadoop kümesi oluşturmak için istek gövdesi gösterilmektedir.

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

Öğe adı	Gerekli	Tür	Description
kimlik	Evet	Dize	Kümenin kaynak tanımlayıcısını belirtir.
name	Evet	Dize	Kümenin adını belirtir.
tür	Evet	Dize	Kümenin türünü belirtir.
location	Evet	Dize	Kümenin oluşturulması gereken desteklenen Azure konumunu belirtir. Daha fazla bilgi için bkz. Kullanılabilir tüm coğrafi konumları listeleme.
etiketler	Hayır	Dize	Kümeye atanacak etiketleri belirtir. Etiketleri kullanma hakkında daha fazla bilgi için bkz. Azure kaynaklarınızı düzenlemek için etiketleri kullanma.
Özellikler	Yes	Karmaşık Tür	Kümenin özelliklerini belirtir.

Özellikler

Öğe adı	Gerekli	Tür	Description
clusterVersion	Evet	Dize	Küme sürümünü belirtir
osType	Evet	Dize	Küme için İşletim sistemini belirtir. Geçerli değer Linux
tier	Hayır	Dize	Kümenin katmanını belirtir. Geçerli değerler standart ve premium değerlerdir. Katman belirtilmezse, küme standart katmanda olur.
clusterDefinition	Yes	Karmaşık Tür	Küme türü ve yapılandırmaları hakkındaki bilgileri belirtir
computeProfile	Yes	Karmaşık Tür	Küme topolojisi ve ilişkili rol özellikleri hakkındaki bilgileri belirtir

clusterDefinition

Öğe adı	Gerekli	Tür	Description
Tür	Evet	Dize	Küme türünü belirtir. Geçerli değerler hadoop, hbase, storm & spark'tır
Yapılandırma	Yes	Sözlük	Bu öğe, yapılandırma türünde bir sözlük ve ilişkili değer sözlüğüdür. ağ geçidi yapılandırma türü, web API'lerine ve Ambari portalına bağlanmak için kullanılan http kullanıcısını yapılandırmak için kullanılır Çekirdek site yapılandırma türü, küme için varsayılan depolama hesabını yapılandırmak için kullanılır

computeProfile

Öğe adı	Gerekli	Tür	Description
clusterVersion	Evet	Dize	Küme sürümünü belirtir
Rolü	Yes	Karmaşık Tür Dizisi (rol)	Kümedeki roller hakkında bilgi belirtir

rol

Öğe adı	Gerekli	Tür	Description
name	Evet	Dize	Rol adını belirtir
targetInstanceCount	Yes	Tamsayı	Rol için hedef örnek sayısını belirtir
hardwareProfile	Yes	Karmaşık Tür	Rolün donanım profili hakkındaki bilgileri belirtir
osProfile	Yes	Karmaşık Tür	Rol için işletim sistemi profili hakkındaki bilgileri belirtir

hardwareProfile

Öğe adı	Gerekli	Tür	Description
vmSize	Evet	Dize	VM'nin boyutunu belirtir. Geçerli boyutlar için HDInsight yapılandırma seçeneklerine bakın (bu bağlantıya geçtikten sonra Node fiyatlandırma katmanlarına kadar aşağı kaydırın)

osProfile

Öğe adı	Gerekli	Tür	Description
linuxOperatingSystemProfile	No	Karmaşık Tür	Linux işletim sistemiyle ilgili ayarları belirtir
virtualNetworkProfile	No	Karmaşık Tür	Küme kullanıcının aboneliğindeki bir sanal ağda dağıtılıyorsa sanal ağ ile ilgili ayarları belirtir
scriptActions	No	Karmaşık Tür Dizisi	Kümede yürütülecek betik eylemlerinin listesi

linuxOperatingSystemProfile

Öğe adı	Gerekli	Tür	Description
Kullanıcı adı	Evet	Dize	SSH kullanıcı adı
sshProfile	No	Karmaşık Tür	SSH anahtarını belirtir. sshProfile veya Paroladan biri gereklidir.
Parola	Hayır	Dize	SSH parolasını belirtir sshProfile veya Paroladan biri gereklidir.

sshProfile

Öğe adı	Gerekli	Tür	Description
publicKeys	Yes	Dizi	certificateData nesnelerinin listesini içerir. Değer bir ssh-rsa ortak anahtarıdır

virtualNetworkProfile

Öğe adı	Gerekli	Tür	Description
kimlik	Evet	Dize	kaynak kimliğini Sanal Ağ
alt ağ	Evet	Dize	Alt ağ adını belirtir

scriptActions

Öğe adı	Gerekli	Tür	Description
name	Evet	Dize	Betik eylemi için kolay ad
Urı	Evet	Dize	Betik eylem dosyasının URL'si
parameters	Hayır	Dize	Betik eylem dosyası yürütülürken geçirilmesi gereken bağımsız değişkenler

Yanıt

Doğrulama tamamlandıysa ve istek kabul edilirse işlem 200 (Tamam) döndürür.

Durum kodu: 200 Tamam

Linux kümesi için yanıt gövdesi ssh anahtarı kullanılarak oluşturulur:

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

Öğe adı	Tür	Description
provisioningState	Dize	Geçerli sağlama durumunu gösterir.
clusterState	Dize	Sağlama devam ederken daha ayrıntılı HDInsight küme durumunu gösterir.
createdDate	Tarih	Küme oluşturma isteğinin alındığı tarih saat
quotaInfo	Karmaşık Tür	Küme tarafından kullanılmayan çekirdekleri belirtir
hatalar	Hata iletileri dizisi	provisioningState = 'failed" ise hata iletisini içerir
connectivityEndpoints	Karmaşık Tür	Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı	Tür	Description
name	Dize	Bağlantı uç noktası için kolay ad
protokol	Dize	Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
location	Dize	Bağlanacak URL'yi belirtir
port	int	Bağlanacak bağlantı noktasını belirtir

Sil

HDInsight kümesini siler.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
DELETE	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Yanıt

İşlemin zaman uyumsuz olarak tamamlandığını belirtmek için HTTP 202 (Kabul Edildi). İşlem başarıyla tamamlandıktan sonra zaman uyumsuz yoklama 204 (NoContent) döndürür.

Açıklamalar

Küme silme isteğinin ilerleme durumunu izlemek için bkz. Zaman Uyumsuz İşlemler (202 Kabul Edildi ve Konum üst bilgisi)

Get

Belirtilen kümenin ayrıntılarını/özelliklerini alır.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Yanıt

İstek başarıyla tamamlanırsa işlem 200 (Tamam) döndürür

Durum kodu: 200 Tamam

Yanıt gövdesi, küme oluşturma işlemiyle aynıdır.

Linux kümesi ayrıntıları için yanıt gövdesi

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

Öğe adı	Tür	Description
provisioningState	Dize	Geçerli sağlama durumunu gösterir.
clusterState	Dize	Sağlama devam ederken daha ayrıntılı HDInsight küme durumunu gösterir.
createdDate	Tarih	Küme oluşturma isteğinin alındığı tarih saat
quotaInfo	Karmaşık Tür	Küme tarafından kullanılmayan çekirdekleri belirtir
hatalar	Hata iletileri dizisi	provisioningState = 'failed" ise hata iletisini içerir
connectivityEndpoints	Karmaşık Tür	Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı	Tür	Description
name	Dize	Bağlantı uç noktası için kolay ad
protokol	Dize	Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
location	Dize	Bağlanacak URL'yi belirtir
port	int	Bağlanacak bağlantı noktasını belirtir

Yapılandırmaları listeleme

Tüm küme yapılandırma ayrıntılarını (hassas bilgiler dahil) alır.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Yanıt

İşlemin başarıyla tamamlanmasının ardından HTTP 200 (Tamam).

Örnek yanıt:

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

Öğe adı	Tür	Description
Yapılandırma	Sözlük	Bu öğe, yapılandırma türüne ve ilişkili değer sözlüğüne sahip bir sözlüktür. ağ geçidi yapılandırma türü, web API'lerine ve Ambari portalına bağlanmak için kullanılan http kullanıcısını yapılandırmak için kullanılır çekirdek site yapılandırma türü, küme için varsayılan depolama hesabını yapılandırmak için kullanılır

Yapılandırmayı alma

Tek bir yapılandırma türüyle ilgili ayrıntıları alır (hassas değerleri atlar).

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Yanıt

İşlemin başarıyla tamamlanmasının ardından HTTP 200 (Tamam).

Örnek yanıt:

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

Ağ geçidi ayarlarını alma

Bu işlem küme ağ geçidi HTTP kimlik bilgilerini alır.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Yanıt

İşlemin başarıyla tamamlanmasının ardından HTTP 200 (Tamam).

Örnek yanıt:

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

Ağ geçidi ayarlarını güncelleştirme

Bu işlem, kullanıcıların küme ağ geçidi HTTP kimlik bilgilerini değiştirmesine olanak tanır.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
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!"  
}  

Yanıt

İşlemin başarıyla tamamlanması üzerine HTTP 202 (Kabul Edildi).

Bağlantı ayarlarını değiştirme (KULLANIMSIZ)

Bu işlem kullanıcıların kümeye HTTPS bağlantısını etkinleştirmesine/devre dışı bırakmasına olanak tanır.

Bunun yerine updateGatewaySettings kullanın.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Bağlantıyı etkinleştirmek için

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

Kaynak grubuna göre listele

Belirtilen kaynak grubundaki kullanıcının aboneliğindeki tüm kümeleri Listeler.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
GET	https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Yanıt

İstek başarıyla tamamlanırsa işlem 200 (Tamam) döndürür.

Durum kodu: 200 Tamam

Yanıt gövdesi, küme ayrıntıları dizisidir. Daha fazla bilgi için bkz. Küme özelliklerini alma.

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

Aboneliğe göre listele

Kullanıcının aboneliğindeki tüm kümeleri Listeler.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
GET	https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Yanıt

İstek başarıyla tamamlanırsa işlem 200 (Tamam) döndürür.

Durum kodu: 200 Tamam

Yanıt gövdesi, küme ayrıntıları dizisidir.

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

Bağlantıyı devre dışı bırakmak için

{  
   "restAuthCredential.isEnabled": false  
}  
  

Öğe adı	Gerekli	Tür	Description
restAuthCredential.isEnabled	Yes	Boole	Bağlantının etkinleştirilmesi veya devre dışı bırakılması gerektiğini belirtir
restAuthCredential.username	Hayır	Dize	isEnabled=true ise gereklidir Bağlantı ayarları için kullanıcı adını belirtir
restAuthCredential.password	Hayır	Dize	isEnabled=true ise gereklidir Bağlantı ayarları için parolayı belirtir

Yanıt

İşlemin zaman uyumsuz olarak tamamlandığını belirtmek için HTTP 202 (Kabul Edildi). İşlem başarıyla tamamlandıktan sonra zaman uyumsuz yoklama 204 (NoContent) döndürür.

Açıklamalar

Küme silme isteğinin ilerleme durumunu izlemek için bkz. Zaman Uyumsuz İşlemler (202 Kabul Edildi ve Konum üst bilgisi)

RDP ayarlarını değiştirme (yalnızca Windows kümesi)

Bu işlem kullanıcının RDP'yi etkinleştirmesine/devre dışı bırakmasına olanak tanır. Windows tabanlı kümeler için geçerlidir.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

İstek Gövdesi

RDP'yi etkinleştirmek için

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

RDP'yi devre dışı bırakmak için

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

osProfile

Öğe adı	Gerekli	Tür	Description
windowsOperatingSystemProfile	No	Karmaşık Tür	Windows işletim sistemiyle ilgili ayarları belirtir

windowsOperatingSystemProfile

Öğe adı	Gerekli	Tür	Description
rdpSettings	No	Karmaşık Tür	Windows kümeleri için RDP ayarlarını belirtir

rdpSettings

Öğe adı	Gerekli	Tür	Description
username	Evet	Dize	RDP kullanıcı adını belirtir
password	Evet	Dize	RDP kullanıcısının parolasını belirtir
expiryDate	Yes	Tarih	RDP kimlik bilgileri için süre sonu tarihi

Yanıt

İstek başarıyla tamamlanırsa işlem 200 (Tamam) döndürür

Durum kodu: 200 Tamam

Yanıt gövdesi , Küme oluşturma ile aynıdır.

Çalışan bir kümede Betik Eylemlerini çalıştırma (yalnızca Linux kümesi)

Çalışan bir kümede Betik eylemi yürütme.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler.

Yöntem	İstek URI'si
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

İstek Gövdesi

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

scriptActions

Öğe adı	Gerekli	Tür	Description
name	Evet	Dize	Betik eyleminin adını belirtir
Urı	Evet	Dize	Betik eyleminin URI'sini belirtir
parameters	Evet	Dize	Betik eylemi için gereken parametreleri belirtir
roller	Yes	Dize Dizisi	Betik eyleminin üzerinde yürüttüğü hedef rolleri belirtir
persistOnSuccess	Yes	Boole	Betik eylemlerinin başarılı yürütmelerden sonra kalıcı olup olmayacağını belirtir

Yanıt

Doğrulama tamamlandıysa ve istek kabul edilirse, işlem 202 (Kabul Edildi) döndürür.

Durum kodu: 202 (Kabul Edildi)

Bir küme için tüm kalıcı Betik Eylemlerini listeleme (yalnızca Linux kümesi)

Bu işlem, belirtilen kümenin tüm kalıcı betik eylemlerini döndürür.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler.

Yöntem	İstek URI'si
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

Yanıt

İşlemin başarıyla tamamlanmasının ardından HTTP 200 (Tamam).

Durum kodu: 200 Tamam

Örnek yanıt:

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

Öğe adı	Tür	Description
name	Dize	Betik eyleminin adını belirtir.
Urı	Dize	Betik eyleminin URI'sini belirtir.
parameters	Dize	Betik eylemi için gereken parametreleri belirtir
roller	Dize Dizisi	Betik eyleminin üzerinde yürütülürken hedeflenen rolleri belirtir.
applicationName	Dize	Betiğin ilişkili olduğu ilgili uygulamayı belirtir. betik kullanıcılar tarafından sağlanıyorsa applicationName null olur

Küme için kalıcı Betik Eylemini kaldırma (yalnızca Linux kümesi)

Bu işlem, küme için HDInsight kalıcı betik eylemini kaldırır.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler.

Yöntem	İstek URI'si
DELETE	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

Yanıt

• HTTP 200 (Tamam), betik eyleminin kalıcı betik eylemleri listesinden kaldırıldığını gösterir.

• HTTP 404 (NotFound), karşılık gelen scriptName ile var olan kalıcı bir betik eylemi olmadığını belirtmek için.

Geçmişten Betik Eylemi yürütmeyi alma (yalnızca Linux kümeleri)

Bu işlem, belirtilen kümenin en son betik eylem yürütmesini veya tek bir betik yürütmesi için yürütme ayrıntılarını döndürür.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler.

Yöntem	İstek URI'si
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}

Yanıt

İstek başarıyla tamamlanırsa işlem 200 (Tamam) döndürür. Yanıt gövdesi, scriptExecutionId sağlanmışsa betik yürütme ayrıntıları dizisi veya tek bir betik yürütme ayrıntıları dizisidir. Aşağıda bir betik yürütme ayrıntısı örneği verilmiştir.

Durum kodu: 200 (Tamam)

Örnek yanıt:

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

Öğe adı	Tür	Description
scriptExecutionId	Uzun	Betik eyleminin yürütme kimliğini belirtir.
name	Dize	Betik eyleminin adını belirtir.
applicationName	Dize	Betiğin ilişkili olduğu ilgili uygulamayı belirtir. Betik kullanıcılar tarafından sağlanıyorsa applicationName null olur
Urı	Dize	Betik eyleminin URI'sini belirtir.
parameters	Dize	Betik eylemi için gereken parametreleri belirtir
roller	Dize Dizisi	Betik eyleminin üzerinde yürütülecek hedeflenen rolleri belirtir.
startTime	DateTime	Betik eylemi yürütmesinin başlangıç saatini belirtir
endTime	DateTime	Betik eylemi yürütmesinin bitiş saatini belirtir
durum	Dize	Betik eylemi yürütme durumunu belirtir
operation	Dize	Betik eyleminin yürütülmesinin nedenini belirtir. Örneğin, Ölçek Artırma, betik eyleminin küme ölçeğini artırma sırasında yürütüldüğünü gösterir.
executionSummary	Karmaşık tür dizisi	Yürütmenin özetini, kaç konanın başarılı olduğu ve kaç konanın betiği yürütemediği açısından belirtir.
debugInformation	Dize	Betik için ayrıntılı hata ayıklama bilgilerini belirtir. debugInformation yalnızca istekte scriptExecutionId sağlandığında döndürülür.

executionSummary

Öğe adı	Tür	Description
durum	Dize	Tek tek konaklarda yürütmenin durumunu belirtir.
instanceCount	int	İlgili duruma sahip yürütme sayısını belirtir.

Betik Eylemi yürütme geçmişinden bir betiği kalıcı olacak şekilde yükseltme (yalnızca Linux kümesi)

Bu işlem, bir HDInsight betiğinin kalıcı olması için betik yürütme geçmişinden yükseltilir.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
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}

Yanıt

• Http 200 (Tamam), betik eyleminin yükseltildiğini belirtmek için.

• HTTP 404 (NotFound), karşılık gelen scriptExecutionId ile var olan bir betik eylemi yürütmesi olmadığını belirtmek için.

Yeniden boyutlandırma

Var olan bir HDInsight kümesini yeniden boyutlandırıyor.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
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}

Aşağıda bir kümenin etiketlerini güncelleştirmeye yönelik örnek bir istek gösterilmektedir

{  
    "targetInstanceCount": 10  
}  

Öğe adı	Gerekli	Tür	Description
targetInstanceCount	Yes	int	Rol için yeni örnek sayısını belirtir

Yanıt

İşlemin zaman uyumsuz olarak tamamlandığını belirtmek için HTTP 202 (Kabul Edildi). İşlem başarıyla tamamlandıktan sonra zaman uyumsuz yoklama 204 (NoContent) döndürür.

Açıklamalar

Küme silme isteğinin ilerleme durumunu izlemek için bkz. Zaman Uyumsuz İşlemler (202 Kabul Edildi ve Konum üst bilgisi)

Güncelleştir

Bir kümenin etiketlerini Güncelleştirmeler.

Diğer tüm güncelleştirmeler ayrı olarak açıklanan ayrı eylemlerdir.

İstek

Bkz. Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler .

Yöntem	İstek URI'si
YAMA	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Aşağıda bir kümenin etiketlerini güncelleştirmeye yönelik örnek bir istek gösterilmektedir

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

Öğe adı	Gerekli	Tür	Description
etiketler	Evet	Dize	Kümeye atanacak etiketleri belirtir. Etiketleri kullanma hakkında daha fazla bilgi için bkz. Azure kaynaklarınızı düzenlemek için etiketleri kullanma.

Yanıt

İstek başarıyla tamamlanırsa işlem 200 (Tamam) döndürür.

Durum kodu: 200 Tamam

Yanıt gövdesi , Küme oluştur ile aynıdır.