Partilhar via

API REST do Cluster no Azure HDInsight

  • Artigo

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.