Consulta de detalles del clúster
Función
Esta API se utiliza para consultar detalles sobre un clúster especificado. Esta API es incompatible con Sahara.
Restricciones
Ninguna
Depuración
Puede depurar esta API a través de la autenticación automática en API Explorer. API Explorer puede generar automáticamente código SDK de ejemplo y proporcionar la depuración de código SDK de ejemplo.
URI
- Formato
- Descripción de parámetro
Tabla 1 Parámetros de URI Parámetro
Obligatorio
Tipo
Descripción
project_id
Sí
String
ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
cluster_id
Sí
String
ID de clúster. Para obtener más información acerca de cómo obtener el valor, consulte Obtención de la información del clúster MRS.
Parámetros de solicitud
Parámetro de solicitud
Ninguna
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
cluster |
Cluster object |
Parámetros de clúster. Para obtener más información, consulte Tabla 3. |
Parámetro |
Tipo |
Descripción |
---|---|---|
clusterId |
String |
ID del clúster |
clusterName |
String |
Nombre del clúster |
totalNodeNum |
String |
Número total de nodos desplegados en un clúster |
clusterState |
String |
Estado del clúster. Valores posibles:
|
stageDesc |
String |
Descripción del progreso de la operación de clúster.
El progreso de la instalación del clúster incluye:
El progreso de ampliación de los grupos incluye:
El progreso de la reducción del clúster incluye:
Si la instalación del clúster, la ampliación, o reducción fallan, stageDesc mostrará la causa del error. |
createAt |
String |
Tiempo de creación del clúster, que es una marca de tiempo de 10 bits |
updateAt |
String |
Tiempo de actualización del clúster, que es una marca de tiempo de 10 bits |
chargingStartTime |
String |
Hora de inicio de la facturación |
billingType |
String |
Modo de facturación de clústeres |
dataCenter |
String |
Región de trabajo del clúster |
vpc |
String |
Nombre de VPC |
vpcId |
String |
ID de VPC |
duration |
String |
Duración de la suscripción al clúster |
fee |
String |
Tarifa de creación de clúster, que se calcula automáticamente |
hadoopVersion |
String |
Versión Hadoop |
componentList |
Array |
Lista de componentes. Para obtener más información, consulte Tabla 4. |
externalIp |
String |
Dirección IP externa |
externalAlternateIp |
String |
Copia de respaldo de la dirección IP externa |
internalIp |
String |
dirección IP interna |
deploymentId |
String |
ID de despliegue de clúster |
remark |
String |
Observaciones de clúster |
orderId |
String |
ID de orden de creación de clúster |
azId |
String |
ID de AZ |
azName |
String |
Nombre de AZ |
azCode |
String |
Nombre de zona de disponibilidad (en). |
availabilityZoneId |
String |
AZ. |
instanceId |
String |
ID de la instancia |
vnc |
String |
URI para iniciar sesión remotamente en un ECS |
tenantId |
String |
ID de proyecto |
volumeSize |
Integer |
Espacio de almacenamiento en disco |
volumeType |
String |
Tipo de disco. |
subnetId |
String |
ID de subred |
subnetName |
String |
Nombre de subred |
securityGroupsId |
String |
ID de grupo de seguridad |
slaveSecurityGroupsId |
String |
ID de grupo de seguridad de un nodo que no es Master. Actualmente, un clúster de MRS utiliza solo un grupo de seguridad. Por lo tanto, este campo ha sido descartado. Este campo devuelve el mismo valor que securityGroupsId para considerar la compatibilidad. |
bootstrapScripts |
Array of BootstrapScript objects |
Información del script de acción de arranque. Para obtener más información sobre los parámetros, consulte Tabla 6. |
safeMode |
Integer |
Modo de ejecución de un clúster MRS
|
clusterVersion |
String |
Versión del clúster |
nodePublicCertName |
String |
Nombre del archivo de clave pública |
masterNodeIp |
String |
Dirección IP de un nodo de Master |
privateIpFirst |
String |
Dirección IP privada preferida |
errorInfo |
String |
Mensaje de error |
tags |
String |
Información de etiqueta |
masterNodeNum |
String |
Número de nodos de Master desplegados en un clúster |
coreNodeNum |
String |
Número de nodos de Core desplegados en un clúster |
masterNodeSize |
String |
Especificaciones de instancia de un nodo de Master. |
coreNodeSize |
String |
Especificaciones de instancia de un nodo Core |
masterNodeProductId |
String |
ID de producto de un nodo Master |
masterNodeSpecId |
String |
ID de especificación de un nodo Master |
coreNodeProductId |
String |
ID de producto de un nodo Core |
coreNodeSpecId |
String |
ID de especificación de un nodo Core |
masterDataVolumeType |
String |
Tipo de almacenamiento en disco de datos del nodo de Master. Actualmente, se admiten SATA, SAS y SSD. |
masterDataVolumeSize |
Integer |
Espacio de almacenamiento en disco de datos del nodo Master. Para aumentar la capacidad de almacenamiento de datos, puede agregar discos al mismo tiempo al crear un clúster. Rango de valores: 100 GB a 32,000 GB |
masterDataVolumeCount |
Integer |
Número de discos de datos del nodo Master. El valor solo se puede establecer en 1. |
coreDataVolumeType |
String |
Tipo de almacenamiento en disco de datos del nodo Core. Actualmente, se admiten SATA, SAS y SSD. |
coreDataVolumeSize |
Integer |
Espacio de almacenamiento en disco de datos del nodo Core. Para aumentar la capacidad de almacenamiento de datos, puede agregar discos al mismo tiempo al crear un clúster. Solo tiene que introducir un número sin la unidad GB. Rango de valores: 100 GB a 32,000 GB |
coreDataVolumeCount |
Integer |
Número de discos de datos del nodo Core. Rango de valores: 1 a 10 |
enterpriseProjectId |
String |
ID del proyecto empresarial |
isMrsManagerFinish |
Boolean |
Si la instalación de MRS Manager ha finalizado durante la creación del clúster.
|
clusterType |
Integer |
Tipo de clúster |
logCollection |
Integer |
Si se recopilan registros cuando se produce un error en la instalación del clúster
|
periodType |
Integer |
Si el tipo de suscripción es anual o mensual
|
scale |
String |
Estado de cambio de nodo. Si este parámetro se deja en blanco, los nodos del clúster no se cambian. Valores posibles:
|
nodeGroups |
List<NodeGroup> |
Lista de nodos Master, Core y Task. Para obtener más descripción de parámetros, Consulte Tabla 5. |
taskNodeGroups |
List<NodeGroup> |
Lista de nodos de tarea. Para obtener más información sobre los parámetros, consulte Tabla 5. |
Parámetro |
Tipo |
Descripción |
---|---|---|
componentId |
String |
ID de componente Por ejemplo, el component_id de Hadoop es MRS 3.0.2_001, MRS 2.1.0_001, MRS 1.9.2_001, MRS 1.8.10_001. |
componentName |
String |
Nombre del componente |
componentVersion |
String |
Versión del componente |
componentDesc |
String |
Descripción de los componentes |
Parámetro |
Tipo |
Descripción |
---|---|---|
GroupName |
String |
Nombre del grupo de nodos. |
NodeNum |
Integer |
Número de nodos. El valor varía de 0 a 500. El número mínimo de nodos de Master y Core es 1 y el número total de nodos Core y Task no puede exceder de 500. |
NodeSize |
String |
Especificaciones de instancia de un nodo. |
NodeSpecId |
String |
ID de especificación de instancia de un nodo |
NodeProductId |
String |
ID de producto de instancia de un nodo |
VmProductId |
String |
ID de producto de VM de un nodo |
VmSpecCode |
String |
Especificaciones de VM de un nodo |
RootVolumeSize |
Integer |
Tamaño del disco del sistema de un nodo. Este parámetro no es configurable y su valor predeterminado es 40 GB. |
RootVolumeProductId |
String |
ID de producto de disco de sistema de un nodo |
RootVolumeType |
String |
Tipo de disco de sistema de un nodo |
RootVolumeResourceSpecCode |
String |
Especificaciones de producto de disco de sistema de un nodo |
RootVolumeResourceType |
String |
Tipo de producto de disco de sistema de un nodo |
DataVolumeType |
String |
Tipo de almacenamiento de disco de datos de un nodo. Actualmente, se admiten SATA, SAS y SSD.
|
DataVolumeCount |
Integer |
Número de discos de datos de un nodo. |
DataVolumeSize |
Integer |
Espacio de almacenamiento en disco de datos de un nodo. |
DataVolumeProductId |
String |
ID de producto de disco de datos de un nodo |
DataVolumeResourceSpecCode |
String |
Especificaciones de producto de disco de datos de un nodo |
DataVolumeResourceType |
String |
Tipo de producto de disco de datos de un nodo |
Parámetro |
Tipo |
Descripción |
---|---|---|
name |
String |
Nombre de un script de acción de arranque. Debe ser único en un clúster. El valor solo puede contener dígitos, letras, espacios, guiones (-) y guiones bajos (_) y no puede comenzar con un espacio. El valor puede contener de 1 a 64 caracteres. |
uri |
String |
Ruta del script de shell. Establezca este parámetro en una ruta de bucket OBS o una ruta de VM local.
|
parameters |
String |
Parámetros de script de acción de arranque |
nodes |
Array String |
Tipo de nodo donde se ejecuta el script de acción de arranque. El valor puede ser Master, Core, o Task. |
active_master |
Boolean |
Si el script de acción de arranque sólo se ejecuta en nodos Master activos. El valor predeterminado es false, que indica que el script de acción de arranque puede ejecutarse en todos los nodos Master. |
before_component_start |
Boolean |
Hora en que se ejecuta el script de acción de arranque. Actualmente, están disponibles las dos opciones siguientes: Before component start y After component start El valor predeterminado es false, que indica que el script de acción de arranque se ejecuta después de iniciar el componente. |
fail_action |
String |
Si continuar ejecutando scripts subsiguientes y crear un clúster después de que no se pueda ejecutar el script de acción de arranque.
El valor predeterminado es errorout, que indica que la acción está detenida.
NOTA:
Se recomienda establecer este parámetro en continue en la fase de puesta en marcha para que el clúster pueda seguir instalando e iniciando sin importar si la acción de arranque se realiza correctamente. |
start_time |
Long |
Tiempo de ejecución de un script de operación de arranque. |
state |
String |
Estado de ejecución de un script de acción de arranque
|
action_stages |
Array of strings |
Seleccione la hora a la que se ejecuta el script de acción de arranque.
|
Ejemplo
- Solicitud de ejemplo
GET /v1.1/{project_id}/cluster_infos/{cluster_id}
- Ejemplo de respuesta
{ "cluster":{ "clusterId":"bdb064ff-2855-4624-90d5-e9a6376abd6e", "clusterName":"c17022001", "masterNodeNum":"2", "coreNodeNum":"3", "clusterState":"scaling-in", "stageDesc": null, "createAt":"1487570757", "updateAt":"1487668974", "billingType":"Metered", "dataCenter":"cn-hk1", "vpc": "vpc-autotest", "vpcId": "e2978efd-ca12-4058-9332-1ca0bfbab592", "duration":"0", "fee":"0", "hadoopVersion":"", "masterNodeSize":"s3.2xlarge.2.linux.bigdata", "coreNodeSize":"s3.2xlarge.2.linux.bigdata", "componentList": [{ "id": null, "componentId": "MRS 3.2.0-LTS.1_001", "componentName": "Hadoop", "componentVersion": "3.1.1", "external_datasources": null, "componentDesc": "A distributed data processing framework for big data sets", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_002", "componentName": "HBase", "componentVersion": "2.2.3", "external_datasources": null, "componentDesc": "HBase is a column-based distributed storage system that features high reliability, performance, and scalability", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_003", "componentName": "Hive", "componentVersion": "3.1.0", "external_datasources": null, "componentDesc": "A data warehouse software that facilitates query and management of big data sets stored in distributed storage systems" "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_004", "componentName": "Spark2x", "componentVersion": "2.4.5", "external_datasources": null, "componentDesc": "Spark2x is a fast general-purpose engine for large-scale data processing. It is developed based on the open-source Spark2.x version.", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_005", "componentName": "Tez", "componentVersion": "0.9.2", "external_datasources": null, "componentDesc": "An application framework which allows for a complex directed-acyclic-graph of tasks for processing data.", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_006", "componentName": "Flink", "componentVersion": "1.12.0", "external_datasources": null, "componentDesc": "Flink is an open-source message processing system that integrates streams in batches.", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_008", "componentName": "Kafka", "componentVersion": "2.11-2.4.0", "external_datasources": null, "componentDesc": "Kafka is a distributed message release and subscription system.", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_009", "componentName": "Flume", "componentVersion": "1.9.0", "external_datasources": null, "componentDesc": "Flume is a distributed, reliable, and highly available service for efficiently collecting, aggregating, and moving large amounts of log data", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_013", "componentName": "Loader", "componentVersion": "1.99.3", "external_datasources": null, "componentDesc": "Loader is a tool designed for efficiently transmitting a large amount of data between Apache Hadoop and structured databases (such as relational databases).", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_014", "componentName": "Hue", "componentVersion": "4.7.0", "external_datasources": null, "componentDesc": "Apache Hadoop UI", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_015", "componentName": "Oozie", "componentVersion": "5.1.0", "external_datasources": null, "componentDesc": "A Hadoop job scheduling system", "componentDescEn": null }, { "id": null, "componentId": "MRS 3.2.0-LTS.1_022", "componentName": "Ranger", "componentVersion": "2.0.0", "external_datasources": null, "componentDesc": "Ranger is a centralized framework based on the Hadoop platform. It provides permission control interfaces such as monitoring, operation, and management interfaces for complex data.", "componentDescEn": null }], "externalIp":"100.XXX.XXX.XXX", "externalAlternateIp":"100.XXX.XXX.XXX", "internalIp":"192.XXX.XXX.XXX", "deploymentId":"4ac46ca7-a488-4b91-82c2-e4d7aa9c40c2", "remark":"", "orderId":"null", "azId":"null", "masterNodeProductId":"b35cf2d2348a445ca74b32289a160882", "masterNodeSpecId":"8ab05e503b4c42abb304e2489560063b", "coreNodeProductId":"dc970349d128460e960a0c2b826c427c", "coreNodeSpecId":"cdc6035a249a40249312f5ef72a23cd7", "azName":"AZ1", "instanceId":"4ac46ca7-a488-4b91-82c2-e4d7aa9c40c2", "vnc":null, "tenantId":"3f99e3319a8943ceb15c584f3325d064", "volumeSize":600, "volumeType":"SATA", "subnetId": "6b96eec3-4f8d-4c83-93e2-6ec625001d7c", "subnetName":"subnet-ftest", "securityGroupsId":"930e34e2-195d-401f-af07-0b64ea6603f8", "slaveSecurityGroupsId":"2ef3343e-3477-4a0d-80fe-4d874e4f81b8", "stageDesc": "Installing MRS Manager", "mrsManagerFinish": false, "safeMode":1, "clusterVersion":"", "nodePublicCertName":"myp", "masterNodeIp":"192.XXX.XXX.XXX", "privateIpFirst":"192.XXX.XXX.XXX", "errorInfo":null, "tags":"k1=v1,k2=v2,k3=v3", "clusterType": 0, "enterpriseProjectId": "0", "logCollection": 1, "nodeGroups": [ { "groupName": "master_node_default_group", "nodeNum": 1, "nodeSize": "s3.xlarge.2.linux.bigdata", "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7", "vmProductId": "", "vmSpecCode": null, "nodeProductId": "dc970349d128460e960a0c2b826c427c", "rootVolumeSize": 480, "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "rootVolumeType": "SATA", "rootVolumeResourceSpecCode": "", "rootVolumeResourceType": "", "dataVolumeType": "SATA", "dataVolumeCount": 1, "dataVolumeSize": 600, "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "dataVolumeResourceSpecCode": "", "dataVolumeResourceType": "" }, { "groupName": "core_node_analysis_group", "nodeNum": 1, "nodeSize": "s3.xlarge.2.linux.bigdata", "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7", "vmProductId": "", "vmSpecCode": null, "nodeProductId": "dc970349d128460e960a0c2b826c427c", "rootVolumeSize": 480, "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "rootVolumeType": "SATA", "rootVolumeResourceSpecCode": "", "rootVolumeResourceType": "", "dataVolumeType": "SATA", "dataVolumeCount": 1, "dataVolumeSize": 600, "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "dataVolumeResourceSpecCode": "", "dataVolumeResourceType": "" }, { "groupName": "task_node_analysis_group", "nodeNum": 1, "nodeSize": "s3.xlarge.2.linux.bigdata", "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7", "vmProductId": "", "vmSpecCode": null, "nodeProductId": "dc970349d128460e960a0c2b826c427c", "rootVolumeSize": 480, "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "rootVolumeType": "SATA", "rootVolumeResourceSpecCode": "", "rootVolumeResourceType": "", "dataVolumeType": "SATA", "dataVolumeCount": 1, "dataVolumeSize": 600, "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "dataVolumeResourceSpecCode": "", "dataVolumeResourceType": "" } ], "taskNodeGroups": [ { "groupName": "task_node_default_group", "nodeNum": 1, "nodeSize": "s3.xlarge.2.linux.bigdata", "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7", "vmProductId": "", "vmSpecCode": null, "nodeProductId": "dc970349d128460e960a0c2b826c427c", "rootVolumeSize": 480, "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "rootVolumeType": "SATA", "rootVolumeResourceSpecCode": "", "rootVolumeResourceType": "", "dataVolumeType": "SATA", "dataVolumeCount": 1, "dataVolumeSize": 600, "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", "dataVolumeResourceSpecCode": "", "dataVolumeResourceType": "", "AutoScalingPolicy": null } ], "masterDataVolumeType": "SATA", "masterDataVolumeSize": 600, "masterDataVolumeCount": 1, "coreDataVolumeType": "SATA", "coreDataVolumeSize": 600, "coreDataVolumeCount": 1, "periodType": 0 } }
Códigos de estado
Tabla 7 describe el código de estado.
Código de estado |
Descripción |
---|---|
200 |
Se han consultado los detalles del clúster. |
Consulte Códigos de estado.
Códigos de error
Consulte Códigos de error.