Retrieve destinations

async AsyncCogniteClient.hosted_extractors.destinations.retrieve(

external_ids: str | SequenceNotStr[str],

ignore_unknown_ids: bool = False,

) → Destination | DestinationList

Retrieve one or more destinations.

Parameters:

• external_ids (str | SequenceNotStr[str]) – The external ID provided by the client. Must be unique for the resource type.

• ignore_unknown_ids (bool) – Ignore external IDs that are not found

Returns:

Requested destinations

Return type:

Destination | DestinationList

Examples

>>> from cognite.client import CogniteClient, AsyncCogniteClient
>>> client = CogniteClient()
>>> # async_client = AsyncCogniteClient()  # another option
>>> res = client.hosted_extractors.destinations.retrieve("myDestination")

Get multiple destinations by id:

>>> res = client.hosted_extractors.destinations.retrieve(
...     ["myDestination", "myDestination2"], ignore_unknown_ids=True
... )