get_datalab_lifecycle_configuration_details

DatalabsApi.get_datalab_lifecycle_configuration_details(id, role_id, projection_expression=None, action=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get datalab lifecycle configuration details

Returns a lifecycle configuration, including its startup scripts. With action=get_dependent_resources, returns the datalabs currently using it instead.

Parameters:

  • id (str) – Identifier of the lifecycle configuration. (required)

  • role_id (str) – User role id (required)

  • projection_expression (str) – Comma-separated list of fields to return; all other fields are omitted.

  • action (str) – Omit to return the configuration. Use get_dependent_resources to list the datalabs currently using it.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

GetDatalabLifecycleConfigurationDetails200Response

Returns:

Returns the result object.

Request and Response Examples

HTTP: GET /datalabs/lifecycle-configurations/{id}

Success (HTTP 200)

Successfully returns datalab lifecycle configuration details

Default response

{
  "LifecycleId": "7c2f1b90-3d5e-4a11-9c88-0e5b7a1d2f34",
  "LifecycleName": "install-team-packages",
  "Description": "Installs the team's shared Python packages on startup",
  "Type": "notebook",
  "IsEnabled": true,
  "AccessType": "owner",
  "CreatedBy": "jdoe",
  "CreationTime": "2026-07-20 10:00:00",
  "LastModifiedBy": "jdoe",
  "LastModifiedTime": "2026-08-05 16:42:11",
  "DatalabsAttached": [
    "ml-exploration"
  ]
}

action=get_dependent_resources

{
  "DependentResources": [
    {
      "ResourceType": "Datalabs",
      "Resources": [
        {
          "DatalabName": "ml-exploration",
          "DatalabId": "b1e6c2a0-9f4d-4c7a-8f2e-1a2b3c4d5e6f"
        }
      ]
    }
  ]
}

Errors

Documented error codes: IPV-1002, AUTH-1002, GE-1020.

HTTP 400

Invalid input parameters

LifecycleId does not exist

{
  "Message": "IPV-1002 - Invalid LifeCycleId - 7c2f1b90-3d5e-4a11-9c88-0e5b7a1d2f34, resource not found."
}

Caller is not authorized on the configuration

{
  "Message": "AUTH-1002 - User action is not permitted"
}

HTTP 500

Something went wrong at backend

Request / response example

{
  "Message": "GE-1020 - Unable to update LifecycleConfiguration table, please retry or contact administrator"
}