Reference

Astra Admin Bulkload API

Astra Admin Bulkload API

Service: astraadminpb.AstraAdmin

Methods:

  • BulkLoad(BulkLoadRequest) -> BulkLoadResponse
  • GetBulkLoadJob(GetBulkLoadJobRequest) -> GetBulkLoadJobResponse

BulkLoadRequest Fields

FieldTypeNotes
tenant_idstringTarget tenant namespace for imported keys.
manifest_sourcestringManifest URI/path. Supports local and s3:// sources.
manifest_checksumstringOptional checksum gate for manifest integrity.
dry_runboolValidates manifest and planning without mutating state.
allow_overwriteboolAllows replacement semantics for existing keys.

BulkLoadResponse Fields

FieldTypeNotes
job_idstringServer-assigned job identifier.
acceptedboolWhether request was accepted for execution.
messagestringStatus/error detail.

GetBulkLoadJobResponse Fields

FieldTypeNotes
job_idstringRequested job identifier.
statusstringJob state (pending, running, completed, failed).
messagestringAdditional result text.
records_totaluint64Planned record count.
records_applieduint64Applied record count so far.
started_at_unix_msuint64Start timestamp epoch ms.
finished_at_unix_msuint64Completion timestamp epoch ms.

Expected Use

Primary client path is astra-forge converge/compile + bulk-load workflow.