Skip to main content

aip_sdk.list_ingest_drops

aip_sdk.list_ingest_drops(version_id: str, *, limit: int = 200, offset: int = 0, client: APIClient | None = None) -> list[TraceDropRecord]

List the records dropped while landing traces into a dataset version.

Prefer iter_ingest_drops() to walk every drop without paging by hand.

Parameters

  • version_id str: Dataset version ID the ingestion run landed into.
  • limit int: Maximum records to return (1 to MAX_DROPS_PER_PAGE).
  • offset int: Number of records to skip, for pagination.
  • client APIClient | None: Optional API client.

Returns

  • list[TraceDropRecord]: One page of drop records for the version, oldest first. A page shorter than
  • list[TraceDropRecord]: limit means there are no further records.

Raises

  • InvalidArgumentError: If limit or offset is out of range.
  • AuthError: If credentials are missing or invalid.
  • NotFoundError: If the dataset version does not exist, or belongs to a workspace the caller is not a member of.
  • ResponseParseError: If the platform's response does not match this SDK version.