İşlemi İptal Et

Makale
08/05/2023

Kullanıcı tarafından oluşturulan hata işlemini iptal eder.

Aşağıdaki API'ler CancelOperation kullanılarak iptal edilebilecek hata işlemlerini başlatır: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.

Zorlama false ise, belirtilen kullanıcı tarafından oluşturulan işlem düzgün bir şekilde durdurulur ve temizlenir. Zorlama true ise, komut durdurulur ve bazı iç durum geride bırakılabilir. Kuvvet değerinin true olarak belirtilmesi dikkatli kullanılmalıdır. Bu API'nin zorlamalı olarak true olarak ayarlanmasına izin verilmemesi için, bu API'nin aynı test komutunda ilk olarak false olarak ayarlanmış zorlamalı olarak çağrılması veya test komutunun OperationState.RollingBack operationState değeri zaten olmadığı sürece çağrılmaması gerekir. Netleştirme: OperationState.RollingBack, sistemin komutun yürütülmesinden kaynaklanan iç sistem durumunu temizlediği anlamına gelir. Test komutu veri kaybına neden olacaksa verileri geri yüklemez. Örneğin, StartDataLoss'u ve ardından bu API'yi çağırırsanız, sistem yalnızca iç durumu komutu çalıştırmadan temizler. Komut veri kaybına neden olacak kadar ilerlediyse hedef bölümün verilerini geri yüklemez.

Önemli not: Bu API force==true ile çağrılırsa iç durum geride bırakılabilir.

İstek

Yöntem	İstek URI'si
POST	`/Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout}`

Parametreler

Ad	Tür	Gerekli	Konum
`api-version`	string	Yes	Sorgu
`OperationId`	string (uuid)	Yes	Sorgu
`Force`	boolean	Yes	Sorgu
`timeout`	integer (int64)	No	Sorgu

`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

`Force`

Tür: boole
Gerekli: Evet
Varsayılan: false

Kullanıcı tarafından oluşturulan işlem yürütülerek değiştirilmiş iç sistem durumunu düzgün bir şekilde geri alıp almamayı ve temizlemeyi gösterir.

`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ı
200 (Tamam)	Başarılı bir işlem 200 durum kodu döndürür.
Diğer tüm durum kodları	Ayrıntılı hata yanıtı.	Doku Oluşturucu

Aracılığıyla paylaş