aip_sdk.resolve_partition

aip_sdk.resolve_partition(dataset_id: str, version_id: str, partition_id: str, *, client: APIClient | None = None) -> list[ResolvedPartition]

Resolve a partition to the concrete canonical targets it selects.

Each occurrence yields one resolved partition — a SESSION selector resolves to a single session, a TRACE selector to one trace per trace in the version, and a SPAN selector to one span per matching span.

Every occurrence is returned in one response, each carrying its full canonical payload (a span's messages, a trace's spans), so cost scales with the version and the breadth of the selector rather than with a page size. Narrow the selector — a target and, if needed, an ancestry_path — when resolving a large trace version. To ask only which metrics could score the partition, use get_partition_metric_availability(), which returns verdicts instead of payloads.

Parameters

• dataset_id str: Dataset ID.
• version_id str: Dataset version ID.
• partition_id str: ID of the partition to resolve.
• client APIClient | None: Optional API client.

Returns

• list[ResolvedPartition]: The resolved partitions, each a
• list[ResolvedPartition]: class:~aip_sdk.trace_models.SessionPartition,
• list[ResolvedPartition]: class:~aip_sdk.trace_models.TracePartition, or
• list[ResolvedPartition]: class:~aip_sdk.trace_models.SpanPartition tagged by partition_type.

Raises

• AuthError: If credentials are missing or invalid.
• NotFoundError: If the partition or dataset version does not exist.
• UnprocessableEntityError: If the version is not an agent-trace version.
• ResponseParseError: If the platform's response does not match this SDK version.