描述叢集 - AWS ParallelCluster

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

描述叢集

取得現有叢集的詳細資訊。

請求語法

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

請求內文

叢集名稱

叢集的名稱。

類型:字串

必要:是

region

叢集所在的。 AWS 區域

類型:字串

必要:否

回應語法

注意

failureReason已更改為failures從 AWS ParallelCluster 版本 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", "scheme": "string", "healthyNodes": integer, "unhealthyNodes": integer } }

回應內文

叢集名稱

叢集的名稱。

類型:字串

cloudformationStackArn

主 CloudFormation 堆棧的 Amazon 資源名稱(ARN)。

類型:字串

cloudformationStackStatus

CloudFormation 堆疊狀態。

類型:字串

有效值: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

叢集配置
url

叢集配置檔案的 URL。

類型:字串

叢集狀態

叢集狀態。

類型:字串

有效值:CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED

computeFleetStatus

運算叢集狀態。

類型:字串

有效值:START_REQUESTED | STARTING | RUNNING | PROTECTED | STOP_REQUESTED | STOPPING | STOPPED | UNKNOWN | ENABLED | DISABLED

creationTime

建立叢集時的時間戳記。

類型:日期時間

lastUpdatedTime

上次更新叢集時的時間戳記。

類型:日期時間

region

在中建立叢集的。 AWS 區域

類型:字串

標籤

與叢集相關聯的標籤清單。

金錀

標籤名稱。

類型:字串

標籤

標籤值。

類型:字串

version

用來建立叢集的 AWS ParallelCluster 版本。

類型:字串

failures

叢集堆疊處於CREATE_FAILED狀態時的失敗清單。

失敗代碼

叢集堆疊處於CREATE_FAILED狀態時的失敗代碼。

類型:字串

失敗原因

叢集堆疊處於CREATE_FAILED狀態時失敗的原因。

類型:字串

頭節點

叢集頭節點。

instanceId

亞馬遜 EC2 執行個體識別碼。

類型:字串

instanceType

Amazon EC2 實例類型。

類型:字串

launchTime

啟動亞馬遜 EC2 執行個體的時間。

類型:日期時間

privateIpAddress

叢集私有 IP 位址。

類型:字串

publicIpAddress

叢集公用 IP 位址。

類型:字串

state

頭節點實例狀態。

類型:字串

有效值:pending | running | shutting-down | terminated | stopping | stopped

排程器
中繼資料

排程器中繼資料。

name

排程器的名稱。

類型:字串

version

排程器版本。

類型:字串

登入節點
status

登錄節點的狀態。

類型:字串

有效值:PENDING | FAILED | ACTIVE

address

登入節點位址。

類型:字串

結構描述

登錄節點配置。

類型:字串

結構描述

健全狀況節點的數目。

類型:整數

結構描述

運作狀態不良的節點數目。

類型:整數

type

排程器類型。

類型:字串

範例

Python

請求

$ describe_cluster(cluster_name_3x)

二百個回應

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