View a markdown version of this page

Beschreiben Sie 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 Cluster

Holen Sie sich detaillierte Informationen zu einem vorhandenen Cluster.

Erforderliche Syntax

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

Anforderungstext

Clustername

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 umgestellt.

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

Clustername

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

ClusterStatus

Der Clusterstatus.

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

Die Berechnung des 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 wurde.

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 wurde.

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 Fehler, wenn sich der Cluster-Stack im Status befindet. CREATE_FAILED

Type: Zeichenkette

head_node

Der Cluster-Kopfknoten.

instanceId

Die Amazon EC2 EC2-Instance-ID.

Type: Zeichenkette

instanceType

Der Amazon EC2 EC2-Instance-Typ.

Type: Zeichenkette

launchTime

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

Typ: DateTime

privat IpAddress

Die private Cluster-IP-Adresse.

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 Login-Knotens.

Type: Zeichenkette

Zulässige Werte: PENDING | FAILED | ACTIVE

address

Die Adresse des Anmeldeknotens.

Type: Zeichenkette

Pool-Name

Der Poolname des Anmeldeknotens.

Type: Zeichenkette

scheme

Das Anmeldeknotenschema.

Type: Zeichenkette

Gesunde Knoten

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