Aracılığıyla paylaş


Işlem

Küme düğümlerini alma

GET /clusters/{cluster}/nodes

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Sorguya bağlanacak küme dizgi
sorgu işlemi
İsteğe bağlı
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 dizgi
sorgu request_id
İsteğe bağlı
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
dizgi

Yanıt

HTTP Kodu Açıklama Şema
200 TAMAM nodelist
400 Geçersiz belirtim İçerik Yok
404 Bulunamadı İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes

Örnek HTTP yanıtı

Yanıt 200

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

Küme düğümleri oluşturma

POST /clusters/{cluster}/nodes/create

Açıklama

Bu işlem bir nodearray'den 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 kullanılabilecek IŞLEMIN URL'sini döndürür.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Düğümlerin ekleneceği küme dizgi
Gövde düğümleri
gerekli
Oluşturulacak düğüm kümeleri NodeCreationRequest

Yanıt

HTTP Kodu Açıklama Şema
202 Kabul
Üst Bilgileri:
Location (dize): İşlemin URL'si.
NodeCreationResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/create

İstek gövdesi

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

Örnek HTTP yanıtı

Yanıt 202

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

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

POST /clusters/{cluster}/nodes/deallocate

Açıklama

Bu işlem bir kümedeki düğümleri serbest bırakıyor. Düğümler düğüm adı, düğüm kimliği veya filtre ile de dahil olmak üzere çeşitli yollarla tanımlanabilir.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Düğümleri serbest bırakmak için küme dizgi
Gövde eylem
gerekli
Hangi düğümlerin serbest bırakıldığına ait açıklama NodeManagementRequest

Yanıt

HTTP Kodu Açıklama Şema
202 Kabul
Üst Bilgileri:
Location (dize): İşlemin URL'si.
NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/deallocate

İstek gövdesi

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

Yanıt 202

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

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

POST /clusters/{cluster}/nodes/remove

Açıklama

Bu işlem bir kümedeki düğümleri kaldırır. Düğümler düğüm adı, düğüm kimliği veya filtre ile de dahil olmak üzere çeşitli yollarla tanımlanabilir. Sonlandırıldığında varsayılan olarak düğümlerin kaldırıldığını (düğümün Sabit değeri true olarak ayarlanmadığı sürece) ve bu durumda bu çağrının sonlandırmadan farklı olmadığını unutmayın.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
düğümleri kaldırılacak küme dizgi
Gövde eylem
gerekli
Kaldırılacak düğümlerin açıklaması NodeManagementRequest

Yanıt

HTTP Kodu Açıklama Şema
202 Kabul
Üst Bilgileri:
Location (dize): İşlemin URL'si.
NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/remove

İstek gövdesi

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

Yanıt 202

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

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

POST /clusters/{cluster}/nodes/shutdown

Açıklama

Bu işlem, her düğümdeki ShutdownPolicy özniteliğinin sırasıyla Terminate (varsayılan) veya Deallocate olmasına bağlı olarak kümedeki düğümleri sonlandırır veya serbest tutar.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Düğümleri kapatacak küme dizgi
Gövde eylem
gerekli
Kapatılan düğümlerin açıklaması NodeManagementRequest

Yanıt

HTTP Kodu Açıklama Şema
202 Kabul
Üst Bilgileri:
Location (dize): İşlemin URL'si.
NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/shutdown

İstek gövdesi

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

Yanıt 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

Açıklama

Bu işlem bir kümedeki düğümleri başlatır. Düğümler düğüm adı, düğüm kimliği veya filtre ile de dahil olmak üzere çeşitli yollarla tanımlanabilir.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Düğümleri başlatacak küme dizgi
Gövde eylem
gerekli
Hangi düğümlerin başlatıldığına ait açıklama NodeManagementRequest

Yanıt

HTTP Kodu Açıklama Şema
202 Kabul
Üst Bilgileri:
Location (dize): İşlemin URL'si.
NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/start

İstek gövdesi

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

Yanıt 202

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

Küme düğümlerini sonlandırma

POST /clusters/{cluster}/nodes/terminate

Açıklama

Bu işlem bir kümedeki düğümleri sonlandırır. Düğümler düğüm adı, düğüm kimliği veya filtre ile de dahil olmak üzere çeşitli yollarla tanımlanabilir.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Düğümleri sonlandırmak için küme dizgi
Gövde eylem
gerekli
Sonlandırılan düğümlerin açıklaması NodeManagementRequest

Yanıt

HTTP Kodu Açıklama Şema
202 Kabul
Üst Bilgileri:
Location (dize): İşlemin URL'si.
NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/terminate

İstek gövdesi

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

Yanıt 202

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

Kümeyi boyuta ölçeklendirme

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

Açıklama

Bu işlem, bir nodearray'ye gereken şekilde düğümleri ekliyor ve toplam sayıya ulaşmasını sağlar. İstek bir kez işlenir ve daha sonra verilen sayıyı korumak için düğümleri yeniden eklemez. Bu, toplam çekirdeklere veya toplam düğümlere göre ölçeklendirilir, ancak her ikisini birden ölçeklendirmez. İşlemin durumunu izlemek için kullanılabilecek IŞLEMIN URL'sini döndürür.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Düğümlerin ekleneceği küme dizgi
Yol nodearray
gerekli
Düğümlerin ekleneceği nodearray dizgi
sorgu totalCoreCount
İsteğe bağlı
Önceden oluşturulmuş düğümler de dahil olmak üzere bu nodearray'de sahip olacak toplam çekirdek sayısı tam sayı
sorgu totalNodeCount
İsteğe bağlı
Önceden oluşturulmuş düğümler de dahil olmak üzere bu nodearray'de bulunması gereken toplam makine sayısı tam sayı

Yanıt

HTTP Kodu Açıklama Şema
202 Kabul
Üst Bilgileri:
Location (dize): İşlemin URL'si.
NodeCreationResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/scale/NODEARRAY_NAME

Örnek HTTP yanıtı

Yanıt 202

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

Küme durumunu alma

GET /clusters/{cluster}/status

Açıklama

Bu işlem, belirli bir kümedeki düğümler ve nodearray'ler için bilgi içerir. Her nodearray için, demette kaç düğüm olduğu, kaç düğümün eklenebilecekleri vb. gibi kullanılabilecek her ayırma "demetinin" durumunu döndürür. Her demet, belirli bir konumda, belirli bir müşteri hesabı altında vb. oluşturulabilen, belirli bir donanım profilinin olası VM'leri kümesidir. Nodearray için geçerli demetler kullanıcının küme tanımına göre belirlenir, ancak sınırlar kısmen bulut sağlayıcısı tarafından belirlenir.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Sorguya bağlanacak küme dizgi
sorgu düğümleri
İsteğe bağlı
True ise, yanıtta düğümler ve düğüm başvuruları döndürülür Boolean

Yanıt

HTTP Kodu Açıklama Şema
200 TAMAM ClusterStatus

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/status

Örnek HTTP yanıtı

Yanıt 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

Açıklama

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.

Parametre

Tür Ad Açıklama Şema
Yol küme
gerekli
Kullanım verilerinin döndürüleceği küme dizgi
sorgu zaman çerçevesi
İsteğe bağlı
Verilirse, sorgu için kullanılacak zaman aralığını belirtir. 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 biçimindedir. enum (monthToDate, lastMonth, weekToDate, özel)
sorgu 'dan
İsteğe bağlı
Özel zaman çerçeveleri için bu, ISO-8601 biçimindeki zaman çerçevesinin başlangıcıdır. Bu, en yakın saate veya güne yuvarlanır. dizgi
sorgu 'a
İsteğe bağlı
Özel zaman çerçeveleri için bu, ISO-8601 biçimindeki zaman çerçevesinin sonudur. Bu, en yakın saate veya güne yuvarlanmış olur. dizgi
sorgu taneciklik
İsteğe bağlı
Verilerin nasıl top yapılacağını belirtir: saate göre, günlük olarak veya tek bir sayı olarak. Bu varsayılan değer günlük olarak ayarlanır. sabit listesi (toplam, günlük, saatlik)

Yanıt

HTTP Kodu Açıklama Şema
200 TAMAM ClusterUsage

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/usage

Örnek HTTP yanıtı

Yanıt 200

{
  "usage" : [ "object" ]
}

İşlemlerin durumunu listeler

GET /operations/

Parametre

Tür Ad Açıklama Şema
sorgu request_id
İsteğe bağlı
İşlemin istek kimliği. Bu verilirse, listede yalnızca 0 veya 1 öğesi olur. dizgi

Yanıt

HTTP Kodu Açıklama Şema
200 TAMAM OperationStatus dizi
400 Geçersiz istek İçerik Yok
404 Bulunamadı İçerik Yok

Örnek HTTP isteği

İstek yolu

/operations/

Örnek HTTP yanıtı

Yanıt 200

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

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

GET /operations/{id}

Parametre

Tür Ad Açıklama Şema
Yol kimliği
gerekli
İşlem kimliği dizgi

Yanıt

HTTP Kodu Açıklama Şema
200 TAMAM operationStatus
404 Bulunamadı İçerik Yok

Örnek HTTP isteği

İstek yolu

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

Örnek HTTP yanıtı

Yanıt 200

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

Kaynaklar

ClusterStatus

Kümenin durumu

Ad Açıklama Şema
maxCoreCount
gerekli
Bu kümeye eklenebilecek en fazla çekirdek sayısı
Örnek: 16
tam sayı
maxCount
gerekli
Bu kümeye eklenebilecek en fazla düğüm sayısı
Örnek: 4
tam sayı
nodearrays
gerekli
Örnek: [ "object" ] < nodearrays> dizisi
düğümleri
İsteğe bağlı
Bu kümedeki isteğe bağlı düğüm listesi, yalnızca node=true sorguda yer alıyorsa dahil edilir
Örnek: [ "[node](#node)" ]
< Node> dizisi
durum
İsteğe bağlı
Kümenin en az bir kez başlatıldıysa geçerli durumu
Örnek: "Starting"
dizgi
targetState
İsteğe bağlı
Kümenin istenen durumu (örneğin Başlatıldı veya Sonlandırıldı)
Örnek: "Started"
dizgi

nodearrays

Ad Açıklama Şema
demetler
gerekli
Bu nodearray 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.
Örnek: [ "object" ]
Dizi demetleri
maxCoreCount
gerekli
Bu nodearray içinde olabilecek en fazla çekirdek sayısı
Örnek: 16
tam sayı
maxCount
gerekli
Bu nodearray içinde olabilecek en fazla düğüm sayısı
Örnek: 4
tam sayı
ad
gerekli
Bu açıklamanın açıklandığı nodearray
Örnek: "execute"
dizgi
nodearray
gerekli
Bu nodearray'nin öznitelikleri
Örnek: "[node](#node)"
Düğümü

demetler

Ad Açıklama Şema
activeCoreCount
gerekli
Bu nodearray'de bu demet için kullanılan çekirdek sayısı
Örnek: 40
tam sayı
activeCount
gerekli
Bu nodearray'de bu demet için kullanılan düğüm sayısı. Buna vm almaya devam eden düğümler dahildir.
Örnek: 10
tam sayı
activeNodes
İsteğe bağlı
Bu düğümde, bu demet için kullanılan düğüm adları. Buna vm almaya devam eden düğümler dahildir. Bu yalnızca sorguda node=true olduğunda dahil edilir.
Örnek: [ "string" ]
dize > dizisini <
kullanılabilir CoreCount
gerekli
Bu demette, bu nodearray içinde kaç ek çekirdek oluşturulabilir? Her zaman availableCount'un bir katı.
Örnek: 8
tam sayı
availableCount
gerekli
Bu demette, bu nodearray içinde kaç ek düğüm oluşturulabilir? MaxCount genel olarak sınırlı olabileceğinden, bunun maxCount ve usedCount tarafından zımniden küçük olabileceğini unutmayın.
Örnek: 2
tam sayı
bucketId
gerekli
Bu demetin tanımlayıcısı. Küme silinmediği sürece bu, nodearray içindeki belirli bir demet için her zaman aynı değere sahip olur.
Örnek: "00000000-0000-0000-0000-000000000000"
dizgi
consumedCoreCount
gerekli
Bu aile için bölgenin tamamında zaten kullanılmakta olan çekirdek sayısı.
Örnek: 2
tam sayı
tanım
İsteğe bağlı
Bu demetten düğüm oluşturmak için kullanılan bu demetin özellikleri. Create-node API'si bu tanımı bucket özelliğinde alır.
Örnek: "object"
tanım
familyConsumedCoreCount
İsteğe bağlı
Bu aile için bölgenin tamamında zaten kullanılmakta olan çekirdek sayısı.
Örnek: 2
tam sayı
ailesiQuotaCoreCount
İsteğe bağlı
Bu bölgedeki bu aile için başlatılabilir toplam çekirdek sayısı. Bu, quotaCount'un tamsayı katı olmayabilir.
Örnek: 16
tam sayı
aileQuotaCount
İsteğe bağlı
Başlatılabilir toplam örnek sayısı (verilen familyQuotaCoreCount)
Örnek: 4
tam sayı
geçersizReason
gerekli
Geçerli false ise, demetin geçersiz olmasının nedeni bu olacaktır. Şu anda tek nedeni NotActivated ve DisabledMachineType'tır.
Örnek: "DisabledMachineType"
dizgi
lastCapacityFailure
gerekli
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.
Örnek: 180.0
sayı
maxCoreCount
gerekli
Global ve nodearray sınırları dahil olmak üzere bu demette bulunabilecek maksimum çekirdek sayısı. Her zaman maxCount'un bir katı.
Örnek: 16
tam sayı
maxCount
gerekli
Genel ve nodearray sınırları dahil olmak üzere bu demette olabilecek en fazla düğüm sayısı
Örnek: 4
tam sayı
maxPlacementGroupCoreSize
gerekli
Bu demetteki bir yerleştirme grubunda bulunabilecek toplam çekirdek sayısı üst sınırı. her zaman maxPlacementGroupSize'ın bir katı.
Örnek: 64
tam sayı
maxPlacementGroupSize
gerekli
Bu demetteki bir yerleştirme grubunda bulunabilecek toplam örnek sayısı üst sınırı
Örnek: 16
tam sayı
placementGroups
gerekli
Varsa, bu nodearray için kullanılan yerleştirme grupları.
Örnek: [ "object" ]
< placementGroups> dizisi
quotaCoreCount
gerekli
Bölgesel kota çekirdek sayısı da dikkate alınarak bu bölgedeki bu aile için başlatılabilir toplam çekirdek sayısı. Bu, quotaCount'un tamsayı katı olmayabilir.
Örnek: 16
tam sayı
quotaCount
gerekli
Başlatılabilir toplam örnek sayısı (verilen quotaCoreCount)
Örnek: 4
tam sayı
regionalConsumedCoreCount
İsteğe bağlı
Tüm bölgede zaten kullanımda olan çekirdek sayısı.
Örnek: 2
tam sayı
bölgeselQuotaCoreCount
İsteğe bağlı
Bu bölgede başlatılabilir toplam çekirdek sayısı. Bu, regionalQuotaCount'un tamsayı katı olmayabilir.
Örnek: 16
tam sayı
Bölgesel QuotaCount
İsteğe bağlı
Başlatılabilir toplam örnek sayısı (regionalQuotaCoreCount verilen)
Örnek: 4
tam sayı
Geçerli
gerekli
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.
Örnek: true
Boolean
virtualMachine
gerekli
Bu demetten başlatılan sanal makinelerin özellikleri
Örnek: "object"
virtualMachine

tanım

Ad Açıklama Şema
machineType
gerekli
Sanal makinenin VM boyutu
Örnek: "A2"
dizgi

yerleştirmeyi Groups

Ad Açıklama Şema
activeCoreCount
gerekli
Bu ölçek kümesinde kaç çekirdek var?
Örnek: 16
tam sayı
activeCount
gerekli
Bu ölçek kümesinde kaç düğüm var?
Örnek: 4
tam sayı
ad
gerekli
Bu yerleştirme grubunun benzersiz tanımlayıcısı
Örnek: "my-placement-group"
dizgi

virtualMachine

Ad Açıklama Şema
gpuCount
gerekli
Bu makine türündeki GPU sayısı
Örnek: 2
tam sayı
infiniband
gerekli
Bu sanal makine InfiniBand bağlantısını destekliyorsa
Örnek: true
Boolean
bellek
gerekli
Bu sanal makinedeki RAM,GB cinsinden
Örnek: 7.5
sayı
pcpuCount
gerekli
Bu makine türünün sahip olduğu fiziksel CPU sayısı
Örnek: 16
tam sayı
vcpuCount
gerekli
Bu makine türünün sahip olduğu sanal CPU sayısı
Örnek: 32
tam sayı
vcpuQuotaCount
İsteğe bağlı
Bu makinenin kotadan kullandığı vCPU sayısı
Örnek: 2
tam sayı

ClusterUsage

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

Ad Açıklama Şema
kullanım
gerekli
Zaman aralığına göre kullanım listesi
Örnek: [ "object" ]
< kullanım> dizisi

kullanım

Ad Açıklama Şema
döküm
gerekli
Bu aralıktaki kullanımın "node" ve "nodearray" kategorisine göre dökümü
Örnek: [ "[clusterusageitem](#clusterusageitem)" ]
< ClusterUsageItem> dizisi
bitiş
gerekli
Aralığın sonu (özel)
Örnek: "string"
dizgi
başlangıç
gerekli
Aralığın başlangıcı (dahil)
Örnek: "string"
dizgi
Toplam
gerekli
Bu kümenin bu aralıktaki genel kullanımı ve "küme" kategorisi
Örnek: "[clusterusageitem](#clusterusageitem)"
ClusterUsageItem

ClusterUsageItem

Ad Açıklama Şema
kategori
gerekli
genel kullanım için "küme"; Tek bir dizi olmayan baş düğüm için "düğüm"; Tüm nodearray için "nodearray"
Örnek: "string"
sabit listesi (küme, düğüm, nodearray)
maliyet
İsteğe bağlı
Bu kullanım için abd doları cinsinden ve perakende fiyatlarıyla tahsil edilecek tutar. Not: Tüm maliyet tutarları tahmindir ve gerçek faturayı yansıtmaz!
Örnek: 0.0
sayı
ayrıntıları
İsteğe bağlı
Saat, core_count, bölge önceliği ve işletim sistemi dahil olmak üzere bir nodearray tarafından kullanılan VM boyutunun ayrıntıları.
Örnek: [ "object" ]
dizi ayrıntıları
saat
gerekli
Bu kategori için çekirdek saat kullanımı sayısı
Örnek: 0.0
sayı
düğüm
İsteğe bağlı
Kullanımın olduğu düğümün veya nodearray'nin adı (küme düzeyinde veriler için yok)
Örnek: "string"
dizgi

ayrıntıları

Ad Açıklama Şema
core_count
İsteğe bağlı
Bu VM boyutundaki çekirdek sayısı
Örnek: 0.0
sayı
maliyet
İsteğe bağlı
Bu VM boyutunun maliyeti
Örnek: 0.0
sayı
saat
İsteğe bağlı
Bu VM boyutu için çekirdek saat kullanımı sayısı
Örnek: 0.0
sayı
işletim sistemi
İsteğe bağlı
İşletim sistemi türü
Örnek: "string"
sabit listesi (Windows, Linux)
öncelik
İsteğe bağlı
VM Sku'sunun önceliği
Örnek: "string"
sabit listesi (Normal, Nokta)
bölge
İsteğe bağlı
VM boyutunun başlatılmış olduğu bölge
Örnek: "string"
dizgi
vm_size
İsteğe bağlı
VM Sku boyutu
Örnek: "string"
dizgi

Düğüm

Düğüm kaydı

Type : object

NodeCreationRequest

Kümeye düğüm eklemeyi belirtir

Ad Açıklama Şema
requestId
İsteğe bağlı
Ağ iletişim hataları durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu eklenip önceki bir istek kimliğiyle eşleşiyorsa, sunucu bu isteği yoksayar ve 409 hatası döndürür.
Örnek: "00000000-0000-0000-0000-000000000000"
dizgi
kümeleri
gerekli
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.
Örnek: [ "object" ]
< diziyi> ayarlar

kümeleri

Ad Açıklama Şema
sayısı
gerekli
Oluşturulacak düğüm sayısı
Örnek: 1
tam sayı
tanım
İsteğe bağlı
Kullanılacak demetin tanımı. Bu, küme durumu API çağrısı tarafından sağlanır. Durum çağrısında verilen öğelerden bazıları eksikse veya demet özelliğinin tamamı eksikse, verilen öğelerle eşleşen ilk demet kullanılır.
Örnek: "object"
tanım
nameFormat
İsteğe bağlı
Verilirse, düğümler standart "nodearray-%d" biçimi yerine bu adlandırma kuralını kullanır
Örnek: "custom-name-%d"
dizgi
nameOffset
İsteğe bağlı
Verildiyse nameFormat ile birlikte yeni düğümler için nodeindex'i kaydırıyor.
Örnek: 1
tam sayı
nodeAttributes
İsteğe bağlı
Bu kümeden her düğümde ayarlanacak ek öznitelikler
Örnek: "[node](#node)"
Düğümü
nodearray
gerekli
Düğümleri başlatacak nodearray'nin adı
Örnek: "execute"
dizgi
placementGroupId
İsteğe bağlı
Verilirse, groupId için aynı değere sahip düğümlerin tümü aynı yerleştirme grubunda başlatılır.
Örnek: "string"
dizgi

tanım

Ad Açıklama Şema
machineType
İsteğe bağlı
Örnek: "A2" dizgi

NodeCreationResult

Ad Açıklama Şema
operationId
gerekli
Bu işlemin kimliği
Örnek: "00000000-0000-0000-0000-000000000000"
dizgi
kümeleri
gerekli
İstektekiyle aynı sırada bir küme dizisi
Örnek: [ "object" ]
< diziyi> ayarlar

kümeleri

Ad Açıklama Şema
eklendi
gerekli
Bu kümede kaç düğüm başlatıldı?
Örnek: 1
tam sayı
İleti
İsteğe bağlı
Varsa, istenen tüm düğümlerin neden eklenemediğine işaret eder
Örnek: "string"
dizgi

NodeList

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

Ad Açıklama Şema
düğümleri
gerekli
Döndürülen düğümler
Örnek: [ "[node](#node)" ]
< Node> dizisi
işlemi
İsteğe bağlı
Sorgu bir işlem kimliği içeriyorsa, bu işlemin durumudur
Örnek: "[operationstatus](#operationstatus)"
operationStatus

NodeManagementRequest

Bir kümedeki düğümlerde eylemlerin nasıl gerçekleştirileceklerini belirtir. Düğümleri belirtmenin birden çok yolu vardır ve birden fazla yol dahil edilirse birleşim olarak değerlendirilir.

Ad Açıklama Şema
filtre
İsteğe bağlı
Düğümler ile eşleşen bir filtre ifadesi. İfadedeki dizelerin düzgün tırnak içine alınması gerektiğini unutmayın.
Örnek: "State === \"Started\""
dizgi
konak adlarını
İsteğe bağlı
Yönetecek kısa konak adlarının listesi (etki alanı olmadan)
Örnek: [ "hostname1", "hostname2" ]
dize > dizisini <
kimlikleri
İsteğe bağlı
Yönetecek düğüm kimliklerinin listesi
Örnek: [ "id1", "id2" ]
dize > dizisini <
ip_addresses
İsteğe bağlı
Yönetecek IP adreslerinin listesi
Örnek: [ "10.0.1.1", "10.1.1.2" ]
dize > dizisini <
adları
İsteğe bağlı
Yönetecek düğüm adlarının listesi
Örnek: [ "name1", "name2" ]
dize > dizisini <
requestId
İsteğe bağlı
Ağ iletişim hataları durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu eklenip önceki bir istek kimliğiyle eşleşiyorsa, sunucu bu isteği yoksayar ve 409 hatası döndürür.
Örnek: "00000000-0000-0000-0000-000000000000"
dizgi

NodeManagementResult

Ad Açıklama Şema
düğümleri
gerekli
Yönetim isteğindeki filtreyle eşleşen her düğüm hakkında bilgi dizisi. Her düğümün durumu, istekten etkilenip etkilenmediğini gösterir.
Örnek: [ "object" ]
dizi düğümleri
operationId
gerekli
Bu işlemin kimliği
Örnek: "00000000-0000-0000-0000-000000000000"
dizgi

düğümleri

Ad Açıklama Şema
hata
İsteğe bağlı
Durum Hata ise, bu hata iletisini içerir
Örnek: "This node must be terminated before it can be removed"
dizgi
kimliği
gerekli
Düğümün kimliği
Örnek: "id1"
dizgi
ad
gerekli
Düğümün adı
Örnek: "name1"
dizgi
durum
İsteğe bağlı
Tamam veya Hatadan Biri
Örnek: "Error"
sabit listesi (Tamam, Hata)

OperationStatus

Bu düğüm işleminin durumu

Ad Açıklama Şema
eylem
gerekli
Örnek: "string" sabit listesi (oluştur)
startTime
gerekli
Bu işlem gönderildiğinde
Örnek: "2020-01-01T12:34:56Z"
dize (tarih-saat)