Kaip veikia Batch API?
Batch API prieigos taškas, kaip dokumentuota čia, leidžia naudotojams pateikti užklausas asinchroniniam paketiniam apdorojimui. Šias užklausas apdorosime per 24 valandas. Kiekvienos užklausos duomenys bus nuskaitomi iš iš anksto įkelto failo, o atsakymai bus įrašomi į išvesties failą. Galite užklausti paketo objekto būsenos naujinių ir rezultatų.
Kokia yra Batch API kainodara?
Kiekvienas modelis bus siūlomas su 50 % kainos nuolaida, palyginti su sinchroninėmis API. Daugiau informacijos apie mūsų API kainodarą rasite čia.
Kuriuos modelius galiu apdoroti paketais?
Batch API plačiai pasiekiama daugumai mūsų modelių, bet ne visiems. Žr. modelių informacinius dokumentus, kad įsitikintumėte, jog jūsų naudojamas modelis palaiko Batch API.
Kas nutinka, jei API neužbaigia mano užklausos per pažadėtą laiką?
Siekiame visas užklausas atlikti per 24 valandas. Jei paketo galiojimas baigiasi (t. y. jo nepavyko užbaigti per SLA laiko langą), likęs darbas atšaukiamas, o bet koks jau užbaigtas darbas grąžinamas. Kūrėjams bus taikomas mokestis už bet kokį užbaigtą darbą.
Koks yra užklausų, kurias galiu apdoroti paketu, limitas?
Įterpinių API turi 1 milijono vienu metu eilėje esančių užklausų limitą.
Visoms kitoms API užklausų, kurias galite apdoroti paketu, skaičiaus limito nėra; tačiau kiekviena naudojimo pakopa turi susietą paketinio apdorojimo užklausų dažnio ribojimą. Jūsų paketinio apdorojimo užklausų dažnio ribojimas apima didžiausią įvesties žetonų, vienu metu esančių eilėje, skaičių. Savo užklausų dažnio ribojimus rasite čia.
Ar galiu pakeisti laiką, per kurį gaunu atsakymą iš Batch API?
Dabartinis mūsų nurodytas laiko langas yra 24 valandos. Šiuo metu šio laikotarpio pakeisti negalime.
Ar Batch API palaiko srautinį perdavimą?
Ne, Batch API srautinio perdavimo nepalaiko. Paketinės užklausos rezultatus grąžina per išvesties failus, o ne kaip srautinius atsakymus.
Ar Batch API palaiko vaizdus?
Taip, Batch API palaiko vaizdus.
Gavau klaidos pranešimą „The URL provided for this request does not prefix-match the batch endpoint“. Ką turėčiau daryti?
Jei gaunate šią klaidą, tai reiškia, kad jūsų URL netinkamai suformatuotas Batch API prieigos taškui. Peržiūrėkite mūsų dokumentaciją čia, kad įsitikintumėte, jog prieigos tašką kviečiate teisingai.
Ar Batch API naudojimas įskaičiuojamas į kitus mano užklausų dažnio ribojimus?
Batch API užklausų dažnio ribojimai yra visiškai atskiri nuo esamų ribojimų.
Kas nutinka, jei paketas atšaukiamas?
Jei paketas atšaukiamas rankiniu būdu, grąžinami visi jau užbaigti rezultatai. Kūrėjams bus taikomas mokestis už bet kokį užbaigtą darbą.
Kas nutinka, jei paketo galiojimas baigiasi?
Jei paketo galiojimas baigiasi (t. y. jo nepavyko užbaigti per SLA laiko langą), likęs darbas atšaukiamas, o bet koks jau užbaigtas darbas grąžinamas. Kūrėjams bus taikomas mokestis už bet kokį užbaigtą darbą.
Kokių paketinių užduočių būsenų galiu tikėtis?
Paketinė užduotis gali turėti bet kurią iš šių būsenų: Tikrinama, Nepavyko, Vykdoma, Užbaigiama, Užbaigta, Baigėsi galiojimas, Atšaukiama ir Atšaukta. Jei API būsenos reikšmes tikrinate programiškai, naudokite mažųjų raidžių literalus: validating, failed, in_progress, finalizing, completed, expired, cancelling ir cancelled.
Tikrinama: prieš pradedant paketą vyksta įkelto failo tikrinimas.
Nepavyko: failas nepraėjo tikrinimo proceso.
Vykdoma: failas sėkmingai patikrintas ir vyksta paketinis procesas.
Užbaigiama: paketinė užduotis baigta, o rezultatai ruošiami.
Užbaigta: paketinė užduotis užbaigta ir rezultatai paruošti.
Baigėsi galiojimas: paketo nepavyko užbaigti per SLA laiko langą.
Atšaukiama: paketinio darbo atšaukimas inicijuotas.
Atšaukta: paketinė užduotis buvo atšaukta.
Kaip patikrinti, kurias paketines užduotis jau sukūriau?
Visų savo paketinių užduočių sąrašą galite gauti naudodami API iškvietimą, nurodytą čia.
Ar šiame prieigos taške palaikomas nulinis duomenų saugojimas?
Jei jūsų organizacijoje įjungtas nulinis duomenų saugojimas, atkreipkite dėmesį, kad nulinis duomenų saugojimas Batch API netaikomas. ZDR organizacijos gali kurti paketines užduotis, tačiau paketų įvesties failai, išvestys, klaidos ir tarpiniai artefaktai saugomi pagal sukonfigūruotas Batch, File Service ir Sediment saugojimo politikas.