Azure HDInsight의 클러스터 REST API

  • 아티클

만들기

지정된 구독에 클러스터를 만듭니다.

요청

클러스터에서 사용되는 헤더 및 매개 변수에 대한 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

다음 예제에서는 Linux 기반 hadoop 클러스터를 만들기 위한 요청 본문을 보여 줍니다. 다른 방법으로 클러스터를 만드는 예제는 아래 예제 섹션을 참조하세요.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
요소 이름 필수 형식 Description
id 예 String 클러스터의 리소스 식별자를 지정합니다.
name 예 String 클러스터의 이름을 지정합니다.
type 예 String 클러스터의 유형을 지정합니다.
위치 예 String 클러스터를 만들어야 하는 지원되는 Azure 위치를 지정합니다. 자세한 내용은 사용 가능한 모든 지역 위치 나열을 참조하세요.
tags 예 String 클러스터에 할당될 태그를 지정합니다. 태그 사용에 대한 자세한 내용은 태그를 사용하여 Azure 리소스 구성을 참조하세요.
속성 Yes 복합 형식 클러스터의 속성을 지정합니다.

속성

요소 이름 필수 형식 Description
clusterVersion 예 String 클러스터 버전을 지정합니다.
osType 예 String 클러스터의 운영 체제를 지정합니다.

유효한 값은 Linux 및 Windows입니다.
clusterDefinition Yes 복합 형식 클러스터 유형 및 구성에 대한 정보를 지정합니다.
computeProfile Yes 복합 형식 클러스터 토폴로지 및 연결된 역할 속성에 대한 정보를 지정합니다.

clusterDefinition

요소 이름 필수 형식 Description
kind 예 String 클러스터 유형을 지정합니다.

유효한 값은 hadoop, hbase, storm & spark입니다.
구성 예 Dictionary 이 요소는 구성 형식 및 관련 값 사전의 사전입니다.

게이트웨이 구성 유형은 웹 API 및 Ambari 포털에 연결하는 데 사용되는 http 사용자를 구성하는 데 사용됩니다.

core-site 구성 유형은 클러스터에 대한 기본 스토리지 계정을 구성하는 데 사용됩니다.

computeProfile

요소 이름 필수 형식 Description
clusterVersion 예 String 클러스터 버전을 지정합니다.
role Yes 복합 형식의 배열(역할) 클러스터의 역할에 대한 정보를 지정합니다.

역할(role)

요소 이름 필수 형식 Description
name 예 String 역할 이름을 지정합니다.
targetInstanceCount 예 정수 역할에 대한 대상 instance 개수를 지정합니다.
hardwareProfile Yes 복합 형식 역할에 대한 하드웨어 프로필에 대한 정보를 지정합니다.
osProfile Yes 복합 형식 역할에 대한 os 프로필에 대한 정보를 지정합니다.

hardwareProfile

요소 이름 필수 형식 Description
vmSize 예 String VM의 크기를 지정합니다. 유효한 크기는 HDInsight 구성 옵션 (이 링크에서 한 번 노드 가격 책정 계층까지 스크롤)을 참조하세요.

osProfile

요소 이름 필수 형식 Description
linuxOperatingSystemProfile No 복합 형식 Linux OS 관련 설정을 지정합니다.
windowsOperatingSystemProfile No 복합 형식 Windows OS 관련 설정을 지정합니다.
virtualNetworkProfile No 복합 형식 클러스터가 사용자 구독의 가상 네트워크에 배포되는 경우 가상 네트워크 관련 설정을 지정합니다.
scriptActions No 복합 형식의 배열 클러스터에서 실행할 스크립트 작업 목록

linuxOperatingSystemProfile

요소 이름 필수 형식 Description
사용자 이름 예 String SSH 사용자 이름
sshProfile No 복합 형식 SSH 키를 지정합니다.

sshProfile 또는 암호 중 하나가 필요합니다.
암호 예 String SSH 암호를 지정합니다.

sshProfile 또는 암호 중 하나가 필요합니다.

sshProfile

요소 이름 필수 형식 Description
publicKeys 예 Array certificateData 개체 목록을 포함합니다. 값은 ssh-rsa 공개 키입니다.

windowsOperatingSystemProfile

요소 이름 필수 형식 Description
rdpSettings No 복합 형식 Windows 클러스터에 대한 RDP 설정을 지정합니다.

rdpSettings

요소 이름 필수 형식 Description
사용자 이름 예 String RDP 사용자 이름을 지정합니다.
password 예 String RDP 사용자의 암호를 지정합니다.
expiryDate 예 Date RDP 자격 증명의 만료 날짜

virtualNetworkProfile

요소 이름 필수 형식 Description
id 예 String Virtual Network 리소스 ID
서브넷 예 String 서브넷 이름을 지정합니다.

scriptActions

요소 이름 필수 형식 Description
name 예 String 스크립트 작업의 이름
uri 예 String 스크립트 작업 파일의 URL
매개 변수 예 String 스크립트 작업 파일을 실행할 때 전달할 인수

응답

유효성 검사가 완료되고 요청이 수락되면 작업은 200(OK)을 반환합니다.

상태 코드: 200 OK

linux 클러스터에 대한 응답 본문은 ssh 키를 사용하여 만듭니다.

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    }  
                }  
            ]  
        }  
    }  
}
요소 이름 Type Description
provisioningState 문자열 현재 프로비전 상태를 나타냅니다.
clusterState 문자열 프로비전이 진행되는 동안 더 자세한 HDInsight 클러스터 상태를 나타냅니다.
createdDate Date 클러스터 만들기 요청이 수신된 날짜/시간
quotaInfo 복합 형식 클러스터에서 사용하는 코어를 지정합니다.
오류 오류 메시지의 배열 provisioningState = 'failed'인 경우 오류 메시지가 포함됩니다.
connectivityEndpoints 복합 형식 클러스터에 대한 퍼블릭 엔드포인트를 지정합니다.

connectivityEndpoints

요소 이름 Type Description
name String 연결 엔드포인트의 이름
protocol String 사용할 프로토콜을 지정합니다(예: HTTPS, SSH).
위치 문자열 연결할 URL을 지정합니다.
포트 int 연결할 포트를 지정합니다.

도메인에 가입된 프리미엄 HDInsight 클러스터 만들기(Linux만 해당, 미리 보기)

Apache Ranger를 사용하여 프리미엄 도메인 조인 클러스터를 만듭니다. 사용자는 보안 클러스터를 만들려면 요청 본문에 SecurityProfile을 제공해야 합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

다음 예제에서는 Linux 기반 프리미엄 도메인에 가입된 Hadoop 클러스터를 만들기 위한 요청 본문을 보여 줍니다.

{
	"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"
						}
					}
				}
			]
		}
	}
}
요소 이름 필수 형식 Description
id 예 String 클러스터의 리소스 식별자를 지정합니다.
name 예 String 클러스터의 이름을 지정합니다.
type 예 String 클러스터의 유형을 지정합니다.
위치 예 String 클러스터를 만들어야 하는 지원되는 Azure 위치를 지정합니다. 자세한 내용은 사용 가능한 모든 지역 위치 나열을 참조하세요.
tags 예 String 클러스터에 할당될 태그를 지정합니다. 태그 사용에 대한 자세한 내용은 태그를 사용하여 Azure 리소스 구성을 참조하세요.
속성 Yes 복합 형식 클러스터의 속성을 지정합니다.

속성

요소 이름 필수 형식 Description
clusterVersion 예 String 클러스터 버전을 지정합니다.
osType 예 String 클러스터의 운영 체제를 지정합니다.

Linux 클러스터 유형만 Azure AD 도메인에 가입할 수 있으므로 유효한 값은 Linux입니다.
계층 예 String 기본값은 표준입니다. 유효한 값은 표준 및 프리미엄입니다. 값을 지정하지 않으면 값이 표준으로 간주됩니다. 클러스터의 계층을 지정합니다. 도메인 가입 클러스터는 프리미엄 계층에서만 지원됩니다.
clusterDefinition Yes 복합 형식 클러스터 유형 및 구성에 대한 정보를 지정합니다.
computeProfile Yes 복합 형식 클러스터 토폴로지 및 연결된 역할 속성에 대한 정보를 지정합니다.
securityProfile No 복합 형식 도메인에 가입된 안전한 클러스터를 만드는 경우 이 요소는 Active Directory 관련 설정을 지정합니다.

clusterDefinition

요소 이름 필수 형식 Description
kind 예 String 클러스터 유형을 지정합니다.

유효한 값은 hadoop, hbase, storm & spark입니다.
구성 예 Dictionary 이 요소는 구성 형식 및 관련 값 사전의 사전입니다.

게이트웨이 구성 유형은 웹 API 및 Ambari 포털에 연결하는 데 사용되는 http 사용자를 구성하는 데 사용됩니다.

core-site 구성 유형은 클러스터에 대한 기본 스토리지 계정을 구성하는 데 사용됩니다.

computeProfile

요소 이름 필수 형식 Description
clusterVersion 예 String 클러스터 버전을 지정합니다.
role Yes 복합 형식의 배열(역할) 클러스터의 역할에 대한 정보를 지정합니다.

securityProfile

요소 이름 필수 형식 Description
directoryType 예 String 사용되는 LDAP 디렉터리의 유형입니다. 현재 "ActiveDirectory"는 유일하게 지원되는 값입니다.
도메인 예 String 클러스터에 대한 Active Directory 도메인
organizationalUnitDN 예 String 사용자 및 컴퓨터 계정을 만들 Active Directory의 조직 구성 단위의 고유 이름
ldapsUrls Yes 문자열 배열 Active Directory에 대한 하나 이상의 LDAPS 서버 URL
domainUserName 예 String 클러스터를 만들 수 있는 충분한 권한이 있는 도메인 사용자 계정입니다. user@domain 형식이어야 합니다.
domainUserPassword 예 String 도메인 사용자 계정의 암호
clusterUsersGroupDNS No 문자열 배열 Ambari 및 Apache Ranger에서 사용할 수 있는 Active Directory 그룹의 고유 이름

역할(role)

요소 이름 필수 형식 Description
name 예 String 역할 이름을 지정합니다.
targetInstanceCount 예 정수 역할에 대한 대상 instance 개수를 지정합니다.
hardwareProfile Yes 복합 형식 역할에 대한 하드웨어 프로필에 대한 정보를 지정합니다.
osProfile Yes 복합 형식 역할에 대한 os 프로필에 대한 정보를 지정합니다.

hardwareProfile

요소 이름 필수 형식 Description
vmSize 예 String VM의 크기를 지정합니다. 유효한 크기는 HDInsight 구성 옵션 (이 링크에서 한 번 노드 가격 책정 계층까지 스크롤)을 참조하세요.

osProfile

요소 이름 필수 형식 Description
linuxOperatingSystemProfile No 복합 형식 Linux OS 관련 설정을 지정합니다.
virtualNetworkProfile No 복합 형식 클러스터가 사용자 구독의 가상 네트워크에 배포되는 경우 가상 네트워크 관련 설정을 지정합니다.
scriptActions No 복합 형식의 배열 클러스터에서 실행할 스크립트 작업 목록

linuxOperatingSystemProfile

요소 이름 필수 형식 Description
사용자 이름 예 String SSH 사용자 이름
sshProfile No 복합 형식 SSH 키를 지정합니다.

sshProfile 또는 암호 중 하나가 필요합니다.
암호 예 String SSH 암호를 지정합니다.

sshProfile 또는 암호 중 하나가 필요합니다.

sshProfile

요소 이름 필수 형식 Description
publicKeys 예 Array certificateData 개체 목록을 포함합니다. 값은 ssh-rsa 공개 키입니다.

virtualNetworkProfile

요소 이름 필수 형식 Description
id 예 String Virtual Network 리소스 ID
서브넷 예 String 서브넷 이름을 지정합니다.

scriptActions

요소 이름 필수 형식 Description
name 예 String 스크립트 작업의 이름
uri 예 String 스크립트 작업 파일의 URL
매개 변수 예 String 스크립트 작업 파일을 실행할 때 전달할 인수

응답

유효성 검사가 완료되고 요청이 수락되면 작업은 200(OK)을 반환합니다.

상태 코드: 200 OK

Linux 클러스터에 대한 응답 본문은 ssh 키를 사용하여 만듭니다.

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    }  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    }  
                }  
            ]  
        }  
    }  
}
요소 이름 Type Description
provisioningState 문자열 현재 프로비전 상태를 나타냅니다.
clusterState 문자열 프로비전이 진행되는 동안 더 자세한 HDInsight 클러스터 상태를 나타냅니다.
createdDate Date 클러스터 만들기 요청이 수신된 날짜/시간
quotaInfo 복합 형식 클러스터에서 사용하는 코어를 지정합니다.
오류 오류 메시지 배열 provisioningState = 'failed'인 경우 오류 메시지가 포함됩니다.
connectivityEndpoints 복합 형식 클러스터에 대한 공용 엔드포인트를 지정합니다.

connectivityEndpoints

요소 이름 Type Description
name String 연결 엔드포인트의 이름
protocol String 사용할 프로토콜을 지정합니다(예: HTTPS, SSH)
위치 문자열 연결할 URL을 지정합니다.
포트 int 연결할 포트를 지정합니다.

Azure Data Lake Store를 기본 파일 시스템으로 사용하여 클러스터 만들기

Azure Data Lake Store를 기본 파일 시스템으로 사용하여 지정된 구독에 클러스터를 만듭니다. 요청 본문에 ClusterIdentity 개체를 제공하고 적절한 Data Lake Store URL을 사용하여 기본 파일 시스템 속성을 구성합니다.

Azure Data Lake는 3.5부터 시작하는 클러스터 버전의 기본 파일 시스템으로 구성할 수 있습니다.

요청

클러스터에서 사용되는 헤더 및 매개 변수에 대한 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
PUT https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

다음 예제에서는 Azure Data Lake Store를 클러스터의 기본 파일 시스템으로 사용하여 Linux 기반 Hadoop 클러스터를 만들기 위한 요청 본문을 보여 줍니다.

{
	"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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
요소 이름 필수 형식 Description
id 예 String 클러스터의 리소스 식별자를 지정합니다.
name 예 String 클러스터의 이름을 지정합니다.
type 예 String 클러스터의 유형을 지정합니다.
위치 예 String 클러스터를 만들어야 하는 지원되는 Azure 위치를 지정합니다. 자세한 내용은 사용 가능한 모든 지역 위치 나열을 참조하세요.
tags 예 String 클러스터에 할당될 태그를 지정합니다. 태그 사용에 대한 자세한 내용은 태그를 사용하여 Azure 리소스 구성을 참조하세요.
속성 Yes 복합 형식 클러스터의 속성을 지정합니다.

속성

요소 이름 필수 형식 Description
clusterVersion 예 String 클러스터 버전을 지정합니다.
osType 예 String 클러스터의 운영 체제를 지정합니다.

유효한 값은 Linux입니다.
계층 예 String 클러스터의 계층을 지정합니다. 유효한 값은 표준 및 프리미엄입니다. 계층을 지정하지 않으면 클러스터는 표준 계층이 됩니다.
clusterDefinition Yes 복합 형식 클러스터 유형 및 구성에 대한 정보를 지정합니다.
computeProfile Yes 복합 형식 클러스터 토폴로지 및 연결된 역할 속성에 대한 정보를 지정합니다.

clusterDefinition

요소 이름 필수 형식 Description
kind 예 String 클러스터 유형을 지정합니다.

유효한 값은 hadoop, hbase, storm & spark입니다.
구성 예 Dictionary 이 요소는 구성 형식 및 관련 값 사전의 사전입니다.

게이트웨이 구성 유형은 웹 API 및 Ambari 포털에 연결하는 데 사용되는 http 사용자를 구성하는 데 사용됩니다.

core-site 구성 유형은 클러스터에 대한 기본 스토리지 계정을 구성하는 데 사용됩니다.

computeProfile

요소 이름 필수 형식 Description
clusterVersion 예 String 클러스터 버전을 지정합니다.
role Yes 복합 형식의 배열(역할) 클러스터의 역할에 대한 정보를 지정합니다.

역할(role)

요소 이름 필수 형식 Description
name 예 String 역할 이름을 지정합니다.
targetInstanceCount 예 정수 역할에 대한 대상 instance 개수를 지정합니다.
hardwareProfile Yes 복합 형식 역할에 대한 하드웨어 프로필에 대한 정보를 지정합니다.
osProfile Yes 복합 형식 역할에 대한 os 프로필에 대한 정보를 지정합니다.

hardwareProfile

요소 이름 필수 형식 Description
vmSize 예 String VM의 크기를 지정합니다. 유효한 크기는 HDInsight 구성 옵션 (이 링크에서 한 번 노드 가격 책정 계층까지 스크롤)을 참조하세요.

osProfile

요소 이름 필수 형식 Description
linuxOperatingSystemProfile No 복합 형식 Linux OS 관련 설정을 지정합니다.
virtualNetworkProfile No 복합 형식 클러스터가 사용자 구독의 가상 네트워크에 배포되는 경우 가상 네트워크 관련 설정을 지정합니다.
scriptActions No 복합 형식의 배열 클러스터에서 실행할 스크립트 작업 목록

linuxOperatingSystemProfile

요소 이름 필수 형식 Description
사용자 이름 예 String SSH 사용자 이름
sshProfile No 복합 형식 SSH 키를 지정합니다.

sshProfile 또는 암호 중 하나가 필요합니다.
암호 예 String SSH 암호를 지정합니다.

sshProfile 또는 암호 중 하나가 필요합니다.

sshProfile

요소 이름 필수 형식 Description
publicKeys 예 Array certificateData 개체 목록을 포함합니다. 값은 ssh-rsa 공개 키입니다.

virtualNetworkProfile

요소 이름 필수 형식 Description
id 예 String Virtual Network 리소스 ID
서브넷 예 String 서브넷 이름을 지정합니다.

scriptActions

요소 이름 필수 형식 Description
name 예 String 스크립트 작업의 이름
uri 예 String 스크립트 작업 파일의 URL
매개 변수 예 String 스크립트 작업 파일을 실행할 때 전달할 인수

응답

유효성 검사가 완료되고 요청이 수락되면 작업은 200(OK)을 반환합니다.

상태 코드: 200 OK

linux 클러스터에 대한 응답 본문은 ssh 키를 사용하여 만듭니다.

{
	"id": "/subscriptions/{subscription ID}/resourceGroups/rg1/providers/Microsoft.HDInsightCurrent/clusters/mycluster",
	"name": "mycluster",
	"type": "Microsoft.HDInsightCurrent/clusters",
	"location": "East Asia",
	"etag": "{value}",
	"tags": null,
	"properties": {
		"clusterVersion": "3.5.1000.0",
		"osType": "Linux",
		"clusterDefinition": {
			"kind": "hadoop"
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Standard_D3"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "myuser"
						}
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Standard_D3"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "myuser"
						}
					}
				}
			]
		},
		"provisioningState": "InProgress",
		"clusterState": "Accepted",
		"createdDate": "2016-11-15T09:21:47.61",
		"quotaInfo": {
			"coresUsed": 16
		},
		"tier": "standard"
	}
}
요소 이름 Type Description
provisioningState 문자열 현재 프로비전 상태를 나타냅니다.
clusterState 문자열 프로비전이 진행되는 동안 더 자세한 HDInsight 클러스터 상태를 나타냅니다.
createdDate Date 클러스터 만들기 요청이 수신된 날짜/시간
quotaInfo 복합 형식 클러스터에서 사용하는 코어를 지정합니다.
오류 오류 메시지의 배열 provisioningState = 'failed'인 경우 오류 메시지가 포함됩니다.
connectivityEndpoints 복합 형식 클러스터에 대한 퍼블릭 엔드포인트를 지정합니다.

connectivityEndpoints

요소 이름 Type Description
name String 연결 엔드포인트의 이름
protocol String 사용할 프로토콜을 지정합니다(예: HTTPS, SSH).
위치 문자열 연결할 URL을 지정합니다.
포트 int 연결할 포트를 지정합니다.

삭제

HDInsight 클러스터를 삭제합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

응답

작업이 비동기적으로 완료됨을 나타내는 HTTP 202(수락됨)입니다. 비동기 폴링은 작업이 성공적으로 완료되면 204(NoContent)를 반환합니다.

설명

클러스터 삭제 요청의 진행률을 추적하려면 비동기 작업(202 허용 및 위치 헤더)을 참조하세요.

Get

지정된 클러스터의 세부 정보/속성을 가져옵니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

응답

요청이 성공적으로 완료되면 작업이 200(정상)을 반환합니다.

상태 코드: 200 OK

응답 본문은 클러스터 만들기와 동일합니다.

Linux 클러스터 세부 정보에 대한 응답 본문

{  
    "id":"/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",  
  "name":"mycluster",   
  "type":"Microsoft.HDInsight/clusters",  
  
    "location": "location-name",  
    "tags": { "tag1": "value1", "tag2": "value2" },  
    "properties": {  
        "clusterVersion": "3.2",  
        "osType": "Linux",  
		"provisioningState": "InProgress",  
		"clusterState": "Accepted",  
		"createdDate": "2015-09-23",  
		"quotaInfo": {  
			"coresUsed": 20  
}  
        "clusterDefinition": {  
            "kind": "hadoop"  
        },  
  
        "computeProfile": {  
            "roles": [  
                {  
                    "name": "headnode",  
  
                    "targetInstanceCount": 2,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
  
                },  
                {  
                    "name": "workernode",  
  
                    "targetInstanceCount": 1,  
  
                    "hardwareProfile": {  
                        "vmSize": "Large"  
                    },  
  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
  
                },  
                {  
                    "name": "zookeepernode",  
  
                    "targetInstanceCount": 3,  
  
                    "hardwareProfile": {  
                        "vmSize": "Small"  
                    },  
  
                    "osProfile": {  
                       "linuxOperatingSystemProfile": {  
                          "username": "sshuser"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
요소 이름 Type Description
provisioningState 문자열 현재 프로비전 상태를 나타냅니다.
clusterState 문자열 프로비전이 진행되는 동안 더 자세한 HDInsight 클러스터 상태를 나타냅니다.
createdDate Date 클러스터 만들기 요청이 수신된 날짜/시간
quotaInfo 복합 형식 클러스터에서 사용하는 코어를 지정합니다.
오류 오류 메시지의 배열 provisioningState = 'failed'인 경우 오류 메시지가 포함됩니다.
connectivityEndpoints 복합 형식 클러스터에 대한 퍼블릭 엔드포인트를 지정합니다.

connectivityEndpoints

요소 이름 Type Description
name String 연결 엔드포인트의 이름
protocol String 사용할 프로토콜을 지정합니다(예: HTTPS, SSH).
위치 문자열 연결할 URL을 지정합니다.
포트 int 연결할 포트를 지정합니다.

구성 나열

모든 클러스터 구성 세부 정보(중요한 정보 포함)를 검색합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

응답

작업이 성공적으로 완료된 경우 HTTP 200(정상)입니다.

예제 응답:

"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"  
      }  
}
요소 이름 Type Description
구성 Dictionary 이 요소는 구성 형식 및 연결된 값 사전의 사전입니다.
게이트웨이 구성 유형은 웹 API 및 Ambari 포털에 연결하는 데 사용되는 http 사용자를 구성하는 데 사용됩니다.
core-site 구성 유형은 클러스터에 대한 기본 스토리지 계정을 구성하는 데 사용됩니다.

구성 가져오기

단일 구성 형식에 대한 세부 정보를 가져옵니다(중요한 값은 생략).

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 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}

응답

작업이 성공적으로 완료된 경우 HTTP 200(정상)입니다.

예제 응답:

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

게이트웨이 설정 가져오기

이 작업은 클러스터 게이트웨이 HTTP 자격 증명을 검색합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

응답

작업이 성공적으로 완료된 경우 HTTP 200(정상)입니다.

예제 응답:

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

게이트웨이 설정 업데이트

이 작업을 통해 사용자는 클러스터 게이트웨이 HTTP 자격 증명을 변경할 수 있습니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
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!"  
}

응답

작업이 성공적으로 완료되면 HTTP 202(수락됨)입니다.

연결 설정 변경(사용되지 않음)

이 작업을 통해 사용자는 클러스터에 대한 HTTPS 연결을 사용하거나 사용하지 않도록 설정할 수 있습니다.

대신 updateGatewaySettings를 사용합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

연결을 사용하도록 설정하려면

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

리소스 그룹별 목록

지정된 리소스 그룹의 사용자 구독에 있는 모든 클러스터를 Lists.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

응답

요청이 성공적으로 완료되면 작업이 200(정상)을 반환합니다.

상태 코드: 200 OK

응답 본문은 클러스터 세부 정보의 배열입니다. 자세한 내용은 클러스터 속성 가져오기를 참조하세요.

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

구독별 목록

사용자의 구독에 있는 모든 클러스터를 Lists.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
GET https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

응답

요청이 성공적으로 완료되면 작업이 200(정상)을 반환합니다.

상태 코드: 200 OK

응답 본문은 클러스터 세부 정보의 배열입니다.

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

연결을 사용하지 않도록 설정하려면

{  
   "restAuthCredential.isEnabled": false  
}
요소 이름 필수 형식 Description
restAuthCredential.isEnabled 예 부울 연결을 사용하도록 설정하거나 사용하지 않도록 설정해야 하는지 여부를 지정합니다.
restAuthCredential.username 예 String isEnabled=true인 경우 필수
연결 설정의 사용자 이름을 지정합니다.
restAuthCredential.password 예 String isEnabled=true인 경우 필수
연결 설정에 대한 암호를 지정합니다.

응답

작업이 비동기적으로 완료됨을 나타내는 HTTP 202(수락됨)입니다. 비동기 폴링은 작업이 성공적으로 완료되면 204(NoContent)를 반환합니다.

설명

클러스터 삭제 요청의 진행률을 추적하려면 비동기 작업(202 허용 및 위치 헤더)을 참조하세요.

RDP 설정 변경(Windows 클러스터에만 해당)

이 작업을 통해 사용자는 RDP를 사용하거나 사용하지 않도록 설정할 수 있습니다. Windows 기반 클러스터에 적용됩니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

요청 본문

RDP를 사용하도록 설정하려면

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

RDP를 사용하지 않도록 설정하려면

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

osProfile

요소 이름 필수 형식 Description
windowsOperatingSystemProfile No 복합 형식 Windows OS 관련 설정을 지정합니다.

windowsOperatingSystemProfile

요소 이름 필수 형식 Description
rdpSettings No 복합 형식 Windows 클러스터에 대한 RDP 설정을 지정합니다.

rdpSettings

요소 이름 필수 형식 Description
사용자 이름 예 String RDP 사용자 이름을 지정합니다.
password 예 String RDP 사용자의 암호를 지정합니다.
expiryDate 예 Date RDP 자격 증명의 만료 날짜

응답

요청이 성공적으로 완료되면 작업이 200(정상)을 반환합니다.

상태 코드: 200 OK

응답 본문은 클러스터 만들기와 동일합니다.

실행 중인 클러스터에서 스크립트 작업 실행(Linux 클러스터에만 해당)

실행 중인 클러스터에서 스크립트 실행 작업

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
POST https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

요청 본문

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

scriptActions

요소 이름 필수 형식 Description
name 예 String 스크립트 작업의 이름을 지정합니다.
uri 예 String 스크립트 작업의 URI를 지정합니다.
매개 변수 예 String 스크립트 작업에 필요한 매개 변수를 지정합니다.
역할 Yes 문자열 배열 스크립트 작업이 실행되는 대상 역할을 지정합니다.
persistOnSuccess 예 부울 성공적으로 실행된 후 스크립트 동작을 유지할지 여부를 지정합니다.

응답

유효성 검사가 완료되고 요청이 수락되면 작업은 202(수락됨)를 반환합니다.

상태 코드: 202(수락됨)

클러스터에 대한 모든 지속형 스크립트 작업 나열(Linux 클러스터에만 해당)

이 작업은 지정된 클러스터의 모든 지속형 스크립트 작업을 반환합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
GET https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

응답

작업이 성공적으로 완료된 경우 HTTP 200(정상)입니다.

상태 코드: 200 OK

예제 응답:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
요소 이름 Type Description
name String 스크립트 작업의 이름을 지정합니다.
uri String 스크립트 작업의 URI를 지정합니다.
매개 변수 문자열 스크립트 작업에 필요한 매개 변수를 지정합니다.
역할 문자열 배열 스크립트 작업이 실행되는 대상 역할을 지정합니다.
applicationName String 스크립트가 연결된 해당 애플리케이션을 지정합니다. 사용자가 스크립트를 제공하는 경우 applicationName은 null입니다.

클러스터에 대한 지속형 스크립트 작업 제거(Linux 클러스터에만 해당)

이 작업은 클러스터에 대한 HDInsight 지속형 스크립트 작업을 제거합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
DELETE https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

응답

  • HTTP 200(OK)은 스크립트 작업이 지속형 스크립트 작업 목록에서 제거되었음을 나타냅니다.

  • HTTP 404(NotFound) - 해당 scriptName을 사용하는 기존 지속형 스크립트 작업이 없음을 나타냅니다.

기록에서 스크립트 작업 실행 가져오기(Linux 클러스터에만 해당)

이 작업은 개별 스크립트 실행에 대해 지정된 클러스터의 최신 스크립트 작업 실행 또는 실행 세부 정보를 반환합니다.

요청

클러스터 에서 사용되는 헤더 및 매개 변수는 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 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}

응답

요청이 성공적으로 완료되면 작업이 200(정상)을 반환합니다. 응답 본문은 scriptExecutionId가 제공되는 경우 스크립트 실행 세부 정보 또는 단일 스크립트 실행 세부 정보의 배열입니다. 다음은 스크립트 실행 세부 정보의 예입니다.

상태 코드: 200(확인)

예제 응답:

{  
  "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"  
}
요소 이름 Type Description
scriptExecutionId long 스크립트 작업의 실행 ID를 지정합니다.
name String 스크립트 작업의 이름을 지정합니다.
applicationName String 스크립트가 연결된 해당 애플리케이션을 지정합니다. 사용자가 스크립트를 제공하는 경우 applicationName은 null입니다.
uri String 스크립트 작업의 URI를 지정합니다.
매개 변수 문자열 스크립트 작업에 필요한 매개 변수를 지정합니다.
역할 문자열 배열 스크립트 작업이 실행되는 대상 역할을 지정합니다.
startTime DateTime 스크립트 작업 실행의 시작 시간을 지정합니다.
endTime DateTime 스크립트 작업 실행의 종료 시간을 지정합니다.
상태 String 스크립트 작업 실행의 상태 지정합니다.
operation 문자열 스크립트 작업이 실행된 이유를 지정합니다. 예를 들어 ScaleUp은 클러스터 스케일 업 중에 스크립트 작업이 실행되었음을 의미합니다.
executionSummary 복합 형식의 배열 성공한 호스트 수와 스크립트를 실행하지 못한 호스트 수에 대한 실행 요약을 지정합니다.
debugInformation 문자열 스크립트에 대한 자세한 디버그 정보를 지정합니다. debugInformation은 요청에 scriptExecutionId가 제공된 경우에만 반환됩니다.

executionSummary

요소 이름 Type Description
상태 String 개별 호스트에서 실행의 상태 지정합니다.
instanceCount Int 해당 상태 있는 실행 수를 지정합니다.

스크립트 작업 실행 기록에서 스크립트를 유지하도록 승격(Linux 클러스터에만 해당)

이 작업은 스크립트 실행 기록에서 유지되도록 HDInsight 스크립트를 승격합니다.

요청

클러스터에서 사용되는 헤더 및 매개 변수에 대한 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
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}

응답

  • 스크립트 작업이 승격되었음을 나타내는 HTTP 200(확인)입니다.

  • HTTP 404(NotFound)는 해당 scriptExecutionId를 사용하여 기존 스크립트 작업 실행이 없음을 나타냅니다.

크기 조정

기존 HDInsight 클러스터의 크기를 조정합니다.

요청

클러스터에서 사용되는 헤더 및 매개 변수에 대한 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
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}

다음은 클러스터에 대한 태그를 업데이트하는 예제 요청을 보여 줍니다.

{  
    "targetInstanceCount": 10  
}
요소 이름 필수 형식 Description
targetInstanceCount Yes Int 역할에 대한 새 instance 개수를 지정합니다.

응답

작업이 비동기적으로 완료됨을 나타내는 HTTP 202(수락됨)입니다. 비동기 폴링은 작업이 성공적으로 완료되면 204(NoContent)를 반환합니다.

설명

클러스터 삭제 요청의 진행률을 추적하려면 비동기 작업(202 허용 및 위치 헤더)을 참조하세요.

업데이트

클러스터에 대한 태그를 업데이트.

다른 모든 업데이트는 별도로 설명된 별도의 작업입니다.

요청

클러스터에서 사용되는 헤더 및 매개 변수에 대한 일반적인 매개 변수 및 헤더를 참조하세요.

메서드 요청 URI
패치 https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

다음은 클러스터에 대한 태그를 업데이트하는 예제 요청을 보여 줍니다.

{   
    "tags": {"department": "finance"}  
}
요소 이름 필수 형식 Description
tags 예 String 클러스터에 할당할 태그를 지정합니다. 태그 사용에 대한 자세한 내용은 태그를 사용하여 Azure 리소스 구성을 참조하세요.

응답

요청이 성공적으로 완료되면 작업이 200(정상)을 반환합니다.

상태 코드: 200 OK

응답 본문은 클러스터 만들기와 동일합니다.