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
GET /v1.1/{project_id}/cluster_infos/{cluster_id}

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

**Tabla 2** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
cluster	Cluster object	Parámetros de clúster. Para obtener más información, consulte Tabla 3.

**Tabla 3** Parámetros de respuesta
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: Starting: se está iniciando el clúster. running: el clúster se está ejecutando. Terminated: el clúster se ha terminado. failed: el clúster falla. abnormal: el clúster es anormal. terminating: se está terminando el clúster. frozen: el clúster se ha congelado. Scaling-out: el clúster se está escalando horizontalmente. Scaling-in: el clúster se está reduciendo.
stageDesc	String	Descripción del progreso de la operación de clúster. El progreso de la instalación del clúster incluye: Verificación de los parámetros del clúster: se están verificando los parámetros del clúster. Aplicación de recursos de clúster: se están aplicando recursos de clúster. Creación de máquinas virtuales: se están creando las máquinas virtuales. Inicialización de máquinas virtuales: se están inicializando las máquinas virtuales. Instalación de MRS Manager: se está instalando MRS Manager. Despliegue del clúster: se está desplegando el clúster. Error en la instalación del clúster: error al instalar el clúster. El progreso de ampliación de los grupos incluye: Preparación para la ampliación: se está preparando la ampliación de clúster. Creación de máquinas virtuales: se están creando las máquinas virtuales. Inicialización de máquinas virtuales: se están inicializando las máquinas virtuales. Adición de nodos al clúster: los nodos se están agregando al clúster. Error de ampliación: error al escalar el clúster. El progreso de la reducción del clúster incluye: Preparación para la reducción: Se está preparando la reducción de clústeres. Instancia en desmantelamiento: La instancia se está desmantelando. Eliminación de máquinas virtuales: se están eliminando las máquinas virtuales. Eliminación de nodos del clúster: se eliminan los nodos del clúster. Error de reducción: error al reducir el clúster. 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 0: clúster normal 1: clúster de seguridad
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. true: La instalación de MRS Manager ha finalizado. false: La instalación de MRS Manager no ha finalizado.
clusterType	Integer	Tipo de clúster
logCollection	Integer	Si se recopilan registros cuando se produce un error en la instalación del clúster 0 No recoger. 1: Recoger.
periodType	Integer	Si el tipo de suscripción es anual o mensual 0: suscripción mensual 1: suscripción anual
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: Scaling-out: el clúster se está escalando horizontalmente. Scaling-in: el clúster se está reduciendo. scaling-error: El clúster está en el estado de ejecución y no se puede ampliar o reducir o las especificaciones no se pueden escalar por última vez. scaling-up: Las especificaciones del nodo Master se están ampliando. scaling_up_first: Las especificaciones del nodo Master en espera se están ampliando. scaled_up_first: Las especificaciones del nodo Master en espera se han ampliado con éxito. scaled-up-success Las especificaciones del nodo master se han ampliado.
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.

**Tabla 4** componentAmb
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

**Tabla 5** NodeGroupV10
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. SATA: E/S común SAS: E/S alta SSD: E/S ultra alta
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

**Tabla 6** BootstrapScripts
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. Ruta del bucket OBS: Ingrese una ruta de script manualmente. Por ejemplo, ingrese la ruta del script de muestra público proporcionado por MRS. Ejemplo: s3a://bootstrap/presto/presto-install.sh. Si dualroles está instalado, el parámetro del script de presto-install.sh es dualroles. Si worker está instalado, el parámetro de script de presto-install.sh es worker. Basado en el hábito de uso de Presto, se recomienda instalar dualroles en los nodos Master activos y worker en los nodos Core. Ruta de acceso de VM local: introduzca una ruta de acceso de script. La ruta de acceso del script debe comenzar con una barra diagonal (/) y terminar con .sh.
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. continue: Continuar para ejecutar scripts subsiguientes. errorout: detener la acción. 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 PENDING IN_PROGRESS SUCCESS FAILURE
action_stages	Array of strings	Seleccione la hora a la que se ejecuta el script de acción de arranque. BEFORE_COMPONENT_FIRST_START: antes de que comience el componente inicial AFTER_COMPONENT_FIRST_START: después de que comience el componente inicial BEFORE_SCALE_IN: antes de reducir AFTER_SCALE_IN: después de reducir BEFORE_SCALE_OUT: antes de escalar horizontalmente after_scale_out: después de escalar horizontalmente

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.

**Tabla 7** 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.