Aracılığıyla paylaş

Azure HDInsight'ta küme REST API'si

Oluştur

Belirtilen abonelikte bir küme oluşturur.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
YERLEŞTİRMEK 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ı bir 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ü Açıklama
kimlik Evet Dize Kümenin kaynak tanımlayıcısını belirtir.
isim Evet Dize Kümenin adını belirtir.
tür Evet Dize Kümenin türünü belirtir.
konum 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ı 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 .
Özellikleri Evet Karmaşık Tür Kümenin özelliklerini belirtir.

Özellikler

Öğe adı Gerekli Türü Açıklama
kümeSürümü Evet Dize Küme sürümünü belirtir
işletim sistemi türü Evet Dize Küme için İşletim sistemini belirtir.

Geçerli değerler Linux ve Windows'tur
clusterDefinition (küme Tanımı) Evet Karmaşık Tür Küme türü ve yapılandırmaları hakkında bilgi belirtir
computeProfile Evet Karmaşık Tür Küme topolojisi ve ilişkili rol özellikleri hakkındaki bilgileri belirtir

clusterDefinition (küme Tanımı)

Öğe adı Gerekli Türü Açıklama
tür Evet Dize Küme türünü belirtir.

Geçerli değerler şunlardır: hadoop, hbase, storm & spark
Yapılandırmalar Evet Sözlük Bu öğe, yapılandırma türünün ve ilişkili değer sözlüğünün bir 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ü Açıklama
kümeSürümü Evet Dize Küme sürümünü belirtir
rol Evet Karmaşık Tür Dizisi (rol) Kümedeki rollerle ilgili bilgileri belirtir

rol

Öğe adı Gerekli Türü Açıklama
isim Evet Dize Rol adını belirtir
targetInstanceCount (hedefÖrnekSayısı) Evet Integer Rol için hedef örnek sayısını belirtir
donanım Profili Evet Karmaşık Tür Rolün donanım profili hakkındaki bilgileri belirtir
İşletim SistemiProfili Evet Karmaşık Tür Rol için işletim sistemi profili hakkındaki bilgileri belirtir

donanım Profili

Öğe adı Gerekli Türü Açıklama
vmSize Evet Dize VM'nin boyutunu belirtir. Geçerli boyutlar için HDInsight yapılandırma seçeneklerine bakın (bu bağlantıda bir kez aşağı kaydırın ve Düğüm fiyatlandırma katmanları'na gidin)

osProfile

Öğe adı Gerekli Türü Açıklama
linuxOperatingSystemProfile Hayı Karmaşık Tür Linux işletim sistemi ile ilgili ayarları belirtir
windowsOperatingSystemProfile Hayı Karmaşık Tür Windows işletim sistemi ile ilgili ayarları belirtir
virtualNetworkProfile Hayı 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 Hayı Karmaşık Tür Dizisi Kümede yürütülecek betik eylemlerinin listesi

linuxOperatingSystemProfile

Öğe adı Gerekli Türü Açıklama
Kullanıcı adı Evet Dize SSH kullanıcı adı
sshProfile Hayı Karmaşık Tür SSH anahtarını belirtir.

sshProfile veya Password'den biri gereklidir.
Şifre Hayı Dize SSH parolasını belirtir

sshProfile veya Password'den biri gereklidir.

sshProfile

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

windowsOperatingSystemProfile

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

rdpSettings

Öğe adı Gerekli Türü Açıklama
kullanıcı adı Evet Dize RDP kullanıcı adını belirtir
şifre Evet Dize RDP kullanıcısının parolasını belirtir
expiryDate Evet Tarih RDP kimlik bilgileri için son kullanma tarihi

virtualNetworkProfile

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

scriptActions

Öğe adı Gerekli Türü Açıklama
isim Evet Dize Komut dosyası eylemi için kolay ad
URI Evet Dize Komut dosyası eylem dosyasının URL'si
Parametreler Hayı Dize Komut dosyası eylem dosyası yürütülürken geçirilecek bağımsız değişkenler

Yanıt

Doğrulama tamamlandıysa ve istek kabul edildiyse, 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ü Açıklama
hazırlamaDurumu Dize Geçerli sağlama durumunu gösterir.
clusterState Dize Sağlama devam ederken HDInsight kümesinin durumunu daha ayrıntılı olarak gösterir.
oluşturulmaTarihi Tarih Küme oluşturma isteğinin alındığı tarih
quotaInfo Karmaşık Tür Küme tarafından kullanılan çekirdekleri belirtir
Hata Hata mesajları dizisi provisioningState = 'başarısız' ise hata mesajını içerir
connectivityEndpoints Karmaşık Tür Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı Türü Açıklama
isim Dize Bağlantı uç noktası için kolay ad
protokol Dize Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
konum Dize Bağlanılacak URL'yi belirtir
liman Int Bağlanılacak bağlantı noktasını belirtir

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

Apache Ranger ile etki alanına katılmış premium 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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
YERLEŞTİRMEK 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ış bir 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ü Açıklama
kimlik Evet Dize Kümenin kaynak tanımlayıcısını belirtir.
isim Evet Dize Kümenin adını belirtir.
tür Evet Dize Kümenin türünü belirtir.
konum 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ı 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 .
Özellikleri Evet Karmaşık Tür Kümenin özelliklerini belirtir.

Özellikler

Öğe adı Gerekli Türü Açıklama
kümeSürümü Evet Dize Küme sürümünü belirtir
işletim sistemi türü 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'tur .
seviye Hayı Dize Varsayılan değer standarttır. Geçerli değerler standart ve premium'dur. Herhangi bir değer belirtilmezse, değerin standart olduğu varsayılır. Küme için Katman'ı belirtir. Etki alanına katılmış kümeler yalnızca premium katmanda desteklenir
clusterDefinition (küme Tanımı) Evet Karmaşık Tür Küme türü ve yapılandırmaları hakkında bilgi belirtir
computeProfile Evet Karmaşık Tür Küme topolojisi ve ilişkili rol özellikleri hakkındaki bilgileri belirtir
güvenlik profili Hayı 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 (küme Tanımı)

Öğe adı Gerekli Türü Açıklama
tür Evet Dize Küme türünü belirtir.

Geçerli değerler şunlardır: hadoop, hbase, storm & spark
Yapılandırmalar Evet Sözlük Bu öğe, yapılandırma türünün ve ilişkili değer sözlüğünün bir 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ü Açıklama
kümeSürümü Evet Dize Küme sürümünü belirtir
rol Evet Karmaşık Tür Dizisi (rol) Kümedeki rollerle ilgili bilgileri belirtir

securityProfile

Öğe adı Gerekli Türü Açıklama
directoryType Evet Dize Kullanılan LDAP dizininin türü. Şu anda desteklenen tek değer "ActiveDirectory"dir.
alan adı Evet Dize Küme için Active Directory etki alanı
organizationalUnitDN Evet Dize Active Directory'de kullanıcı ve bilgisayar hesaplarının oluşturulacağı kuruluş biriminin ayırt edici adı
ldapsURL'leri Evet Dize Dizisi Active Directory için bir veya daha fazla LDAPS sunucusunun URL'leri
domainUserName Evet Dize Kümeyi oluşturmak için yeterli izinlere sahip bir etki alanı kullanıcı hesabı. user@domain formatında olmalıdır
domainUserPassword Evet Dize Etki alanı kullanıcı hesabının parolası
clusterUsersGroupDNS Hayı Dize Dizisi Ambari ve Apache Ranger'da kullanılabilecek Active Directory gruplarının ayırt edici adları

rol

Öğe adı Gerekli Türü Açıklama
isim Evet Dize Rol adını belirtir
targetInstanceCount (hedefÖrnekSayısı) Evet Integer Rol için hedef örnek sayısını belirtir
donanım Profili Evet Karmaşık Tür Rolün donanım profili hakkındaki bilgileri belirtir
İşletim SistemiProfili Evet Karmaşık Tür Rol için işletim sistemi profili hakkındaki bilgileri belirtir

donanım Profili

Öğe adı Gerekli Türü Açıklama
vmSize Evet Dize VM'nin boyutunu belirtir. Geçerli boyutlar için HDInsight yapılandırma seçeneklerine bakın (bu bağlantıda bir kez aşağı kaydırın ve Düğüm fiyatlandırma katmanları'na gidin)

osProfile

Öğe adı Gerekli Türü Açıklama
linuxOperatingSystemProfile Hayı Karmaşık Tür Linux işletim sistemi ile ilgili ayarları belirtir
virtualNetworkProfile Hayı 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 Hayı Karmaşık Tür Dizisi Kümede yürütülecek betik eylemlerinin listesi

linuxOperatingSystemProfile

Öğe adı Gerekli Türü Açıklama
Kullanıcı adı Evet Dize SSH kullanıcı adı
sshProfile Hayı Karmaşık Tür SSH anahtarını belirtir.

sshProfile veya Password'den biri gereklidir.
Şifre Hayı Dize SSH parolasını belirtir

sshProfile veya Password'den biri gereklidir.

sshProfile

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

virtualNetworkProfile

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

scriptActions

Öğe adı Gerekli Türü Açıklama
isim Evet Dize Komut dosyası eylemi için kolay ad
URI Evet Dize Komut dosyası eylem dosyasının URL'si
Parametreler Hayı Dize Komut dosyası eylem dosyası yürütülürken geçirilecek bağımsız değişkenler

Yanıt

Doğrulama tamamlandıysa ve istek kabul edildiyse, 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ü Açıklama
hazırlamaDurumu Dize Geçerli sağlama durumunu gösterir.
clusterState Dize Sağlama devam ederken HDInsight kümesinin durumunu daha ayrıntılı olarak gösterir.
oluşturulmaTarihi Tarih Küme oluşturma isteğinin alındığı tarih
quotaInfo Karmaşık Tür Küme tarafından kullanılan çekirdekleri belirtir
Hata Hata mesajları dizisi provisioningState = 'başarısız' ise hata mesajını içerir
connectivityEndpoints Karmaşık Tür Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı Türü Açıklama
isim Dize Bağlantı uç noktası için kolay ad
protokol Dize Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
konum Dize Bağlanılacak URL'yi belirtir
liman Int Bağlanılacak bağlantı noktasını belirtir

Varsayılan dosya sistemi olarak Azure Data Lake Store ile bir küme oluşturma

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

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

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
YERLEŞTİRMEK 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ı bir Hadoop kümesi oluşturmaya yönelik 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ü Açıklama
kimlik Evet Dize Kümenin kaynak tanımlayıcısını belirtir.
isim Evet Dize Kümenin adını belirtir.
tür Evet Dize Kümenin türünü belirtir.
konum 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ı 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 .
Özellikleri Evet Karmaşık Tür Kümenin özelliklerini belirtir.

Özellikler

Öğe adı Gerekli Türü Açıklama
kümeSürümü Evet Dize Küme sürümünü belirtir
işletim sistemi türü Evet Dize Küme için İşletim sistemini belirtir.

Geçerli değer Linux'tur
seviye Hayı Dize Kümenin katmanını belirtir. Geçerli değerler standart ve premium'dur. Katman belirtilmezse, küme standart katmanda olur.
clusterDefinition (küme Tanımı) Evet Karmaşık Tür Küme türü ve yapılandırmaları hakkında bilgi belirtir
computeProfile Evet Karmaşık Tür Küme topolojisi ve ilişkili rol özellikleri hakkındaki bilgileri belirtir

clusterDefinition (küme Tanımı)

Öğe adı Gerekli Türü Açıklama
tür Evet Dize Küme türünü belirtir.

Geçerli değerler şunlardır: hadoop, hbase, storm & spark
Yapılandırmalar Evet Sözlük Bu öğe, yapılandırma türünün ve ilişkili değer sözlüğünün bir 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ü Açıklama
kümeSürümü Evet Dize Küme sürümünü belirtir
rol Evet Karmaşık Tür Dizisi (rol) Kümedeki rollerle ilgili bilgileri belirtir

rol

Öğe adı Gerekli Türü Açıklama
isim Evet Dize Rol adını belirtir
targetInstanceCount (hedefÖrnekSayısı) Evet Integer Rol için hedef örnek sayısını belirtir
donanım Profili Evet Karmaşık Tür Rolün donanım profili hakkındaki bilgileri belirtir
İşletim SistemiProfili Evet Karmaşık Tür Rol için işletim sistemi profili hakkındaki bilgileri belirtir

donanım Profili

Öğe adı Gerekli Türü Açıklama
vmSize Evet Dize VM'nin boyutunu belirtir. Geçerli boyutlar için HDInsight yapılandırma seçeneklerine bakın (bu bağlantıda bir kez aşağı kaydırın ve Düğüm fiyatlandırma katmanları'na gidin)

osProfile

Öğe adı Gerekli Türü Açıklama
linuxOperatingSystemProfile Hayı Karmaşık Tür Linux işletim sistemi ile ilgili ayarları belirtir
virtualNetworkProfile Hayı 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 Hayı Karmaşık Tür Dizisi Kümede yürütülecek betik eylemlerinin listesi

linuxOperatingSystemProfile

Öğe adı Gerekli Türü Açıklama
Kullanıcı adı Evet Dize SSH kullanıcı adı
sshProfile Hayı Karmaşık Tür SSH anahtarını belirtir.

sshProfile veya Password'den biri gereklidir.
Şifre Hayı Dize SSH parolasını belirtir

sshProfile veya Password'den biri gereklidir.

sshProfile

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

virtualNetworkProfile

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

scriptActions

Öğe adı Gerekli Türü Açıklama
isim Evet Dize Komut dosyası eylemi için kolay ad
URI Evet Dize Komut dosyası eylem dosyasının URL'si
Parametreler Hayı Dize Komut dosyası eylem dosyası yürütülürken geçirilecek bağımsız değişkenler

Yanıt

Doğrulama tamamlandıysa ve istek kabul edildiyse, 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ü Açıklama
hazırlamaDurumu Dize Geçerli sağlama durumunu gösterir.
clusterState Dize Sağlama devam ederken HDInsight kümesinin durumunu daha ayrıntılı olarak gösterir.
oluşturulmaTarihi Tarih Küme oluşturma isteğinin alındığı tarih
quotaInfo Karmaşık Tür Küme tarafından kullanılan çekirdekleri belirtir
Hata Hata mesajları dizisi provisioningState = 'başarısız' ise hata mesajını içerir
connectivityEndpoints Karmaşık Tür Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı Türü Açıklama
isim Dize Bağlantı uç noktası için kolay ad
protokol Dize Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
konum Dize Bağlanılacak URL'yi belirtir
liman Int Bağlanılacak bağlantı noktasını belirtir

Sil

HDInsight kümesini siler.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

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

Yanıt

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

Açıklamalar

Silme kümesi isteğinin ilerlemesini izlemek için bkz: Zaman Uyumsuz İşlemler (202 Kabul Edildi ve Konum üst bilgisi)

Edin

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

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
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 ile 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ü Açıklama
hazırlamaDurumu Dize Geçerli sağlama durumunu gösterir.
clusterState Dize Sağlama devam ederken HDInsight kümesinin durumunu daha ayrıntılı olarak gösterir.
oluşturulmaTarihi Tarih Küme oluşturma isteğinin alındığı tarih
quotaInfo Karmaşık Tür Küme tarafından kullanılan çekirdekleri belirtir
Hata Hata mesajları dizisi provisioningState = 'başarısız' ise hata mesajını içerir
connectivityEndpoints Karmaşık Tür Küme için genel uç noktaları belirtir

connectivityEndpoints

Öğe adı Türü Açıklama
isim Dize Bağlantı uç noktası için kolay ad
protokol Dize Kullanılacak Protokolü belirtir (örnek: HTTPS, SSH)
konum Dize Bağlanılacak URL'yi belirtir
liman Int Bağlanılacak 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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

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

Yanıt

HTTP 200 (Tamam) işlemi başarıyla tamamlandığında.

Ö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ü Açıklama
Yapılandırmalar Sözlük Bu öğe, yapılandırma türünün ve ilişkili değer sözlüğünün bir 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

Yapılandırma al

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

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
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

HTTP 200 (Tamam) işlemi başarıyla tamamlandığında.

Ö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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

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

Yanıt

HTTP 200 (Tamam) işlemi başarıyla tamamlandığında.

Ö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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
PAYLAŞ 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

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

Bağlantı ayarlarını değiştirme (KULLANIM DIŞI)

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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
PAYLAŞ 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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
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, bir küme ayrıntıları dizisidir. Daha fazla bilgi için bkz: Küme özelliklerini alma.

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

Aboneliğe göre listeleme

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

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
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, bir 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ü Açıklama
restAuthCredential.isEnabled Evet Boolean (Boole Mantığı) Bağlantının etkinleştirilmesi veya devre dışı bırakılması gerektiğini belirtir
restAuthCredential.username Hayı Dize isEnabled=true ise gereklidir
Bağlantı ayarları için kullanıcı adını belirtir
restAuthCredential.password Hayı Dize isEnabled=true ise gereklidir
Bağlantı ayarları için parolayı belirtir

Yanıt

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

Açıklamalar

Silme kümesi isteğinin ilerlemesini 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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
PAYLAŞ 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ü Açıklama
windowsOperatingSystemProfile Hayı Karmaşık Tür Windows işletim sistemi ile ilgili ayarları belirtir

windowsOperatingSystemProfile

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

rdpSettings

Öğe adı Gerekli Türü Açıklama
kullanıcı adı Evet Dize RDP kullanıcı adını belirtir
şifre Evet Dize RDP kullanıcısının parolasını belirtir
expiryDate Evet Tarih RDP kimlik bilgileri için son kullanma 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 Eylemleri çalıştırma (yalnızca Linux kümesi)

Çalışan bir kümede Komut Dosyası Yürütme eylemi.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
PAYLAŞ 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ü Açıklama
isim Evet Dize Kod eyleminin adını belirtir
URI Evet Dize Komut dosyası eyleminin URI'sini belirtir
Parametreler Evet Dize Kod eylemi için gereken parametreleri belirtir
görevler Evet Dize Dizisi Komut dosyası eyleminin yürütüleceği hedef rolleri belirtir
persistOnSuccess Evet Boolean (Boole Mantığı) Başarılı yürütmelerden sonra komut dosyası eylemlerinin 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

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

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

Yanıt

HTTP 200 (Tamam) işlemi başarıyla tamamlandığında.

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ü Açıklama
isim Dize Betik eyleminin adını belirtir.
URI Dize Komut dosyası eyleminin URI'sini belirtir.
Parametreler Dize Kod eylemi için gereken parametreleri belirtir
görevler Dize Dizisi Betik eyleminin yürütüldüğü hedeflenen rolleri belirtir.
uygulama adı Dize Komut dosyasının ilişkili olduğu ilgili uygulamayı belirtir. applicationName, komut dosyası kullanıcılar tarafından sağlanıyorsa null olur

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

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

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
SİLMEK 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) komut dosyası eyleminin kalıcı komut dosyası eylemleri listesinden kaldırıldığını belirtmek için.

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

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

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

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
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, komut dosyası yürütme ayrıntılarından oluşan bir dizidir veya scriptExecutionId sağlanmışsa tek bir betik yürütme ayrıntısıdır. Aşağıda bir komut dosyası 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ü Açıklama
scriptExecutionId Uzun Kod eyleminin yürütme kimliğini belirtir.
isim Dize Betik eyleminin adını belirtir.
uygulama adı Dize Komut dosyasının ilişkili olduğu ilgili uygulamayı belirtir. applicationName, komut dosyası kullanıcılar tarafından sağlanıyorsa null olur
URI Dize Komut dosyası eyleminin URI'sini belirtir.
Parametreler Dize Kod eylemi için gereken parametreleri belirtir
görevler Dize Dizisi Betik eyleminin yürütüldüğü hedeflenen rolleri belirtir.
başlangıç zamanı Tarih ve Saat Komut dosyası eylemi yürütmesinin başlangıç zamanını belirtir
bitişZamanı Tarih ve Saat Komut dosyası eylemi yürütmesinin bitiş zamanını belirtir
statü Dize Komut dosyası eylemi yürütmesinin durumunu belirtir
Operasyon Dize Komut dosyası eyleminin neden yürütüldüğünü belirtir. Örneğin, ScaleUp betik eyleminin küme ölçeğini artırma sırasında yürütüldüğü anlamına gelir.
yürütmeÖzeti Karmaşık türde dizi Yürütme özetini, kaç ana bilgisayarın başarılı olduğu ve kaç ana bilgisayarın komut dosyasını yürütemediği açısından belirtir.
debugInformation Dize Komut dosyası için ayrıntılı hata ayıklama bilgilerini belirtir. debugInformation yalnızca istekte bir scriptExecutionId sağlandığında döndürülür.

yürütmeÖzeti

Öğe adı Türü Açıklama
statü Dize Tek tek ana bilgisayarlarda yürütmenin durumunu belirtir.
instanceCount Int Karşılık gelen 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, betik yürütme geçmişinden bir HDInsight betiğini kalıcı hale getirir.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
PAYLAŞ 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) komut dosyası eyleminin yükseltildiğini belirtmek için.

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

Yeniden boyutlandır

Mevcut bir HDInsight kümesini yeniden boyutlandırır.

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
PAYLAŞ 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ştirmek için örnek bir istek gösterilmektedir

{  
    "targetInstanceCount": 10  
}
Öğe adı Gerekli Türü Açıklama
targetInstanceCount (hedefÖrnekSayısı) Evet Int Rol için yeni örnek sayısını belirtir

Yanıt

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

Açıklamalar

Silme kümesi isteğinin ilerlemesini izlemek için bkz: Zaman Uyumsuz İşlemler (202 Kabul Edildi ve Konum üst bilgisi)

Güncelleştir

Bir kümenin etiketlerini güncelleştirir.

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

İstek

Kümeler tarafından kullanılan üst bilgiler ve parametreler için ortak parametreler ve üst bilgiler bölümüne bakın.

Yöntem İstenilen URI
Düzeltme Eki 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ştirmek için örnek bir istek gösterilmektedir

{   
    "tags": {"department": "finance"}  
}
Öğe adı Gerekli Türü Açıklama
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şturma ile aynıdır.

  • Last updated on