Operations

Küme düğümlerini alma

GET /clusters/{cluster}/nodes

Parameters

Type	Name	Description	Schema
Path	cluster required	Sorguya bağlanacak küme	string
Query	operation optional	Verilirse, yalnızca bu işlem kimliği için düğümleri döndürür ve gövdede işlem özniteliğini içerir	string
Query	request_id optional	Verilirse, yalnızca bu istek kimliğiyle tanımlanan işlemin düğümlerini döndürür. ve gövdedeki işlem özniteliğini içerir	string

Responses

HTTP Code	Description	Schema
200	OK	NodeList
400	Invalid specification	No Content
404	Not found	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/nodes

Örnek HTTP yanıtı

Response 200

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

Küme düğümleri oluşturma

POST /clusters/{cluster}/nodes/create

Description

Bu işlem bir düğüm dizisinden kümeye yeni düğümler ekler. Tek bir çağrıda birden çok düğüm tanımını kabul eder. İşlemin durumunu izlemek için kullanabileceğiniz işlemin URL'sini döndürür.

Parameters

Type	Name	Description	Schema
Path	cluster required	Düğümlerin ekleneceği küme	string
Body	nodes required	Oluşturulacak düğüm kümeleri	NodeCreationRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (dize) : İşlemin URL'si.	NodeCreationResult
409	Invalid input	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/nodes/create

Request body

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

Örnek HTTP yanıtı

Response 202

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

Küme düğümlerini serbest bırakma

POST /clusters/{cluster}/nodes/deallocate

Description

Bu işlem bir kümedeki düğümleri serbest bırakıyor. Düğüm adı, düğüm kimliği veya filtre gibi çeşitli yöntemler kullanarak düğümleri tanımlayabilirsiniz.

Parameters

Type	Name	Description	Schema
Path	cluster required	Düğümleri serbest bırakmak istediğiniz küme	string
Body	action required	Hangi düğümlerin serbest bırakıldığına ait açıklama	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (dize) : İşlemin URL'si.	NodeManagementResult
409	Invalid input	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/nodes/deallocate

Request body

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

Örnek HTTP yanıtı

Response 202

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

Küme düğümlerini sonlandırma ve kaldırma

POST /clusters/{cluster}/nodes/remove

Description

Bu işlem bir kümedeki düğümleri kaldırır. Düğümleri düğüm adı, düğüm kimliği gibi çeşitli yollarla veya filtre kullanarak tanımlayabilirsiniz. Varsayılan olarak, düğüm özelliği olarak ayarlanmadığı truesürece düğümler Fixed sonlandırıldığında kaldırılır. Bu durumda, bu çağrı sonlandırma olarak aynı şekilde davranır.

Parameters

Type	Name	Description	Schema
Path	cluster required	Düğümleri kaldırmak istediğiniz küme	string
Body	action required	Kaldırılacak düğümlerin açıklaması	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (dize) : İşlemin URL'si.	NodeManagementResult
409	Invalid input	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/nodes/remove

Request body

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

Örnek HTTP yanıtı

Response 202

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

Küme düğümlerini sonlandırma veya serbest bırakma

POST /clusters/{cluster}/nodes/shutdown

Description

Bu işlem bir kümedeki düğümleri sonlandırır veya serbest tutar. İşlem, eylemi belirlemek için her düğümde özniteliğini kullanır ShutdownPolicy . Öznitelik (varsayılan) olarak ayarlanırsa Terminate işlem düğümü sonlandırır. özniteliği olarak ayarlanırsa Deallocate, işlem düğümü serbest bıraktır.

Parameters

Type	Name	Description	Schema
Path	cluster required	Düğümleri kapatmak istediğiniz küme	string
Body	action required	Kapatılan düğümlerin açıklaması	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (dize) : İşlemin URL'si.	NodeManagementResult
409	Invalid input	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/nodes/shutdown

Request body

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

Örnek HTTP yanıtı

Response 202

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

Serbest bırakılmış veya sonlandırılan küme düğümlerini başlatma

POST /clusters/{cluster}/nodes/start

Description

Bu işlem bir kümedeki düğümleri başlatır. Düğümleri düğüm adına, düğüm kimliğine göre veya filtre kullanarak tanımlayabilirsiniz.

Parameters

Type	Name	Description	Schema
Path	cluster required	Düğümleri başlatacak küme	string
Body	action required	Hangi düğümlerin başlatıldığına ait açıklama	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (dize) : İşlemin URL'si.	NodeManagementResult
409	Invalid input	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/nodes/start

Request body

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

Örnek HTTP yanıtı

Response 202

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

Küme düğümlerini sonlandırma

POST /clusters/{cluster}/nodes/terminate

Description

Bu işlem bir kümedeki düğümleri sonlandırır. Düğümleri düğüm adı, düğüm kimliği gibi çeşitli yollarla veya filtre kullanarak tanımlayabilirsiniz.

Parameters

Type	Name	Description	Schema
Path	cluster required	Düğümleri sonlandırmak istediğiniz küme	string
Body	action required	Sonlandırılan düğümlerin açıklaması	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (dize) : İşlemin URL'si.	NodeManagementResult
409	Invalid input	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/nodes/terminate

Request body

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

Örnek HTTP yanıtı

Response 202

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

Kümeyi boyuta ölçeklendirme

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

Description

Bu işlem, toplam sayıya ulaşmak için düğüm dizisine gerektiğinde düğüm ekler. Küme isteği bir kez işler. Daha sonra numarayı korumak için düğümleri yeniden eklemez. Toplam çekirdeklere veya toplam düğümlere göre ölçeklendirin, ancak her ikisini birden ölçeklendiremezsiniz. İşlem, işlemin durumunu izlemek için kullanılacak URL'yi döndürür.

Parameters

Type	Name	Description	Schema
Path	cluster required	Düğümlerin ekleneceği küme	string
Path	nodearray required	Düğümlerin ekleneceği düğüm dizisi	string
Query	totalCoreCount optional	Önceden oluşturduğunuz düğümler de dahil olmak üzere bu düğüm dizisindeki toplam çekirdek sayısı	integer
Query	totalNodeCount optional	Önceden oluşturduğunuz düğümler de dahil olmak üzere bu düğüm dizisindeki toplam makine sayısı	integer

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (dize) : İşlemin URL'si.	NodeCreationResult
409	Invalid input	No Content

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/scale/NODEARRAY_NAME

Örnek HTTP yanıtı

Response 202

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

Küme durumunu alma

GET /clusters/{cluster}/status

Description

Bu işlem, bir kümedeki düğümler ve düğüm dizileri için bilgi döndürür. Her düğüm dizisi için, kullanabileceğiniz her ayırma "demetinin" durumunu döndürür. Durum, demette kaç düğüm olduğunu ve kaç düğüm ekleyebileceğinizi gösterir. Her demet, belirli bir donanım profiline sahip olası VM'lerden oluşan bir kümedir. Bu VM'leri bir müşteri hesabı altında belirli bir konumda oluşturabilirsiniz. Kullanıcının küme tanımı, düğüm dizisi için geçerli demetleri belirler. Sınırları bulut sağlayıcısı belirler.

Parameters

Type	Name	Description	Schema
Path	cluster required	Sorguya bağlanacak küme	string
Query	nodes optional	True ise, yanıt düğümleri ve düğüm başvurularını içerir	boolean

Responses

HTTP Code	Description	Schema
200	OK	ClusterStatus

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/status

Örnek HTTP yanıtı

Response 200

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

Küme için kullanım ve isteğe bağlı maliyet bilgilerini alma

GET /clusters/{cluster}/usage

Description

Bu işlem, küme için genel kullanım verileri (çekirdek saatler) ve varsa maliyet verilerinin yanı sıra düğüm başına dökümü döndürür. Varsayılan olarak, geçerli ayın kullanım değerini döndürür.

Parameters

Type	Name	Description	Schema
Path	cluster required	Kullanım verilerinin döndürüleceği küme	string
Query	timeframe optional	Sorgunun zaman aralığı. monthToDate geçerli ayın kullanımını, lastMonth ise önceki ayın kullanımını döndürür. weekToDate geçerli haftanın kullanımını döndürür (Pazar'dan itibaren). custom için 'from' ve 'to' sorgu parametreleri gerekir. Varsayılan değer MonthToDate'tır. Tüm saatler UTC cinsindendir.	enum (monthToDate, lastMonth, weekToDate, özel)
Query	from optional	Özel zaman çerçeveleri için, iso-8601 biçiminde zaman çerçevesinin başlangıcı. Değer en yakın saate veya güne yuvarlanır.	string
Query	to optional	Özel zaman çerçeveleri için iso-8601 biçiminde zaman çerçevesinin sonunu kullanın. Değer en yakın saate veya güne yuvarlanıyor.	string
Query	granularity optional	Verilerin nasıl top yapılacağını belirtir: saate göre, günlük olarak veya tek bir sayı olarak. Varsayılan değer günlük olarak ayarlanır.	sabit listesi (toplam, günlük, saatlik)

Responses

HTTP Code	Description	Schema
200	OK	ClusterUsage

Örnek HTTP isteği

Request path

/clusters/CLUSTER_NAME/usage

Örnek HTTP yanıtı

Response 200

{
  "usage" : [ "object" ]
}

İşlemlerin durumunu listeler

GET /operations/

Parameters

Type	Name	Description	Schema
Query	request_id optional	İşlemin istek kimliği. Bu kimliği sağlarsanız, listede sıfır veya bir öğe bulunur.	string

Responses

HTTP Code	Description	Schema
200	OK	< OperationStatus> array
400	Invalid request	No Content
404	Not found	No Content

Örnek HTTP isteği

Request path

/operations/

Örnek HTTP yanıtı

Response 200

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

Kimliğine göre işlem durumunu alır

GET /operations/{id}

Parameters

Type	Name	Description	Schema
Path	id required	İşlem kimliği	string

Responses

HTTP Code	Description	Schema
200	OK	OperationStatus
404	Not found	No Content

Örnek HTTP isteği

Request path

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

Örnek HTTP yanıtı

Response 200

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

Resources

ClusterStatus

Kümenin durumu.

Name	Description	Schema
maxCoreCount required	Bu kümeye ekleyebileceğiniz maksimum çekirdek sayısı. Example : `16`	integer
maxCount required	Bu kümeye ekleyebileceğiniz en fazla düğüm sayısı. Example : `4`	integer
nodearrays required	Example : `[ "object" ]`	< nodearrays> array
nodes optional	Bu kümedeki düğümlerin isteğe bağlı bir listesi. Yanıt bu listeyi yalnızca sorguda ayarlarsanız `nodes=true` içerir. Example : `[ "[node](#node)" ]`	< Node> array
state optional	Küme en az bir kez başlatıldıysa, kümenin geçerli durumu Example : `"Starting"`	string
targetState optional	Kümenin istenen durumu (örneğin, Başlatıldı veya Sonlandırıldı) Example : `"Started"`	string

nodearrays

Name	Description	Schema
buckets required	Bu düğüm dizisi için her ayırma demeti. "Çekirdek sayısı" ayarları her zaman bu demet için çekirdek sayısının bir katıdır. Example : `[ "object" ]`	< buckets> array
maxCoreCount required	Bu düğüm dizisindeki çekirdek sayısı üst sınırı Example : `16`	integer
maxCount required	Bu düğüm dizisindeki en fazla düğüm sayısı Example : `4`	integer
name required	Düğüm dizisi adı Example : `"execute"`	string
nodearray required	Bu düğüm dizisinin öznitelikleri Example : `"[node](#node)"`	Node

buckets

Name	Description	Schema
activeCoreCount required	Bu düğüm dizisindeki bu demet için kullanılan çekirdek sayısı Example : `40`	integer
activeCount required	Bu düğüm dizisindeki bu demet için kullanılan düğüm sayısı. Bu sayı, vm almaya devam eden düğümleri içerir. Example : `10`	integer
activeNodes optional	Bu düğüm dizisindeki bu demet için kullanılan düğüm adları. Bu liste, vm almaya devam eden düğümleri içerir. Yanıt bu özelliği yalnızca sorgu içeriyorsa içerir `nodes=true`. Example : `[ "string" ]`	< dize > dizisi
availableCoreCount required	Bu demet ve düğüm dizisinde kaç ek çekirdek oluşturabileceğiniz. Bu değer her zaman öğesinin bir katıdır `availableCount`. Example : `8`	integer
availableCount required	Bu demet ve düğüm dizisinde kaç ek düğüm oluşturabileceğiniz. Bu değer, 'den çıkardığınızda `usedCount` elde ettiğiniz sayıdan `maxCount`küçük olabilir çünkü `maxCount` genel bir sınırı olabilir. Example : `2`	integer
bucketId required	Bu demetin tanımlayıcısı. Kümeyi silmediğiniz sürece bu değer düğüm dizisindeki belirli bir demet için aynı kalır. Example : `"00000000-0000-0000-0000-000000000000"`	string
consumedCoreCount required	Bu aile için bölgenin tamamında zaten kullanılmakta olan çekirdek sayısı. Example : `2`	integer
definition optional	Bu demetten düğüm oluşturmak için kullanılan bu demetin özellikleri. Create-node API'si bu tanımı özelliğinde `bucket` alır. Example : `"object"`	definition
familyConsumedCoreCount optional	Bu aile için bölgenin tamamında zaten kullanılmakta olan çekirdek sayısı. Example : `2`	integer
familyQuotaCoreCount optional	Bu bölgedeki bu aile için başlatabileceğiniz toplam çekirdek sayısı. Bu sayı quotaCount'un tamsayı katı olmayabilir. Example : `16`	integer
familyQuotaCount optional	familyQuotaCoreCount değerini ayarlarken başlatabileceğiniz toplam örnek sayısı. Example : `4`	integer
invalidReason required	Geçerli false ise, alan demetin geçersiz olmasının nedenini içerir. Şu anda tek nedeni NotActivated ve DisabledMachineType'tır. Example : `"DisabledMachineType"`	string
lastCapacityFailure required	Bu demeti en son ne zaman kapasite hatasıyla karşılaştığından bu yana saniye olarak ne kadar süreyle. Herhangi bir negatif değer hiçbir zaman olarak değerlendirilir. Example : `180.0`	number
maxCoreCount required	Genel ve nodearray sınırları dahil olmak üzere bu demette bulunabilecek maksimum çekirdek sayısı. Her zaman maxCount'un bir katı. Example : `16`	integer
maxCount required	Genel ve nodearray sınırları dahil olmak üzere bu demette bulunabilecek en fazla düğüm sayısı Example : `4`	integer
maxPlacementGroupCoreSize required	Bu demet için yerleştirme grubundaki toplam çekirdek sayısı üst sınırı. Her zaman bir katıdır `maxPlacementGroupSize`. Example : `64`	integer
maxPlacementGroupSize required	Bu demet için bir yerleştirme grubundaki toplam örnek sayısı üst sınırı. Example : `16`	integer
placementGroups required	Yerleştirme, varsa bu düğüm dizisi için kullanılan gruplardır. Example : `[ "object" ]`	< placementGroups> array
quotaCoreCount required	Bu bölgedeki bu aile için başlatabileceğiniz toplam çekirdek sayısı. Bu sayı bölgesel kota çekirdek sayısını da dikkate alır. Bu değer quotaCount değerinin tamsayı katı olmayabilir. Example : `16`	integer
quotaCount required	quotaCoreCount değeriyle başlatabileceğiniz toplam örnek sayısı. Example : `4`	integer
regionalConsumedCoreCount optional	Tüm bölgede zaten kullanımda olan çekirdek sayısı. Example : `2`	integer
regionalQuotaCoreCount optional	Bu bölgede başlatabileceğiniz toplam çekirdek sayısı. Bu sayı regionalQuotaCount'un tamsayı katı olmayabilir. Example : `16`	integer
regionalQuotaCount optional	Başlatabileceğiniz toplam örnek sayısı (regionalQuotaCoreCount verilen) Example : `4`	integer
valid required	True ise, bu demet yeni düğümler için kullanılacak geçerli bir demeti temsil eder. False ise, bu demet yalnızca mevcut düğümleri temsil eder. Example : `true`	boolean
virtualMachine required	Bu demetten başlattığınız sanal makinelerin özellikleri Example : `"object"`	virtualMachine

definition

Name	Description	Schema
machineType required	Sanal makinenin VM boyutu Example : `"A2"`	string

placementGroups

Name	Description	Schema
activeCoreCount required	Bu ölçek kümesindeki çekirdek sayısı Example : `16`	integer
activeCount required	Bu ölçek kümesindeki düğüm sayısı Example : `4`	integer
name required	Bu yerleştirme grubunun benzersiz tanımlayıcısı Example : `"my-placement-group"`	string

virtualMachine

Name	Description	Schema
gpuCount required	Bu makine türündeki GPU sayısı Example : `2`	integer
infiniband required	Bu sanal makine InfiniBand bağlantısını destekliyorsa Example : `true`	boolean
memory required	Bu sanal makinedeki RAM,GB cinsinden Example : `7.5`	number
pcpuCount required	Bu makine türünün sahip olduğu fiziksel CPU sayısı Example : `16`	integer
vcpuCount required	Bu makine türü için sanal CPU sayısı Example : `32`	integer
vcpuQuotaCount optional	Bu makinenin kotadan kullandığı vCPU sayısı Example : `2`	integer

ClusterUsage

Küme için kullanım ve isteğe bağlı maliyet bilgileri

Name	Description	Schema
usage required	Zaman aralığına göre kullanım listesi Example : `[ "object" ]`	< usage> array

usage

Name	Description	Schema
breakdown required	Bu aralıktaki kullanımın "node" ve "nodearray" kategorisine göre dökümü Example : `[ "[clusterusageitem](#clusterusageitem)" ]`	< ClusterUsageItem> array
end required	Aralığın sonu (özel) Example : `"string"`	string
start required	Aralığın başlangıcı (dahil) Example : `"string"`	string
total required	Bu kümenin bu aralıktaki genel kullanımı ve "küme" kategorisi Example : `"[clusterusageitem](#clusterusageitem)"`	ClusterUsageItem

ClusterUsageItem

Name	Description	Schema
category required	genel kullanım için "küme"; Tek bir dizi olmayan baş düğüm için "düğüm"; Tüm nodearray için "nodearray" Example : `"string"`	sabit listesi (küme, düğüm, nodearray)
cost optional	Bu kullanım için ABD doları cinsinden ve perakende fiyatlarla ücretlendirilecek tutar. Not: Tüm maliyet tutarları tahmindir ve gerçek faturayı yansıtmaz! Example : `0.0`	number
details optional	Saat sayısı, çekirdek sayısı, bölge önceliği ve işletim sistemi gibi bir nodearray tarafından kullanılan VM boyutunun ayrıntıları. Example : `[ "object" ]`	< details> array
hours required	Bu kategori için çekirdek saat kullanımı sayısı Example : `0.0`	number
node optional	Kullanımın olduğu düğümün veya düğüm dizisinin adı (küme düzeyinde veriler için yok) Example : `"string"`	string

details

Name	Description	Schema
core_count optional	Bu VM boyutundaki çekirdek sayısı Example : `0.0`	number
cost optional	Bu VM boyutunun maliyeti Example : `0.0`	number
hours optional	Bu VM boyutu için çekirdek saat kullanımı sayısı Example : `0.0`	number
os optional	İşletim sistemi türü Example : `"string"`	sabit listesi (Windows, Linux)
priority optional	VM Sku'sunun önceliği Example : `"string"`	sabit listesi (Normal, Nokta)
region optional	VM boyutunun örneğini oluşturduğunuz bölge Example : `"string"`	string
vm_size optional	VM Sku boyutu Example : `"string"`	string

Node

Düğüm kaydı.

Type : object

NodeCreationRequest

Kümeye düğümlerin nasıl ekleneceğini belirtir.

Name	Description	Schema
requestId optional	Ağ iletişim hataları durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Sunucu önceki bir istekle eşleşen bir `requestId` istek alırsa, isteği yoksayar ve 409 hatası döndürür. Example : `"00000000-0000-0000-0000-000000000000"`	string
sets required	Oluşturulacak düğüm tanımlarının listesi. İstek en az bir küme içermelidir. Her küme farklı bir özellik kümesi belirtebilir. Example : `[ "object" ]`	< sets> array

sets

Name	Description	Schema
count required	Oluşturulacak düğüm sayısı Example : `1`	integer
definition optional	Kullanılacak demetin tanımı. Küme durumu API çağrısı bu tanımı sağlar. Tanımda durum çağrısında veya demet özelliğinin tamamında verilen bazı öğeler eksikse, verilen öğelerle eşleşen ilk demet kullanılır. Example : `"object"`	definition
nameFormat optional	Bu değeri sağlarsanız düğümler standart `nodearray-%d` biçim yerine bu adlandırma kuralını kullanır Example : `"custom-name-%d"`	string
nameOffset optional	Bu özelliği ile `nameFormat`sağlarsanız, özelliği yeni düğümler için uzaklık gösterir `nodeindex` . Example : `1`	integer
nodeAttributes optional	Bu kümedeki her düğümde ayar için ek öznitelikler Example : `"[node](#node)"`	Node
nodearray required	Düğümleri başlatacak öğesinin `nodearray` adı Example : `"execute"`	string
placementGroupId optional	Bu özelliği sağlarsanız, tümü için `groupId` aynı değere sahip düğümler aynı yerleştirme grubunda başlar. Example : `"string"`	string

definition

Name	Description	Schema
machineType optional	Example : `"A2"`	string

NodeCreationResult

Name	Description	Schema
operationId required	İşlemin kimliği Example : `"00000000-0000-0000-0000-000000000000"`	string
sets required	İstektekiyle aynı sırada bir küme dizisi Example : `[ "object" ]`	< sets> array

sets

Name	Description	Schema
added required	Kümeye eklenecek düğüm sayısı Example : `1`	integer
message optional	Varsa sistemin neden tüm istenen düğümleri ekleyemediğini açıklar Example : `"string"`	string

NodeList

Düğüm aramasının sonuçları

Name	Description	Schema
nodes required	Sistemin döndürdüğü düğümler Example : `[ "[node](#node)" ]`	< Node> array
operation optional	Sorgu bir işlem kimliği içeriyorsa, bu alan bu işlemin durumunu gösterir Example : `"[operationstatus](#operationstatus)"`	OperationStatus

NodeManagementRequest

Bir kümedeki düğümlerde eylemlerin nasıl gerçekleştirileceklerini belirtir. Düğümleri birden çok şekilde belirtebilirsiniz. Birden fazla yol eklerseniz, istek belirtimi birleşim olarak kabul eder.

Name	Description	Schema
filter optional	Düğümler ile eşleşen bir filtre ifadesi. İfadedeki dizelerin düzgün tırnak içine alınması gerektiğini unutmayın. Example : `"State === \"Started\""`	string
hostnames optional	Yönetecek kısa konak adlarının listesi (etki alanı olmadan) Example : `[ "hostname1", "hostname2" ]`	< dize > dizisi
ids optional	Yönetecek düğüm kimliklerinin listesi Example : `[ "id1", "id2" ]`	< dize > dizisi
ip_addresses optional	Yönetecek IP adreslerinin listesi Example : `[ "10.0.1.1", "10.1.1.2" ]`	< dize > dizisi
names optional	Yönetecek düğüm adlarının listesi Example : `[ "name1", "name2" ]`	< dize > dizisi
requestId optional	Ağ iletişim hataları durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Sunucu önceki istek kimliğiyle eşleşen bir `requestId` istek alırsa, isteği yoksayar ve 409 hatası döndürür. Example : `"00000000-0000-0000-0000-000000000000"`	string

NodeManagementResult

Name	Description	Schema
nodes required	Yönetim isteğindeki filtreyle eşleşen her düğüm hakkında bilgi dizisi. Her düğümün durumu, isteğin bunu etkileyip etkilemediğini gösterir. Example : `[ "object" ]`	< nodes> array
operationId required	Bu işlemin kimliği Example : `"00000000-0000-0000-0000-000000000000"`	string

nodes

Name	Description	Schema
error optional	Durum Hata ise, hata iletisi Example : `"This node must be terminated before it can be removed"`	string
id required	Düğümün kimliği Example : `"id1"`	string
name required	Düğümün adı Example : `"name1"`	string
status optional	Tamam veya Hatadan Biri Example : `"Error"`	sabit listesi (Tamam, Hata)

OperationStatus

Düğüm işleminin durumu.

Name	Description	Schema
action required	Example : `"string"`	enum (create)
startTime required	İşlemi gönderdiğinizde Example : `"2020-01-01T12:34:56Z"`	string (date-time)

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-07-16

Aracılığıyla paylaş

Operations

Küme düğümlerini alma

Parameters

Responses

Örnek HTTP isteği

Request path

Örnek HTTP yanıtı

Response 200

Küme düğümleri oluşturma

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Request body

Örnek HTTP yanıtı

Response 202

Küme düğümlerini serbest bırakma

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Request body

Örnek HTTP yanıtı

Response 202

Küme düğümlerini sonlandırma ve kaldırma

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Request body

Örnek HTTP yanıtı

Response 202

Küme düğümlerini sonlandırma veya serbest bırakma

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Request body

Örnek HTTP yanıtı

Response 202

Serbest bırakılmış veya sonlandırılan küme düğümlerini başlatma

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Request body

Örnek HTTP yanıtı

Response 202

Küme düğümlerini sonlandırma

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Request body

Örnek HTTP yanıtı

Response 202

Kümeyi boyuta ölçeklendirme

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Örnek HTTP yanıtı

Response 202

Küme durumunu alma

Description

Parameters

Responses

Örnek HTTP isteği

Request path

Örnek HTTP yanıtı

Response 200

Küme için kullanım ve isteğe bağlı maliyet bilgilerini alma