Udostępnij za pośrednictwem

Przenoszenie wystąpienia

  • Artykuł

Przenosi wystąpienie partycji usługi bezstanowej.

To polecenie przenosi wystąpienie partycji usługi bezstanowej, z uwzględnieniem wszystkich ograniczeń. Aby można było przenieść wystąpienie, należy określić identyfikator partycji i nazwę usługi. CurrentNodeName po określeniu identyfikuje przeniesione wystąpienie. Jeśli nie zostanie określony, losowe wystąpienie zostanie przeniesione Nowa nazwa węzła można pominąć, a w takim przypadku wystąpienie zostanie przeniesione do węzła losowego. Jeśli parametr IgnoreConstraints zostanie określony i ustawiony na wartość true, wystąpienie zostanie przeniesione niezależnie od ograniczeń.

Żądanie

Metoda Identyfikator URI żądania
POST /Services/{serviceId}/$/GetPartitions/{partitionId}/$/MoveInstance?api-version=8.0&CurrentNodeName={CurrentNodeName}&NewNodeName={NewNodeName}&IgnoreConstraints={IgnoreConstraints}&timeout={timeout}

Parametry

Nazwa Typ Wymagane Lokalizacja
serviceId ciąg Tak Ścieżka
partitionId string (uuid) Tak Ścieżka
api-version ciąg Tak Zapytanie
CurrentNodeName ciąg Nie Zapytanie
NewNodeName ciąg Nie Zapytanie
IgnoreConstraints boolean Nie Zapytanie
timeout liczba całkowita (int64) Nie Zapytanie

serviceId

Typ: ciąg
Wymagane: Tak

Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi będzie miała wartość "myapp~app1~svc1" w wersji 6.0 lub nowszej oraz "myapp/app1/svc1" w poprzednich wersjach.

partitionId

Typ: ciąg (uuid)
Wymagane: Tak

Tożsamość partycji.

api-version

Typ: ciąg
Wymagane: Tak
Ustawienie domyślne: 8.0

Wersja interfejsu API. Ten parametr jest wymagany, a jego wartość musi mieć wartość "8.0".

Wersja interfejsu API REST usługi Service Fabric jest oparta na wersji środowiska uruchomieniowego, w której wprowadzono lub zmieniono interfejs API. Środowisko uruchomieniowe usługi Service Fabric obsługuje więcej niż jedną wersję interfejsu API. Ta wersja jest najnowszą obsługiwaną wersją interfejsu API. Jeśli zostanie przekazana niższa wersja interfejsu API, zwrócona odpowiedź może być inna niż ta udokumentowana w tej specyfikacji.

Ponadto środowisko uruchomieniowe akceptuje wszystkie wersje wyższe niż najnowsza obsługiwana wersja do bieżącej wersji środowiska uruchomieniowego. Jeśli więc najnowsza wersja interfejsu API to 6.0, a środowisko uruchomieniowe to 6.1, środowisko uruchomieniowe zaakceptuje wersję 6.1 dla tego interfejsu API. Jednak zachowanie interfejsu API będzie zgodnie z udokumentowaną wersją 6.0.

CurrentNodeName

Typ: ciąg
Wymagane: Nie

Nazwa węzła źródłowego do przeniesienia wystąpienia. Jeśli nie zostanie określony, wystąpienie zostanie przeniesione z węzła losowego.

NewNodeName

Typ: ciąg
Wymagane: Nie

Nazwa węzła docelowego dla przenoszenia repliki pomocniczej lub wystąpienia. Jeśli nie zostanie określony, replika lub wystąpienie zostanie przeniesione do węzła losowego.

IgnoreConstraints

Typ: wartość logiczna
Wymagane: Nie
Ustawienie domyślne: false

Ignoruj ograniczenia podczas przenoszenia repliki lub wystąpienia. Jeśli ten parametr nie zostanie określony, wszystkie ograniczenia zostaną uznane.

timeout

Typ: liczba całkowita (int64)
Wymagane: Nie
Ustawienie domyślne: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund.

Odpowiedzi

Kod stanu HTTP Opis Response Schema
200 (OK) Żądanie pomyślnej operacji zwróci kod stanu 200.
Wszystkie inne kody stanu Szczegółowa odpowiedź na błąd.
 Błąd sieci szkieletowej