Retrieve multiple data sets by id

async AsyncCogniteClient.data_sets.retrieve_multiple(
ids: Sequence[int] | None = None,
external_ids: SequenceNotStr[str] | None = None,
ignore_unknown_ids: bool = False,
) → DataSetList

Retrieve multiple data sets by id.

Deprecated since version 8.23.0: The Data Sets API is deprecated and is scheduled for removal on 2027-12-31. Scope data with spaces and govern consumption with data products. See https://docs.cognite.com/cdf/deprecated for details and migration guidance.

Parameters:

  • ids (Sequence[int] | None) – IDs

  • external_ids (SequenceNotStr[str] | None) – External IDs

  • ignore_unknown_ids (bool) – Ignore IDs and external IDs that are not found rather than throw an exception.

Returns:

The requested data sets.

Return type:

DataSetList

Examples

Get data sets by id:

>>> from cognite.client import CogniteClient, AsyncCogniteClient
>>> client = CogniteClient()
>>> # async_client = AsyncCogniteClient()  # another option
>>> res = client.data_sets.retrieve_multiple(ids=[1, 2, 3])

Get data sets by external id:

>>> res = client.data_sets.retrieve_multiple(
...     external_ids=["abc", "def"], ignore_unknown_ids=True
... )