Kako deluje Batch API?
Končna točka Batch API-ja, kot je dokumentirana tukaj, uporabnikom omogoča pošiljanje zahtev za asinhrono paketno obdelavo. Te zahteve bomo obdelali v 24 urah. Podrobnosti vsake zahteve bodo prebrane iz vnaprej naložene datoteke, odgovori pa bodo zapisani v izhodno datoteko. Objekt paketa lahko poizvedujete za posodobitve stanja in rezultate.
Kakšne so cene za Batch API?
Vsak model bo na voljo s 50-odstotnim popustom pri stroških v primerjavi s sinhronimi API-ji. Tukaj je več informacij o cenah naših API-jev.
Katere modele lahko obdelujem paketno?
Batch API je široko na voljo za večino naših modelov, vendar ne za vse. Oglejte si referenčno dokumentacijo za modele, da se prepričate, da model, ki ga uporabljate, podpira Batch API.
Kaj se zgodi, če API ne dokonča moje zahteve v obljubljenem času?
Naš cilj je obdelati vse zahteve v 24 urah. Če paket poteče (tj. ga ni bilo mogoče dokončati v časovnem okviru SLA), se preostalo delo prekliče, morebitno že dokončano delo pa se vrne. Razvijalcem bo zaračunano vsako dokončano delo.
Kakšna je omejitev števila zahtev, ki jih lahko obdelujem paketno?
API-ji za vdelave imajo omejitev 1 milijon zahtev v čakalni vrsti hkrati.
Za vse druge API-je ni omejitve števila zahtev, ki jih lahko obdelujete paketno; vendar ima vsaka raven uporabe povezano omejitev hitrosti za pakete. Vaša omejitev hitrosti za pakete vključuje največje število vhodnih žetonov, ki jih imate hkrati v čakalni vrsti. Svoje omejitve hitrosti najdete tukaj.
Ali lahko spremenim čas, potreben za odgovor Batch API-ja?
Naš trenutno določeni časovni okvir je 24 ur. Tega časovnega obdobja trenutno ne moremo spremeniti.
Ali je v Batch API-ju podprto pretočno predvajanje?
Ne, pretočno predvajanje v Batch API-ju ni podprto. Paketne zahteve vračajo rezultate prek izhodnih datotek in ne prek pretočnih odgovorov.
Ali so slike v Batch API-ju podprte?
Da, slike so v Batch API-ju podprte.
Prejel sem sporočilo o napaki “The URL provided for this request does not prefix-match the batch endpoint”. Kaj naj storim?
Če prejmete to napako, to pomeni, da je vaš URL za končno točko Batch API-ja nepravilno oblikovan. Oglejte si našo dokumentacijo tukaj, da se prepričate, da pravilno kličete končno točko.
Ali uporaba Batch API-ja vpliva na moje druge omejitve hitrosti?
Omejitve hitrosti za Batch API so popolnoma ločene od obstoječih omejitev.
Kaj se zgodi, če je paket preklican?
Če je paket ročno preklican, se vrnejo vsi rezultati, ki so že bili dokončani. Razvijalcem bo zaračunano vsako dokončano delo.
Kaj se zgodi, če paket poteče?
Če paket poteče (tj. ga ni bilo mogoče dokončati v časovnem okviru SLA), se preostalo delo prekliče, morebitno že dokončano delo pa se vrne. Razvijalcem bo zaračunano vsako dokončano delo.
Katera stanja lahko pričakujem pri paketnih opravilih?
Paketno opravilo ima lahko katero koli od naslednjih stanj: Preverjanje, Neuspešno, V teku, Zaključevanje, Dokončano, Poteklo, Preklicevanje in Preklicano. Če vrednosti stanja API-ja preverjate programsko, uporabite literale z malimi črkami: validating, failed, in_progress, finalizing, completed, expired, cancelling in cancelled.
Preverjanje: Preverjanje veljavnosti naložene datoteke poteka, preden se paket lahko začne.
Neuspešno: Datoteka ni uspešno prestala postopka preverjanja veljavnosti.
V teku: Datoteka je bila uspešno preverjena in paketni postopek poteka.
Zaključevanje: Paketno opravilo je dokončano, rezultati pa se pripravljajo.
Dokončano: Paketno opravilo je dokončano in rezultati so pripravljeni.
Poteklo: Paketa ni bilo mogoče dokončati v časovnem okviru SLA.
Preklicevanje: Preklic paketnega opravila se je začel.
Preklicano: Paketno opravilo je bilo preklicano.
Kako lahko preverim, katera paketna opravila sem že ustvaril?
Seznam vseh svojih paketnih opravil lahko pridobite z uporabo klica API-ja, navedenega tukaj.
Ali je na tej končni točki podprta ničelna hramba podatkov?
Če imate za svojo organizacijo omogočeno ničelno hrambo podatkov, upoštevajte, da ničelna hramba podatkov ne velja za Batch API. Organizacije z ZDR lahko ustvarjajo paketna opravila, vendar se paketne vhodne datoteke, izhodi, napake in vmesni artefakti hranijo v skladu s konfiguriranimi pravilniki hrambe za Batch, File Service in Sediment.