Dela via

Samtidighetskontroll

  • Artikel

Kommentar

API:erna för Molnpartnerportalen är integrerade med och fortsätter att fungera i Partnercenter. Övergången introducerar små ändringar. Granska ändringarna som anges i API-referensen för Cloud Partner Portal för att se till att koden fortsätter att fungera efter övergången till Partnercenter. CPP-API:er bör endast användas för befintliga produkter som redan var integrerade före övergången till Partnercenter. nya produkter ska använda API:er för insändning av Partnercenter.

Varje anrop till cloud partner-portalens publicerings-API:er måste uttryckligen ange vilken strategi för samtidighetskontroll som ska användas. Om du inte anger If-Match-huvudet resulterar det i ett HTTP 400-felsvar. Vi erbjuder två strategier för samtidighetskontroll.

  • Optimistisk – Klienten som utför uppdateringen verifierar om data har ändrats sedan den senast läste data.
  • Senaste vinner – Klienten uppdaterar data direkt, oavsett om ett annat program har ändrat dem sedan den senaste lästiden.

Optimistiskt samtidighetsarbetsflöde

Vi rekommenderar att du använder den optimistiska samtidighetsstrategin med följande arbetsflöde för att garantera att inga oväntade ändringar görs i dina resurser.

  1. Hämta en entitet med api:erna. Svaret innehåller ett ETag-värde som identifierar den för närvarande lagrade versionen av entiteten (vid tidpunkten för svaret).
  2. Vid tidpunkten för uppdateringen inkluderar du samma ETag-värde i det obligatoriska if-match-begärandehuvudet .
  3. API:et jämför ETag-värdet som togs emot i begäran med det aktuella ETag-värdet för entiteten i en atomisk transaktion.
    • Om ETag-värdena skiljer sig returnerar API:et ett 412 Precondition Failed HTTP-svar. Det här felet anger att en annan process har uppdaterat entiteten sedan klienten senast hämtade den, eller att ETag-värdet som anges i begäran är felaktigt.
    • Om ETag-värdena är desamma, eller om If-Match-huvudet innehåller jokertecknet asterisk (*), utför API:et den begärda åtgärden. API-åtgärden uppdaterar också det lagrade ETag-värdet för entiteten.

Kommentar

Om du anger jokertecknet (*) i if-match-huvudet resulterar det i API:et med hjälp av samtidighetsstrategin Senaste-en-vinner. I det här fallet sker inte ETag-jämförelsen och resursen uppdateras utan några kontroller.