Partilhar via


API REST de cluster no Azure HDInsight

Create

Cria um cluster na assinatura especificada.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

O exemplo a seguir mostra o corpo da solicitação para criar um cluster hadoop baseado em Linux. Para obter exemplos de criação de clusters de outras maneiras, consulte a seçã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 Obrigatório Tipo Descrição
id Yes Corda Especifica o identificador de recurso do cluster.
nome Yes Corda Especifica o nome do cluster.
tipo Yes Corda Especifica o tipo do cluster.
localização Yes Corda Especifica o local do Azure com suporte onde o cluster deve ser criado. Para obter mais informações, consulte Listar todas as localizações geográficas disponíveis.
etiquetas Não Corda Especifica as tags que serão atribuídas ao cluster. Para obter mais informações sobre como usar tags, consulte Usando tags para organizar seus recursos do Azure.
Propriedades Yes Tipo Complexo Especifica as propriedades do cluster.

Propriedades

Nome do elemento Obrigatório Tipo Descrição
versão do cluster Yes Corda Especifica a versão do cluster
tipo de sistema operativo Yes Corda Especifica o sistema operacional do cluster.

Os valores válidos são Linux e Windows
clusterDefinição 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 de cluster e as propriedades de função associadas

clusterDefinição

Nome do elemento Obrigatório Tipo Descrição
tipo Yes Corda 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 de tipo de configuração e seu dicionário de valores associado.

o tipo de configuração de gateway é usado para configurar o usuário http usado para se conectar às APIs da Web e ao portal Ambari

O tipo de configuração de site principal é usado para configurar a conta de armazenamento padrão para o cluster

computeProfile

Nome do elemento Obrigatório Tipo Descrição
versão do cluster Yes Corda Especifica a versão do cluster
Função Yes Matriz de tipo complexo (função) Especifica informações sobre funções no cluster

função

Nome do elemento Obrigatório Tipo Descrição
nome Yes Corda 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
osPerfil Yes Tipo Complexo Especifica informações sobre o perfil do sistema operacional para a função

hardwareProfile

Nome do elemento Obrigatório Tipo Descrição
vmTamanho Yes Corda Especifica o tamanho da VM. Consulte as opções de configuração do HDInsight (uma vez neste link, role para baixo até Níveis de preços do Nó) para obter os tamanhos válidos

osProfile

Nome do elemento Obrigatório Tipo Descrição
linuxOperatingSystemProfile Não Tipo Complexo Especifica as configurações relacionadas ao sistema operacional linux
windowsOperatingSystemProfile Não Tipo Complexo Especifica as configurações relacionadas ao sistema operacional Windows
virtualNetworkProfile Não Tipo Complexo Especifica configurações relacionadas à rede virtual se o cluster estiver sendo implantado em uma rede virtual na assinatura do usuário
scriptActions Não Matriz de tipo complexo Lista de ações de script a serem executadas no cluster

linuxOperatingSystemProfile

Nome do elemento Obrigatório Tipo Descrição
Nome de utilizador Yes Corda Nome de usuário SSH
sshProfile Não Tipo Complexo Especifica a chave SSH.

É necessário um dos sshProfile ou Password.
Palavra-passe Não Corda Especifica a senha SSH

É necessário um dos sshProfile ou Password.

sshProfile

Nome do elemento Obrigatório Tipo Descrição
publicKeys Yes Array Contém uma lista de objetos certificateData. O valor é uma chave pública ssh-rsa

windowsOperatingSystemProfile

Nome do elemento Obrigatório Tipo Descrição
rdpConfigurações Não Tipo Complexo Especifica as configurações de RDP para clusters do Windows

rdpConfigurações

Nome do elemento Obrigatório Tipo Descrição
nome de utilizador Yes Corda Especifica o nome de usuário RDP
palavra-passe Yes Corda Especifica a senha para o usuário RDP
expiryDate Yes Date Data de expiração das credenciais do PDR

virtualNetworkProfile

Nome do elemento Obrigatório Tipo Descrição
id Yes Corda ID do recurso de rede virtual
sub-rede Yes Corda Especifica o nome da sub-rede

scriptActions

Nome do elemento Obrigatório Tipo Descrição
nome Yes Corda Nome amigável para a ação de script
URI Yes Corda URL para o arquivo de ação de script
parâmetros Não Corda Argumentos a serem passados ao executar o arquivo de ação de script

Resposta

Se a validação for concluída e a solicitação for aceita, a operação retornará 200 (OK).

Código de status: 200 OK

Corpo de resposta para um cluster linux cria usando 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 Descrição
estado de provisionamento Corda Indica o estado de provisionamento atual.
Estado-Cluster Corda Indica o estado mais detalhado do cluster HDInsight enquanto o provisionamento está em andamento.
createdDate (Data de criação) Date Data/hora em que a solicitação de criação do cluster foi recebida
quotaInformação Tipo Complexo Especifica os coresUsed pelo cluster
erros Matriz de mensagens de erro Contém a mensagem de erro if provisioningState = 'failed"
conectividadePontos finais Tipo Complexo Especifica os pontos de extremidade públicos para o cluster

conectividadePontos finais

Nome do elemento Tipo Descrição
nome Corda Nome amigável para o ponto de extremidade de conectividade
protocolo Corda Especifica o protocolo a ser usado (exemplo: HTTPS, SSH)
localização Corda Especifica a URL a ser conectada
porta Int Especifica a porta a ser conectada

Criar um cluster HDInsight premium associado a um domínio (somente Linux, visualização)

Crie um cluster premium associado a um domínio com o Apache Ranger. O usuário precisa fornecer SecurityProfile no corpo da solicitação para criar um cluster seguro.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

O exemplo a seguir mostra o corpo da solicitação para criar um cluster Hadoop baseado em Linux, premium e associado ao 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 Obrigatório Tipo Descrição
id Yes Corda Especifica o identificador de recurso do cluster.
nome Yes Corda Especifica o nome do cluster.
tipo Yes Corda Especifica o tipo do cluster.
localização Yes Corda Especifica o local do Azure com suporte onde o cluster deve ser criado. Para obter mais informações, consulte Listar todas as localizações geográficas disponíveis.
etiquetas Não Corda Especifica as tags que serão atribuídas ao cluster. Para obter mais informações sobre como usar tags, consulte Usando tags para organizar seus recursos do Azure.
Propriedades Yes Tipo Complexo Especifica as propriedades do cluster.

Propriedades

Nome do elemento Obrigatório Tipo Descrição
versão do cluster Yes Corda Especifica a versão do cluster
tipo de sistema operativo Yes Corda Especifica o sistema operacional do cluster.

O valor válido é Linux porque apenas os tipos de cluster Linux podem ingressar em um domínio do Azure AD.
escalão Não Corda O valor padrão é padrão. Os valores válidos são standard e premium. Se nenhum valor for especificado, o valor será considerado padrão. Especifica a Camada para o cluster. Clusters ingressados no domínio são suportados apenas na camada premium
clusterDefinição 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 de cluster e as propriedades de função associadas
perfil de segurança Não Tipo Complexo Se um cluster seguro associado ao domínio estiver sendo criado, esse elemento especifica as configurações relacionadas ao Ative Directory

clusterDefinição

Nome do elemento Obrigatório Tipo Descrição
tipo Yes Corda 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 de tipo de configuração e seu dicionário de valores associado.

o tipo de configuração de gateway é usado para configurar o usuário http usado para se conectar às APIs da Web e ao portal Ambari

O tipo de configuração de site principal é usado para configurar a conta de armazenamento padrão para o cluster

computeProfile

Nome do elemento Obrigatório Tipo Descrição
versão do cluster Yes Corda 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 Obrigatório Tipo Descrição
directoryType Yes Corda Tipo de diretório LDAP usado. Atualmente, "ActiveDirectory" é o único valor suportado.
domínio Yes Corda Domínio do Ative Directory para o cluster
organizacionalUnitDN Yes Corda Nome distinto da unidade organizacional no Ative Directory onde as contas de usuário e computador serão criadas
ldapsUrls Yes Matriz de String URLs de um ou vários servidores LDAPS para o Ative Directory
domainUserName Yes Corda Uma conta de usuário de domínio com permissões suficientes para criar o cluster. Deve ser em formato user@domain
domainUserPassword Yes Corda Senha para a conta de usuário do domínio
clusterUsersGroupDNS Não Matriz de String Nomes distintos dos grupos do Ative Directory que estarão disponíveis no Ambari e Apache Ranger

função

Nome do elemento Obrigatório Tipo Descrição
nome Yes Corda 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
osPerfil Yes Tipo Complexo Especifica informações sobre o perfil do sistema operacional para a função

hardwareProfile

Nome do elemento Obrigatório Tipo Descrição
vmTamanho Yes Corda Especifica o tamanho da VM. Consulte as opções de configuração do HDInsight (uma vez neste link, role para baixo até Níveis de preços do Nó) para obter os tamanhos válidos

osProfile

Nome do elemento Obrigatório Tipo Descrição
linuxOperatingSystemProfile Não Tipo Complexo Especifica as configurações relacionadas ao sistema operacional linux
virtualNetworkProfile Não Tipo Complexo Especifica configurações relacionadas à rede virtual se o cluster estiver sendo implantado em uma rede virtual na assinatura do usuário
scriptActions Não Matriz de tipo complexo Lista de ações de script a serem executadas no cluster

linuxOperatingSystemProfile

Nome do elemento Obrigatório Tipo Descrição
Nome de utilizador Yes Corda Nome de usuário SSH
sshProfile Não Tipo Complexo Especifica a chave SSH.

É necessário um dos sshProfile ou Password.
Palavra-passe Não Corda Especifica a senha SSH

É necessário um dos sshProfile ou Password.

sshProfile

Nome do elemento Obrigatório Tipo Descrição
publicKeys Yes Array Contém uma lista de objetos certificateData. O valor é uma chave pública ssh-rsa

virtualNetworkProfile

Nome do elemento Obrigatório Tipo Descrição
id Yes Corda ID do recurso de rede virtual
sub-rede Yes Corda Especifica o nome da sub-rede

scriptActions

Nome do elemento Obrigatório Tipo Descrição
nome Yes Corda Nome amigável para a ação de script
URI Yes Corda URL para o arquivo de ação de script
parâmetros Não Corda Argumentos a serem passados ao executar o arquivo de ação de script

Resposta

Se a validação for concluída e a solicitação for aceita, a operação retornará 200 (OK).

Código de status: 200 OK

Corpo de resposta para um cluster linux cria usando 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 Descrição
estado de provisionamento Corda Indica o estado de provisionamento atual.
Estado-Cluster Corda Indica o estado mais detalhado do cluster HDInsight enquanto o provisionamento está em andamento.
createdDate (Data de criação) Date Data/hora em que a solicitação de criação do cluster foi recebida
quotaInformação Tipo Complexo Especifica os coresUsed pelo cluster
erros Matriz de mensagens de erro Contém a mensagem de erro if provisioningState = 'failed"
conectividadePontos finais Tipo Complexo Especifica os pontos de extremidade públicos para o cluster

conectividadePontos finais

Nome do elemento Tipo Descrição
nome Corda Nome amigável para o ponto de extremidade de conectividade
protocolo Corda Especifica o protocolo a ser usado (exemplo: HTTPS, SSH)
localização Corda Especifica a URL a ser conectada
porta Int Especifica a porta a ser conectada

Criar um cluster com o Repositório Azure Data Lake como o sistema de arquivos padrão

Cria um cluster na assinatura especificada com o Repositório Azure Data Lake como o sistema de arquivos padrão. Forneça um objeto ClusterIdentity no corpo da solicitação e configure a propriedade default-filesystem com a URL apropriada do Repositório Data Lake.

O Azure Data Lake pode ser configurado como o sistema de arquivos padrão para versões de cluster a partir da versão 3.5, inclusive.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

O exemplo a seguir mostra o corpo da solicitação para criar um cluster Hadoop baseado em Linux usando o Repositório Azure Data Lake como o sistema de arquivos padrão 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 Obrigatório Tipo Descrição
id Yes Corda Especifica o identificador de recurso do cluster.
nome Yes Corda Especifica o nome do cluster.
tipo Yes Corda Especifica o tipo do cluster.
localização Yes Corda Especifica o local do Azure com suporte onde o cluster deve ser criado. Para obter mais informações, consulte Listar todas as localizações geográficas disponíveis.
etiquetas Não Corda Especifica as tags que serão atribuídas ao cluster. Para obter mais informações sobre como usar tags, consulte Usando tags para organizar seus recursos do Azure.
Propriedades Yes Tipo Complexo Especifica as propriedades do cluster.

Propriedades

Nome do elemento Obrigatório Tipo Descrição
versão do cluster Yes Corda Especifica a versão do cluster
tipo de sistema operativo Yes Corda Especifica o sistema operacional do cluster.

O valor válido é Linux
escalão Não Corda 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á de camada padrão.
clusterDefinição 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 de cluster e as propriedades de função associadas

clusterDefinição

Nome do elemento Obrigatório Tipo Descrição
tipo Yes Corda 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 de tipo de configuração e seu dicionário de valores associado.

o tipo de configuração de gateway é usado para configurar o usuário http usado para se conectar às APIs da Web e ao portal Ambari

O tipo de configuração de site principal é usado para configurar a conta de armazenamento padrão para o cluster

computeProfile

Nome do elemento Obrigatório Tipo Descrição
versão do cluster Yes Corda Especifica a versão do cluster
Função Yes Matriz de tipo complexo (função) Especifica informações sobre funções no cluster

função

Nome do elemento Obrigatório Tipo Descrição
nome Yes Corda 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
osPerfil Yes Tipo Complexo Especifica informações sobre o perfil do sistema operacional para a função

hardwareProfile

Nome do elemento Obrigatório Tipo Descrição
vmTamanho Yes Corda Especifica o tamanho da VM. Consulte as opções de configuração do HDInsight (uma vez neste link, role para baixo até Níveis de preços do Nó) para obter os tamanhos válidos

osProfile

Nome do elemento Obrigatório Tipo Descrição
linuxOperatingSystemProfile Não Tipo Complexo Especifica as configurações relacionadas ao sistema operacional linux
virtualNetworkProfile Não Tipo Complexo Especifica configurações relacionadas à rede virtual se o cluster estiver sendo implantado em uma rede virtual na assinatura do usuário
scriptActions Não Matriz de tipo complexo Lista de ações de script a serem executadas no cluster

linuxOperatingSystemProfile

Nome do elemento Obrigatório Tipo Descrição
Nome de utilizador Yes Corda Nome de usuário SSH
sshProfile Não Tipo Complexo Especifica a chave SSH.

É necessário um dos sshProfile ou Password.
Palavra-passe Não Corda Especifica a senha SSH

É necessário um dos sshProfile ou Password.

sshProfile

Nome do elemento Obrigatório Tipo Descrição
publicKeys Yes Array Contém uma lista de objetos certificateData. O valor é uma chave pública ssh-rsa

virtualNetworkProfile

Nome do elemento Obrigatório Tipo Descrição
id Yes Corda ID do recurso de rede virtual
sub-rede Yes Corda Especifica o nome da sub-rede

scriptActions

Nome do elemento Obrigatório Tipo Descrição
nome Yes Corda Nome amigável para a ação de script
URI Yes Corda URL para o arquivo de ação de script
parâmetros Não Corda Argumentos a serem passados ao executar o arquivo de ação de script

Resposta

Se a validação for concluída e a solicitação for aceita, a operação retornará 200 (OK).

Código de status: 200 OK

Corpo de resposta para um cluster linux cria usando 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 Descrição
estado de provisionamento Corda Indica o estado de provisionamento atual.
Estado-Cluster Corda Indica o estado mais detalhado do cluster HDInsight enquanto o provisionamento está em andamento.
createdDate (Data de criação) Date Data/hora em que a solicitação de criação do cluster foi recebida
quotaInformação Tipo Complexo Especifica os coresUsed pelo cluster
erros Matriz de mensagens de erro Contém a mensagem de erro if provisioningState = 'failed"
conectividadePontos finais Tipo Complexo Especifica os pontos de extremidade públicos para o cluster

conectividadePontos finais

Nome do elemento Tipo Descrição
nome Corda Nome amigável para o ponto de extremidade de conectividade
protocolo Corda Especifica o protocolo a ser usado (exemplo: HTTPS, SSH)
localização Corda Especifica a URL a ser conectada
porta Int Especifica a porta a ser conectada

Suprimir

Exclui um cluster HDInsight.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

Resposta

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

Observações

Para acompanhar o progresso de uma solicitação de cluster de exclusão, consulte Operações assíncronas (cabeçalho 202 aceito e local)

Obter

Obtém os detalhes/propriedades do cluster especificado.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

Resposta

A operação retornará 200 (OK) se a solicitação for concluída com êxito

Código de status: 200 OK

O corpo da resposta é o mesmo que criar cluster.

Corpo de resposta para detalhes do cluster 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 Descrição
estado de provisionamento Corda Indica o estado de provisionamento atual.
Estado-Cluster Corda Indica o estado mais detalhado do cluster HDInsight enquanto o provisionamento está em andamento.
createdDate (Data de criação) Date Data/hora em que a solicitação de criação do cluster foi recebida
quotaInformação Tipo Complexo Especifica os coresUsed pelo cluster
erros Matriz de mensagens de erro Contém a mensagem de erro if provisioningState = 'failed"
conectividadePontos finais Tipo Complexo Especifica os pontos de extremidade públicos para o cluster

conectividadePontos finais

Nome do elemento Tipo Descrição
nome Corda Nome amigável para o ponto de extremidade de conectividade
protocolo Corda Especifica o protocolo a ser usado (exemplo: HTTPS, SSH)
localização Corda Especifica a URL a ser conectada
porta Int Especifica a porta a ser conectada

Listar configurações

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Publicação 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 bem-sucedida da operação.

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 Descrição
configurações Dicionário Este elemento é um dicionário de tipo de configuração e seu dicionário de valores associado.
o tipo de configuração de gateway é usado para configurar o usuário http usado para se conectar às APIs da Web e ao portal Ambari
O tipo de configuração de site principal é usado para configurar a conta de armazenamento padrão para o cluster

Obter configuração

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Obtém 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 bem-sucedida da operação.

Resposta de exemplo:

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

Obter configurações de gateway

Esta operação recupera credenciais HTTP do gateway de cluster.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Publicação 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 bem-sucedida da operação.

Resposta de exemplo:

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

Atualizar configurações de gateway

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Publicação 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 (Aceito) após a conclusão bem-sucedida da operação.

Alterar configurações de conectividade (DEPRECATED)

Esta operação permite que os usuários habilitem/desabilitem a conectividade HTTPS para o cluster.

Use updateGatewaySettings em vez disso.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

Para habilitar a conectividade

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

Lista por grupo de recursos

Lista todos os clusters na assinatura do usuário no grupo de recursos especificado.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

Resposta

A operação retornará 200 (OK) se a solicitação for concluída com êxito.

Código de status: 200 OK

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

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

Lista por subscrição

Lista todos os clusters na assinatura do usuário.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

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

Resposta

A operação retornará 200 (OK) se a solicitação for concluída com êxito.

Código de status: 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 Obrigatório Tipo Descrição
restAuthCredential.isEnabled Yes booleano Especifica se a conectividade deve ser habilitada ou desabilitada
restAuthCredential.username Não Corda Obrigatório se isEnabled=true
Especifica o nome de usuário para as configurações de conectividade
restAuthCredential.password Não Corda Obrigatório se isEnabled=true
Especifica a senha para as configurações de conectividade

Resposta

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

Observações

Para acompanhar o progresso de uma solicitação de cluster de exclusão, consulte Operações assíncronas (cabeçalho 202 aceito e local)

Alterar configurações de RDP (somente cluster do Windows)

Esta operação permite que um usuário habilite/desabilite o RDP. Aplica-se a clusters baseados no Windows.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Publicação https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/changerdpsetting?api-version={api-version}

Órgão do Pedido

Para habilitar o PDR

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

Para desativar o RDP

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

osProfile

Nome do elemento Obrigatório Tipo Descrição
windowsOperatingSystemProfile Não Tipo Complexo Especifica as configurações relacionadas ao sistema operacional Windows

windowsOperatingSystemProfile

Nome do elemento Obrigatório Tipo Descrição
rdpConfigurações Não Tipo Complexo Especifica as configurações de RDP para clusters do Windows

rdpConfigurações

Nome do elemento Obrigatório Tipo Descrição
nome de utilizador Yes Corda Especifica o nome de usuário RDP
palavra-passe Yes Corda Especifica a senha para o usuário RDP
expiryDate Yes Date Data de expiração das credenciais do PDR

Resposta

A operação retornará 200 (OK) se a solicitação for concluída com êxito

Código de status: 200 OK

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

Executar ações de script em um cluster em execução (somente cluster Linux)

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Publicação https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}/executeScriptActions?api-version={api-version}

Órgão do Pedido

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

scriptActions

Nome do elemento Obrigatório Tipo Descrição
nome Yes Corda Especifica o nome da ação de script
URI Yes Corda Especifica o URI da ação de script
parâmetros Yes Corda Especifica os parâmetros exigidos pela ação de script
funções Yes Matriz de String Especifica as funções de destino nas quais a ação de script é executada
persistOnSuccess Yes booleano Especifica se as ações de script serão mantidas após execuções bem-sucedidas

Resposta

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

Código de status: 202 (Aceito)

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

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Obtém 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 bem-sucedida da operação.

Código de status: 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
nome Corda Especifica o nome da ação de script.
URI Corda Especifica o URI da ação de script.
parâmetros Corda Especifica os parâmetros exigidos pela ação de script
funções Matriz de String Especifica as funções de destino nas quais a ação de script é executada.
Nome da Aplicação Corda Especifica o aplicativo correspondente ao qual o script está associado. applicationName é null se o script for fornecido por usuários

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

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
SUPRIMIR 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 de 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 com scriptName correspondente.

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

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Obtém 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 retornará 200 (OK) se a solicitação for concluída com êxito. Corpo da resposta é uma matriz de detalhes de execução de script ou um único detalhe de execução de script se scriptExecutionId for fornecido. Abaixo está um exemplo de um detalhe de execução de script.

Código de status: 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 Descrição
scriptExecutionId Longo Especifica a id de execução da ação de script.
nome Corda Especifica o nome da ação de script.
Nome da Aplicação Corda Especifica o aplicativo correspondente ao qual o script está associado. applicationName é null se o script for fornecido por usuários
URI Corda Especifica o URI da ação de script.
parâmetros Corda Especifica os parâmetros exigidos pela ação de script
funções Matriz de String Especifica as funções de destino nas quais a ação de script é executada.
horaDeInício Data e Hora Especifica a hora de início da execução da ação de script
Hora de Término Data e Hora Especifica a hora de término da execução da ação de script
estado Corda Especifica o status da execução da ação de script
operação Corda Especifica o motivo pelo qual a ação de script foi executada. Por exemplo, ScaleUp significa que a ação de script foi executada durante o aumento de escala do cluster.
execuçãoResumo Matriz de tipo complexo Especifica o resumo da execução em termos de quantos hosts foram bem-sucedidos e quantos hosts não conseguiram executar o script.
debugInformation Corda Especifica informações detalhadas de depuração para o script. debugInformation é retornado somente quando um scriptExecutionId é fornecido na solicitação.

execuçãoResumo

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

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

Esta operação promove um script HDInsight do histórico de execução de scripts a ser persistido.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Publicação 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 de script foi promovida.

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

Redimensionar

Redimensiona um cluster HDInsight existente.

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
Publicação 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 seguir mostra um exemplo de solicitação para atualizar tags para um cluster

{  
    "targetInstanceCount": 10  
}  
Nome do elemento Obrigatório Tipo Descrição
targetInstanceCount Yes int Especifica a nova contagem de instâncias para a função

Resposta

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

Observações

Para acompanhar o progresso de uma solicitação de cluster de exclusão, consulte Operações assíncronas (cabeçalho 202 aceito e local)

Atualização

Atualiza tags para um cluster.

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

Request

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por clusters.

Método Solicitar URI
CORREÇÃO https://management.azure.com/subscriptions/{subscription Id}/resourceGroups/{resourceGroup Name}/providers/Microsoft.HDInsight/clusters/{cluster name}?api-version={api-version}

A seguir mostra um exemplo de solicitação para atualizar tags para um cluster

{   
    "tags": {"department": "finance"}  
}  
  
Nome do elemento Obrigatório Tipo Descrição
etiquetas Yes Corda Especifica as tags que serão atribuídas ao cluster. Para obter mais informações sobre como usar tags, consulte Usando tags para organizar seus recursos do Azure.

Resposta

A operação retornará 200 (OK) se a solicitação for concluída com êxito.

Código de status: 200 OK

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