Kā darbojas Batch API?
Batch API galapunkts, kā dokumentēts šeit, ļauj lietotājiem iesniegt pieprasījumus asinhronai paketapstrādei. Mēs apstrādāsim šos pieprasījumus 24 stundu laikā. Katra pieprasījuma informācija tiks nolasīta no iepriekš augšupielādēta faila, un atbildes tiks ierakstītas izvades failā. Varat vaicāt paketapstrādes objektu, lai saņemtu statusa atjauninājumus un rezultātus.
Kāda ir Batch API cena?
Katrs modelis tiks piedāvāts ar 50% izmaksu atlaidi salīdzinājumā ar sinhronajām API. Šeit ir plašāka informācija par mūsu API cenām.
Kurus modeļus varu izmantot paketapstrādē?
Batch API ir plaši pieejama lielākajai daļai mūsu modeļu, bet ne visiem. Skatiet modeļu atsauces dokumentāciju, lai pārliecinātos, ka jūsu izmantotais modelis atbalsta Batch API.
Kas notiek, ja API nepabeidz manu pieprasījumu solītajā laikā?
Mūsu mērķis ir apstrādāt visus pieprasījumus 24 stundu laikā. Ja paketapstrādei beidzas termiņš (t. i., to nevarēja pabeigt SLA laika periodā), atlikušais darbs tiek atcelts un tiek atgriezts viss jau pabeigtais darbs. Izstrādātājiem tiks piemērota maksa par jebkuru pabeigto darbu.
Kāds ir ierobežojums pieprasījumu skaitam, ko varu apstrādāt paketē?
Iegulšanas API vienlaikus var būt ne vairāk kā 1 miljons rindā ievietotu pieprasījumu.
Visām pārējām API pieprasījumu skaitam, ko varat apstrādāt paketē, ierobežojuma nav; tomēr katram lietošanas līmenim ir saistīts paketapstrādes darbības ierobežojums. Jūsu paketapstrādes darbības ierobežojums ietver maksimālo ievades tekstvienību skaitu, kas jums vienlaikus ir ievietots rindā. Jūsu darbības ierobežojumus varat atrast šeit.
Vai varu mainīt laiku, pēc kura saņemu atbildi no Batch API?
Mūsu pašreiz norādītais laika periods ir 24 stundas. Pašlaik šo laika periodu nevaram mainīt.
Vai Batch API atbalsta straumēšanu?
Nē, Batch API straumēšanu neatbalsta. Paketapstrādes pieprasījumi atgriež rezultātus, izmantojot izvades failus, nevis straumētas atbildes.
Vai Batch API atbalsta attēlus?
Jā, Batch API atbalsta attēlus.
Saņēmu kļūdas ziņojumu “The URL provided for this request does not prefix-match the batch endpoint”. Ko man darīt?
Ja saņemat šo kļūdu, tas nozīmē, ka jūsu URL ir nepareizi formatēts Batch API galapunktam. Skatiet mūsu dokumentāciju šeit, lai pārliecinātos, ka galapunktu izsaucat pareizi.
Vai Batch API izmantošana tiek ieskaitīta manos citos darbības ierobežojumos?
Batch API darbības ierobežojumi ir pilnīgi nošķirti no esošajiem ierobežojumiem.
Kas notiek, ja paketapstrāde tiek atcelta?
Ja paketapstrāde tiek manuāli atcelta, tiek atgriezti visi rezultāti, kas jau ir pabeigti. Izstrādātājiem tiks piemērota maksa par jebkuru pabeigto darbu.
Kas notiek, ja paketapstrādei beidzas termiņš?
Ja paketapstrādei beidzas termiņš (t. i., to nevarēja pabeigt SLA laika periodā), atlikušais darbs tiek atcelts un tiek atgriezts viss jau pabeigtais darbs. Izstrādātājiem tiks piemērota maksa par jebkuru pabeigto darbu.
Kādus statusus varu sagaidīt paketapstrādes uzdevumiem?
Paketapstrādes uzdevumam var būt kāds no šiem statusiem: Validēšana, Neizdevies, Notiek izpilde, Pabeigšana, Pabeigts, Beidzies termiņš, Atcelšana un Atcelts. Ja API statusa vērtības pārbaudāt programmatiski, izmantojiet mazo burtu literāļus: validating, failed, in_progress, finalizing, completed, expired, cancelling un cancelled.
Validēšana: Augšupielādētā faila validācija notiek, pirms paketapstrāde var sākties.
Neizdevies: Faila validācijas process neizdevās.
Notiek izpilde: Fails tika sekmīgi validēts, un paketapstrādes process ir uzsākts.
Pabeigšana: Paketapstrādes uzdevums ir pabeigts, un rezultāti tiek sagatavoti.
Pabeigts: Paketapstrādes uzdevums ir pabeigts, un rezultāti ir gatavi.
Beidzies termiņš: Paketapstrādi nevarēja pabeigt SLA laika periodā.
Atcelšana: Ir sākta paketapstrādes uzdevuma atcelšana.
Atcelts: Paketapstrādes uzdevums tika atcelts.
Kā varu pārbaudīt, kurus paketapstrādes uzdevumus jau esmu izveidojis?
Visu savu paketapstrādes uzdevumu sarakstu varat iegūt, izmantojot šeit norādīto API izsaukumu.
Vai šajā galapunktā tiek atbalstīta nulles datu saglabāšana?
Ja jūsu organizācijai ir iespējota nulles datu saglabāšana, ņemiet vērā, ka nulles datu saglabāšana neattiecas uz Batch API. ZDR organizācijas var izveidot paketapstrādes uzdevumus, bet paketapstrādes ievades faili, izvades dati, kļūdas un starpposma artefakti tiek saglabāti saskaņā ar konfigurētajām Batch, File Service un Sediment saglabāšanas politikām.