Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
describeCluster
Obtenga información detallada sobre un clúster existente.
Temas
Sintaxis de la solicitud
GET /v3/clusters/{clusterName
}
{
"region": "string"
}
Cuerpo de la solicitud
- clusterName
-
El nombre del clúster.
Tipo: cadena
Obligatorio: sí
- región
-
La Región de AWS en la que se encuentra el clúster.
Tipo: cadena
Requerido: no
Sintaxis de la respuesta
nota
failureReason
ha cambiado a failures
a partir de AWS ParallelCluster versión 3.5.0.
{
"clusterName": "string",
"region": "string",
"version": "string",
"cloudFormationStackStatus": "CREATE_IN_PROGRESS",
"clusterStatus": "CREATE_IN_PROGRESS",
"scheduler": {
"type": "string",
"metadata": {
"name": "string",
"version": "string"
}
},
"cloudformationStackArn": "string",
"creationTime": "2019-08-24T14:15:22Z",
"lastUpdatedTime": "2019-08-24T14:15:22Z",
"clusterConfiguration": {
"url": "string"
},
"computeFleetStatus": "START_REQUESTED",
"tags": [
{
"key": "string",
"value": "string"
}
],
"headNode": {
"instanceId": "string",
"instanceType": "string",
"launchTime": "2019-08-24T14:15:22Z",
"privateIpAddress": "string",
"publicIpAddress": "string",
"state": "pending"
},
"failures": [
{
"failureCode": "string",
"failureReason": "string"
}
]
"loginNodes": {
"status": "string",
"address": "string",
"poolName": "string",
"scheme": "string",
"healthyNodes": integer,
"unhealthyNodes": integer
}
}
Cuerpo de respuesta
- clusterName
-
El nombre del clúster.
Tipo: cadena
- cloudformationStackArn
-
El nombre de recurso de Amazon (ARN) de la pila principal de CloudFormation.
Tipo: cadena
- cloudformationStackStatus
-
El estado de la pila de CloudFormation.
Tipo: cadena
Valores válidos:
CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE
- clusterConfiguration
-
- url
-
La URL del archivo de configuración del clúster.
Tipo: cadena
- clusterStatus
-
El estado del clúster.
Tipo: cadena
Valores válidos:
CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED
- computeFleetStatus
-
El estado de la flota de computación.
Tipo: cadena
Valores válidos:
START_REQUESTED | STARTING | RUNNING | PROTECTED | STOP_REQUESTED | STOPPING | STOPPED | UNKNOWN | ENABLED | DISABLED
- creationTime
-
Marca de tiempo de la creación del clúster.
Tipo: datetime
- lastUpdatedTime
-
Marca de tiempo de la última actualización del clúster.
Tipo: datetime
- región
-
La Región de AWS en la que se crea el clúster.
Tipo: cadena
- etiquetas
-
La lista de etiquetas asociadas al clúster.
- key
-
Nombre de la etiqueta.
Tipo: cadena
- etiqueta
-
Valor de la etiqueta.
Tipo: cadena
- versión
-
La versión de AWS ParallelCluster que se utiliza para crear el clúster.
Tipo: cadena
- failures
-
La lista de errores cuando la pila de clústeres está en estado
CREATE_FAILED
.- failureCode
-
El código de error cuando la pila de clústeres está en estado
CREATE_FAILED
.Tipo: cadena
- failureReason
-
El motivo del error cuando la pila de clústeres está en estado
CREATE_FAILED
.Tipo: cadena
- head_node
-
El nodo principal del clúster.
- instanceId
-
ID de instancia de Amazon EC2.
Tipo: cadena
- instanceType
-
El tipo de instancia de Amazon EC2.
Tipo: cadena
- launchTime
-
La hora en que se lanzó la instancia de Amazon EC2.
Tipo: datetime
- privateIpAddress
-
La dirección IP privada del clúster.
Tipo: cadena
- publicIpAddress
-
La dirección IP pública del clúster.
Tipo: cadena
- estado
-
El estado de la instancia de nodo principal.
Tipo: cadena
Valores válidos:
pending | running | shutting-down | terminated | stopping | stopped
- programador
-
- metadatos
-
Los metadatos del programador.
- name
-
El nombre del programador.
Tipo: cadena
- versión
-
La versión del programador.
Tipo: cadena
- loginNodes
-
- estado
-
El estado del nodo de inicio de sesión.
Tipo: cadena
Valores válidos:
PENDING | FAILED | ACTIVE
- address
-
La dirección del nodo de inicio de sesión.
Tipo: cadena
- poolName
-
El nombre del grupo de nodos de inicio de sesión.
Tipo: cadena
- scheme
-
El esquema del nodo de inicio de sesión.
Tipo: cadena
- healthyNodes
-
El número de nodos en buen estado.
Tipo: número entero
- unhealthyNodes
-
El número de nodos en mal estado.
Tipo: número entero
- type
-
El tipo de programador.
Tipo: cadena
Ejemplo
Solicitud
$
describe_cluster(
cluster_name_3x
)
Respuesta 200
{
'cloud_formation_stack_status': 'CREATE_COMPLETE',
'cloudformation_stack_arn': 'arn:aws:cloudformation:us-east-1:123456789012:stack/cluster_name_3x/16b49540-aee5-11ec-8e18-0ac1d712b241',
'cluster_configuration': {
'url': 'https://parallelcluster-....'
},
'cluster_name': 'cluster_name_3x',
'cluster_status': 'CREATE_COMPLETE',
'compute_fleet_status': 'RUNNING',
'creation_time': datetime.datetime(2022, 3, 28, 22, 19, 9, 661000, tzinfo=tzlocal()),
'head_node': {
'instance_id': 'i-abcdef01234567890',
'instance_type': 't2.micro',
'launch_time': datetime.datetime(2022, 3, 28, 22, 21, 56, tzinfo=tzlocal()),
'private_ip_address': '172.31.56.3',
'public_ip_address': '107.23.100.164',
'state': 'running'
},
'last_updated_time': datetime.datetime(2022, 3, 28, 22, 19, 9, 661000, tzinfo=tzlocal()),
'region': 'us-east-1',
'tags': [
{
'key': 'parallelcluster:version', 'value': '3.2.1'
}
],
'version': '3.2.1'
}