Operations

Azure CycleCloud, kümeleri, düğümleri ve ilgili kaynakları program aracılığıyla yönetmek için bir REST API sağlar. Küme durumunu sorgulamak, düğüm oluşturup yönetmek ve uzun süre çalışan işlemleri izlemek için bu API işlemlerini kullanın. Bu başvuru, CycleCloud küme yönetimini iş akışlarınızla otomatikleştirmenize ve tümleştirmenize yardımcı olmak için kullanılabilir uç noktaları, parametreleri ve yanıt biçimlerini listeler.

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övdede işlem özniteliğini içerir string

Responses

HTTP Kodu Description Schema
200 OK 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

Description

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.

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 Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeCreationResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/create

İstek içeriği

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

Description

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

Parameters

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

Responses

HTTP Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/deallocate

İstek içeriği

{
  "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 yeniden oluşturma

POST /clusters/{cluster}/nodes/reimage

Description

Bu işlem bir kümedeki düğümleri yeniden oluşturur. Düğümler düğüm adı, düğüm kimliği veya filtre gibi çeşitli yollarla tanımlanabilir.

Parameters

Type Name Description Schema
Path cluster
required		 Düğümleri yeniden görüntüye almak için küme string
Body action
required		 Yeniden görüntüleyebileceğiniz düğümlerin açıklaması NodeManagementRequest

Responses

HTTP Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/reimage

İstek içeriği

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

Description

Bu işlem bir kümedeki düğümleri kaldırır. Düğümleri düğüm adına, düğüm kimliğine veya filtreye göre tanımlayabilirsiniz. Varsayılan olarak, CycleCloud sonlandırmada düğümleri kaldırır, bu nedenle bu çağrı sonlandır gibi davranır. Sabit özniteliği true olarak ayarlanmış düğümler sonlandırmada kaldırılmaz.

Parameters

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

Responses

HTTP Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/remove

İstek içeriği

{
  "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 yeniden başlatma

POST /clusters/{cluster}/nodes/restart

Description

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

Parameters

Type Name Description Schema
Path cluster
required		 içinde düğümleri yeniden başlatacak küme string
Body action
required		 Yeniden başlatılan düğümlerin açıklaması NodeManagementRequest

Responses

HTTP Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/restart

İstek içeriği

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

Description

Bu çağrı bir kümedeki düğümleri kapatır. Her düğümün ShutdownPolicy özniteliği şu eyleme karar verir: Sonlandır (varsayılan) veya Serbest Bırak.

Parameters

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

Responses

HTTP Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/shutdown

İstek içeriği

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

Description

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

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 Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/start

İstek içeriği

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

Description

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

Parameters

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

Responses

HTTP Kodu Description Schema
202 Kabul
Üst bilgiler :
Location (dize): İşlemin URL'si.		 NodeManagementResult
409 Geçersiz giriş İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/terminate

İstek içeriği

{
  "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üğümü için Konuk Sistem Durumu Raporu gönderme

POST /clusters/{cluster}/nodes/{node}/ghr

Description

Sistem durumu sorunu olan bir düğüm için sistem durumu raporu gönderme

Parameters

Type Name Description Schema
Path cluster
required		 Bildirecek düğümü içeren küme string
Path node
required		 Rapora bağlanacak düğüm string
Query category
optional		 Etki için Konuk Durumu Raporu kategorisi string
Query Açıklama
optional		 Hatayı veya bağlamı açıklayan özel ileti string

Responses

HTTP Kodu Description Schema
202 Kabul edildi İçerik Yok
400 Geçersiz giriş İçerik Yok
404 Bulunamadı İçerik Yok
409 Çakışma - Bu düğüm için zaten gönderilen Konuk Durumu Raporu İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/string/ghr

Küme düğümü için Konuk Durumu Raporu alma

GET /clusters/{cluster}/nodes/{node}/ghr

Description

Sistem durumu sorunu olan bir düğümün iş yükü etkisini döndürür, böylece durumu raporlama uç noktasına gönderebilirsiniz.

Parameters

Type Name Description Schema
Path cluster
required		 Bildirecek düğümü içeren küme string
Path node
required		 Rapora bağlanacak düğüm string
Query category
optional		 Etki için Konuk Durumu Raporu kategorisi string
Query Açıklama
optional		 Hatayı veya bağlamı açıklayan özel ileti string

Responses

HTTP Kodu Description Schema
200 Ok İçerik Yok
400 Geçersiz giriş İçerik Yok
404 Bulunamadı İçerik Yok

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/nodes/string/ghr

Kümeyi boyuta ölçeklendirme

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

Description

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. Aynı istekte her ikisini birden totalCoreCount değil, (toplam CPU çekirdekleri) veya totalNodeCount (toplam VM'ler) kullanarak hedef boyutu belirtin. 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
Path nodearray
required		 Düğümlerin ekleneceği nodearray string
Query totalCoreCount
optional		 Önceden oluşturulmuş düğümler de dahil olmak üzere bu nodearray'de sahip olacak toplam çekirdek sayısı integer
Query totalNodeCount
optional		 Önceden oluşturulmuş düğümler de dahil olmak üzere bu nodearray'de bulunması gereken toplam makine sayısı integer

Responses

HTTP Kodu Description Schema
202 Kabul
Üst bilgiler :
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

Description

Bu işlem, belirli bir kümedeki düğümler ve nodearray'ler için bilgi içerir. Her nodearray için kullanılabilir her ayırma "demetinin" durumunu döndürür. Durum, demetteki geçerli düğüm sayısını ve ekleyebileceğiniz düğüm sayısını içerir. Her demet, belirli bir müşteri hesabı altında belirli bir konumda oluşturulabilen belirli bir donanım profilinin olası VM'leri kümesidir. Kullanıcının küme tanımı bir nodearray için geçerli demetleri belirler, ancak bulut sağlayıcısı kısmen sınırları belirler.

Parameters

Type Name Description Schema
Path cluster
required		 Sorguya bağlanacak küme string
Query nodes
optional		 True ise, yanıtta düğümler ve düğüm başvuruları döndürülür boolean

Responses

HTTP Kodu Description Schema
200 OK 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

Description

Bu işlem, küme için genel kullanım verilerini (çekirdek saatler) ve varsa maliyet verilerini ve 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 Süre
optional		 Sorgu için kullanılacak zaman aralığı. Geçerli değerler: monthToDate (geçerli ay), lastMonth (önceki ay), weekToDate (geçerli hafta, Pazar'dan itibaren) veya custom (ve from sorgu parametrelerini gerektirirto). Varsayılan değer: monthToDate. Tüm saatler UTC cinsindendir. enum (monthToDate, lastMonth, weekToDate, özel)
Query from
optional		 Özel zaman çerçeveleri için bu değer, ISO-8601 biçimindeki zaman çerçevesinin başlangıcıdır. En yakın saate veya güne yuvarlanır. string
Query to
optional		 Özel zaman çerçeveleri için bu değer, ISO-8601 biçimindeki zaman çerçevesinin sonudur. En yakın saate veya güne yuvarlanir. string
Query Taneciklilik
optional		 Verilerin nasıl top yapılacağını belirtir: saatlik, günlük veya tek bir toplam olarak. Varsayılan aralık günlük olarak ayarlanır. sabit listesi (toplam, günlük, saatlik)

Responses

HTTP Kodu Description Schema
200 OK ClusterUsage

Örnek HTTP isteği

İstek yolu

/clusters/CLUSTER_NAME/usage

Örnek HTTP yanıtı

Yanıt 200

{
  "usage" : [ "object" ]
}

İşlemlerin durumunu listeleme

GET /operations/

Parameters

Type Name Description Schema
Query request_id
optional		 İşlemin istek kimliği. Bu değer verilirse, listede 0 veya 1 öğesi bulunur. string

Responses

HTTP Kodu Description Schema
200 OK < 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}

Parameters

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

Responses

HTTP Kodu Description Schema
200 OK 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"
}

Resources

Azure CycleCloud kümeleri, düğüm dizilerini, düğümleri ve ayırma durumunu açıklayan bir kaynak modelleri kümesi tanımlar. Bu kaynaklar REST API tarafından döndürülür ve kapasite sınırları, kullanım ve küme durumu gibi ayrıntıları sağlar. CycleCloud kümelerini program aracılığıyla yönetirken ve izlerken API yanıtlarının yapısını ve özelliklerini anlamak için bu başvuruyu kullanın.

ClusterStatus

Kümenin durumu

Name Description Schema
maxCoreCount
required		 Bu kümeye eklenebilecek en fazla çekirdek sayısı
Örnek : 16		 integer
maxCount
required		 Bu kümeye eklenebilecek en fazla düğüm sayısı
Örnek : 4		 integer
nodearrays
required		 Örnek : [ "object" ] < nodearrays> Dizi
nodes
optional		 Bu kümedeki isteğe bağlı düğüm listesi, yalnızca node=true sorguda yer alıyorsa dahil edilir
Örnek : [ "[node](#node)" ]		 < Düğüm> Dizi
state
optional		 Kümenin geçerli durumu, en az bir başlangıçtan sonra kullanılabilir
Örnek : "Starting"		 string
targetState
optional		 Kümenin istenen durumu (örneğin, Başlatıldı veya Sonlandırıldı)
Örnek : "Started"		 string

nodearrays

Name Description Schema
Kova
required		 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" ]		 < Kova> Dizi
maxCoreCount
required		 Bu nodearray içinde olabilecek en fazla çekirdek sayısı
Örnek : 16		 integer
maxCount
required		 Bu nodearray içinde olabilecek en fazla düğüm sayısı
Örnek : 4		 integer
name
required		 Nodearray adı
Örnek : "execute"		 string
nodearray
required		 Bu nodearray'nin öznitelikleri
Örnek : "[node](#node)"		 Node

Kova

Name Description Schema
activeCoreCount
required		 Bu nodearray'de bu demet için kullanılan çekirdek sayısı
Örnek : 40		 integer
activeCount
required		 Bu nodearray'de bu demet için kullanılan düğüm sayısı. Bu sayı, vm almaya devam eden düğümleri içerir.
Örnek : 10		 integer
activeNodes
optional		 Bu demet için nodearray içinde kullanılmakta olan düğümlerin adları( vm almaya devam eden düğümler de dahil). Yalnızca sorgu node=true içerdiğinde döndürülür.
Örnek : [ "string" ]		 < dize > dizisi
availableCoreCount
required		 Bu demette, bu nodearray içinde kaç ek çekirdek oluşturulabilir? Her zaman availableCount'un bir katı.
Örnek : 8		 integer
availableCount
required		 Nodearray içindeki bu demette oluşturulabilecek ek düğümlerin sayısı. Genel sınırla eşlenebileceği için maxCount değer eksiden usedCountmaxCount düşük olabilir.
Örnek : 2		 integer
bucketId
required		 Demet için benzersiz tanımlayıcı. Değer, kümenin ömrü boyunca bir nodearray içindeki belirli bir demet için aynı kalır.
Örnek : "00000000-0000-0000-0000-000000000000"		 string
consumedCoreCount
required		 Bu aile için bölgenin tamamında zaten kullanılmakta olan çekirdek sayısı.
Örnek : 2		 integer
definition
optional		 Bu demetten düğüm oluşturmak için kullanılan özellikler. Create-node API'si bu tanımı özelliğinde bucket alır.
Örnek : "object"		 definition
familyConsumedCoreCount
optional		 Bu aile için bölgenin tamamında zaten kullanılmakta olan çekirdek sayısı.
Örnek : 2		 integer
familyQuotaCoreCount
optional		 Bölgedeki bu VM ailesi için çalıştırabileceğiniz toplam çekirdek sayısı. Değerin bir tamsayı katı familyQuotaCountolması şart değildir.
Örnek : 16		 integer
familyQuotaCount
optional		 Başlatılabilir toplam örnek sayısı (verilen familyQuotaCoreCount)
Örnek : 4		 integer
invalidReason
required		 False olduğunda valid demetin geçersiz olmasının nedeni. Şu anda tek olası değerler ve NotActivated'tirDisabledMachineType.
Örnek : "DisabledMachineType"		 string
lastCapacityFailure
required		 Bu demetin kapasite hatasıyla karşılaştığından bu yana geçmesine neden olan saniye sayısı. Herhangi bir negatif değer hiçbir zaman olarak değerlendirilir.
Örnek : 180.0		 number
maxCoreCount
required		 Global ve nodearray sınırları dahil olmak üzere bu demette bulunabilecek maksimum çekirdek sayısı. Her zaman maxCount'un bir katı.
Örnek : 16		 integer
maxCount
required		 Genel ve nodearray sınırları dahil olmak üzere bu demette olabilecek en fazla düğüm sayısı
Örnek : 4		 integer
maxPlacementGroupCoreSize
required		 Bu demetteki bir yerleştirme grubunda bulunabilecek toplam çekirdek sayısı üst sınırı. her zaman maxPlacementGroupSize'ın bir katı.
Örnek : 64		 integer
maxPlacementGroupSize
required		 Bu demetteki bir yerleştirme grubunda bulunabilecek toplam örnek sayısı üst sınırı
Örnek : 16		 integer
placementGroups
required		 Varsa, bu nodearray için kullanılan yerleştirme grupları.
Örnek : [ "object" ]		 < placementGroups> Dizi
quotaCoreCount
required		 Bölgedeki bu VM ailesi için çalıştırılabilir toplam çekirdek sayısı ve bölgesel kota çekirdek sayısı hesaplanabilir. Değerin bir tamsayı katı quotaCountolması şart değildir.
Örnek : 16		 integer
quotaCount
required		 Başlatılabilir toplam örnek sayısı (verilen quotaCoreCount)
Örnek : 4		 integer
regionalConsumedCoreCount
optional		 Tüm bölgede zaten kullanımda olan çekirdek sayısı.
Örnek : 2		 integer
regionalQuotaCoreCount
optional		 Bölgede çalışabilen toplam çekirdek sayısı. Değerin bir tamsayı katı regionalQuotaCountolması şart değildir.
Örnek : 16		 integer
regionalQuotaCount
optional		 Başlatılabilir toplam örnek sayısı (regionalQuotaCoreCount verilen)
Örnek : 4		 integer
spotPlacementScore
required		 Spot VM kullanılabilirliği olasılığını gösteren bu demet için spot yerleştirme puanı. Yüksek, Orta, Düşük veya geçerli değilse boş bir dize olabilir.
Örnek : "High"		 string
geçerli
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.
Örnek : true		 boolean
virtualMachine
required		 Bu demetten başlatılan sanal makinelerin özellikleri
Örnek : "object"		 virtualMachine

Tanımı

Name Description Schema
machineType
required		 Sanal makinenin VM boyutu
Örnek : "A2"		 string

placementGroups

Name Description Schema
activeCoreCount
required		 Bu ölçek kümesinde kaç çekirdek var?
Örnek : 16		 integer
activeCount
required		 Bu ölçek kümesinde kaç düğüm var?
Örnek : 4		 integer
name
required		 Bu yerleştirme grubunun benzersiz tanımlayıcısı
Örnek : "my-placement-group"		 string

virtualMachine

Name Description Schema
gpuCount
required		 Bu makine türündeki GPU sayısı
Örnek : 2		 integer
ınfiniband
required		 Bu sanal makine InfiniBand bağlantısını destekliyorsa
Örnek : true		 boolean
memory
required		 Bu sanal makinedeki RAM,GB cinsinden
Örnek : 7.5		 number
pcpuCount
required		 Bu makine türünün sahip olduğu fiziksel CPU sayısı
Örnek : 16		 integer
vcpuCount
required		 Bu makine türünün sahip olduğu sanal CPU sayısı
Örnek : 32		 integer
vcpuQuotaCount
optional		 Bu makinenin kotadan kullandığı vCPU sayısı
Örnek : 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
Örnek : [ "object" ]		 < Kullanım> Dizi

Kullanım

Name Description Schema
Arıza
required		 Bu aralıktaki kullanımın "node" ve "nodearray" kategorisine göre dökümü
Örnek : [ "[clusterusageitem](#clusterusageitem)" ]		 < ClusterUsageItem> Dizi
end
required		 Aralığın sonu (özel)
Örnek : "string"		 string
start
required		 Aralığın başlangıcı (dahil)
Örnek : "string"		 string
total
required		 Bu kümenin bu aralıktaki genel kullanımı ve "küme" kategorisi
Örnek : "[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"
Örnek : "string"		 sabit listesi (küme, düğüm, nodearray)
cost
optional		 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		 number
details
optional		 Saat, core_count, bölge, öncelik ve işletim sistemi dahil olmak üzere bir nodearray tarafından kullanılan VM boyutunun ayrıntıları.
Örnek : [ "object" ]		 < Şey> Dizi
hours
required		 Bu kategori için çekirdek saat kullanımı sayısı
Örnek : 0.0		 number
node
optional		 Kullanımın olduğu düğümün veya nodearray'nin adı (küme düzeyinde veriler için yok)
Örnek : "string"		 string

Şey

Name Description Schema
core_count
optional		 Bu VM boyutundaki çekirdek sayısı
Örnek : 0.0		 number
cost
optional		 Bu VM boyutunun maliyeti
Örnek : 0.0		 number
hours
optional		 Bu VM boyutu için çekirdek saat kullanımı sayısı
Örnek : 0.0		 number
os
optional		 İşletim sistemi türü
Örnek : "string"		 sabit listesi (Windows, Linux)
priority
optional		 VM SKU'sunun önceliği
Örnek : "string"		 sabit listesi (Normal, Nokta)
region
optional		 VM boyutunun başlatılmış olduğu bölge
Örnek : "string"		 string
vm_size
optional		 VM SKU boyutu
Örnek : "string"		 string

Node

Düğüm kaydı

Tür: nesne

NodeCreationRequest

Kümeye düğüm eklemeyi belirtir

Name Description Schema
Requestıd
optional		 Ağ iletişim hataları varsa yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu değer dahil edilirse ve önceki bir istek kimliğiyle eşleşirse, sunucu bu isteği yoksayar ve 409 hatası döndürür.
Örnek : "00000000-0000-0000-0000-000000000000"		 string
Ayarlar
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.
Örnek : [ "object" ]		 < Ayarlar> Dizi

Ayarlar

Name Description Schema
count
required		 Oluşturulacak düğüm sayısı
Örnek : 1		 integer
definition
optional		 Kullanılacak demetin tanımı, 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"		 definition
nameFormat
optional		 Belirtilirse, düğümler standart "nodearray-%d" biçimi yerine bu adlandırma kuralını kullanır
Örnek : "custom-name-%d"		 string
nameOffset
optional		 Verildiyse nameFormat ile birlikte yeni düğümler için düğüm dizinini kaydırıyor.
Örnek : 1		 integer
nodeAttributes
optional		 Bu kümeden her düğümde ayarlanacak ek öznitelikler
Örnek : "[node](#node)"		 Node
nodearray
required		 Düğümleri başlatacak nodearray'nin adı
Örnek : "execute"		 string
placementGroupId
optional		 Verilirse, groupId için aynı değere sahip düğümlerin tümü aynı yerleştirme grubunda başlar.
Örnek : "string"		 string

Tanımı

Name Description Schema
machineType
optional		 Örnek : "A2" string

NodeCreationResult

Name Description Schema
operationId
required		 Bu işlemin kimliği
Örnek : "00000000-0000-0000-0000-000000000000"		 string
Ayarlar
required		 İstektekiyle aynı sırada bir küme dizisi
Örnek : [ "object" ]		 < Ayarlar> Dizi

Ayarlar

Name Description Schema
Eklen -di
required		 Bu kümede kaç düğüm başlatıldı?
Örnek : 1		 integer
message
optional		 Varsa, istenen tüm düğümlerin neden eklenemediğine işaret eder
Örnek : "string"		 string

NodeList

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

Name Description Schema
nodes
required		 Döndürülen düğümler
Örnek : [ "[node](#node)" ]		 < Düğüm> Dizi
operation
optional		 Sorgu bir işlem kimliği içeriyorsa işlemin durumu
Ö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.

Name Description Schema
filter
optional		 Düğümler ile eşleşen bir filtre ifadesi. İfadedeki dizeler düzgün tırnak içine alınmalıdır.
Örnek : "State === \"Started\""		 string
Hostname
optional		 Yönetecek kısa konak adlarının listesi (etki alanı olmadan)
Örnek : [ "hostname1", "hostname2" ]		 < dize > dizisi
Kimlik
optional		 Yönetecek düğüm kimliklerinin listesi
Örnek : [ "id1", "id2" ]		 < dize > dizisi
ip_addresses
optional		 Yönetecek IP adreslerinin listesi
Örnek : [ "10.0.1.1", "10.1.1.2" ]		 < dize > dizisi
names
optional		 Yönetecek düğüm adlarının listesi
Örnek : [ "name1", "name2" ]		 < dize > dizisi
Requestıd
optional		 Ağ iletişim hataları varsa yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu değer dahil edilirse ve önceki bir istek kimliğiyle eşleşirse, sunucu bu isteği yoksayar ve 409 hatası döndürür.
Örnek : "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.
Örnek : [ "object" ]		 < Düğüm> Dizi
operationId
required		 Bu işlemin kimliği
Örnek : "00000000-0000-0000-0000-000000000000"		 string

Düğüm

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

OperationStatus

Bu düğüm işleminin durumu

Name Description Schema
action
required		 Örnek : "string" sabit listesi (oluştur)
startTime
required		 Bu işlem gönderildiğinde
Örnek : "2020-01-01T12:34:56Z"		 string (tarih-saat)
  • Last updated on