API REST do Cluster no Azure HDInsight

Criar

Cria um cluster na subscrição especificada.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método	URI do pedido
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

O exemplo seguinte mostra o corpo do pedido para criar um cluster hadoop baseado em Linux. Para obter exemplos de criação de clusters de outras formas, veja a secção Exemplos abaixo.

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

Nome do elemento	Necessário	Tipo	Descrição
ID	Sim	String	Especifica o identificador de recurso do cluster.
name	Sim	String	Especifica o nome do cluster.
tipo	Sim	String	Especifica o tipo do cluster.
localização	Sim	String	Especifica a localização suportada do Azure onde o cluster deve ser criado. Para obter mais informações, veja Listar todas as localizações geográficas disponíveis.
etiquetas	No	String	Especifica as etiquetas que serão atribuídas ao cluster. Para obter mais informações sobre como utilizar etiquetas, veja Utilizar etiquetas para organizar os recursos do Azure.
Propriedades	Yes	Tipo Complexo	Especifica as propriedades do cluster.

Propriedades

Nome do elemento	Necessário	Tipo	Description
clusterVersion	Sim	String	Especifica a versão do cluster
osType	Sim	String	Especifica o sistema operativo do cluster. Os valores válidos são Linux e Windows
clusterDefinition	Yes	Tipo Complexo	Especifica informações sobre o tipo de cluster e as configurações
computeProfile	Yes	Tipo Complexo	Especifica informações sobre a topologia do cluster e as propriedades de função associadas

clusterDefinition

Nome do elemento	Necessário	Tipo	Description
tipo	Sim	String	Especifica o tipo de cluster. Os valores válidos são hadoop, hbase, storm & spark
configurações	Yes	Dicionário	Este elemento é um dicionário do tipo de configuração e do respetivo dicionário de valor associado. O tipo de configuração do gateway é utilizado para configurar o utilizador http utilizado para ligar a APIs Web e ao portal do Ambari o tipo de configuração do site principal é utilizado para configurar a conta de armazenamento predefinida para o cluster

computeProfile

Nome do elemento	Necessário	Tipo	Description
clusterVersion	Sim	String	Especifica a versão do cluster
função	Yes	Matriz de Tipo Complexo (função)	Especifica informações sobre funções no cluster

role

Nome do elemento	Necessário	Tipo	Descrição
name	Sim	String	Especifica o nome da função
targetInstanceCount	Yes	Número inteiro	Especifica a contagem de instâncias de destino para a função
hardwareProfile	Yes	Tipo Complexo	Especifica informações sobre o perfil de hardware para a função
osProfile	Yes	Tipo Complexo	Especifica informações sobre o perfil do SO para a função

hardwareProfile

Nome do elemento	Necessário	Tipo	Description
vmSize	Sim	String	Especifica o tamanho da VM. Veja opções de configuração do HDInsight (uma vez nesta ligação, desloque-se para baixo até Escalões de preço do Nó) para obter tamanhos válidos

osProfile

Nome do elemento	Necessário	Tipo	Description
linuxOperatingSystemProfile	No	Tipo Complexo	Especifica as definições relacionadas com o SO linux
windowsOperatingSystemProfile	No	Tipo Complexo	Especifica as definições relacionadas com o SO windows
virtualNetworkProfile	No	Tipo Complexo	Especifica as definições relacionadas com a rede virtual se o cluster estiver a ser implementado numa rede virtual na subscrição do utilizador
scriptActions	No	Matriz de Tipo Complexo	Lista de ações de script a executar no cluster

linuxOperatingSystemProfile

Nome do elemento	Necessário	Tipo	Description
Nome de utilizador	Sim	String	Nome de utilizador SSH
sshProfile	No	Tipo Complexo	Especifica a chave SSH. É necessária uma de sshProfile ou Palavra-passe.
Palavra-passe	Não	String	Especifica a palavra-passe SSH É necessária uma de sshProfile ou Palavra-passe.

sshProfile

Nome do elemento	Necessário	Tipo	Description
publicKeys	Yes	Matriz	Contém uma lista de objetos certificateData. O valor é uma chave pública ssh-rsa

windowsOperatingSystemProfile

Nome do elemento	Necessário	Tipo	Description
rdpSettings	No	Tipo Complexo	Especifica as definições de RDP para clusters do Windows

rdpSettings

Nome do elemento	Necessário	Tipo	Description
nome de utilizador	Sim	String	Especifica o nome de utilizador RDP
palavra-passe	Sim	String	Especifica a palavra-passe para o utilizador RDP
expirayDate	Yes	Data	Data de expiração das credenciais de RDP

virtualNetworkProfile

Nome do elemento	Necessário	Tipo	Descrição
ID	Sim	String	ID de Recurso do Rede Virtual
sub-rede	Sim	String	Especifica o nome da sub-rede

scriptActions

Nome do elemento	Necessário	Tipo	Descrição
name	Sim	String	Nome amigável para a ação de script
uri	Sim	String	URL para o ficheiro de ação do script
parâmetros	Não	String	Argumentos a transmitir ao executar o ficheiro de ação de script

Resposta

Se a validação estiver concluída e o pedido for aceite, a operação devolverá 200 (OK).

Código de estado: 200 OK

O corpo de resposta de um cluster linux cria com a chave 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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Nome do elemento	Tipo	Description
provisioningState	String	Indica o estado de aprovisionamento atual.
clusterState	String	Indica o estado de cluster do HDInsight mais detalhado enquanto o aprovisionamento está em curso.
createdDate	Date	Datetime quando o pedido de criação do cluster foi recebido
quotaInfo	Tipo Complexo	Especifica os núcleosUtilados pelo cluster
erros	Matriz de mensagens de erro	Contém a mensagem de erro se provisioningState = "failed"
connectivityEndpoints	Tipo Complexo	Especifica os pontos finais públicos para o cluster

connectivityEndpoints

Nome do elemento	Tipo	Descrição
name	String	Nome amigável para o ponto final de conectividade
protocolo	String	Especifica o Protocolo a utilizar (exemplo: HTTPS, SSH)
localização	String	Especifica o URL a ligar
porta	int	Especifica a porta a ligar

Criar um cluster do HDInsight premium associado a um domínio (apenas linux, pré-visualização)

Crie um cluster premium associado a um domínio com o Apache Ranger. O utilizador tem de fornecer SecurityProfile no corpo do pedido para criar um cluster seguro.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

O exemplo seguinte mostra o corpo do pedido para criar um cluster hadoop baseado em Linux, premium e associado a um domínio.

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

Nome do elemento	Necessário	Tipo	Descrição
ID	Sim	String	Especifica o identificador de recursos do cluster.
name	Sim	String	Especifica o nome do cluster.
tipo	Sim	String	Especifica o tipo de cluster.
localização	Sim	String	Especifica a localização suportada do Azure onde o cluster deve ser criado. Para obter mais informações, veja Listar todas as localizações geográficas disponíveis.
etiquetas	No	String	Especifica as etiquetas que serão atribuídas ao cluster. Para obter mais informações sobre como utilizar etiquetas, veja Utilizar etiquetas para organizar os recursos do Azure.
Propriedades	Yes	Tipo Complexo	Especifica as propriedades do cluster.

Propriedades

Nome do elemento	Necessário	Tipo	Description
clusterVersion	Sim	String	Especifica a versão do cluster
osType	Sim	String	Especifica o sistema operativo do cluster. O valor válido é o Linux porque apenas os tipos de cluster do Linux podem associar um domínio Azure AD.
tier	Não	String	O valor predefinido é standard. Os valores válidos são standard e premium. Se não for especificado nenhum valor, assume-se que o valor é padrão. Especifica a Camada para o cluster. Os clusters associados a um domínio só são suportados no escalão premium
clusterDefinition	Yes	Tipo Complexo	Especifica informações sobre o tipo de cluster e as configurações
computeProfile	Yes	Tipo Complexo	Especifica informações sobre a topologia do cluster e as propriedades de função associadas
securityProfile	No	Tipo Complexo	Se estiver a ser criado um cluster seguro associado a um domínio, este elemento especifica as definições relacionadas com o Active Directory

clusterDefinition

Nome do elemento	Necessário	Tipo	Description
tipo	Sim	String	Especifica o tipo de cluster. Os valores válidos são hadoop, hbase, storm & spark
configurações	Yes	Dicionário	Este elemento é um dicionário do tipo de configuração e do respetivo dicionário de valor associado. O tipo de configuração do gateway é utilizado para configurar o utilizador http utilizado para ligar a APIs Web e ao portal do Ambari o tipo de configuração do site principal é utilizado para configurar a conta de armazenamento predefinida para o cluster

computeProfile

Nome do elemento	Necessário	Tipo	Description
clusterVersion	Sim	String	Especifica a versão do cluster
função	Yes	Matriz de Tipo Complexo (função)	Especifica informações sobre funções no cluster

securityProfile

Nome do elemento	Necessário	Tipo	Description
directoryType	Sim	String	Tipo de diretório LDAP utilizado. Atualmente, "ActiveDirectory" é o único valor suportado.
domínio	Sim	String	Domínio do Active Directory para o cluster
organizationalUnitDN	Sim	String	Nome único da unidade organizacional no Active Directory onde serão criadas contas de utilizador e computador
ldapsUrls	Yes	Matriz da Cadeia	URLs de um ou vários servidores LDAPS para o Active Directory
domainUserName	Sim	String	Uma conta de utilizador de domínio com permissões suficientes para criar o cluster. Deve estar no formato user@domain
domainUserPassword	Sim	String	Palavra-passe para a conta de utilizador do domínio
clusterUsersGroupDNS	No	Matriz da Cadeia	Nomes distintos dos grupos do Active Directory que estarão disponíveis no Ambari e no Apache Ranger

role

Nome do elemento	Necessário	Tipo	Descrição
name	Sim	String	Especifica o nome da função
targetInstanceCount	Yes	Número inteiro	Especifica a contagem de instâncias de destino para a função
hardwareProfile	Yes	Tipo Complexo	Especifica informações sobre o perfil de hardware da função
osProfile	Yes	Tipo Complexo	Especifica informações sobre o perfil do so para a função

hardwareProfile

Nome do elemento	Necessário	Tipo	Description
vmSize	Sim	String	Especifica o tamanho da VM. Veja opções de configuração do HDInsight (uma vez nesta ligação, desloque-se para baixo até escalões de preço do Nó) para obter tamanhos válidos

osProfile

Nome do elemento	Necessário	Tipo	Description
linuxOperatingSystemProfile	No	Tipo Complexo	Especifica as definições relacionadas com o SO linux
virtualNetworkProfile	No	Tipo Complexo	Especifica as definições relacionadas com a rede virtual se o cluster estiver a ser implementado numa rede virtual na subscrição do utilizador
scriptActions	No	Matriz de Tipo Complexo	Lista de ações de script a executar no cluster

linuxOperatingSystemProfile

Nome do elemento	Necessário	Tipo	Description
Nome de utilizador	Sim	String	Nome de utilizador SSH
sshProfile	No	Tipo Complexo	Especifica a chave SSH. É necessário um dos sshProfile ou Palavra-passe.
Palavra-passe	Não	String	Especifica a palavra-passe SSH É necessário um dos sshProfile ou Palavra-passe.

sshProfile

Nome do elemento	Necessário	Tipo	Description
publicKeys	Yes	Matriz	Contém uma lista de objetos certificateData. O valor é uma chave pública ssh-rsa

virtualNetworkProfile

Nome do elemento	Necessário	Tipo	Descrição
ID	Sim	String	ID de Recurso do Rede Virtual
sub-rede	Sim	String	Especifica o nome da sub-rede

scriptActions

Nome do elemento	Necessário	Tipo	Descrição
name	Sim	String	Nome amigável para a ação de script
URI	Sim	String	URL para o ficheiro de ação do script
parâmetros	Não	String	Argumentos a transmitir ao executar o ficheiro de ação de script

Resposta

Se a validação estiver concluída e o pedido for aceite, a operação devolverá 200 (OK).

Código de estado: 200 OK

O corpo da resposta de um cluster do Linux é criado com a chave 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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Nome do elemento	Tipo	Description
provisioningState	String	Indica o estado de aprovisionamento atual.
clusterState	String	Indica o estado do cluster do HDInsight mais detalhado enquanto o aprovisionamento está em curso.
createdDate	Date	Datetime quando o pedido de criação do cluster foi recebido
quotaInfo	Tipo Complexo	Especifica os núcleosUtilizados pelo cluster
erros	Matriz de mensagens de erro	Contém a mensagem de erro se provisioningState = "failed"
connectivityEndpoints	Tipo Complexo	Especifica os pontos finais públicos para o cluster

connectivityEndpoints

Nome do elemento	Tipo	Descrição
name	String	Nome amigável para o ponto final de conectividade
protocolo	String	Especifica o Protocolo a utilizar (exemplo: HTTPS, SSH)
localização	String	Especifica o URL a ligar
porta	int	Especifica a porta a ligar

Criar um cluster com o Azure Data Lake Store como sistema de ficheiros predefinido

Cria um cluster na subscrição especificada com o Azure Data Lake Store como o sistema de ficheiros predefinido. Forneça um objeto ClusterIdentity no corpo do pedido e configure a propriedade default-filesystem com o URL do Data Lake Store adequado.

O Azure Data Lake pode ser configurado como o sistema de ficheiros predefinido para versões de cluster a partir da 3.5 inclusive.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método	URI do pedido
PUT	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}}

O exemplo seguinte mostra o corpo do pedido para criar um cluster do Hadoop baseado em Linux com o Azure Data Lake Store como o sistema de ficheiros predefinido para o cluster.

{
	"id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup1/providers/Microsoft.HDInsight/clusters/mycluster",
	"name": "mycluster",
	"type": "Microsoft.HDInsight/clusters",
	"location": "location-name",
	"tags": {
		"tag1": "value1",
		"tag2": "value2"
	},
	"properties": {
		"clusterVersion": "3.5",
		"osType": "Linux",
		"tier": "Standard",
		"clusterDefinition": {
			"kind": "hadoop",
			"configurations": {
				"gateway": {
					"restAuthCredential.isEnabled": true,
					"restAuthCredential.username": "http-user",
					"restAuthCredential.password": "password"
				},
				"clusterIdentity": {
					"clusterIdentity.applicationId": "applicationId",
					"clusterIdentity.certificate": "certificate-contents-in-base64-encoding",
					"clusterIdentity.aadTenantId": "aad-tenant-id",
					"clusterIdentity.resourceUri": "https://KonaCompute.net/",
					"clusterIdentity.certificatePassword": "certificate-password"
				},
				"core-site": {
					"fs.defaultFS": "adl://home",
					"dfs.adls.home.hostname": "yourstorageaccount.azuredatalakestore.net",
					"dfs.adls.home.mountpoint": "/path/to/cluster/root"
				}
			}
		},
		"computeProfile": {
			"roles": [
				{
					"name": "headnode",
					"targetInstanceCount": 2,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "workernode",
					"targetInstanceCount": 1,
					"hardwareProfile": {
						"vmSize": "Large"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": " ssh-rsa key"
									}
								]
							}
						}
					}
				},
				{
					"name": "zookeepernode",
					"targetInstanceCount": 3,
					"hardwareProfile": {
						"vmSize": "Small"
					},
					"osProfile": {
						"linuxOperatingSystemProfile": {
							"username": "username",
							"sshProfile": {
								"publicKeys": [
									{
										"certificateData": "ssh-rsa key"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}  

Nome do elemento	Necessário	Tipo	Descrição
ID	Sim	String	Especifica o identificador de recurso do cluster.
name	Sim	String	Especifica o nome do cluster.
tipo	Sim	String	Especifica o tipo do cluster.
localização	Sim	String	Especifica a localização suportada do Azure onde o cluster deve ser criado. Para obter mais informações, veja Listar todas as localizações geográficas disponíveis.
etiquetas	No	String	Especifica as etiquetas que serão atribuídas ao cluster. Para obter mais informações sobre como utilizar etiquetas, veja Utilizar etiquetas para organizar os recursos do Azure.
Propriedades	Yes	Tipo Complexo	Especifica as propriedades do cluster.

Propriedades

Nome do elemento	Necessário	Tipo	Description
clusterVersion	Sim	String	Especifica a versão do cluster
osType	Sim	String	Especifica o sistema operativo para o cluster. O valor válido é Linux
tier	Não	String	Especifica a camada para o cluster. Os valores válidos são standard e premium. Se a camada não for especificada, o cluster será do escalão padrão.
clusterDefinition	Yes	Tipo Complexo	Especifica informações sobre o tipo de cluster e as configurações
computeProfile	Yes	Tipo Complexo	Especifica informações sobre a topologia do cluster e as propriedades de função associadas

clusterDefinition

Nome do elemento	Necessário	Tipo	Description
tipo	Sim	String	Especifica o tipo de cluster. Os valores válidos são hadoop, hbase, storm & spark
configurações	Yes	Dicionário	Este elemento é um dicionário do tipo de configuração e do respetivo dicionário de valor associado. o tipo de configuração do gateway é utilizado para configurar o utilizador http utilizado para ligar às APIs Web e ao portal do Ambari o tipo de configuração do site principal é utilizado para configurar a conta de armazenamento predefinida para o cluster

computeProfile

Nome do elemento	Necessário	Tipo	Description
clusterVersion	Sim	String	Especifica a versão do cluster
função	Yes	Matriz de Tipo Complexo (função)	Especifica informações sobre funções no cluster

role

Nome do elemento	Necessário	Tipo	Descrição
name	Sim	String	Especifica o nome da função
targetInstanceCount	Yes	Número inteiro	Especifica a contagem de instâncias de destino para a função
hardwareProfile	Yes	Tipo Complexo	Especifica informações sobre o perfil de hardware da função
osProfile	Yes	Tipo Complexo	Especifica informações sobre o perfil do so para a função

hardwareProfile

Nome do elemento	Necessário	Tipo	Description
vmSize	Sim	String	Especifica o tamanho da VM. Veja opções de configuração do HDInsight (uma vez nesta ligação, desloque-se para baixo até escalões de preço do Nó) para obter tamanhos válidos

osProfile

Nome do elemento	Necessário	Tipo	Description
linuxOperatingSystemProfile	No	Tipo Complexo	Especifica as definições relacionadas com o SO linux
virtualNetworkProfile	No	Tipo Complexo	Especifica as definições relacionadas com a rede virtual se o cluster estiver a ser implementado numa rede virtual na subscrição do utilizador
scriptActions	No	Matriz de Tipo Complexo	Lista de ações de script a executar no cluster

linuxOperatingSystemProfile

Nome do elemento	Necessário	Tipo	Description
Nome de utilizador	Sim	String	Nome de utilizador SSH
sshProfile	No	Tipo Complexo	Especifica a chave SSH. É necessário um dos sshProfile ou Palavra-passe.
Palavra-passe	Não	String	Especifica a palavra-passe SSH É necessário um dos sshProfile ou Palavra-passe.

sshProfile

Nome do elemento	Necessário	Tipo	Description
publicKeys	Yes	Matriz	Contém uma lista de objetos certificateData. O valor é uma chave pública ssh-rsa

virtualNetworkProfile

Nome do elemento	Necessário	Tipo	Descrição
ID	Sim	String	ID de Recurso do Rede Virtual
sub-rede	Sim	String	Especifica o nome da sub-rede

scriptActions

Nome do elemento	Necessário	Tipo	Descrição
name	Sim	String	Nome amigável para a ação de script
uri	Sim	String	URL para o ficheiro de ação do script
parâmetros	Não	String	Argumentos a transmitir ao executar o ficheiro de ação de script

Resposta

Se a validação estiver concluída e o pedido for aceite, a operação devolverá 200 (OK).

Código de estado: 200 OK

O corpo de resposta de um cluster linux cria com a chave 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"
	}
}  

Nome do elemento	Tipo	Description
provisioningState	String	Indica o estado de aprovisionamento atual.
clusterState	String	Indica o estado de cluster do HDInsight mais detalhado enquanto o aprovisionamento está em curso.
createdDate	Date	Datetime quando o pedido de criação do cluster foi recebido
quotaInfo	Tipo Complexo	Especifica os núcleosUtilados pelo cluster
erros	Matriz de mensagens de erro	Contém a mensagem de erro se provisioningState = "failed"
connectivityEndpoints	Tipo Complexo	Especifica os pontos finais públicos para o cluster

connectivityEndpoints

Nome do elemento	Tipo	Descrição
name	String	Nome amigável para o ponto final de conectividade
protocolo	String	Especifica o Protocolo a utilizar (exemplo: HTTPS, SSH)
localização	String	Especifica o URL a ligar
porta	int	Especifica a porta a ligar

Eliminar

Elimina um cluster do HDInsight.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
DELETE	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Resposta

HTTP 202 (Aceite) para indicar que a operação será concluída de forma assíncrona. A consulta assíncrona devolverá um 204 (NoContent) assim que a operação for concluída com êxito.

Observações

Para controlar o progresso de um pedido de cluster de eliminação, veja Operações Assíncronas (cabeçalho 202 Aceite e Localização)

Get

Obtém os detalhes/propriedades do cluster especificado.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Resposta

A operação devolverá 200 (OK) se o pedido for concluído com êxito

Código de estado: 200 OK

O corpo da resposta é o mesmo que criar cluster.

Corpo da resposta para detalhes do cluster do 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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}  
  

Nome do elemento	Tipo	Description
provisioningState	String	Indica o estado de aprovisionamento atual.
clusterState	String	Indica o estado de cluster do HDInsight mais detalhado enquanto o aprovisionamento está em curso.
createdDate	Date	Datetime quando o pedido de criação do cluster foi recebido
quotaInfo	Tipo Complexo	Especifica os núcleosUtilados pelo cluster
erros	Matriz de mensagens de erro	Contém a mensagem de erro se provisioningState = "failed"
connectivityEndpoints	Tipo Complexo	Especifica os pontos finais públicos para o cluster

connectivityEndpoints

Nome do elemento	Tipo	Descrição
name	String	Nome amigável para o ponto final de conectividade
protocolo	String	Especifica o Protocolo a utilizar (exemplo: HTTPS, SSH)
localização	String	Especifica o URL a ligar
porta	int	Especifica a porta a ligar

Listar configurações

Obtém todos os detalhes de configuração do cluster (incluindo informações confidenciais).

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations?api-version={api-version}

Resposta

HTTP 200 (OK) após a conclusão da operação com êxito.

Resposta de exemplo:

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

Nome do elemento	Tipo	Description
configurações	Dicionário	Este elemento é um dicionário do tipo de configuração e do respetivo dicionário de valor associado. o tipo de configuração do gateway é utilizado para configurar o utilizador http utilizado para ligar às APIs Web e ao portal do Ambari o tipo de configuração do site principal é utilizado para configurar a conta de armazenamento predefinida para o cluster

Obter configuração

Obtém detalhes sobre um único tipo de configuração (omite valores confidenciais).

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Resposta

HTTP 200 (OK) após a conclusão da operação com êxito.

Resposta de exemplo:

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

Obter definições de gateway

Esta operação obtém credenciais HTTP do gateway de cluster.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/getGatewaySettings?api-version={api-version}

Resposta

HTTP 200 (OK) após a conclusão da operação com êxito.

Resposta de exemplo:

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

Atualizar as definições do gateway

Esta operação permite que os utilizadores alterem as credenciais HTTP do gateway de cluster.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método	URI do pedido
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!"  
}  

Resposta

HTTP 202 (Aceite) após a conclusão da operação com êxito.

Alterar as definições de conectividade (PRETERIDO)

Esta operação permite que os utilizadores ativem/desativem a conectividade HTTPS ao cluster.

Em alternativa, utilize updateGatewaySettings .

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método	URI do pedido
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/configurations/{configuration Type}?api-version={api-version}

Para ativar a conectividade

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

Listar por grupo de recursos

Listas todos os clusters na subscrição do utilizador no grupo de recursos especificado.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método	URI do pedido
GET	https://management.azure.com/subscriptions/{subscription Id}/resourcegroups/{resourceGroup Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Resposta

A operação devolverá 200 (OK) se o pedido for concluído com êxito.

Código de estado: 200 OK

O corpo da resposta é uma matriz de detalhes do cluster. Para obter mais informações, veja Obter propriedades do cluster.

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

Listar por subscrição

Listas todos os clusters na subscrição do utilizador.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método	URI do pedido
GET	https://management.azure.com/subscriptions/{subscription Id}/providers/Microsoft.HDInsight/clusters?api-version={api-version}

Resposta

A operação devolverá 200 (OK) se o pedido for concluído com êxito.

Código de estado: 200 OK

O corpo da resposta é uma matriz de detalhes do cluster.

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

Para desativar a conectividade

{  
   "restAuthCredential.isEnabled": false  
}  
  

Nome do elemento	Necessário	Tipo	Description
restAuthCredential.isEnabled	Yes	Booleano	Especifica se a conectividade deve estar ativada ou desativada
restAuthCredential.username	Não	String	Necessário se isEnabled=true Especifica o nome de utilizador para as definições de conectividade
restAuthCredential.password	Não	String	Necessário se isEnabled=true Especifica a palavra-passe das definições de conectividade

Resposta

HTTP 202 (Aceite) para indicar que a operação será concluída de forma assíncrona. A consulta assíncrona devolverá um 204 (NoContent) assim que a operação for concluída com êxito.

Observações

Para controlar o progresso de um pedido de eliminação do cluster, veja Operações Assíncronas (cabeçalho 202 Aceite e Localização)

Alterar as definições de RDP (apenas cluster do Windows)

Esta operação permite que um utilizador ative/desative o RDP. Aplica-se a clusters baseados no Windows.

Pedir

Veja Common parameters and headers for headers and parameters that are used by clusters ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros utilizados por clusters).

Método	URI do pedido
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

Corpo do Pedido

Para ativar o RDP

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

Para desativar o RDP

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

osProfile

Nome do elemento	Necessário	Tipo	Description
windowsOperatingSystemProfile	No	Tipo Complexo	Especifica as definições relacionadas com o SO windows

windowsOperatingSystemProfile

Nome do elemento	Necessário	Tipo	Description
rdpSettings	No	Tipo Complexo	Especifica as definições de RDP para clusters do Windows

rdpSettings

Nome do elemento	Necessário	Tipo	Description
nome de utilizador	Sim	String	Especifica o nome de utilizador RDP
palavra-passe	Sim	String	Especifica a palavra-passe para o utilizador RDP
expiryDate	Yes	Data	Data de expiração das credenciais de RDP

Resposta

A operação devolverá 200 (OK) se o pedido for concluído com êxito

Código de estado: 200 OK

O corpo da resposta é o mesmo que Criar um cluster.

Executar Ações de Script num cluster em execução (apenas cluster do Linux)

Execute a ação Script num cluster em execução.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
POST	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

Corpo do Pedido

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

scriptActions

Nome do elemento	Necessário	Tipo	Descrição
name	Sim	String	Especifica o nome da ação de script
uri	Sim	String	Especifica o URI da ação de script
parâmetros	Sim	String	Especifica os parâmetros necessários para a ação de script
funções	Yes	Matriz da Cadeia	Especifica as funções de destino em que a ação de script é executada
persistOnSuccess	Yes	Booleano	Especifica se as ações do script serão mantidas após execuções bem-sucedidas

Resposta

Se a validação estiver concluída e o pedido for aceite, a operação devolverá 202 (Aceite).

Código de estado: 202 (Aceite)

Listar todas as Ações de Script persistentes para um cluster (apenas cluster do Linux)

Esta operação devolve todas as ações de scripts persistentes do cluster especificado.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
GET	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions?api-version={api-version}

Resposta

HTTP 200 (OK) após a conclusão da operação com êxito.

Código de estado: 200 OK

Resposta de exemplo:

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

Nome do elemento	Tipo	Descrição
name	String	Especifica o nome da ação de script.
uri	String	Especifica o URI da ação de script.
parâmetros	String	Especifica os parâmetros necessários para a ação de script
funções	Matriz da Cadeia	Especifica as funções de destino em que a ação de script é executada.
applicationName	String	Especifica a aplicação correspondente à qual o script está associado. applicationName é nulo se o script for fornecido pelos utilizadores

Remover uma Ação de Script persistente para um cluster (apenas cluster do Linux)

Esta operação remove uma ação de script persistente do HDInsight para um cluster.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
DELETE	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/scriptActions/{script Name}?api-version={api-version}

Resposta

• HTTP 200 (OK) para indicar que a ação do script foi removida da lista de ações de script persistentes.

• HTTP 404 (NotFound) para indicar que não existe nenhuma ação de script persistente existente com scriptName correspondente.

Obter a execução da Ação de Script a partir do histórico (apenas clusters do Linux)

Esta operação devolve a execução da ação de scripts mais recente do cluster ou detalhes de execução especificados para uma execução de script individual.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
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}

Resposta

A operação devolverá 200 (OK) se o pedido for concluído com êxito. O corpo da resposta é uma matriz de detalhes de execução do script ou um único detalhe de execução de script se scriptExecutionId for fornecido. Segue-se um exemplo de um detalhe de execução do script.

Código de estado: 200 (OK)

Resposta de exemplo:

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

Nome do elemento	Tipo	Description
scriptExecutionId	Longo	Especifica o ID de execução da ação de script.
name	String	Especifica o nome da ação de script.
applicationName	String	Especifica a aplicação correspondente à qual o script está associado. applicationName é nulo se o script for fornecido pelos utilizadores
uri	String	Especifica o URI da ação de script.
parâmetros	String	Especifica os parâmetros necessários para a ação de script
funções	Matriz da Cadeia	Especifica as funções de destino em que a ação de script é executada.
startTime	DateTime	Especifica a hora de início da execução da ação do script
endTime	DateTime	Especifica a hora de fim da execução da ação do script
status	String	Especifica o estado da execução da ação do script
operation	String	Especifica o motivo pelo qual a ação do script foi executada. Por exemplo, ScaleUp significa que a ação de script foi executada durante o aumento vertical do cluster.
executionSummary	Matriz de tipo complexo	Especifica o resumo da execução em termos de quantos anfitriões foram bem-sucedidos e quantos anfitriões não executaram o script.
debugInformation	String	Especifica informações de depuração detalhadas para o script. debugInformation é devolvido apenas quando um scriptExecutionId é fornecido no pedido.

executionSummary

Nome do elemento	Tipo	Description
status	String	Especifica o estado da execução em anfitriões individuais.
instanceCount	int	Especifica o número de execuções com o estado correspondente.

Promover um script a partir do histórico de execução da Ação de Script a manter (apenas cluster do Linux)

Esta operação promove a persistência de um script do HDInsight a partir do histórico de execução de scripts.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
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}

Resposta

• HTTP 200 (OK) para indicar que a ação do script foi promovida.

• HTTP 404 (NotFound) para indicar que não existe nenhuma execução de ação de script existente com scriptExecutionId correspondente.

Redimensionar

Redimensiona um cluster do HDInsight existente.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
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}

Segue-se um pedido de exemplo para atualizar etiquetas para um cluster

{  
    "targetInstanceCount": 10  
}  

Nome do elemento	Necessário	Tipo	Description
targetInstanceCount	Yes	int	Especifica a nova contagem de instâncias para a função

Resposta

HTTP 202 (Aceite) para indicar que a operação será concluída de forma assíncrona. A consulta assíncrona devolverá um 204 (NoContent) assim que a operação for concluída com êxito.

Observações

Para controlar o progresso de um pedido de cluster de eliminação, veja Operações Assíncronas (cabeçalho 202 Aceite e Localização)

Atualizar

Atualizações etiquetas para um cluster.

Todas as outras atualizações são ações separadas descritas separadamente.

Pedir

Veja Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados pelos clusters.

Método	URI do pedido
PATCH	https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

Segue-se um pedido de exemplo para atualizar etiquetas para um cluster

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

Nome do elemento	Necessário	Tipo	Description
etiquetas	Sim	String	Especifica as etiquetas que serão atribuídas ao cluster. Para obter mais informações sobre como utilizar etiquetas, veja Utilizar etiquetas para organizar os recursos do Azure.

Resposta

A operação devolverá 200 (OK) se o pedido for concluído com êxito.

Código de estado: 200 OK

O corpo da resposta é o mesmo que Criar um cluster.