Kontrola współbieżności

Uwaga / Notatka

Interfejsy API portalu Cloud Partner Portal są zintegrowane z Partner Center i będą nadal w nim działać. Przejście wprowadza niewielkie zmiany. Przejrzyj zmiany wymienione w Dokumentacja interfejsu API portalu Cloud Partner Portal, aby upewnić się, że kod będzie nadal działać po przejściu do Centrum partnerskiego. Interfejsy API CPP powinny być używane tylko dla istniejących produktów, które zostały już zintegrowane przed przejściem do Centrum partnerskiego; nowe produkty powinny używać interfejsów API przesyłania w Centrum partnerskim.

Każde wywołanie interfejsów API publikowania portalu dla partnerów w chmurze musi jawnie określać, która strategia kontroli współbieżności ma być używana. Niepodanie nagłówka If-Match spowoduje wyświetlenie odpowiedzi o błędzie HTTP 400. Oferujemy dwie strategie kontroli współbieżności.

• Optymistyczny — klient wykonujący aktualizację sprawdza, czy dane uległy zmianie od czasu ostatniego odczytu danych.
• Ostatnia wygrana — klient bezpośrednio aktualizuje dane, niezależnie od tego, czy inna aplikacja zmodyfikowała je od czasu ostatniego odczytu.

Optymistyczny przepływ pracy współbieżności

Zalecamy użycie optymistycznej strategii współbieżności z następującym przepływem pracy, aby zagwarantować, że w zasobach nie zostaną wprowadzone żadne nieoczekiwane zmiany.

1. Pobieranie jednostki przy użyciu interfejsów API. Odpowiedź zawiera wartość ETag, która identyfikuje aktualnie przechowywaną wersję jednostki (w momencie odpowiedzi).
2. W momencie aktualizacji uwzględnij tę samą wartość ETag w obowiązkowym nagłówku żądania If-Match .
3. Interfejs API porównuje wartość ETag otrzymaną w żądaniu z bieżącą wartością ETag jednostki w transakcji niepodzielnej.
   • Jeśli wartości elementu ETag są różne, interfejs API zwraca 412 Precondition Failed odpowiedź HTTP. Ten błąd wskazuje, że albo inny proces zaktualizował jednostkę od czasu ostatniego pobrania jej przez klienta, albo że wartość ETag określona w żądaniu jest niepoprawna.
   • Jeśli wartości elementu ETag są takie same lub nagłówek If-Match zawiera symbol wieloznaczny gwiazdki (*), interfejs API wykonuje żądaną operację. Operacja interfejsu API aktualizuje również przechowywaną wartość ETag jednostki.

Uwaga / Notatka

Określenie symbolu wieloznacznego (*) w nagłówku If-Match powoduje użycie w interfejsie API strategii współbieżności Last-one-wins. W takim przypadku porównanie ETag nie ma miejsca, a zasób jest aktualizowany bez żadnych kontroli.