View a markdown version of this page

Beschreiben Sie den Cluster - AWS ParallelCluster
Erforderliche SyntaxAnforderungstextAntwortsyntaxAntworttextBeispiel

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Beschreiben Sie den Cluster

Holen Sie sich detaillierte Informationen zu einem vorhandenen Cluster.

Erforderliche Syntax

GET /v3/clusters/{clusterName}
{
  "region": "string"
}

Anforderungstext

Cluster-Name

Der Name des Clusters.

Type: Zeichenkette

Erforderlich: Ja

Region

Der AWS-Region , in dem sich der Cluster befindet.

Type: Zeichenkette

Erforderlich: Nein

Antwortsyntax

Anmerkung

failureReasonwurde auf failures AWS ParallelCluster Version 3.5.0 geändert.

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

Antworttext

Cluster-Name

Der Name des Clusters.

Type: Zeichenkette

Wolkenbildung StackArn

Der Amazon-Ressourcenname (ARN) des CloudFormation Hauptstapels.

Type: Zeichenkette

Wolkenbildung StackStatus

Der CloudFormation Stack-Status.

Type: Zeichenkette

Zulässige Werte: 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

Cluster-Konfiguration
URL

Die URL der Cluster-Konfigurationsdatei.

Type: Zeichenkette

Cluster-Status

Der Cluster-Status.

Type: Zeichenkette

Zulässige Werte: CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED

berechnen FleetStatus

Der berechnete Flottenstatus.

Type: Zeichenkette

Zulässige Werte: START_REQUESTED | STARTING | RUNNING | PROTECTED | STOP_REQUESTED | STOPPING | STOPPED | UNKNOWN | ENABLED | DISABLED

creationTime

Zeitstempel für die Erstellung des Clusters.

Typ: DateTime

zuletzt UpdatedTime

Zeitstempel für die letzte Aktualisierung des Clusters.

Typ: DateTime

Region

Der, AWS-Region in dem der Cluster erstellt wird.

Type: Zeichenkette

tags

Die Liste der Tags, die dem Cluster zugeordnet sind.

Schlüssel

Tag-Name.

Type: Zeichenkette

Tag (Markierung)

Tag-Wert.

Type: Zeichenkette

version

Die AWS ParallelCluster Version, die zum Erstellen des Clusters verwendet wird.

Type: Zeichenkette

failures

Die Liste der Fehler, wenn sich der Cluster-Stack im CREATE_FAILED Status befindet.

Fehlercode

Der Fehlercode, wenn sich der Cluster-Stack im CREATE_FAILED Status befindet.

Type: Zeichenkette

Grund des Fehlers

Der Grund für den Ausfall, wenn sich der Cluster-Stack im Status befindet. CREATE_FAILED

Type: Zeichenkette

head_node

Der Cluster-Kopfknoten.

instanceId

Die Amazon EC2-Instanz-ID.

Type: Zeichenkette

instanceType

Der Amazon EC2-Instanztyp.

Type: Zeichenkette

launchTime

Der Zeitpunkt, zu dem die Amazon EC2-Instance gestartet wurde.

Typ: DateTime

privat IpAddress

Die private IP-Adresse des Clusters.

Type: Zeichenkette

öffentlich IpAddress

Die öffentliche IP-Adresse des Clusters.

Type: Zeichenkette

state

Der Instanzstatus des Hauptknotens.

Type: Zeichenkette

Zulässige Werte: pending | running | shutting-down | terminated | stopping | stopped

Scheduler
Metadaten

Die Scheduler-Metadaten.

Name

Der Name des Schedulers.

Type: Zeichenkette

version

Die Scheduler-Version.

Type: Zeichenkette

LoginNodes
Status

Der Status des Anmeldeknotens.

Type: Zeichenkette

Zulässige Werte: PENDING | FAILED | ACTIVE

address

Die Adresse des Anmeldeknotens.

Type: Zeichenkette

Poolname

Der Poolname des Anmeldeknotens.

Type: Zeichenkette

scheme

Das Anmeldeknotenschema.

Type: Zeichenkette

HealthyNodes

Die Anzahl der gesunden Knoten.

Typ: Ganzzahl

Ungesunde Knoten

Die Anzahl der fehlerhaften Knoten.

Typ: Ganzzahl

type

Der Scheduler-Typ.

Type: Zeichenkette

Beispiel

Python

Anforderung

$ describe_cluster(cluster_name_3x)

200 Antwort 

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