API de REST de clúster en Azure HDInsight

Crear

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

Solicitud

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

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 creación de 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" }  
                                ]  
                            }  
                        }  
                    }  
                }  
            ]  
        }  
    }  
}  
  

Propiedades

clusterDefinition

computeProfile

rol

hardwareProfile

osProfile

linuxOperatingSystemProfile

sshPerfil

windowsOperatingSystemProfile

rdpConfiguración

virtualNetworkProfile

scriptActions

Respuesta

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

Código de estado: 200 OK

El cuerpo de respuesta de un clúster de Linux se 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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

connectivityEndpoints

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 Parámetros y encabezados comunes para conocer los encabezados y parámetros que usan los clústeres.

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

Propiedades

clusterDefinition

computeProfile

securityProfile

rol

hardwareProfile

osProfile

linuxOperatingSystemProfile

sshPerfil

virtualNetworkProfile

scriptActions

Respuesta

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

Código de estado: 200 OK

El cuerpo de respuesta de un clúster de Linux se 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"  
                    }  
                }  
            ]  
        }  
    }  
}  
  

connectivityEndpoints

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 el sistema de archivos predeterminado para las versiones de clúster a partir de la versión 3.5 inclusive.

Solicitud

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

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

Propiedades

clusterDefinition

computeProfile

rol

hardwareProfile

osProfile

linuxOperatingSystemProfile

sshPerfil

virtualNetworkProfile

scriptActions

Respuesta

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

Código de estado: 200 OK

El cuerpo de respuesta de un clúster de Linux se 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"
	}
}  

connectivityEndpoints

Borrar

Elimina un clúster de HDInsight.

Solicitud

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

Respuesta

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

Observaciones

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

Obtener

Obtiene los detalles o propiedades del clúster especificado.

Solicitud

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

Respuesta

La operación devolverá 200 (OK) si la solicitud se completa correctamente

Código de estado: 200 OK

El cuerpo de la respuesta es el mismo que el de create cluster.

Cuerpo de respuesta para 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"  
                       }  
                     }  
                }  
            ]  
        }  
    }  
}  
  

connectivityEndpoints

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 conocer los encabezados y parámetros que usan los clústeres.

Respuesta

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

Ejemplo de respuesta:

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

Obtener la configuración

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

Solicitud

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

Respuesta

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

Ejemplo de respuesta:

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

Obtener la configuración de la puerta de enlace

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

Solicitud

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

Respuesta

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

Ejemplo de respuesta:

{  
     "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 del clúster.

Solicitud

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

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

Respuesta

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

Cambiar la configuración de conectividad (OBSOLETO)

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

En su lugar, use updateGatewaySettings .

Solicitud

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

Para habilitar la conectividad

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

Enumeración por grupo de recursos

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

Solicitud

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

Respuesta

La operación devolverá 200 (OK) si la solicitud se completa correctamente.

Código de estado: 200 OK

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

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

Lista por suscripción

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

Solicitud

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

Respuesta

La operación devolverá 200 (OK) si la solicitud se completa correctamente.

Código de estado: 200 OK

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

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

Para deshabilitar la conectividad

{  
   "restAuthCredential.isEnabled": false  
}  
  

Respuesta

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

Observaciones

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

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

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

Solicitud

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

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

windowsOperatingSystemProfile

rdpConfiguración

Respuesta

La operación devolverá 200 (OK) si la solicitud se completa correctamente

Código de estado: 200 OK

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

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

Ejecutar acción de script en un clúster en ejecución.

Solicitud

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

Cuerpo de la solicitud

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

scriptActions

Respuesta

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

Código de estado: 202 (Aceptado)

Enumerar 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 Parámetros y encabezados comunes para conocer los encabezados y parámetros que usan los clústeres.

Respuesta

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

Código de estado: 200 OK

Ejemplo de respuesta:

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

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 Parámetros y encabezados comunes para conocer los encabezados y parámetros que usan los clústeres.

Respuesta

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

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

Obtener la ejecución de acciones 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 para una ejecución de script individual.

Solicitud

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

Respuesta

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

Código de estado: 200 (OK)

Ejemplo de respuesta:

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

executionSummary

Promover un script del historial de ejecución de acciones de script para que se conserve (solo clúster de Linux)

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

Solicitud

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

Respuesta

• HTTP 200 (OK) para indicar que se ha promovido la acción del 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 Parámetros y encabezados comunes para conocer los encabezados y parámetros que usan los clústeres.

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

{  
    "targetInstanceCount": 10  
}  

Respuesta

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

Observaciones

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

Actualizar

Actualiza las etiquetas de un clúster.

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

Solicitud

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

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

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

Respuesta

La operación devolverá 200 (OK) si la solicitud se completa correctamente.

Código de estado: 200 OK

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