Compartir a través de

API REST de clúster en Azure HDInsight

  • Artículo

Crear

Crea un clúster en la suscripción especificada.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

En el ejemplo siguiente se muestra el cuerpo de la solicitud para crear un clúster de Hadoop basado en Linux. Para obtener ejemplos de cómo crear clústeres de otras maneras, consulte la sección Ejemplos a continuación.

{  
    "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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}
Nombre del elemento Obligatorio Tipo Descripción
id Sí String Especifica el identificador de recurso del clúster.
name Sí String Especifica el nombre del clúster.
type Sí String Especifica el tipo del clúster.
ubicación Sí String Especifica la ubicación de Azure admitida en la que se debe crear el clúster. Para obtener más información, vea Enumerar todas las ubicaciones geográficas disponibles.
etiquetas No String Especifica las etiquetas que se asignarán al clúster. Para más información sobre el uso de etiquetas, consulte Uso de etiquetas para organizar los recursos de Azure.
Propiedades Sí Tipo complejo Especifica las propiedades del clúster.

Propiedades

Nombre del elemento Obligatorio Tipo Descripción
clusterVersion Sí String Especifica la versión del clúster.
osType Sí String Especifica el sistema operativo para el clúster.

Los valores válidos son Linux y Windows
clusterDefinition Sí Tipo complejo Especifica información sobre el tipo de clúster y las configuraciones.
computeProfile Sí Tipo complejo Especifica información sobre la topología del clúster y las propiedades de rol asociadas.

clusterDefinition

Nombre del elemento Obligatorio Tipo Descripción
kind Sí String Especifica el tipo de clúster.

Los valores válidos son hadoop, hbase, storm & spark
configuraciones Sí Diccionario Este elemento es un diccionario de tipo de configuración y su diccionario de valores asociado.

El tipo de configuración de puerta de enlace se usa para configurar el usuario http que se usa para conectarse a las API web y el portal de Ambari.

El tipo de configuración de sitio principal se usa para configurar la cuenta de almacenamiento predeterminada para el clúster.

computeProfile

Nombre del elemento Obligatorio Tipo Descripción
clusterVersion Sí String Especifica la versión del clúster.
role Sí Matriz de tipo complejo (rol) Especifica información sobre los roles del clúster.

rol

Nombre del elemento Obligatorio Tipo Descripción
name Sí String Especifica el nombre del rol.
targetInstanceCount Sí Entero Especifica el recuento de instancias de destino para el rol.
hardwareProfile Sí Tipo complejo Especifica información sobre el perfil de hardware para el rol.
osProfile Sí Tipo complejo Especifica información sobre el perfil del sistema operativo para el rol.

hardwareProfile

Nombre del elemento Obligatorio Tipo Descripción
vmSize Sí String Especifica el tamaño de la máquina virtual. Consulte las opciones de configuración de HDInsight (una vez en este vínculo, desplácese hacia abajo hasta planes de tarifa de Node) para conocer los tamaños válidos.

osProfile

Nombre del elemento Obligatorio Tipo Descripción
linuxOperatingSystemProfile No Tipo complejo Especifica la configuración relacionada con el sistema operativo Linux.
windowsOperatingSystemProfile No Tipo complejo Especifica la configuración relacionada con el sistema operativo windows.
virtualNetworkProfile No Tipo complejo Especifica la configuración relacionada con la red virtual si el clúster se implementa en una red virtual en la suscripción del usuario.
scriptActions No Matriz de tipo complejo Lista de acciones de script que se van a ejecutar en el clúster

linuxOperatingSystemProfile

Nombre del elemento Obligatorio Tipo Descripción
Nombre de usuario Sí String Nombre de usuario de SSH
sshProfile No Tipo complejo Especifica la clave SSH.

Se requiere uno de sshProfile o Password.
Contraseña No String Especifica la contraseña SSH.

Se requiere uno de sshProfile o Password.

sshProfile

Nombre del elemento Obligatorio Tipo Descripción
publicKeys Sí Array Contiene una lista de objetos certificateData. El valor es una clave pública ssh-rsa.

windowsOperatingSystemProfile

Nombre del elemento Obligatorio Tipo Descripción
rdpSettings No Tipo complejo Especifica la configuración de RDP para los clústeres de Windows.

rdpSettings

Nombre del elemento Obligatorio Tipo Descripción
username Sí String Especifica el nombre de usuario de RDP.
password Sí String Especifica la contraseña para el usuario RDP.
expiryDate Sí Date Fecha de expiración de las credenciales de RDP

virtualNetworkProfile

Nombre del elemento Obligatorio Tipo Descripción
id Sí String id. de recurso de Virtual Network
subred Sí String Especifica el nombre de la subred.

scriptActions

Nombre del elemento Obligatorio Tipo Descripción
name Sí String Nombre descriptivo de la acción de script
uri Sí String Dirección URL del archivo de acción de script
parámetros No String Argumentos que se van a pasar al ejecutar el archivo de acción de script

Response

Si se completa la validación y se acepta la solicitud, la operación devolverá 200 (Correcto).

Código de estado: 200 Correcto

El cuerpo de respuesta de un clúster de Linux crea mediante la clave 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"  
                    }  
                }  
            ]  
        }  
    }  
}
Nombre del elemento Tipo Descripción
provisioningState String Indica el estado de aprovisionamiento actual.
clusterState String Indica el estado del clúster de HDInsight más detallado mientras el aprovisionamiento está en curso.
createdDate Fecha Fecha y hora en que se recibió la solicitud de creación del clúster
quotaInfo Tipo complejo Especifica los núcleosUso por el clúster.
errors Matriz de mensajes de error Contiene el mensaje de error si provisioningState = 'failed'
connectivityEndpoints Tipo complejo Especifica los puntos de conexión públicos para el clúster.

connectivityEndpoints

Nombre del elemento Tipo Descripción
name String Nombre descriptivo del punto de conexión de conectividad
protocol String Especifica el protocolo que se va a usar (ejemplo: HTTPS, SSH)
ubicación String Especifica la dirección URL que se va a conectar.
port int Especifica el puerto para conectarse.

Creación de un clúster de HDInsight premium unido a un dominio (solo Linux, versión preliminar)

Cree un clúster unido a un dominio Premium con Apache Ranger. El usuario debe proporcionar SecurityProfile en el cuerpo de la solicitud para crear un clúster seguro.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

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

En el ejemplo siguiente se muestra el cuerpo de la solicitud para crear un clúster de Hadoop basado en Linux, premium y unido a un dominio.

{
	"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"
						}
					}
				}
			]
		}
	}
}
Nombre del elemento Obligatorio Tipo Descripción
id Sí String Especifica el identificador de recurso del clúster.
name Sí String Especifica el nombre del clúster.
type Sí String Especifica el tipo del clúster.
ubicación Sí String Especifica la ubicación de Azure admitida donde se debe crear el clúster. Para obtener más información, vea Enumerar todas las ubicaciones geográficas disponibles.
etiquetas No String Especifica las etiquetas que se asignarán al clúster. Para más información sobre el uso de etiquetas, consulte Uso de etiquetas para organizar los recursos de Azure.
Propiedades Sí Tipo complejo Especifica las propiedades del clúster.

Propiedades

Nombre del elemento Obligatorio Tipo Descripción
clusterVersion Sí String Especifica la versión del clúster.
osType Sí String Especifica el sistema operativo para el clúster.

El valor válido es Linux porque solo los tipos de clúster de Linux pueden unirse a un dominio de Azure AD.
Nivel: No String El valor predeterminado es estándar. Los valores válidos son estándar y Premium. Si no se especifica ningún valor, se supone que el valor es estándar. Especifica el nivel del clúster. Los clústeres unidos a un dominio solo se admiten en el nivel Premium
clusterDefinition Sí Tipo complejo Especifica información sobre el tipo de clúster y las configuraciones.
computeProfile Sí Tipo complejo Especifica información sobre la topología del clúster y las propiedades de rol asociadas.
securityProfile No Tipo complejo Si se crea un clúster seguro unido a un dominio, este elemento especifica la configuración relacionada con Active Directory.

clusterDefinition

Nombre del elemento Obligatorio Tipo Descripción
kind Sí String Especifica el tipo de clúster.

Los valores válidos son hadoop, hbase, storm & spark
configuraciones Sí Diccionario Este elemento es un diccionario de tipo de configuración y su diccionario de valores asociado.

El tipo de configuración de puerta de enlace se usa para configurar el usuario http que se usa para conectarse a las API web y el portal de Ambari.

El tipo de configuración de sitio principal se usa para configurar la cuenta de almacenamiento predeterminada para el clúster.

computeProfile

Nombre del elemento Obligatorio Tipo Descripción
clusterVersion Sí String Especifica la versión del clúster.
role Sí Matriz de tipo complejo (rol) Especifica información sobre los roles del clúster.

securityProfile

Nombre del elemento Obligatorio Tipo Descripción
directoryType Sí String Tipo de directorio LDAP que se usa. Actualmente, "ActiveDirectory" es el único valor admitido.
dominio Sí String Dominio de Active Directory para el clúster
organizationalUnitDN Sí String Nombre distintivo de la unidad organizativa en Active Directory donde se crearán cuentas de usuario y equipo
ldapsUrls Sí Matriz de cadena Direcciones URL de uno o varios servidores LDAPS para Active Directory
domainUserName Sí String Una cuenta de usuario de dominio con permisos suficientes para crear el clúster. Debe estar en formato user@domain
domainUserPassword Sí String Contraseña de la cuenta de usuario de dominio
clusterUsersGroupDNS No Matriz de cadena Nombres distintivos de los grupos de Active Directory que estarán disponibles en Ambari y Apache Ranger

rol

Nombre del elemento Obligatorio Tipo Descripción
name Sí String Especifica el nombre del rol.
targetInstanceCount Sí Entero Especifica el recuento de instancias de destino para el rol.
hardwareProfile Sí Tipo complejo Especifica información sobre el perfil de hardware para el rol.
osProfile Sí Tipo complejo Especifica información sobre el perfil del sistema operativo para el rol.

hardwareProfile

Nombre del elemento Obligatorio Tipo Descripción
vmSize Sí String Especifica el tamaño de la máquina virtual. Consulte las opciones de configuración de HDInsight (una vez en este vínculo, desplácese hacia abajo hasta planes de tarifa de Node) para conocer los tamaños válidos.

osProfile

Nombre del elemento Obligatorio Tipo Descripción
linuxOperatingSystemProfile No Tipo complejo Especifica la configuración relacionada con el sistema operativo Linux.
virtualNetworkProfile No Tipo complejo Especifica la configuración relacionada con la red virtual si el clúster se está implementando en una red virtual en la suscripción del usuario.
scriptActions No Matriz de tipo complejo Lista de acciones de script que se van a ejecutar en el clúster

linuxOperatingSystemProfile

Nombre del elemento Obligatorio Tipo Descripción
Nombre de usuario Sí String Nombre de usuario de SSH
sshProfile No Tipo complejo Especifica la clave SSH.

Se requiere una de sshProfile o password.
Contraseña No String Especifica la contraseña SSH.

Se requiere una de sshProfile o password.

sshProfile

Nombre del elemento Obligatorio Tipo Descripción
publicKeys Sí Array Contiene una lista de objetos certificateData. El valor es una clave pública ssh-rsa.

virtualNetworkProfile

Nombre del elemento Obligatorio Tipo Descripción
id Sí String id. de recurso de Virtual Network
subred Sí String Especifica el nombre de la subred.

scriptActions

Nombre del elemento Obligatorio Tipo Descripción
name Sí String Nombre descriptivo de la acción de script
uri Sí String Dirección URL del archivo de acción de script
parámetros No String Argumentos que se van a pasar al ejecutar el archivo de acción de script

Response

Si se completa la validación y se acepta la solicitud, la operación devolverá 200 (Correcto).

Código de estado: 200 Correcto

El cuerpo de respuesta de un clúster de Linux crea mediante la clave 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"  
                    }  
                }  
            ]  
        }  
    }  
}
Nombre del elemento Tipo Descripción
provisioningState String Indica el estado de aprovisionamiento actual.
clusterState String Indica el estado del clúster de HDInsight más detallado mientras el aprovisionamiento está en curso.
createdDate Fecha Fecha y hora en que se recibió la solicitud de creación del clúster
quotaInfo Tipo complejo Especifica los núcleosUso por el clúster.
errors Matriz de mensajes de error Contiene el mensaje de error si provisioningState = 'failed'
connectivityEndpoints Tipo complejo Especifica los puntos de conexión públicos para el clúster.

connectivityEndpoints

Nombre del elemento Tipo Descripción
name String Nombre descriptivo del punto de conexión de conectividad
protocol String Especifica el protocolo que se va a usar (ejemplo: HTTPS, SSH)
ubicación String Especifica la dirección URL que se va a conectar.
port int Especifica el puerto para conectarse.

Creación de un clúster con Azure Data Lake Store como sistema de archivos predeterminado

Crea un clúster en la suscripción especificada con Azure Data Lake Store como sistema de archivos predeterminado. Proporcione un objeto ClusterIdentity en el cuerpo de la solicitud y configure la propiedad default-filesystem con la dirección URL adecuada de Data Lake Store.

Azure Data Lake se puede configurar como sistema de archivos predeterminado para las versiones de clúster a partir de la versión 3.5 inclusive.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

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

En el ejemplo siguiente se muestra el cuerpo de la solicitud para crear un clúster de Hadoop basado en Linux mediante Azure Data Lake Store como sistema de archivos predeterminado para el clúster.

{
	"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"
									}
								]
							}
						}
					}
				}
			]
		}
	}
}
Nombre del elemento Obligatorio Tipo Descripción
id Sí String Especifica el identificador de recurso del clúster.
name Sí String Especifica el nombre del clúster.
type Sí String Especifica el tipo del clúster.
ubicación Sí String Especifica la ubicación de Azure admitida donde se debe crear el clúster. Para obtener más información, vea Enumerar todas las ubicaciones geográficas disponibles.
etiquetas No String Especifica las etiquetas que se asignarán al clúster. Para más información sobre el uso de etiquetas, consulte Uso de etiquetas para organizar los recursos de Azure.
Propiedades Sí Tipo complejo Especifica las propiedades del clúster.

Propiedades

Nombre del elemento Obligatorio Tipo Descripción
clusterVersion Sí String Especifica la versión del clúster.
osType Sí String Especifica el sistema operativo para el clúster.

El valor válido es Linux
Nivel: No String Especifica el nivel del clúster. Los valores válidos son estándar y Premium. Si no se especifica el nivel, el clúster será del nivel estándar.
clusterDefinition Sí Tipo complejo Especifica información sobre el tipo de clúster y las configuraciones.
computeProfile Sí Tipo complejo Especifica información sobre la topología del clúster y las propiedades de rol asociadas.

clusterDefinition

Nombre del elemento Obligatorio Tipo Descripción
kind Sí String Especifica el tipo de clúster.

Los valores válidos son hadoop, hbase, storm & spark
configuraciones Sí Diccionario Este elemento es un diccionario de tipo de configuración y su diccionario de valores asociado.

El tipo de configuración de puerta de enlace se usa para configurar el usuario http que se usa para conectarse a las API web y el portal de Ambari.

El tipo de configuración de sitio principal se usa para configurar la cuenta de almacenamiento predeterminada para el clúster.

computeProfile

Nombre del elemento Obligatorio Tipo Descripción
clusterVersion Sí String Especifica la versión del clúster.
role Sí Matriz de tipo complejo (rol) Especifica información sobre los roles del clúster.

rol

Nombre del elemento Obligatorio Tipo Descripción
name Sí String Especifica el nombre del rol.
targetInstanceCount Sí Entero Especifica el recuento de instancias de destino para el rol.
hardwareProfile Sí Tipo complejo Especifica información sobre el perfil de hardware para el rol.
osProfile Sí Tipo complejo Especifica información sobre el perfil del sistema operativo para el rol.

hardwareProfile

Nombre del elemento Obligatorio Tipo Descripción
vmSize Sí String Especifica el tamaño de la máquina virtual. Consulte las opciones de configuración de HDInsight (una vez en este vínculo, desplácese hacia abajo hasta planes de tarifa de Node) para conocer los tamaños válidos.

osProfile

Nombre del elemento Obligatorio Tipo Descripción
linuxOperatingSystemProfile No Tipo complejo Especifica la configuración relacionada con el sistema operativo Linux.
virtualNetworkProfile No Tipo complejo Especifica la configuración relacionada con la red virtual si el clúster se implementa en una red virtual en la suscripción del usuario.
scriptActions No Matriz de tipo complejo Lista de acciones de script que se van a ejecutar en el clúster

linuxOperatingSystemProfile

Nombre del elemento Obligatorio Tipo Descripción
Nombre de usuario Sí String Nombre de usuario de SSH
sshProfile No Tipo complejo Especifica la clave SSH.

Se requiere una de sshProfile o password.
Contraseña No String Especifica la contraseña SSH.

Se requiere una de sshProfile o password.

sshProfile

Nombre del elemento Obligatorio Tipo Descripción
publicKeys Sí Array Contiene una lista de objetos certificateData. El valor es una clave pública ssh-rsa.

virtualNetworkProfile

Nombre del elemento Obligatorio Tipo Descripción
id Sí String id. de recurso de Virtual Network
subred Sí String Especifica el nombre de la subred.

scriptActions

Nombre del elemento Obligatorio Tipo Descripción
name Sí String Nombre descriptivo de la acción de script
uri Sí String Dirección URL del archivo de acción de script
parámetros No String Argumentos que se van a pasar al ejecutar el archivo de acción de script

Response

Si se completa la validación y se acepta la solicitud, la operación devolverá 200 (Correcto).

Código de estado: 200 Correcto

El cuerpo de respuesta de un clúster de Linux crea mediante la clave 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"
	}
}
Nombre del elemento Tipo Descripción
provisioningState String Indica el estado de aprovisionamiento actual.
clusterState String Indica el estado del clúster de HDInsight más detallado mientras el aprovisionamiento está en curso.
createdDate Fecha Fecha y hora en que se recibió la solicitud de creación del clúster
quotaInfo Tipo complejo Especifica los núcleosUso por el clúster.
errors Matriz de mensajes de error Contiene el mensaje de error si provisioningState = 'failed'
connectivityEndpoints Tipo complejo Especifica los puntos de conexión públicos para el clúster.

connectivityEndpoints

Nombre del elemento Tipo Descripción
name String Nombre descriptivo del punto de conexión de conectividad
protocol String Especifica el protocolo que se va a usar (ejemplo: HTTPS, SSH)
ubicación String Especifica la dirección URL que se va a conectar.
port int Especifica el puerto que se va a conectar.

Eliminar

Elimina un clúster de HDInsight.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Response

HTTP 202 (aceptado) para indicar que la operación se completará de forma asincrónica. El sondeo asincrónico devolverá 204 (NoContent) una vez que la operación se complete correctamente.

Comentarios

Para realizar un seguimiento del progreso de una solicitud de eliminación del clúster, consulte Operaciones asincrónicas (encabezado Aceptado y ubicación 202).

Get

Obtiene los detalles o propiedades del clúster especificado.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Response

La operación devolverá 200 (CORRECTO) si la solicitud se ha completado correctamente.

Código de estado: 200 Aceptar

El cuerpo de la respuesta es el mismo que crear clúster.

Cuerpo de respuesta para los detalles del clúster de 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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}
Nombre del elemento Tipo Descripción
provisioningState String Indica el estado de aprovisionamiento actual.
clusterState String Indica el estado del clúster de HDInsight más detallado mientras el aprovisionamiento está en curso.
createdDate Fecha Fecha y hora en que se recibió la solicitud de creación del clúster
quotaInfo Tipo complejo Especifica los núcleosUso por el clúster.
errors Matriz de mensajes de error Contiene el mensaje de error si provisioningState = 'failed'
connectivityEndpoints Tipo complejo Especifica los puntos de conexión públicos para el clúster.

connectivityEndpoints

Nombre del elemento Tipo Descripción
name String Nombre descriptivo del punto de conexión de conectividad
protocol String Especifica el protocolo que se va a usar (ejemplo: HTTPS, SSH)
ubicación String Especifica la dirección URL que se va a conectar.
port int Especifica el puerto que se va a conectar.

Enumerar configuraciones

Recupera todos los detalles de configuración del clúster (incluida la información confidencial).

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Response

HTTP 200 (CORRECTO) al completar correctamente la operación.

Respuesta de ejemplo:

"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"  
      }  
}
Nombre del elemento Tipo Descripción
configuraciones Diccionario Este elemento es un diccionario de tipo de configuración y su diccionario de valores asociado.
El tipo de configuración de puerta de enlace se usa para configurar el usuario http que se usa para conectarse a las API web y el portal de Ambari.
El tipo de configuración de sitio principal se usa para configurar la cuenta de almacenamiento predeterminada para el clúster.

obtener la configuración

Obtiene detalles sobre un único tipo de configuración (omite valores confidenciales).

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Response

HTTP 200 (CORRECTO) al completar correctamente la operación.

Respuesta de ejemplo:

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

Obtención de la configuración de la puerta de enlace

Esta operación recupera las credenciales HTTP de la puerta de enlace de clúster.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Response

HTTP 200 (CORRECTO) al completar correctamente la operación.

Respuesta de ejemplo:

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

Actualizar la configuración de la puerta de enlace

Esta operación permite a los usuarios cambiar las credenciales HTTP de la puerta de enlace de clúster.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

Método URI de solicitud
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!"  
}

Response

HTTP 202 (aceptado) al completar correctamente la operación.

Cambiar la configuración de conectividad (EN DESUSO)

Esta operación permite a los usuarios habilitar o deshabilitar la conectividad HTTPS con el clúster.

Use updateGatewaySettings en su lugar.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

Método URI de solicitud
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 habilitar la conectividad

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

Enumeración por grupo de recursos

Listas todos los clústeres de la suscripción del usuario en el grupo de recursos especificado.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Response

La operación devolverá 200 (CORRECTO) si la solicitud se ha completado correctamente.

Código de estado: 200 Aceptar

El cuerpo de la respuesta es una matriz de detalles del clúster. Para más información, consulte Obtención de propiedades del clúster.

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

Enumeración por suscripción

Listas todos los clústeres de la suscripción del usuario.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Response

La operación devolverá 200 (CORRECTO) si la solicitud se ha completado correctamente.

Código de estado: 200 Aceptar

El cuerpo de la respuesta es una matriz de detalles del clúster.

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

Para deshabilitar la conectividad

{  
   "restAuthCredential.isEnabled": false  
}
Nombre del elemento Obligatorio Tipo Descripción
restAuthCredential.isEnabled Sí Boolean Especifica si se debe habilitar o deshabilitar la conectividad.
restAuthCredential.username No String Obligatorio si isEnabled=true
Especifica el nombre de usuario para la configuración de conectividad.
restAuthCredential.password No String Obligatorio si isEnabled=true
Especifica la contraseña para la configuración de conectividad.

Response

HTTP 202 (aceptado) para indicar que la operación se completará de forma asincrónica. El sondeo asincrónico devolverá 204 (NoContent) una vez que la operación se complete correctamente.

Comentarios

Para realizar un seguimiento del progreso de una solicitud de eliminación del clúster, consulte Operaciones asincrónicas (encabezado Aceptado y ubicación 202).

Cambiar la configuración de RDP (solo clúster de Windows)

Esta operación permite a un usuario habilitar o deshabilitar RDP. Se aplica a los clústeres basados en Windows.

Solicitud

Consulte Parámetros y encabezados comunes para los encabezados y parámetros que usan los clústeres.

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

Cuerpo de la solicitud

Para habilitar RDP

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

Para deshabilitar RDP

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

osProfile

Nombre del elemento Obligatorio Tipo Descripción
windowsOperatingSystemProfile No Tipo complejo Especifica la configuración relacionada con el sistema operativo windows.

windowsOperatingSystemProfile

Nombre del elemento Obligatorio Tipo Descripción
rdpSettings No Tipo complejo Especifica la configuración de RDP para los clústeres de Windows.

rdpSettings

Nombre del elemento Obligatorio Tipo Descripción
username Sí String Especifica el nombre de usuario de RDP.
password Sí String Especifica la contraseña del usuario RDP.
expiryDate Sí Date Fecha de expiración de las credenciales de RDP

Response

La operación devolverá 200 (CORRECTO) si la solicitud se ha completado correctamente.

Código de estado: 200 Correcto

El cuerpo de la respuesta es el mismo que crear un clúster.

Ejecución de acciones de script en un clúster en ejecución (solo clúster de Linux)

Ejecute la acción Script en un clúster en ejecución.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

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

Cuerpo de la solicitud

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

scriptActions

Nombre del elemento Obligatorio Tipo Descripción
name Sí String Especifica el nombre de la acción de script.
uri Sí String Especifica el URI de la acción de script.
parámetros Sí String Especifica los parámetros requeridos por la acción de script.
roles Sí Matriz de cadena Especifica los roles de destino en los que se ejecuta la acción de script.
persistOnSuccess Sí Boolean Especifica si las acciones del script se conservarán después de ejecuciones correctas.

Response

Si se completa la validación y se acepta la solicitud, la operación devolverá 202 (aceptado).

Código de estado: 202 (aceptado)

Enumeración de todas las acciones de script persistentes para un clúster (solo clúster de Linux)

Esta operación devuelve todas las acciones de scripts persistentes del clúster especificado.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

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

Response

HTTP 200 (CORRECTO) al completar correctamente la operación.

Código de estado: 200 Correcto

Respuesta de ejemplo:

{  
"value":  
[  
  {  
    "name":"script-name",  
    "uri":"script-uri",  
    "parameters":"script-parameters",  
    "roles":["headnode","workernode"],  
    "applicationName":null  
  },  
  ...  
]  
}
Nombre del elemento Tipo Descripción
name String Especifica el nombre de la acción de script.
uri String Especifica el URI de la acción de script.
parámetros String Especifica los parámetros requeridos por la acción de script.
roles Matriz de cadena Especifica los roles de destino en los que se ejecuta la acción de script.
applicationName String Especifica la aplicación correspondiente a la que está asociado el script. applicationName es null si los usuarios proporcionan el script

Eliminación de una acción de script persistente para un clúster (solo clúster de Linux)

Esta operación quita una acción de script persistente de HDInsight para un clúster.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

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

Response

  • HTTP 200 (CORRECTO) para indicar que la acción de script se ha quitado de la lista de acciones de script persistentes.

  • HTTP 404 (NotFound) para indicar que no hay ninguna acción de script persistente existente con el scriptName correspondiente.

Obtención de la ejecución de la acción de script del historial (solo clústeres de Linux)

Esta operación devuelve la ejecución de la acción de scripts más reciente del clúster especificado o los detalles de ejecución de una ejecución de script individual.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

Método URI de solicitud
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}

Response

La operación devolverá 200 (CORRECTO) si la solicitud se ha completado correctamente. El cuerpo de la respuesta es una matriz de detalles de ejecución de script o detalles de ejecución de script único si se proporciona scriptExecutionId. A continuación se muestra un ejemplo de un detalle de ejecución de script.

Código de estado: 200 (correcto)

Respuesta de ejemplo:

{  
  "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"  
}
Nombre del elemento Tipo Descripción
scriptExecutionId long Especifica el identificador de ejecución de la acción de script.
name String Especifica el nombre de la acción de script.
applicationName String Especifica la aplicación correspondiente a la que está asociado el script. applicationName es null si los usuarios proporcionan el script
uri String Especifica el URI de la acción de script.
parámetros String Especifica los parámetros requeridos por la acción de script.
roles Matriz de cadena Especifica los roles de destino en los que se ejecuta la acción de script.
startTime DateTime Especifica la hora de inicio de la ejecución de la acción de script.
endTime DateTime Especifica la hora de finalización de la ejecución de la acción de script.
status String Especifica el estado de la ejecución de la acción de script.
operation String Especifica el motivo por el que se ejecutó la acción de script. Por ejemplo, ScaleUp significa que la acción de script se ejecutó durante el escalado vertical del clúster.
executionSummary Matriz de tipo complejo Especifica el resumen de la ejecución en términos de cuántos hosts se realizaron correctamente y cuántos hosts no pudieron ejecutar el script.
debugInformation String Especifica información detallada de depuración para el script. debugInformation solo se devuelve cuando se proporciona un scriptExecutionId en la solicitud.

executionSummary

Nombre del elemento Tipo Descripción
status String Especifica el estado de la ejecución en hosts individuales.
instanceCount Int Especifica el número de ejecuciones con el estado correspondiente.

Promoción de un script desde el historial de ejecución de la acción de script para que se conserve (solo clúster de Linux)

Esta operación promueve un script de HDInsight del historial de ejecución de scripts que se va a conservar.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

Método URI de solicitud
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}

Response

  • HTTP 200 (CORRECTO) para indicar que se ha promocionado la acción de script.

  • HTTP 404 (NotFound) para indicar que no hay ninguna ejecución de acción de script existente con el scriptExecutionId correspondiente.

Cambiar de tamaño

Cambia el tamaño de un clúster de HDInsight existente.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

Método URI de solicitud
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}

A continuación se muestra una solicitud de ejemplo para actualizar las etiquetas de un clúster.

{  
    "targetInstanceCount": 10  
}
Nombre del elemento Obligatorio Tipo Descripción
targetInstanceCount Sí Int Especifica el nuevo recuento de instancias para el rol.

Response

HTTP 202 (aceptado) para indicar que la operación se completará de forma asincrónica. El sondeo asincrónico devolverá 204 (NoContent) una vez que la operación se complete correctamente.

Comentarios

Para realizar un seguimiento del progreso de una solicitud de eliminación del clúster, consulte Operaciones asincrónicas (encabezado Aceptado y ubicación 202)

Actualizar

Novedades etiquetas para un clúster.

Todas las demás actualizaciones son acciones independientes que se describen por separado.

Solicitud

Consulte Common parameters and headers for headers and parameters that are used by clusters (Parámetros y encabezados comunes para encabezados y parámetros que usan los clústeres).

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

A continuación se muestra una solicitud de ejemplo para actualizar las etiquetas de un clúster.

{   
    "tags": {"department": "finance"}  
}
Nombre del elemento Obligatorio Tipo Descripción
etiquetas Sí String Especifica las etiquetas que se asignarán al clúster. Para más información sobre el uso de etiquetas, consulte Uso de etiquetas para organizar los recursos de Azure.

Response

La operación devolverá 200 (CORRECTO) si la solicitud se ha completado correctamente.

Código de estado: 200 Correcto

El cuerpo de la respuesta es el mismo que crear un clúster.