---
title: "Retrieve information about slurm nodesets belonging to a project or cluster."
method: GET
path: "/projects/{project_id}/slurm/{slurm_cluster_id}/nodesets"
tags: ["Slurm Nodesets"]
---

# Retrieve information about slurm nodesets belonging to a project or cluster.

`GET /projects/{project_id}/slurm/{slurm_cluster_id}/nodesets`

## Request

- Base URL: `https://api.cloud.crusoe.ai/v1`
- URL: `https://api.cloud.crusoe.ai/v1/projects/{project_id}/slurm/{slurm_cluster_id}/nodesets`
- Auth: none declared
- TypeScript: <https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway/docs/projects/:project_id/slurm/:slurm_cluster_id/nodesets/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `project_id` string, required
- `slurm_cluster_id` string, required

## Query parameters

- `name` string

## Response `200`

- ListSlurmNodesetsResponse
  - `items` SlurmNodeset[], required
    - `count` integer, required: Count of nodes that have all slurm replicas running.
    - `created_at` string: Created at timestamp of the nodeset.
    - `id` string, required: ID of the nodeset.
    - `issues` SlurmNodesetIssue[]: Message describing why nodeset is not in running.
      - `code` string: Machine-readable issue code.
      - `message` string: Human-readable description.
    - `name` string, required: Name of the nodeset.
    - `state` 'PROVISIONING' | 'RUNNING' | 'DELETING' | 'DELETED' | 'UPDATING' | 'UNHEALTHY' | 'CREATE_FAILED' | 'DELETE_FAILED', required: Current state.
    - `subnet_id` string: Subnet ID of the nodeset.
    - `transport_partition_id` string: Transport Partition ID of the nodeset.
    - `type` string, required: VM type in the nodeset
    - `updated_at` string: Updated at timestamp of the nodeset.
    - `vm_ssh_public_key` string: VM SSH Public Key of the nodeset.

## Other responses

- `401`: Error Authentication Failed
- `500`: Error Internal Server

---

[API](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway.md) - [All operations](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway/revisions/a3fd2dedc72b?raw)