다음을 통해 공유

작업

  • 아티클

클러스터 노드 가져오기

GET /clusters/{cluster}/nodes

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		쿼리할 클러스터 문자열
쿼리 작업
선택적		 지정된 경우 이 작업 ID의 노드만 반환하고 본문에 작업 특성을 포함합니다. 문자열
쿼리 request_id
선택적		 지정된 경우 이 요청 ID로 식별되는 작업에 대한 노드만 반환합니다.
본문에 작업 특성 포함		 문자열

응답

HTTP 코드 묘사 스키마
200 그래 nodeList
400 잘못된 사양 콘텐츠 없음
404 찾을 수 없음 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/nodes

HTTP 응답 예제

응답 200

{
  "nodes" : [ { } ],
  "operation" : {
    "action" : "string",
    "startTime" : "2020-01-01T12:34:56Z"
  }
}

클러스터 노드 만들기

POST /clusters/{cluster}/nodes/create

묘사

이 작업은 nodearray의 새 노드를 클러스터에 추가합니다. 단일 호출에서 여러 노드 정의를 허용합니다. 작업의 상태를 추적하는 데 사용할 수 있는 작업에 대한 URL을 반환합니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		노드를 추가할 클러스터 문자열
본문 노드
필요한 		만들 노드 집합 nodeCreationRequest

응답

HTTP 코드 묘사 스키마
202 허용
헤더:
Location(문자열) : 작업의 URL입니다.		 NodeCreationResult
409 잘못된 입력 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/nodes/create

요청 본문

{
  "requestId" : "00000000-0000-0000-0000-000000000000",
  "sets" : [ "object" ]
}

HTTP 응답 예제

응답 202

{
  "operationId" : "00000000-0000-0000-0000-000000000000",
  "sets" : [ "object" ]
}

클러스터 노드 할당 취소

POST /clusters/{cluster}/nodes/deallocate

묘사

이 작업은 클러스터의 노드 할당을 취소합니다. 노드 이름, 노드 ID 또는 필터를 비롯한 여러 가지 방법으로 노드를 식별할 수 있습니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		노드의 할당을 취소할 클러스터 문자열
본문 작업
필요한 		할당 취소할 노드에 대한 설명 NodeManagementRequest

응답

HTTP 코드 묘사 스키마
202 허용
헤더:
Location(문자열) : 작업의 URL입니다.		 NodeManagementResult
409 잘못된 입력 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/nodes/deallocate

요청 본문

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

HTTP 응답 예제

응답 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

클러스터 노드 종료 및 제거

POST /clusters/{cluster}/nodes/remove

묘사

이 작업은 클러스터의 노드를 제거합니다. 노드 이름, 노드 ID 또는 필터를 비롯한 여러 가지 방법으로 노드를 식별할 수 있습니다. 기본적으로 노드는 종료될 때 제거됩니다(노드가 true로 설정된 경우 제외). 이 경우 이 호출은 종료와 다르지 않습니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		에서 노드를 제거할 클러스터 문자열
본문 작업
필요한 		제거할 노드에 대한 설명 NodeManagementRequest

응답

HTTP 코드 묘사 스키마
202 허용
헤더:
Location(문자열) : 작업의 URL입니다.		 NodeManagementResult
409 잘못된 입력 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/nodes/remove

요청 본문

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

HTTP 응답 예제

응답 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

클러스터 노드 종료 또는 할당 취소

POST /clusters/{cluster}/nodes/shutdown

묘사

이 작업은 각 노드의 ShutdownPolicy 특성이 각각 Terminate(기본값) 또는 할당 취소인지에 따라 클러스터의 노드를 종료하거나 할당 취소합니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		노드를 종료할 클러스터 문자열
본문 작업
필요한 		종료할 노드에 대한 설명 NodeManagementRequest

응답

HTTP 코드 묘사 스키마
202 허용
헤더:
Location(문자열) : 작업의 URL입니다.		 NodeManagementResult
409 잘못된 입력 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/nodes/shutdown

요청 본문

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

HTTP 응답 예제

응답 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

할당 취소 또는 종료된 클러스터 노드 시작

POST /clusters/{cluster}/nodes/start

묘사

이 작업은 클러스터에서 노드를 시작합니다. 노드 이름, 노드 ID 또는 필터를 비롯한 여러 가지 방법으로 노드를 식별할 수 있습니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		노드를 시작할 클러스터 문자열
본문 작업
필요한 		시작할 노드에 대한 설명 NodeManagementRequest

응답

HTTP 코드 묘사 스키마
202 허용
헤더:
Location(문자열) : 작업의 URL입니다.		 NodeManagementResult
409 잘못된 입력 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/nodes/start

요청 본문

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

HTTP 응답 예제

응답 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

클러스터 노드 종료

POST /clusters/{cluster}/nodes/terminate

묘사

이 작업은 클러스터의 노드를 종료합니다. 노드 이름, 노드 ID 또는 필터를 비롯한 여러 가지 방법으로 노드를 식별할 수 있습니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		에서 노드를 종료할 클러스터 문자열
본문 작업
필요한 		종료할 노드에 대한 설명 NodeManagementRequest

응답

HTTP 코드 묘사 스키마
202 허용
헤더:
Location(문자열) : 작업의 URL입니다.		 NodeManagementResult
409 잘못된 입력 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/nodes/terminate

요청 본문

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

HTTP 응답 예제

응답 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

클러스터 크기를 조정합니다.

POST /clusters/{cluster}/scale/{nodearray}

묘사

이 작업은 노드 배열에 필요에 따라 노드를 추가하여 총 개수에 도달합니다. 요청은 한 번 처리되며 지정된 번호를 유지하기 위해 나중에 노드를 다시 추가하지 않습니다. 이는 총 코어 또는 총 노드로 크기가 조정되지만 둘 다 확장되지는 않습니다. 작업의 상태를 추적하는 데 사용할 수 있는 작업에 대한 URL을 반환합니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		노드를 추가할 클러스터 문자열
경로 nodearray
필요한 		노드를 추가할 nodearray 문자열
쿼리 totalCoreCount
선택적		 이미 생성된 노드를 포함하여 이 nodearray에 포함할 총 코어 수 정수
쿼리 totalNodeCount
선택적		 이미 만든 노드를 포함하여 이 nodearray에 포함할 총 컴퓨터 수 정수

응답

HTTP 코드 묘사 스키마
202 허용
헤더:
Location(문자열) : 작업의 URL입니다.		 NodeCreationResult
409 잘못된 입력 콘텐츠 없음

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/scale/NODEARRAY_NAME

HTTP 응답 예제

응답 202

{
  "operationId" : "00000000-0000-0000-0000-000000000000",
  "sets" : [ "object" ]
}

클러스터 상태 가져오기

GET /clusters/{cluster}/status

묘사

이 작업에는 지정된 클러스터의 노드 및 nodearray에 대한 정보가 포함됩니다. 각 nodearray에 대해 사용할 수 있는 할당의 각 "버킷" 상태(예: 버킷에 있는 노드 수, 추가할 수 있는 노드 수 등)를 반환합니다. 각 버킷은 지정된 하드웨어 프로필의 가능한 VM 집합으로, 지정된 위치, 지정된 고객 계정 등에서 만들 수 있습니다. nodearray에 대한 유효한 버킷은 사용자의 클러스터 정의에 따라 결정되지만 제한은 클라우드 공급자에 의해 부분적으로 결정됩니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		쿼리할 클러스터 문자열
쿼리 노드
선택적		 true이면 노드 및 노드 참조가 응답에 반환됩니다. 부울

응답

HTTP 코드 묘사 스키마
200 그래 ClusterStatus

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/status

HTTP 응답 예제

응답 200

{
  "maxCoreCount" : 16,
  "maxCount" : 4,
  "nodearrays" : [ "object" ],
  "nodes" : [ { } ],
  "state" : "Starting",
  "targetState" : "Started"
}

클러스터에 대한 사용량 및 선택적 비용 정보 가져오기

GET /clusters/{cluster}/usage

묘사

이 작업은 클러스터에 대한 전체 사용량 데이터(코어 시간) 및 비용 데이터(사용 가능한 경우)와 노드별 분석 데이터를 반환합니다. 기본적으로 현재 월의 사용량을 반환합니다.

매개 변수

형 이름 묘사 스키마
경로 클러스터
필요한 		사용량 현황 데이터를 반환할 클러스터 문자열
쿼리 기간
선택적		 지정된 경우 쿼리에 사용할 시간 범위를 지정합니다. monthToDate는 현재 월의 사용량을 반환하고 lastMonth는 이전 달의 사용량을 반환합니다. weekToDate는 현재 주(일요일부터 시작)의 사용량을 반환합니다. 사용자 지정을 사용하려면 'from' 및 'to' 쿼리 매개 변수가 필요합니다. 기본값은 MonthToDate입니다. 모든 시간은 UTC입니다. enum(monthToDate, lastMonth, weekToDate, custom)
쿼리
선택적		 사용자 지정 기간의 경우 ISO-8601 형식의 시간 프레임 시작입니다. 가장 가까운 시간 또는 일로 반올림됩니다. 문자열
쿼리
선택적		 사용자 지정 기간의 경우 ISO-8601 형식의 기간이 종료됩니다. 가장 가까운 시간 또는 일로 반올림됩니다. 문자열
쿼리 세분성
선택적		 데이터를 시간별, 매일 또는 단일 숫자로 집계하는 방법을 지정합니다. 이 기본값은 매일입니다. 열거형(합계, 일별, 매시간)

응답

HTTP 코드 묘사 스키마
200 그래 clusterUsage

HTTP 요청 예제

요청 경로

/clusters/CLUSTER_NAME/usage

HTTP 응답 예제

응답 200

{
  "usage" : [ "object" ]
}

작업 상태를 나열합니다.

GET /operations/

매개 변수

형 이름 묘사 스키마
쿼리 request_id
선택적		 작업에 대한 요청 ID입니다. 이 항목이 지정된 경우 목록에는 0개 또는 1개의 요소만 포함됩니다. 문자열

응답

HTTP 코드 묘사 스키마
200 그래 OperationStatus 배열
400 잘못된 요청 콘텐츠 없음
404 찾을 수 없음 콘텐츠 없음

HTTP 요청 예제

요청 경로

/operations/

HTTP 응답 예제

응답 200

[ {
  "action" : "string",
  "startTime" : "2020-01-01T12:34:56Z"
} ]

ID별로 작업 상태를 가져옵니다.

GET /operations/{id}

매개 변수

형 이름 묘사 스키마
경로 ID
필요한 		작업 ID 문자열

응답

HTTP 코드 묘사 스키마
200 그래 OperationStatus
404 찾을 수 없음 콘텐츠 없음

HTTP 요청 예제

요청 경로

/operations/00000000-0000-0000-0000-000000000000

HTTP 응답 예제

응답 200

{
  "action" : "string",
  "startTime" : "2020-01-01T12:34:56Z"
}

리소스

ClusterStatus

클러스터의 상태

이름 묘사 스키마
maxCoreCount
필요한 		이 클러스터에 추가할 수 있는 최대 코어 수
예제: 16		 정수
maxCount
필요한 		이 클러스터에 추가할 수 있는 최대 노드 수
예제: 4		 정수
nodearrays
필요한 		예제: [ "object" ] nodearrays 배열
노드
선택적		 이 클러스터에 있는 노드의 선택적 목록으로, nodes=true가 쿼리에 있는 경우에만 포함됩니다.
예제: [ "[node](#node)" ]		 < Node> 배열
상태
선택적		 클러스터가 한 번 이상 시작된 경우 클러스터의 현재 상태입니다.
예제: "Starting"		 문자열
targetState
선택적		 클러스터의 원하는 상태(예: 시작됨 또는 종료됨)
예제: "Started"		 문자열

nodearrays

이름 묘사 스키마
버킷
필요한 		이 nodearray에 대한 할당의 각 버킷입니다. "코어 수" 설정은 항상 이 버킷에 대한 코어 수의 배수입니다.
예제: [ "object" ]		 < 버킷> 배열
maxCoreCount
필요한 		이 nodearray에 있을 수 있는 최대 코어 수
예제: 16		 정수
maxCount
필요한 		이 nodearray에 있을 수 있는 최대 노드 수
예제: 4		 정수
이름
필요한 		설명하는 nodearray
예제: "execute"		 문자열
nodearray
필요한 		이 nodearray의 특성
예제: "[node](#node)"		 노드

버킷

이름 묘사 스키마
activeCoreCount
필요한 		이 nodearray에서 이 버킷에 사용 중인 코어 수
예제: 40		 정수
activeCount
필요한 		이 nodearray에서 이 버킷에 사용 중인 노드 수입니다. 여기에는 여전히 VM을 획득하는 노드가 포함됩니다.
예제: 10		 정수
activeNodes
선택적		 이 nodearray에서 이 버킷에 사용 중인 노드 이름입니다. 여기에는 여전히 VM을 획득하는 노드가 포함됩니다. 이는 nodes=true가 쿼리에 있는 경우에만 포함됩니다.
예제: [ "string" ]		 < 문자열 > 배열
availableCoreCount
필요한 		이 nodearray에서 이 버킷에 만들 수 있는 추가 코어 수입니다. 항상 availableCount의 배수입니다.
예제: 8		 정수
availableCount
필요한 		이 nodearray에서 이 버킷에 만들 수 있는 추가 노드 수입니다. maxCount는 전역적으로 제한될 수 있으므로 maxCount 및 usedCount에서 암시하는 것보다 적을 수 있습니다.
예제: 2		 정수
bucketId
필요한 		이 버킷의 식별자입니다. 클러스터가 삭제되지 않는 한 노드 배열에서 지정된 버킷에 대해 항상 동일한 값을 갖습니다.
예제: "00000000-0000-0000-0000-000000000000"		 문자열
consumedCoreCount
필요한 		전체 지역에서 이미 사용 중인 이 제품군의 코어 수입니다.
예제: 2		 정수
정의
선택적		 이 버킷에서 노드를 만드는 데 사용되는 이 버킷의 속성입니다. create-nodes API는 bucket 속성에서 이 정의를 사용합니다.
예제: "object"		 정의
familyConsumedCoreCount
선택적		 전체 지역에서 이미 사용 중인 이 제품군의 코어 수입니다.
예제: 2		 정수
familyQuotaCoreCount
선택적		 이 지역에서 이 제품군에 대해 시작할 수 있는 총 코어 수입니다. 할당량의 정수 배수가 아닐 수 있습니다.
예제: 16		 정수
familyQuotaCount
선택적		 시작할 수 있는 총 인스턴스 수(familyQuotaCoreCount가 지정된 경우)
예제: 4		 정수
invalidReason
필요한 		유효하지 않은 경우 버킷이 잘못된 이유가 포함됩니다. 현재 NotActivated 및 DisabledMachineType이 유일한 이유입니다.
예제: "DisabledMachineType"		 문자열
lastCapacityFailure
필요한 		이 버킷이 마지막으로 용량 오류가 발생한 이후의 시간(초)입니다. 음수 값은 절대로 처리되지 않습니다.
예제: 180.0		 수
maxCoreCount
필요한 		전역 및 nodearray 제한을 포함하여 이 버킷에 있을 수 있는 최대 코어 수입니다. 항상 maxCount의 배수입니다.
예제: 16		 정수
maxCount
필요한 		전역 및 nodearray 제한을 포함하여 이 버킷에 있을 수 있는 최대 노드 수
예제: 4		 정수
maxPlacementGroupCoreSize
필요한 		이 버킷의 배치 그룹에 있을 수 있는 최대 코어 수입니다. 항상 maxPlacementGroupSize의 배수입니다.
예제: 64		 정수
maxPlacementGroupSize
필요한 		이 버킷의 배치 그룹에 있을 수 있는 최대 총 인스턴스 수
예제: 16		 정수
placementGroups
필요한 		이 nodearray에 사용 중인 배치 그룹(있는 경우)입니다.
예제: [ "object" ]		 < placementGroups> 배열
quotaCoreCount
필요한 		지역 할당량 코어 수를 고려하여 이 지역에서 이 제품군에 대해 시작할 수 있는 총 코어 수입니다. 할당량의 정수 배수가 아닐 수 있습니다.
예제: 16		 정수
quotaCount
필요한 		시작할 수 있는 총 인스턴스 수(quotaCoreCount가 지정됨)
예제: 4		 정수
regionalConsumedCoreCount
선택적		 전체 지역에서 이미 사용 중인 코어 수입니다.
예제: 2		 정수
지역 QuotaCoreCount
선택적		 이 지역에서 시작할 수 있는 총 코어 수입니다. 지역별QuotaCount의 정수 배수가 아닐 수 있습니다.
예제: 16		 정수
지역 QuotaCount
선택적		 시작할 수 있는 총 인스턴스 수입니다(지역별QuotaCoreCount가 지정됨).
예제: 4		 정수
유효한
필요한 		true이면 이 버킷은 새 노드에 사용할 현재 유효한 버킷을 나타냅니다. false이면 이 버킷은 기존 노드만 나타냅니다.
예제: true		 부울
virtualMachine
필요한 		이 버킷에서 시작된 가상 머신의 속성
예제: "object"		 virtualMachine

정의

이름 묘사 스키마
machineType
필요한 		가상 머신의 VM 크기
예제: "A2"		 문자열

placementGroups

이름 묘사 스키마
activeCoreCount
필요한 		이 확장 집합에 있는 코어 수
예제: 16		 정수
activeCount
필요한 		이 확장 집합에 있는 노드 수
예제: 4		 정수
이름
필요한 		이 배치 그룹의 고유 식별자
예제: "my-placement-group"		 문자열

virtualMachine

이름 묘사 스키마
gpuCount
필요한 		이 컴퓨터 유형에 포함된 GPU 수
예제: 2		 정수
초기화
필요한 		이 가상 머신이 InfiniBand 연결을 지원하는 경우
예제: true		 부울
메모리
필요한 		이 가상 머신의 RAM(GB)
예제: 7.5		 수
pcpuCount
필요한 		이 컴퓨터 유형에 포함된 실제 CPU 수
예제: 16		 정수
vcpuCount
필요한 		이 컴퓨터 형식의 가상 CPU 수
예제: 32		 정수
vcpuQuotaCount
선택적		 이 컴퓨터가 할당량에서 사용하는 vCPU 수
예제: 2		 정수

ClusterUsage

클러스터에 대한 사용량 및 선택적 비용 정보

이름 묘사 스키마
사용량
필요한 		시간 간격별 사용량 목록
예제: [ "object" ]		 < 사용량> 배열

사용량

이름 묘사 스키마
분석
필요한 		"node" 및 "nodearray" 범주별 이 간격의 사용량 분석
예제: [ "[clusterusageitem](#clusterusageitem)" ]		 < ClusterUsageItem> 배열
끝
필요한 		간격의 끝(배타적)
예제: "string"		 문자열
시작
필요한 		간격의 시작 부분(포함)
예제: "string"		 문자열
총
필요한 		범주가 "클러스터"인 이 간격의 이 클러스터에 대한 전체 사용량
예제: "[clusterusageitem](#clusterusageitem)"		 clusterUsageItem

ClusterUsageItem

이름 묘사 스키마
범주
필요한 		전체 사용량에 대한 "cluster"; 단일 비 배열 헤드 노드에 대한 "node"; 전체 nodearray에 대한 "nodearray"
예제: "string"		 enum(클러스터, 노드, nodearray)
비용
선택적		 이 사용량에 대해 청구되는 금액(미국 달러 및 소매 요율)입니다. 참고: 모든 비용 금액은 예상 금액이며 실제 청구서를 반영하지 않습니다.
예제: 0.0		 수
세부 정보
선택적		 시간, core_count, 지역 우선 순위 및 운영 체제를 포함하여 nodearray에서 사용하는 VM 크기에 대한 세부 정보입니다.
예제: [ "object" ]		 < 세부 정보> 배열
시간
필요한 		이 범주에 대한 사용량의 코어 시간 수
예제: 0.0		 수
노드
선택적		 사용할 노드 또는 nodearray의 이름입니다(클러스터 수준 데이터에는 없음).
예제: "string"		 문자열

세부 정보

이름 묘사 스키마
core_count
선택적		 이 VM 크기의 코어 수
예제: 0.0		 수
비용
선택적		 이 VM 크기의 비용
예제: 0.0		 수
시간
선택적		 이 VM 크기에 대한 사용량의 코어 시간 수
예제: 0.0		 수
os
선택적		 운영 체제 유형
예제: "string"		 enum(Windows, Linux)
우선 순위
선택적		 VM SKU의 우선 순위
예제: "string"		 enum(Regular, Spot)
지역
선택적		 VM 크기가 인스턴스화된 지역
예제: "string"		 문자열
vm_size
선택적		 VM SKU 크기
예제: "string"		 문자열

노드

노드 레코드

Type : object

NodeCreationRequest

클러스터에 노드를 추가하는 방법을 지정합니다.

이름 묘사 스키마
requestId
선택적		 네트워크 통신 오류가 발생할 경우 중복 작업을 방지하기 위해 선택적으로 사용자가 제공한 고유 토큰입니다. 이 항목이 포함되고 이전 요청 ID와 일치하는 경우 서버는 이 요청을 무시하고 409 오류를 반환합니다.
예제: "00000000-0000-0000-0000-000000000000"		 문자열
집합
필요한 		만들 노드 정의 목록입니다. 요청에는 하나 이상의 집합이 포함되어야 합니다. 각 집합은 다른 속성 집합을 지정할 수 있습니다.
예제: [ "object" ]		 < > 배열을 설정합니다.

집합

이름 묘사 스키마
개수
필요한 		만들 노드 수
예제: 1		 정수
정의
선택적		 사용할 버킷의 정의입니다. 클러스터 상태 API 호출에서 제공합니다. 상태 호출에 지정된 항목 중 일부가 누락되었거나 전체 버킷 속성이 누락된 경우 지정된 항목과 일치하는 첫 번째 버킷이 사용됩니다.
예제: "object"		 정의
nameFormat
선택적		 지정된 경우 노드는 표준 "nodearray-%d" 형식 대신 이 명명 규칙을 사용합니다.
예제: "custom-name-%d"		 문자열
nameOffset
선택적		 nameFormat과 함께 지정된 경우 새 노드에 대한 nodeindex를 오프셋합니다.
예제: 1		 정수
nodeAttributes
선택적		 이 집합의 각 노드에서 설정할 추가 특성
예제: "[node](#node)"		 노드
nodearray
필요한 		노드를 시작할 nodearray의 이름입니다.
예제: "execute"		 문자열
placementGroupId
선택적		 지정된 경우 groupId에 대해 동일한 값을 가진 노드가 모두 동일한 배치 그룹에서 시작됩니다.
예제: "string"		 문자열

정의

이름 묘사 스키마
machineType
선택적		 예제: "A2" 문자열

NodeCreationResult

이름 묘사 스키마
operationId
필요한 		이 작업의 ID
예제: "00000000-0000-0000-0000-000000000000"		 문자열
집합
필요한 		요청과 동일한 순서로 집합 배열
예제: [ "object" ]		 < > 배열을 설정합니다.

집합

이름 묘사 스키마
추가된
필요한 		이 집합에서 시작된 노드 수
예제: 1		 정수
메시지
선택적		 요청된 모든 노드를 추가할 수 없는 이유(있는 경우)를 나타냅니다.
예제: "string"		 문자열

NodeList

노드 검색 결과

이름 묘사 스키마
노드
필요한 		반환된 노드
예제: [ "[node](#node)" ]		 < Node> 배열
작업
선택적		 쿼리에 작업 ID가 포함된 경우 해당 작업의 상태입니다.
예제: "[operationstatus](#operationstatus)"		 OperationStatus

NodeManagementRequest

클러스터의 노드에서 작업을 수행하는 방법을 지정합니다. 노드를 지정하는 방법에는 여러 가지가 있으며, 둘 이상의 방법이 포함된 경우 공용 구조체로 처리됩니다.

이름 묘사 스키마
필터
선택적		 노드와 일치하는 필터 식입니다. 식의 문자열은 제대로 따옴표로 묶어야 합니다.
예제: "State === \"Started\""		 문자열
호스트 이름
선택적		 관리할 짧은 호스트 이름 목록(도메인 없음)
예제: [ "hostname1", "hostname2" ]		 < 문자열 > 배열
id
선택적		 관리할 노드 ID 목록
예제: [ "id1", "id2" ]		 < 문자열 > 배열
ip_addresses
선택적		 관리할 IP 주소 목록
예제: [ "10.0.1.1", "10.1.1.2" ]		 < 문자열 > 배열
이름
선택적		 관리할 노드 이름 목록
예제: [ "name1", "name2" ]		 < 문자열 > 배열
requestId
선택적		 네트워크 통신 오류가 발생할 경우 중복 작업을 방지하기 위해 선택적으로 사용자가 제공한 고유 토큰입니다. 이 항목이 포함되고 이전 요청 ID와 일치하는 경우 서버는 이 요청을 무시하고 409 오류를 반환합니다.
예제: "00000000-0000-0000-0000-000000000000"		 문자열

NodeManagementResult

이름 묘사 스키마
노드
필요한 		관리 요청의 필터와 일치하는 각 노드에 대한 정보 배열입니다. 각 노드의 상태는 요청의 영향을 받았는지를 나타냅니다.
예제: [ "object" ]		 < 노드> 배열
operationId
필요한 		이 작업의 ID
예제: "00000000-0000-0000-0000-000000000000"		 문자열

노드

이름 묘사 스키마
오류
선택적		 상태가 오류인 경우 오류 메시지가 포함됩니다.
예제: "This node must be terminated before it can be removed"		 문자열
ID
필요한 		노드의 ID
예제: "id1"		 문자열
이름
필요한 		노드의 이름
예제: "name1"		 문자열
상태
선택적		 확인 또는 오류 중 하나
예제: "Error"		 enum(확인, 오류)

OperationStatus

이 노드 작업의 상태입니다.

이름 묘사 스키마
작업
필요한 		예제: "string" enum(만들기)
startTime
필요한 		이 작업이 제출된 경우
예제: "2020-01-01T12:34:56Z"		 string(date-time)