Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.