기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
describeClusterInstances
클러스터에 속하는 인스턴스를 설명합니다.
요청 구문
GET /v3/clusters/{clusterName}/instances
{
"nextToken": "string",
"nodeType": "string",
"queueName": "string",
"region": "string"
}요청 본문
- clusterName
-
클러스터의 이름입니다.
유형: 문자열
필수 항목 여부: 예
- nextToken
-
페이지가 매겨진 요청에 사용되는 토큰입니다.
유형: 문자열
필수 항목 여부: 아니요
- nodeType
-
노드 유형별로 인스턴스를 필터링합니다.
유형: 문자열
유효한 값:
HeadNode,ComputeNode,LoginNode필수 항목 여부: 아니요
- queueName
-
대기열 이름을 기준으로 인스턴스를 필터링합니다.
유형: 문자열
필수 항목 여부: 아니요
- region
-
클러스터가 속한 AWS 리전입니다.
유형: 문자열
필수사항: 아니요
응답 구문
{
"nextToken": "string",
"instances": [
{
"instanceId": "string",
"instanceType": "string",
"launchTime": "2019-08-24T14:15:22Z",
"privateIpAddress": "string",
"publicIpAddress": "string",
"state": "pending",
"nodeType": "HeadNode",
"queueName": "string",
"poolName": "string"
}
]
}응답 본문
- instances
-
클러스터 인스턴스 목록입니다입니다.
- instanceId
-
Amazon EC2 인스턴스 ID입니다.
유형: 문자열
- instanceType
-
Amazon EC2 인스턴스 유형
유형: 문자열
- launchTime
-
Amazon EC2 인스턴스가 시작된 시간입니다.
유형: 날짜/시간
- nodeType
-
노드 유형입니다.
유형: 문자열
유효한 값:
HeadNode,ComputeNode,LoginNode - publicIpAddress
-
클러스터 퍼블릭 IP 주소입니다.
유형: 문자열
- queueName
-
Amazon EC2 인스턴스가 노드를 지원하는 대기열의 이름입니다.
유형: 문자열
- state
-
노드 Amazon EC2 인스턴스 상태입니다.
유형: 문자열
유효값:
pending | running | shutting-down | terminated | stopping | stopped
- nextToken
-
페이지가 매겨진 요청에 사용되는 토큰입니다.
유형: 문자열
예제
요청
$describe_cluster_instances(cluster_name_3x)
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'
}
]
}