Operations

Fürtcsomópontok lekérése

GET /clusters/{cluster}/nodes

Parameters

Típus	Name	Description	Schema
Path	cluster required	A lekérdezendő fürt	karakterlánc
Query	operation optional	Ha meg van adva, csak a műveletazonosító csomópontjait adja vissza, és tartalmazza a törzs műveleti attribútumát	karakterlánc
Query	request_id optional	Ha meg van adva, csak a kérelemazonosító által azonosított művelet csomópontjait adja vissza, és tartalmazza a törzs műveleti attribútumát	karakterlánc

Responses

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

Példa HTTP-kérésre

Request path

/clusters/CLUSTER_NAME/nodes

Példa HTTP-válaszra

Response 200

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

Fürtcsomópontok létrehozása

POST /clusters/{cluster}/nodes/create

Description

Ez a művelet új csomópontokat ad hozzá egy csomóponttömbből egy fürthöz. Egyetlen hívásban több csomópontdefiníciót is elfogad. Visszaadja a művelet URL-címét, amellyel nyomon követheti a művelet állapotát.

Parameters

Típus	Name	Description	Schema
Path	cluster required	A csomópontokat hozzáadni kívánt fürt	karakterlánc
Body	nodes required	Létrehozandó csomópontkészletek	NodeCreationRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (karakterlánc): A művelet URL-címe.	NodeCreationResult
409	Invalid input	No Content

Példa HTTP-kérésre

Request path

/clusters/CLUSTER_NAME/nodes/create

Request body

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

Példa HTTP-válaszra

Response 202

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

Fürtcsomópontok felszabadítása

POST /clusters/{cluster}/nodes/deallocate

Description

Ez a művelet felszabadítja a csomópontokat egy fürtben. A csomópontokat többféle módszerrel is azonosíthatja, beleértve a csomópont nevét, a csomópont azonosítóját vagy egy szűrőt.

Parameters

Típus	Name	Description	Schema
Path	cluster required	Az a fürt, amelyben csomópontokat szeretne felszabadítani	karakterlánc
Body	action required	A felszabadítani kívánt csomópontok leírása	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (karakterlánc): A művelet URL-címe.	NodeManagementResult
409	Invalid input	No Content

Példa HTTP-kérésre

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

Példa HTTP-válaszra

Response 202

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

Fürtcsomópontok leállása és eltávolítása

POST /clusters/{cluster}/nodes/remove

Description

Ez a művelet eltávolítja a fürt csomópontjait. A csomópontokat többféleképpen is azonosíthatja, például a csomópont nevét, a csomópont azonosítóját vagy egy szűrőt. Alapértelmezés szerint a csomópontok el lesznek távolítva a leállított állapotban, kivéve, ha a csomópont tulajdonsága Fixed be van állítva true. Ebben az esetben ez a hívás ugyanúgy működik, mint a megszakítás.

Parameters

Típus	Name	Description	Schema
Path	cluster required	Az a fürt, ahol el szeretné távolítani a csomópontokat	karakterlánc
Body	action required	Az eltávolítandó csomópontok leírása	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (karakterlánc): A művelet URL-címe.	NodeManagementResult
409	Invalid input	No Content

Példa HTTP-kérésre

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

Példa HTTP-válaszra

Response 202

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

Fürtcsomópontok leállása vagy felszabadítása

POST /clusters/{cluster}/nodes/shutdown

Description

Ez a művelet leállítja vagy felszabadítja a fürt csomópontjait. A művelet az ShutdownPolicy egyes csomópontok attribútumával határozza meg a műveletet. Ha az attribútum Terminate értéke (alapértelmezett), a művelet leállítja a csomópontot. Ha az attribútum be van állítva Deallocate, a művelet felszabadítja a csomópontot.

Parameters

Típus	Name	Description	Schema
Path	cluster required	Az a fürt, ahol le szeretné állítani a csomópontokat	karakterlánc
Body	action required	A leállítandó csomópontok leírása	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (karakterlánc): A művelet URL-címe.	NodeManagementResult
409	Invalid input	No Content

Példa HTTP-kérésre

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

Példa HTTP-válaszra

Response 202

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

Felszabadított vagy leállított fürtcsomópontok indítása

POST /clusters/{cluster}/nodes/start

Description

Ez a művelet csomópontokat indít el egy fürtben. A csomópontokat csomópontnév, csomópontazonosító vagy szűrő használatával azonosíthatja.

Parameters

Típus	Name	Description	Schema
Path	cluster required	A csomópontok indítására kijelölt fürt	karakterlánc
Body	action required	Az elindítandó csomópontok leírása	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (karakterlánc): A művelet URL-címe.	NodeManagementResult
409	Invalid input	No Content

Példa HTTP-kérésre

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

Példa HTTP-válaszra

Response 202

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

Fürtcsomópontok leállása

POST /clusters/{cluster}/nodes/terminate

Description

Ez a művelet leállítja a fürt csomópontjait. A csomópontokat többféleképpen is azonosíthatja, például a csomópont nevét, a csomópont azonosítóját vagy egy szűrőt.

Parameters

Típus	Name	Description	Schema
Path	cluster required	Az a fürt, ahol le szeretné zárni a csomópontokat	karakterlánc
Body	action required	A megszüntetni kívánt csomópontok leírása	NodeManagementRequest

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (karakterlánc): A művelet URL-címe.	NodeManagementResult
409	Invalid input	No Content

Példa HTTP-kérésre

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

Példa HTTP-válaszra

Response 202

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

Fürt méretezése méretre

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

Description

Ez a művelet szükség szerint hozzáad csomópontokat egy csomóponttömbhöz a teljes szám eléréséhez. A fürt egyszer dolgozza fel a kérést. Később nem adja hozzá újra a csomópontokat a szám fenntartása érdekében. Az összes mag vagy az összes csomópont skálázható, de mindkettőt nem. A művelet a művelet állapotának nyomon követéséhez használandó URL-címet adja vissza.

Parameters

Típus	Name	Description	Schema
Path	cluster required	A csomópontokat hozzáadni kívánt fürt	karakterlánc
Path	nodearray required	Az a csomóponttömb, amelybe csomópontokat kíván hozzáadni	karakterlánc
Query	totalCoreCount optional	A csomóponttömb magjainak teljes száma, beleértve a már létrehozott csomópontokat is	egész szám
Query	totalNodeCount optional	A csomóponttömbben lévő gépek teljes száma, beleértve a már létrehozott csomópontokat is	egész szám

Responses

HTTP Code	Description	Schema
202	Accepted Headers : `Location` (karakterlánc): A művelet URL-címe.	NodeCreationResult
409	Invalid input	No Content

Példa HTTP-kérésre

Request path

/clusters/CLUSTER_NAME/scale/NODEARRAY_NAME

Példa HTTP-válaszra

Response 202

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

Fürt állapotának lekérése

GET /clusters/{cluster}/status

Description

Ez a művelet a fürt csomópontjaira és csomóponttömbjeire vonatkozó információkat adja vissza. Minden csomóponttömbhöz visszaadja a használható foglalás egyes "gyűjtőinek" állapotát. Az állapot azt mutatja, hogy hány csomópont található a gyűjtőben, és hány további csomópontot adhat hozzá. Minden gyűjtő egy adott hardverprofillal rendelkező lehetséges virtuális gépek készlete. Ezeket a virtuális gépeket egy adott helyen, egy ügyfélfiókban hozhatja létre. A felhasználó fürtdefiníciója határozza meg a csomóponttömb érvényes gyűjtőit. A felhőszolgáltató határozza meg a korlátokat.

Parameters

Típus	Name	Description	Schema
Path	cluster required	A lekérdezendő fürt	karakterlánc
Query	nodes optional	Ha igaz, a válasz csomópontokat és csomóponthivatkozásokat tartalmaz	boolean

Responses

HTTP Code	Description	Schema
200	OK	ClusterStatus

Példa HTTP-kérésre

Request path

/clusters/CLUSTER_NAME/status

Példa HTTP-válaszra

Response 200

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

A fürt használati és opcionális költségadatainak lekérése

GET /clusters/{cluster}/usage

Description

Ez a művelet a fürt általános használati adatait (alapórákat) és költségadatokat adja vissza, ha elérhető, valamint csomópontonkénti bontást. Alapértelmezés szerint az aktuális havi használati értéket adja vissza.

Parameters

Típus	Name	Description	Schema
Path	cluster required	A fürt, amely használati adatokat ad vissza a következőhöz:	karakterlánc
Query	timeframe optional	A lekérdezés időtartománya. A monthToDate az aktuális hónap használati adatait adja vissza, a lastMonth pedig az előző hónap használati adatait adja vissza. A weekToDate az aktuális hét (vasárnaptól kezdődő) használatát adja vissza. Az egyéni megköveteli a "from" és a "to" lekérdezési paramétereket. Az alapértelmezett a MonthToDate. Minden időpont a UTC időzónában van megadva.	enum (monthToDate, lastMonth, weekToDate, custom)
Query	from optional	Egyéni időkeretek esetén az időkeret kezdete ISO-8601 formátumban. Az érték le van kerekítve a legközelebbi órára vagy napra.	karakterlánc
Query	to optional	Egyéni időkeretek esetén használja az időkeret végét ISO-8601 formátumban. Az érték a legközelebbi órára vagy napra kerekül.	karakterlánc
Query	granularity optional	Megadja az adatok összesítésének módját: óránként, naponta vagy egyetlen számként. Az alapértelmezett érték napi.	enum (összesen, naponta, óránként)

Responses

HTTP Code	Description	Schema
200	OK	ClusterUsage

Példa HTTP-kérésre

Request path

/clusters/CLUSTER_NAME/usage

Példa HTTP-válaszra

Response 200

{
  "usage" : [ "object" ]
}

A műveletek állapotának felsorolása

GET /operations/

Parameters

Típus	Name	Description	Schema
Query	request_id optional	A művelet kérésazonosítója. Ha megadja ezt az azonosítót, a lista nulla vagy egy elemet tartalmaz.	karakterlánc

Responses

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

Példa HTTP-kérésre

Request path

/operations/

Példa HTTP-válaszra

Response 200

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

A művelet állapotának lekérdezése azonosító szerint

GET /operations/{id}

Parameters

Típus	Name	Description	Schema
Path	id required	A művelet azonosítója	karakterlánc

Responses

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

Példa HTTP-kérésre

Request path

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

Példa HTTP-válaszra

Response 200

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

Resources

ClusterStatus

A fürt állapota.

Name	Description	Schema
maxCoreCount required	A fürthöz hozzáadható magok maximális száma. Example : `16`	egész szám
maxCount required	A fürthöz hozzáadható csomópontok maximális száma. Example : `4`	egész szám
nodearrays required	Example : `[ "object" ]`	< nodearrays> array
nodes optional	A fürt csomópontjainak választható listája. A válasz csak akkor tartalmazza ezt a listát, ha be van állítva `nodes=true` a lekérdezésben. Example : `[ "[node](#node)" ]`	< Node> array
state optional	A fürt aktuális állapota, ha a fürt legalább egyszer elindult Example : `"Starting"`	karakterlánc
targetState optional	A fürt kívánt állapota (például Elindítva vagy Megszakítva) Example : `"Started"`	karakterlánc

nodearrays

Name	Description	Schema
buckets required	A csomóponttömb minden foglalási gyűjtője. A "magok száma" beállítás mindig a gyűjtő magszámának többszöröse. Example : `[ "object" ]`	< buckets> array
maxCoreCount required	A csomóponttömb magjainak maximális száma Example : `16`	egész szám
maxCount required	A csomóponttömb csomópontjainak maximális száma Example : `4`	egész szám
name required	A csomóponttömb neve Example : `"execute"`	karakterlánc
nodearray required	A csomóponttömb attribútumai Example : `"[node](#node)"`	Node

buckets

Name	Description	Schema
activeCoreCount required	A gyűjtőhöz használt magok száma ebben a csomóponttömbben Example : `40`	egész szám
activeCount required	A gyűjtőhöz használt csomópontok száma ebben a csomóponttömbben. Ez a szám olyan csomópontokat is tartalmaz, amelyek még mindig virtuális gépet szereznek be. Example : `10`	egész szám
activeNodes optional	A gyűjtőhöz használt csomópontnevek ebben a csomóponttömbben. Ez a lista olyan csomópontokat is tartalmaz, amelyek még mindig virtuális gépet szereznek be. A válasz csak akkor tartalmazza ezt a tulajdonságot, ha a lekérdezés tartalmaz `nodes=true`. Example : `[ "string" ]`	<sztringtömb >
availableCoreCount required	Hány további magot hozhat létre ebben a gyűjtő- és csomóponttömbben. Ez az érték mindig a többszöröse.`availableCount` Example : `8`	egész szám
availableCount required	Hány további csomópontot hozhat létre ebben a gyűjtőben és csomóponttömbben. Ez az érték kisebb lehet, mint a kivonáskor `usedCountmaxCount`kapott szám, mert `maxCount` lehet, hogy globális korlátja van. Example : `2`	egész szám
bucketId required	A gyűjtő azonosítója. Ez az érték ugyanaz marad egy csomóponttömb adott gyűjtője esetében, ha nem törli a fürtöt. Example : `"00000000-0000-0000-0000-000000000000"`	karakterlánc
consumedCoreCount required	A családhoz tartozó magok száma, amelyek már használatban vannak az egész régióban. Example : `2`	egész szám
definition optional	A gyűjtő tulajdonságai, amelyek csomópontok létrehozására szolgálnak ebből a gyűjtőből. A create-nodes API ezt a definíciót `bucket` a tulajdonságában használja. Example : `"object"`	definition
familyConsumedCoreCount optional	A családhoz tartozó magok száma, amelyek már használatban vannak az egész régióban. Example : `2`	egész szám
familyQuotaCoreCount optional	Az ebben a régióban a családhoz indítható teljes magok száma. Lehet, hogy ez a szám nem a quotaCount egész számának többszöröse. Example : `16`	egész szám
familyQuotaCount optional	A familyQuotaCoreCount beállításakor elindítható összes példány száma. Example : `4`	egész szám
invalidReason required	Ha az érvényesség hamis, a mező tartalmazza a gyűjtő érvénytelenségének okát. Jelenleg a NotActivated és a DisabledMachineType az egyetlen ok. Example : `"DisabledMachineType"`	karakterlánc
lastCapacityFailure required	Mennyi ideig, másodpercek alatt, mióta ez a gyűjtő legutóbb kapacitáshiba történt. A negatív értékek soha nem lesznek kezelve. Example : `180.0`	number
maxCoreCount required	Az ebben a gyűjtőben található magok maximális száma, beleértve a globális és csomóponti korlátokat is. Mindig a maxCount többszöröse. Example : `16`	egész szám
maxCount required	Az ebben a gyűjtőben található csomópontok maximális száma, beleértve a globális és csomóponti korlátokat Example : `4`	egész szám
maxPlacementGroupCoreSize required	A gyűjtő elhelyezési csoportjában lévő magok maximális teljes száma. Mindig a többszöröse.`maxPlacementGroupSize` Example : `64`	egész szám
maxPlacementGroupSize required	A gyűjtő elhelyezési csoportjában található példányok maximális száma. Example : `16`	egész szám
placementGroups required	A csomóponttömbhöz használt elhelyezési csoportok, ha vannak ilyenek. Example : `[ "object" ]`	< placementGroups> array
quotaCoreCount required	Az ebben a régióban a családhoz indítható teljes magok száma. Ez a szám a regionális kvótamagok számát is figyelembe veszi. Ez az érték nem lehet a quotaCount egész számának többszöröse. Example : `16`	egész szám
quotaCount required	Az összes elindítható példány száma a quotaCoreCount alapján. Example : `4`	egész szám
regionalConsumedCoreCount optional	A teljes régióban már használatban lévő magok száma. Example : `2`	egész szám
regionalQuotaCoreCount optional	Az ebben a régióban indítható magok száma. Ez a szám nem lehet a regionalQuotaCount egész számának többszöröse. Example : `16`	egész szám
regionalQuotaCount optional	Az összes elindítható példány száma (adott regionalQuotaCoreCount) Example : `4`	egész szám
valid required	Ha igaz, ez a gyűjtő egy jelenleg érvényes, új csomópontokhoz használható gyűjtőt jelöl. Ha hamis, ez a gyűjtő csak a meglévő csomópontokat jelöli. Example : `true`	boolean
virtualMachine required	Az ebből a gyűjtőből indított virtuális gépek tulajdonságai Example : `"object"`	virtualMachine

definition

Name	Description	Schema
machineType required	A virtuális gép virtuálisgép-mérete Example : `"A2"`	karakterlánc

placementGroups

Name	Description	Schema
activeCoreCount required	A méretezési csoportban lévő magok száma Example : `16`	egész szám
activeCount required	A méretezési csoportban lévő csomópontok száma Example : `4`	egész szám
name required	Az elhelyezési csoport egyedi azonosítója Example : `"my-placement-group"`	karakterlánc

virtualMachine

Name	Description	Schema
gpuCount required	A géptípushoz tartozó GPU-k száma Example : `2`	egész szám
infiniband required	Ha ez a virtuális gép támogatja az InfiniBand-kapcsolatot Example : `true`	boolean
memory required	A ram ebben a virtuális gépen, GB-ban Example : `7.5`	number
pcpuCount required	A géptípushoz tartozó fizikai PROCESSZORok száma Example : `16`	egész szám
vcpuCount required	Az ehhez a géptípushoz tartozó virtuális CPU-k száma Example : `32`	egész szám
vcpuQuotaCount optional	A gép által a kvótából használt vCPU-k száma Example : `2`	egész szám

ClusterUsage

A fürt használati és opcionális költségadatai

Name	Description	Schema
usage required	A használatok listája időintervallum szerint Example : `[ "object" ]`	< usage> array

usage

Name	Description	Schema
breakdown required	A használat lebontása ebben az intervallumban a "csomópont" és a "nodearray" kategória szerint Example : `[ "[clusterusageitem](#clusterusageitem)" ]`	< ClusterUsageItem> array
end required	Az intervallum vége (kizárólagos) Example : `"string"`	karakterlánc
start required	Az intervallum kezdete (beleértve) Example : `"string"`	karakterlánc
total required	A fürt általános használata ebben az intervallumban a "fürt" kategóriával Example : `"[clusterusageitem](#clusterusageitem)"`	ClusterUsageItem

ClusterUsageItem

Name	Description	Schema
category required	"fürt" az általános használathoz; "csomópont" egyetlen nem tömb főcsomóponthoz; "nodearray" egy teljes nodearray-hoz Example : `"string"`	enum (fürt, csomópont, csomópontarray)
cost optional	A használatért felszámítandó összeg amerikai dollárban és kiskereskedelmi áron. Megjegyzés: minden költségösszeg becslés, és nem tükrözi a tényleges számlát! Example : `0.0`	number
details optional	A csomópontarray által használt virtuálisgép-méret részletei, beleértve az órákat, a magok számát, a régió prioritását és az operációs rendszert. Example : `[ "object" ]`	< details> array
hours required	A kategória alaphasználati óráinak száma Example : `0.0`	number
node optional	Annak a csomópontnak vagy csomóponttömbnek a neve, amelyet a használat használ (fürtszintű adatok esetében hiányzik) Example : `"string"`	karakterlánc

details

Name	Description	Schema
core_count optional	Az ebben a virtuálisgép-méretben lévő magok száma Example : `0.0`	number
cost optional	A virtuális gép méretének költsége Example : `0.0`	number
hours optional	Az ehhez a virtuális gép méretéhez tartozó alaphasználati órák száma Example : `0.0`	number
os optional	Az operációs rendszer típusa Example : `"string"`	enum (Windows, Linux)
priority optional	A virtuálisgép-termékváltozat prioritása Example : `"string"`	enum (Normál, Direkt)
region optional	Az a régió, ahol a virtuális gép méretét példányosíthatja Example : `"string"`	karakterlánc
vm_size optional	Virtuálisgép-termékváltozat mérete Example : `"string"`	karakterlánc

Node

Csomópontrekord.

Type : object

NodeCreationRequest

Megadja, hogyan adhat hozzá csomópontokat egy fürthöz.

Name	Description	Schema
requestId optional	Nem kötelező, hogy a felhasználó által megadott egyedi jogkivonat megakadályozza az ismétlődő műveleteket hálózati kommunikációs hibák esetén. Ha a kiszolgáló egy korábbi kérésnek megfelelő kérést `requestId` kap, figyelmen kívül hagyja a kérést, és 409-et ad vissza. Example : `"00000000-0000-0000-0000-000000000000"`	karakterlánc
sets required	A létrehozni kívánt csomópontdefiníciók listája. A kérelemnek legalább egy készletet tartalmaznia kell. Mindegyik készlet különböző tulajdonságokat adhat meg. Example : `[ "object" ]`	< sets> array

sets

Name	Description	Schema
count required	A létrehozni kívánt csomópontok száma Example : `1`	egész szám
definition optional	A használni kívánt gyűjtő definíciója. A fürt állapotának API-hívása ezt a definíciót biztosítja. Ha a definícióból hiányzik néhány elem az állapothívásban vagy a teljes gyűjtőtulajdonságban, akkor a rendszer az első olyan gyűjtőt használja, amely megfelel az adott elemeknek. Example : `"object"`	definition
nameFormat optional	Ha megadja ezt az értéket, a csomópontok ezt az elnevezési konvenciót használják a szabványos `nodearray-%d` formátum helyett Example : `"custom-name-%d"`	karakterlánc
nameOffset optional	Ha ezt a tulajdonságot `nameFormat`adja meg, a tulajdonság eltolása `nodeindex` új csomópontok esetén. Example : `1`	egész szám
nodeAttributes optional	További attribútumok a készlet minden csomópontján Example : `"[node](#node)"`	Node
nodearray required	`nodearray` A csomópontok indításához Example : `"execute"`	karakterlánc
placementGroupId optional	Ha megadja ezt a tulajdonságot, a csomópontok azonos értékkel indulnak `groupId` el ugyanabban az elhelyezési csoportban. Example : `"string"`	karakterlánc

definition

Name	Description	Schema
machineType optional	Example : `"A2"`	karakterlánc

NodeCreationResult

Name	Description	Schema
operationId required	A művelet azonosítója Example : `"00000000-0000-0000-0000-000000000000"`	karakterlánc
sets required	Halmazok tömbje, a kérelemben megadott sorrendben Example : `[ "object" ]`	< sets> array

sets

Name	Description	Schema
added required	A készletbe felvenni kívánt csomópontok száma Example : `1`	egész szám
message optional	Ez a cikk azt ismerteti, hogy a rendszer miért nem tudja hozzáadni az összes kért csomópontot, ha van ilyen Example : `"string"`	karakterlánc

NodeList

Csomópontkeresés eredményei

Name	Description	Schema
nodes required	A rendszer által visszaadott csomópontok Example : `[ "[node](#node)" ]`	< Node> array
operation optional	Ha a lekérdezés tartalmaz egy műveletazonosítót, ez a mező a művelet állapotát jeleníti meg Example : `"[operationstatus](#operationstatus)"`	OperationStatus

NodeManagementRequest

Meghatározza, hogyan hajthat végre műveleteket a fürtön lévő csomópontokon. A csomópontokat többféleképpen is megadhatja. Ha több módszert is tartalmaz, a kérés a specifikációt egyesítőként kezeli.

Name	Description	Schema
filter optional	Csomópontokkal egyező szűrőkifejezés. Vegye figyelembe, hogy a kifejezésben szereplő sztringeket megfelelően kell idézni. Example : `"State === \"Started\""`	karakterlánc
hostnames optional	A kezelendő rövid gazdagépnevek listája (tartomány nélkül) Example : `[ "hostname1", "hostname2" ]`	<sztringtömb >
ids optional	A kezelni kívánt csomópontazonosítók listája Example : `[ "id1", "id2" ]`	<sztringtömb >
ip_addresses optional	A kezelendő IP-címek listája Example : `[ "10.0.1.1", "10.1.1.2" ]`	<sztringtömb >
names optional	A kezelni kívánt csomópontnevek listája Example : `[ "name1", "name2" ]`	<sztringtömb >
requestId optional	Nem kötelező, hogy a felhasználó által megadott egyedi jogkivonat megakadályozza az ismétlődő műveleteket hálózati kommunikációs hibák esetén. Ha a kiszolgáló egy korábbi kérésazonosítónak megfelelő kérést `requestId` kap, figyelmen kívül hagyja a kérést, és 409-et ad vissza. Example : `"00000000-0000-0000-0000-000000000000"`	karakterlánc

NodeManagementResult

Name	Description	Schema
nodes required	A felügyeleti kérelem szűrőjének megfelelő csomópontokkal kapcsolatos információk tömbje. Minden csomópont állapota jelzi, hogy a kérés hatással van-e rá. Example : `[ "object" ]`	< nodes> array
operationId required	A művelet azonosítója Example : `"00000000-0000-0000-0000-000000000000"`	karakterlánc

nodes

Name	Description	Schema
error optional	Ha az állapot hiba, a hibaüzenet Example : `"This node must be terminated before it can be removed"`	karakterlánc
id required	A csomópont azonosítója Example : `"id1"`	karakterlánc
name required	A csomópont neve Example : `"name1"`	karakterlánc
status optional	Az ok vagy a hiba egyike Example : `"Error"`	enum (OK, Hiba)

OperationStatus

A csomópontművelet állapota.

Name	Description	Schema
action required	Example : `"string"`	enum (create)
startTime required	A művelet elküldésekor Example : `"2020-01-01T12:34:56Z"`	string (date-time)

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-07-16

Megosztás a következőn keresztül:

Operations

Fürtcsomópontok lekérése

Parameters

Responses

Példa HTTP-kérésre

Request path

Példa HTTP-válaszra

Response 200

Fürtcsomópontok létrehozása

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Request body

Példa HTTP-válaszra

Response 202

Fürtcsomópontok felszabadítása

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Request body

Példa HTTP-válaszra

Response 202

Fürtcsomópontok leállása és eltávolítása

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Request body

Példa HTTP-válaszra

Response 202

Fürtcsomópontok leállása vagy felszabadítása

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Request body

Példa HTTP-válaszra

Response 202

Felszabadított vagy leállított fürtcsomópontok indítása

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Request body

Példa HTTP-válaszra

Response 202

Fürtcsomópontok leállása

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Request body

Példa HTTP-válaszra

Response 202

Fürt méretezése méretre

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Példa HTTP-válaszra

Response 202

Fürt állapotának lekérése

Description

Parameters

Responses

Példa HTTP-kérésre

Request path

Példa HTTP-válaszra

Response 200

A fürt használati és opcionális költségadatainak lekérése