Düğüm Geçişlerini Başlat

Makale
08/05/2023

Küme düğümünü başlatır veya durdurur.

Küme düğümünü başlatır veya durdurur. Küme düğümü, işletim sistemi örneğinin kendisi değil bir işlemdir. Bir düğümü başlatmak için NodeTransitionType parametresi için "Başlat" yazın. Düğümü durdurmak için NodeTransitionType parametresi için "Durdur" yazın. Bu API işlemi başlatır: API döndürdüğünde düğümün geçişi henüz tamamlanmamış olabilir. İşlemin ilerleme durumunu almak için aynı OperationId ile GetNodeTransitionProgress'i çağırın.

İstek

Yöntem	İstek URI'si
POST	`/Faults/Nodes/{nodeName}/$/StartTransition/?api-version=6.0&OperationId={OperationId}&NodeTransitionType={NodeTransitionType}&NodeInstanceId={NodeInstanceId}&StopDurationInSeconds={StopDurationInSeconds}&timeout={timeout}`

Parametreler

Ad	Tür	Gerekli	Konum
`nodeName`	string	Yes	Yol
`api-version`	string	Yes	Sorgu
`OperationId`	string (uuid)	Yes	Sorgu
`NodeTransitionType`	string (sabit listesi)	Yes	Sorgu
`NodeInstanceId`	string	Yes	Sorgu
`StopDurationInSeconds`	integer (int32)	Yes	Sorgu
`timeout`	integer (int64)	No	Sorgu

`nodeName`

Tür: dize
Gerekli: Evet

Düğümün adı.

`api-version`

Tür: dize
Gerekli: Evet
Varsayılan: 6.0

API'nin sürümü. Bu parametre gereklidir ve değeri '6.0' olmalıdır.

Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenen yanıttan farklı olabilir.

Ayrıca çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul edin. Bu nedenle, en son API sürümü 6.0 ise ancak çalışma zamanı 6.1 ise, istemcileri yazmayı kolaylaştırmak için çalışma zamanı bu API için sürüm 6.1'i kabul eder. Ancak API'nin davranışı, belgelenen 6.0 sürümüne göre olacaktır.

`OperationId`

Tür: dize (uuid)
Gerekli: Evet

Bu API'nin çağrısını tanımlayan GUID. Bu, karşılık gelen GetProgress API'sine geçirilir

`NodeTransitionType`

Tür: dize (sabit listesi)
Gerekli: Evet

Gerçekleştirilecek geçişin türünü gösterir. NodeTransitionType.Start durdurulmuş bir düğümü başlatır. NodeTransitionType.Stop, çalışır durumda olan bir düğümü durdurur. Olası değerler şunlardır: 'Invalid', 'Start', 'Stop'

`NodeInstanceId`

Tür: dize
Gerekli: Evet

Hedef düğümün düğüm örneği kimliği. Bu, GetNodeInfo API'si aracılığıyla belirlenebilir.

`StopDurationInSeconds`

Tür: tamsayı (int32)
Gerekli: Evet
InclusiveMinimum: 0

Düğümün durdurulmasını sağlamak için saniye cinsinden süre. En düşük değer 600, maksimum değer 14400'dür. Bu süre dolduktan sonra düğüm otomatik olarak geri gelir.

`timeout`

Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.

Yanıtlar

HTTP Durum Kodu	Description	Yanıt Şeması
202 (Kabul Edildi)	202 durum kodu işlemin kabul edildiğine işaret eder. İlerleme durumunu almak için GetNodeTransitionProgress API'sini çağırın.
Diğer tüm durum kodları	Ayrıntılı hata yanıtı.	Doku Oluşturucu

Aracılığıyla paylaş