Operations

Küme düğümlerini alma

GET /clusters/{cluster}/nodes

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Sorguya almak için küme string
Sorgu Işlem
Isteğ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 string
Sorgu request_id
Isteğe bağlı
Verilirse, yalnızca bu istek kimliğiyle tanımlanan işlemin düğümlerini döndürür.
ve gövdesinde işlem özniteliğini içerir
string

Yanıtlar

HTTP Kodu Description Ş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

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

Description

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

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Düğümlerin kaldırılacağı küme string
Gövde Eylem
Gerekli
Kaldırılacak düğümlerin açıklaması NodeManagementRequest

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

Description

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

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.

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Düğümleri başlatacak küme string
Gövde Eylem
gerekli
Başlatacak düğümlerin açıklaması NodeManagementRequest

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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}

Description

Bu işlem, bir nodearray'ye gereken düğümleri arak 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.

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Düğümlerin ekleneceği küme string
Yol nodearray
gerekli
Düğümlerin ekleneceği nodearray string
Sorgu totalCoreCount
Isteğe bağlı
Önceden oluşturulmuş düğümler de dahil olmak üzere bu nodearray'de sahip olacak toplam çekirdek sayısı tamsayı
Sorgu totalNodeCount
Isteğe bağlı
Önceden oluşturulmuş düğümler de dahil olmak üzere bu nodearray'de sahip olacak toplam makine sayısı tamsayı

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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, demetteki düğüm sayısı, eklenebilecek düğüm sayısı 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ı tarafından belirlenir, ancak sınırlar kısmen bulut sağlayıcısı tarafından belirlenir.

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Sorguya almak için küme string
Sorgu Düğüm
Isteğe bağlı
True ise, yanıtta düğümler ve düğüm başvuruları döndürülür boolean

Yanıtlar

HTTP Kodu Description Ş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"
}

İşlemlerin durumunu Listeler

GET /operations/

Parametreler

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

Yanıtlar

HTTP Kodu Description Ş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}

Parametreler

Tür Ad Açıklama Şema
Yol id
Gerekli
İşlem kimliği string

Yanıtlar

HTTP Kodu Description Ş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"
}

Küme düğümlerini alma

GET /clusters/{cluster}/nodes

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Sorguya almak için küme string
Sorgu Işlem
Isteğ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 string
Sorgu request_id
Isteğe bağlı
Verilirse, yalnızca bu istek kimliğiyle tanımlanan işlemin düğümlerini döndürür.
ve gövdesinde işlem özniteliğini içerir
string

Yanıtlar

HTTP Kodu Description Ş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

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

Description

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

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Düğümlerin kaldırılacağı küme string
Gövde Eylem
gerekli
Kaldırılacak düğümlerin açıklaması NodeManagementRequest

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

Description

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

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.

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Düğümleri başlatacak küme string
Gövde Eylem
Gerekli
Başlatacak düğümlerin açıklaması NodeManagementRequest

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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

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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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 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}

Description

Bu işlem, toplam sayıya isabet etmek için düğümleri gerektiği gibi bir nodearray'ye ekler. İ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.

Parametreler

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

Yanıtlar

HTTP Kodu Description Şema
202 Kabul edildi
Ü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, demetteki düğüm sayısı, eklenebilecek düğüm sayısı 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ı tarafından belirlenir, ancak sınırlar kısmen bulut sağlayıcısı tarafından belirlenir.

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Sorguya bağlanacak küme string
Sorgu Düğüm
Isteğe bağlı
True ise, yanıtta düğümler ve düğüm başvuruları döndürülür boolean

Yanıtlar

HTTP Kodu Description Ş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

Description

Bu işlem, küme için genel kullanım verilerini (ç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.

Parametreler

Tür Ad Açıklama Şema
Yol Küme
gerekli
Kullanım verilerinin döndürüleceği küme string
Sorgu Süre
Isteğ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 cinsindendir. enum (monthToDate, lastMonth, weekToDate, özel)
Sorgu Kaynak
Isteğ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 saat veya güne yuvarlanır. string
Sorgu Hedef
Isteğe bağlı
Özel zaman çerçeveleri için bu, ISO-8601 biçimindeki zaman çerçevesinin sonudur. Bu, en yakın saat veya güne yuvarlanmış olur. string
Sorgu Taneciklilik
Isteğ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ıtlar

HTTP Kodu Description Ş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/

Parametreler

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

Yanıtlar

HTTP Kodu Description Ş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}

Parametreler

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

Yanıtlar

HTTP Kodu Description Ş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
tamsayı
maxCount
gerekli
Bu kümeye eklenebilecek en fazla düğüm sayısı
Örnek : 4
tamsayı
nodearrays
gerekli
Örnek : [ "object" ] <nodearrays> Dizi
Düğüm
Isteğe bağlı
Bu kümedeki isteğe bağlı düğüm listesi, yalnızca node=true sorgudaysa dahil edilir
Örnek : [ "[node](#node)" ]
<Düğüm> Dizi
Durum
Isteğe bağlı
Kümenin en az bir kez başlatıldıysa geçerli durumu
Örnek : "Starting"
string
targetState
Isteğe bağlı
Kümenin istenen durumu (örneğin Başlatıldı veya Sonlandırıldı)
Örnek : "Started"
string

nodearrays

Ad Açıklama Şema
Kova
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" ]
<Kova> Dizi
maxCoreCount
Gerekli
Bu nodearray'de olabilecek en fazla çekirdek sayısı
Örnek : 16
tamsayı
maxCount
gerekli
Bu nodearray içinde olabilecek en fazla düğüm sayısı
Örnek : 4
tamsayı
Adı
gerekli
Bu açıklamanın açıklandığı nodearray
Örnek : "execute"
string
nodearray
gerekli
Bu nodearray'nin öznitelikleri
Örnek : "[node](#node)"
Node

Kova

Ad Açıklama Şema
activeCoreCount
Gerekli
Bu nodearray'de bu demet için kullanılan çekirdek sayısı
Örnek : 40
tamsayı
activeCount
gerekli
Bu düğüm dizisinde, bu demet için kullanılan düğüm sayısı. Buna vm almaya devam eden düğümler dahildir.
Örnek : 10
tamsayı
activeNodes
Isteğe bağlı
Bu nodearray'de 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 > dizisi
availableCoreCount
Gerekli
Bu düğüm dizisinde, bu demette kaç tane ek çekirdek oluşturulabileceği. Her zaman availableCount'un bir katı.
Örnek : 8
tamsayı
availableCount
gerekli
Bu düğüm dizisinde, bu demette kaç tane 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
tamsayı
bucketId
gerekli
Bu demetin tanımlayıcısı. Küme silinmediği sürece düğüm dizisindeki belirli bir demet için her zaman aynı değere sahip olur.
Örnek : "00000000-0000-0000-0000-000000000000"
string
consumedCoreCount
gerekli
Bu aile için bölgenin tamamında zaten kullanımda olan çekirdek sayısı.
Örnek : 2
tamsayı
Tanımı
Isteğe bağlı
Bu demetten düğüm oluşturmak için kullanılan bu demetin özellikleri. Create-nodes API'si bucket özelliğinde bu tanımı alır.
Örnek : "object"
Tanımı
familyConsumedCoreCount
Isteğe bağlı
Bu aile için bölgenin tamamında zaten kullanımda olan çekirdek sayısı.
Örnek : 2
tamsayı
familyQuotaCoreCount
Isteğ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
tamsayı
familyQuotaCount
Isteğe bağlı
Başlatılabilir toplam örnek sayısı (verilen familyQuotaCoreCount)
Örnek : 4
tamsayı
invalidReason
gerekli
Geçerli değeri false ise, demetin geçersiz olmasının nedeni bu olacaktır. Şu anda tek nedenler NotActivated ve DisabledMachineType'tır.
Örnek : "DisabledMachineType"
string
maxCoreCount
gerekli
Genel ve nodearray sınırları dahil olmak üzere bu demette bulunabilecek maksimum çekirdek sayısı. Her zaman maxCount'un bir katı.
Örnek : 16
tamsayı
maxCount
gerekli
Genel ve nodearray sınırları dahil olmak üzere bu demette olabilecek en fazla düğüm sayısı
Örnek : 4
tamsayı
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
tamsayı
maxPlacementGroupSize
gerekli
Bu demetteki bir yerleştirme grubunda bulunabilecek toplam örnek sayısı üst sınırı
Örnek : 16
tamsayı
placementGroups
gerekli
Varsa, bu nodearray için kullanılan yerleştirme grupları.
Örnek : [ "object" ]
<placementGroups> Dizi
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
tamsayı
quotaCount
gerekli
Başlatılabilir toplam örnek sayısı (verilen quotaCoreCount)
Örnek : 4
tamsayı
regionalConsumedCoreCount
Isteğe bağlı
Tüm bölgede zaten kullanımda olan çekirdek sayısı.
Örnek : 2
tamsayı
regionalQuotaCoreCount
Isteğe bağlı
Bu bölgede başlatılabilir toplam çekirdek sayısı. Bu, regionalQuotaCount'un tamsayı katı olmayabilir.
Örnek : 16
tamsayı
regionalQuotaCount
Isteğe bağlı
Başlatılabilir toplam örnek sayısı (regionalQuotaCoreCount değeri verilmelidir)
Örnek : 4
tamsayı
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"
string

placementGroups

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

virtualMachine

Ad Açıklama Şema
gpuCount
Gerekli
Bu makine türündeki GPU sayısı
Örnek : 2
tamsayı
ınfiniband
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
tamsayı
vcpuCount
gerekli
Bu makine türünün sahip olduğu sanal CPU sayısı
Örnek : 32
tamsayı

Düğüm

Düğüm kaydı

Tür : object

NodeCreationRequest

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

Ad Açıklama Şema
requestId
Isteğe bağlı
Ağ iletişimi hataları durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu 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
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" ]
<Ayarlar> Dizi

Ayarlar

Ad Açıklama Şema
Sayısı
gerekli
Oluşturulacak düğüm sayısı
Örnek : 1
tamsayı
Tanımı
Isteğ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 bucket özelliğinin tamamı eksikse, verilen öğelerle eşleşen ilk demet kullanılır.
Örnek : "object"
Tanımı
nameFormat
Isteğe bağlı
Belirtilirse, düğümler standart "nodearray-%d" biçimi yerine bu adlandırma kuralını kullanır
Örnek : "custom-name-%d"
string
nameOffset
Isteğe bağlı
Verilirse, nameFormat ile birlikte yeni düğümler için nodeindex'i uzaklıklar.
Örnek : 1
tamsayı
nodeAttributes
Isteğe bağlı
Bu kümeden her düğümde ayarlanacak ek öznitelikler
Örnek : "[node](#node)"
Node
nodearray
Gerekli
Düğümleri başlatacak nodearray'nin adı
Örnek : "execute"
string
placementGroupId
Isteğe bağlı
Belirtilirse, groupId için aynı değere sahip düğümlerin tümü aynı yerleştirme grubunda başlatılır.
Örnek : "string"
string

Tanımı

Ad Açıklama Şema
machineType
Isteğe bağlı
Örnek : "A2" string

NodeCreationResult

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

Ayarlar

Ad Açıklama Şema
Eklen -di
Gerekli
Bu kümede kaç düğüm başlatıldı?
Örnek : 1
tamsayı
ileti
Isteğe bağlı
Varsa, istenen tüm düğümlerin neden eklenmediğini gösterir
Örnek : "string"
string

Nodelist

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

Ad Açıklama Şema
Düğüm
Gerekli
Döndürülen düğümler
Örnek : [ "[node](#node)" ]
<Düğüm> Dizi
Işlem
Isteğe bağlı
Sorgu bir işlem kimliği içeriyorsa, bu işlemin durumudur
Örnek : "[operationstatus](#operationstatus)"
OperationStatus

NodeManagementRequest

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
Isteğ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\""
string
Hostname
Isteğe bağlı
Yönetecek kısa konak adlarının (etki alanı olmadan) listesi
Örnek : [ "hostname1", "hostname2" ]
< dize > dizisi
Kimlik
Isteğe bağlı
Yönetecek düğüm kimliklerinin listesi
Örnek : [ "id1", "id2" ]
< dize > dizisi
ip_addresses
Isteğe bağlı
Yönetecek IP adreslerinin listesi
Örnek : [ "10.0.1.1", "10.1.1.2" ]
< dize > dizisi
Ad -larını
Isteğe bağlı
Yönetecek düğüm adlarının listesi
Örnek : [ "name1", "name2" ]
< dize > dizisi
requestId
Isteğe bağlı
Ağ iletişimi hataları olması durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu 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

Ad Açıklama Şema
Düğüm
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" ]
<Düğüm> Dizi
operationId
gerekli
Bu işlemin kimliği
Örnek : "00000000-0000-0000-0000-000000000000"
string

Düğüm

Ad Açıklama Şema
Hata
Isteğe bağlı
Durum Hata ise, bu hata iletisini içerir
Örnek : "This node must be terminated before it can be removed"
string
id
Gerekli
Düğümün kimliği
Örnek : "id1"
string
Adı
Gerekli
Düğümün adı
Örnek : "name1"
string
Durum
Isteğe bağlı
Tamam veya Hatadan Biri
Örnek : "Error"
enum (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)

ClusterStatus

Kümenin durumu

Ad Açıklama Şema
maxCoreCount
Gerekli
Bu kümeye eklenebilecek en fazla çekirdek sayısı
Örnek : 16
tamsayı
maxCount
Gerekli
Bu kümeye eklenebilecek en fazla düğüm sayısı
Örnek : 4
tamsayı
nodearrays
Gerekli
Örnek : [ "object" ] <nodearrays> Dizi
Düğüm
Isteğe bağlı
Bu kümedeki isteğe bağlı düğüm listesi, yalnızca node=true sorgudaysa dahil edilir
Örnek : [ "[node](#node)" ]
<Düğüm> Dizi
Durum
Isteğe bağlı
Kümenin en az bir kez başlatıldıysa geçerli durumu
Örnek : "Starting"
string
targetState
Isteğe bağlı
Kümenin istenen durumu (örneğin Başlatıldı veya Sonlandırıldı)
Örnek : "Started"
string

nodearrays

Ad Açıklama Şema
Kova
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" ]
<Kova> Dizi
maxCoreCount
gerekli
Bu nodearray'de olabilecek en fazla çekirdek sayısı
Örnek : 16
tamsayı
maxCount
gerekli
Bu nodearray içinde olabilecek en fazla düğüm sayısı
Örnek : 4
tamsayı
Adı
Gerekli
Bu açıklamanın açıklandığı nodearray
Örnek : "execute"
string
nodearray
gerekli
Bu nodearray'nin öznitelikleri
Örnek : "[node](#node)"
Node

Kova

Ad Açıklama Şema
activeCoreCount
Gerekli
Bu nodearray'de bu demet için kullanılan çekirdek sayısı
Örnek : 40
tamsayı
activeCount
Gerekli
Bu düğüm dizisinde, bu demet için kullanılan düğüm sayısı. Buna vm almaya devam eden düğümler dahildir.
Örnek : 10
tamsayı
activeNodes
Isteğe bağlı
Bu nodearray'de 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 > dizisi
availableCoreCount
Gerekli
Bu düğüm dizisinde, bu demette kaç tane ek çekirdek oluşturulabileceği. Her zaman availableCount'un bir katı.
Örnek : 8
tamsayı
availableCount
Gerekli
Bu düğüm dizisinde, bu demette kaç tane 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
tamsayı
bucketId
Gerekli
Bu demetin tanımlayıcısı. Küme silinmediği sürece düğüm dizisindeki belirli bir demet için her zaman aynı değere sahip olur.
Örnek : "00000000-0000-0000-0000-000000000000"
string
consumedCoreCount
Gerekli
Bu aile için bölgenin tamamında zaten kullanımda olan çekirdek sayısı.
Örnek : 2
tamsayı
Tanımı
Isteğe bağlı
Bu demetten düğüm oluşturmak için kullanılan bu demetin özellikleri. Create-nodes API'si bucket özelliğinde bu tanımı alır.
Örnek : "object"
Tanımı
familyConsumedCoreCount
Isteğe bağlı
Bu aile için bölgenin tamamında zaten kullanımda olan çekirdek sayısı.
Örnek : 2
tamsayı
familyQuotaCoreCount
Isteğ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
tamsayı
familyQuotaCount
Isteğe bağlı
Başlatılabilir toplam örnek sayısı (verilen familyQuotaCoreCount)
Örnek : 4
tamsayı
invalidReason
gerekli
Geçerli değeri false ise, demetin geçersiz olmasının nedeni bu olacaktır. Şu anda tek nedenler NotActivated ve DisabledMachineType'tır.
Örnek : "DisabledMachineType"
string
lastCapacityFailure
gerekli
Bu demeti son kez kapasite hatasıyla karşılaştığından bu yana saniye cinsinden ne kadar süreyle. Negatif değerler hiçbir zaman olarak değerlendirilmez.
Örnek : 180.0
sayı
maxCoreCount
Gerekli
Genel ve nodearray sınırları dahil olmak üzere bu demette bulunabilecek maksimum çekirdek sayısı. Her zaman maxCount'un bir katı.
Örnek : 16
tamsayı
maxCount
gerekli
Genel ve nodearray sınırları dahil olmak üzere bu demette olabilecek en fazla düğüm sayısı
Örnek : 4
tamsayı
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
tamsayı
maxPlacementGroupSize
gerekli
Bu demetteki bir yerleştirme grubunda bulunabilecek toplam örnek sayısı üst sınırı
Örnek : 16
tamsayı
placementGroups
gerekli
Varsa, bu nodearray için kullanılan yerleştirme grupları.
Örnek : [ "object" ]
<placementGroups> Dizi
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
tamsayı
quotaCount
gerekli
Başlatılabilir toplam örnek sayısı (verilen quotaCoreCount)
Örnek : 4
tamsayı
regionalConsumedCoreCount
Isteğe bağlı
Tüm bölgede zaten kullanımda olan çekirdek sayısı.
Örnek : 2
tamsayı
regionalQuotaCoreCount
Isteğe bağlı
Bu bölgede başlatılabilir toplam çekirdek sayısı. Bu, regionalQuotaCount'un tamsayı katı olmayabilir.
Örnek : 16
tamsayı
regionalQuotaCount
Isteğe bağlı
Başlatılabilir toplam örnek sayısı (regionalQuotaCoreCount değeri verilmelidir)
Örnek : 4
tamsayı
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"
string

placementGroups

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

virtualMachine

Ad Açıklama Şema
gpuCount
gerekli
Bu makine türündeki GPU sayısı
Örnek : 2
tamsayı
ınfiniband
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
tamsayı
vcpuCount
Gerekli
Bu makine türünün sahip olduğu sanal CPU sayısı
Örnek : 32
tamsayı
vcpuQuotaCount
Isteğe bağlı
Bu makinenin kotadan kullandığı vCPU sayısı
Örnek : 2
tamsayı

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> Dizi

Kullanım

Ad Açıklama Şema
Arıza
gerekli
Bu aralıktaki kullanımın "node" ve "nodearray" kategorisine göre dökümü
Örnek : [ "[clusterusageitem](#clusterusageitem)" ]
<ClusterUsageItem> Dizi
Son -unda
Gerekli
Aralığın sonu (özel)
Örnek : "string"
string
Başlatmak
gerekli
Aralığın başlangıcı (dahil)
Örnek : "string"
string
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
Isteğ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ı
Şey
Isteğe bağlı
Saat, core_count, bölge önceliği ve işletim sistemi dahil olmak üzere nodearray tarafından kullanılan VM boyutunun ayrıntıları.
Örnek : [ "object" ]
<Şey> Dizi
Saat
Gerekli
Bu kategori için çekirdek saat kullanım sayısı
Örnek : 0.0
sayı
Düğüm
Isteğe bağlı
Kullanımın olduğu düğümün veya nodearray'nin adı (küme düzeyinde veriler için yoktur)
Örnek : "string"
string

Şey

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

Düğüm

Düğüm kaydı

Türü : object

NodeCreationRequest

Kümeye düğüm eklemeyi belirtir

Ad Açıklama Şema
requestId
Isteğe bağlı
Ağ iletişimi hataları durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu 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
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" ]
<Ayarlar> Dizi

Ayarlar

Ad Açıklama Şema
Sayısı
gerekli
Oluşturulacak düğüm sayısı
Örnek : 1
tamsayı
Tanımı
Isteğ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 bucket özelliğinin tamamı eksikse, verilen öğelerle eşleşen ilk demet kullanılır.
Örnek : "object"
Tanımı
nameFormat
Isteğe bağlı
Belirtilirse, düğümler standart "nodearray-%d" biçimi yerine bu adlandırma kuralını kullanır
Örnek : "custom-name-%d"
string
nameOffset
Isteğe bağlı
Verilirse, nameFormat ile birlikte yeni düğümler için nodeindex'i uzaklıklar.
Örnek : 1
tamsayı
nodeAttributes
Isteğe bağlı
Bu kümeden her düğümde ayarlanacak ek öznitelikler
Örnek : "[node](#node)"
Node
nodearray
Gerekli
Düğümleri başlatacak nodearray'nin adı
Örnek : "execute"
string
placementGroupId
Isteğe bağlı
Belirtilirse, groupId için aynı değere sahip düğümlerin tümü aynı yerleştirme grubunda başlatılır.
Örnek : "string"
string

Tanımı

Ad Açıklama Şema
machineType
Isteğe bağlı
Örnek : "A2" string

NodeCreationResult

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

Ayarlar

Ad Açıklama Şema
Eklen -di
Gerekli
Bu kümede kaç düğüm başlatıldı?
Örnek : 1
tamsayı
ileti
Isteğe bağlı
Varsa, istenen tüm düğümlerin neden eklenmediğini gösterir
Örnek : "string"
string

Nodelist

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

Ad Açıklama Şema
Düğüm
gerekli
Döndürülen düğümler
Örnek : [ "[node](#node)" ]
<Düğüm> Dizi
Işlem
Isteğ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 kabul edilir.

Ad Açıklama Şema
Filtre
Isteğ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\""
string
Hostname
Isteğe bağlı
Yönetecek kısa konak adlarının (etki alanı olmadan) listesi
Örnek : [ "hostname1", "hostname2" ]
< dize > dizisi
Kimlik
Isteğe bağlı
Yönetecek düğüm kimliklerinin listesi
Örnek : [ "id1", "id2" ]
< dize > dizisi
ip_addresses
Isteğe bağlı
Yönetecek IP adreslerinin listesi
Örnek : [ "10.0.1.1", "10.1.1.2" ]
< dize > dizisi
Ad -larını
Isteğe bağlı
Yönetecek düğüm adlarının listesi
Örnek : [ "name1", "name2" ]
< dize > dizisi
requestId
Isteğe bağlı
Ağ iletişimi hataları durumunda yinelenen işlemleri önlemek için kullanıcı tarafından sağlanan isteğe bağlı benzersiz belirteç. Bu 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

Ad Açıklama Şema
Düğüm
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" ]
<Düğüm> Dizi
operationId
Gerekli
Bu işlemin kimliği
Örnek : "00000000-0000-0000-0000-000000000000"
string

Düğüm

Ad Açıklama Şema
Hata
Isteğe bağlı
Durum Hata ise, bu hata iletisini içerir
Örnek : "This node must be terminated before it can be removed"
string
id
gerekli
Düğümün kimliği
Örnek : "id1"
string
Adı
Gerekli
Düğümün adı
Örnek : "name1"
string
Durum
Isteğ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)