# get_drive_by_id

## nominal.experimental.drives.get_drive_by_id(client, id, *, workspace_rid=None)

Retrieve a drive by its workspace-unique id.

Parameters:
:   - **client** ([*NominalClient*](https://dev.nominal.io/python/ref/generated/nominal.core.NominalClient.md#nominal.core.NominalClient "nominal.core.client.NominalClient"))

      Client providing authentication and workspace configuration.
    - **id** ([*str*](https://docs.python.org/3/builtins/stdtypes.html#str "(in Python v3.15)"))

      Identifier of the drive to retrieve.
    - **workspace_rid** ([*str*](https://docs.python.org/3/builtins/stdtypes.html#str "(in Python v3.15)") *|* *None*)

      Workspace to look in. Defaults to the client’s workspace.

Returns:
:   The drive. This is a [`VirtualDrive`](https://dev.nominal.io/python/ref/generated/nominal.experimental.drives.VirtualDrive.md#nominal.experimental.drives.VirtualDrive "nominal.experimental.drives.VirtualDrive") when the drive mirrors an external provider.

Return type:
:   [*Drive*](https://dev.nominal.io/python/ref/generated/nominal.experimental.drives.Drive.md#nominal.experimental.drives.Drive "nominal.experimental.drives.drive.Drive")
