Method: hashLists.batchGet

string

Obbligatorio. I nomi degli specifici elenchi di hash. L'elenco POTREBBE essere un elenco di minacce o potrebbe essere la cache globale. I nomi NON DEVONO contenere duplicati; Se lo fa, il client riceverà un errore.

string (bytes format)

Le versioni dell'elenco hash già in possesso del client. Se è la prima volta che il client recupera gli elenchi di hash, il campo deve essere lasciato vuoto. In caso contrario, il client deve fornire le versioni ricevute in precedenza dal server. Il client NON DEVE manipolare questi byte.

Il client non deve inviare le versioni nello stesso ordine dei nomi degli elenchi corrispondenti. Il client potrebbe inviare un numero di versioni inferiore o superiore a quello dei nomi per una richiesta. Tuttavia, il client NON DEVE inviare più versioni che corrispondono allo stesso nome. In caso affermativo, il client riceverà un errore.

Nota storica: nella V4 dell'API, questa funzionalità si chiamava states. è ora rinominata version per maggiore chiarezza.

Una stringa con codifica base64.

enum (HashLength)

La lunghezza del prefisso hash desiderata in byte degli hash restituiti. Il server restituirà quindi tutti i prefissi hash con la lunghezza specificata.

Elenchi di hash diversi prevedono requisiti diversi sui valori accettabili del campo desiredHashLength. disponibile nel campo supportedHashLengths in HashListMetadata. Se desiredHashLength non specifica un valore all'interno di supportedHashLengths, verrà restituito un errore ai clienti.

In particolare, per BatchGetHashListsRequest, i clienti non possono specificare un valore desiredHashLength diverso per elenchi diversi. Per eseguire questa operazione, il client deve essere suddiviso in più BatchGetHashListsRequest.

object (SizeConstraints)

I vincoli di dimensione in ogni elenco. Se omesso, non ci sono vincoli. Tieni presente che le dimensioni qui riportate sono a livello di elenco, non aggregate per tutti gli elenchi.