describeClusterInstances

Describe las instancias que pertenecen a un clúster.

Sintaxis de la solicitud

GET /v3/clusters/{clusterName}/instances
{
  "nextToken": "string",
  "nodeType": "string",
  "queueName": "string",
  "region": "string"
}

Cuerpo de la solicitud

clusterName

El nombre del clúster.

Tipo: String

Obligatorio: sí

nextToken

Un token que se usa para las solicitudes paginadas.

Tipo: String

Obligatorio: no

nodeType

Filtra las instancias por tipo de nodo.

Tipo: String

Valores válidos: HeadNode, ComputeNode, LoginNode

Obligatorio: no

queueName

Filtra las instancias por nombre de cola.

Tipo: String

Obligatorio: no

region

La Región de AWS en la que se encuentra el clúster.

Tipo: String

Obligatorio: no

Sintaxis de la respuesta

{
  "nextToken": "string",
  "instances": [
    {
      "instanceId": "string",
      "instanceType": "string",
      "launchTime": "2019-08-24T14:15:22Z",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "state": "pending",
      "nodeType": "HeadNode",
      "queueName": "string"
    }
  ]
}

Cuerpo de respuesta

instances

La lista de instancias del clúster.

instanceId

El identificador de la instancia de EC2.

Tipo: String

instanceType

El tipo de instancia de EC2.

Tipo: String

launchTime

La hora en que se lanzó la instancia de EC2.

Tipo: datetime

nodeType

El tipo de nodo.

Tipo: String

Valores válidos: HeadNode, ComputeNode, LoginNode

publicIpAddress

La dirección IP pública del clúster.

Tipo: String

queueName

El nombre de la cola en la que la instancia de EC2 está respaldando un nodo.

Tipo: String

estado

El estado de la instancia de EC2 del nodo.

Tipo: String

Valores válidos: pending | running | shutting-down | terminated | stopping | stopped

nextToken

Un token que se usa para las solicitudes paginadas.

Tipo: String

Ejemplo

Python

Solicitud

$ describe_cluster_instances(cluster_name_3x)

Respuesta 200

{
  'instances': [
    {
      'instance_id': 'i-abcdef01234567890',
      'instance_type': 't2.micro',
      'launch_time': datetime.datetime(2022, 3, 30, 14, 2, 7, tzinfo=tzlocal()),
      'node_type': 'HeadNode',
      'private_ip_address': '192.0.2.5',
      'public_ip_address': '198.51.100.180',
      'state': 'running'
    }
  ]
}