SFsfcompute
Orders
Clusters

Get order clusters

Changed on

Get clusters associated with this order. This can currently canonly be one, but might in the future be multiple.

get/v0/orders/{id}/clusters

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:ordr_k3R-nX9vLm7Qp2Yw5Jd8F

Order ID

Response

List of clusters associated with the order

object'list' required
has_moreboolean required

Example response

{
  "object": "list",
  "data": [
    {
      "object": "kubernetes_cluster",
      "kubernetes_api_url": "https://cluster.example.com",
      "name": "richmond",
      "kubernetes_namespace": "sf-user123",
      "kubernetes_ca_cert": "-----BEGIN CERTIFICATE-----...",
      "contract": {
        "object": "contract",
        "id": "cont_k3R-nX9vLm7Qp2Yw5Jd8F",
        "created_at": "2025-07-11T20:41:37.423Z",
        "instance_type": "h100i",
        "shape": {
          "intervals": [
            "2025-07-11T20:41:37.423Z"
          ]
        },
        "colocate_with": [
          "cont_k3R-nX9vLm7Qp2Yw5Jd8F"
        ],
        "cluster_id": "clus_k3R-nX9vLm7Qp2Yw5Jd8F",
        "zone": "richmond",
        "is_node": true,
        "procurement_id": "proc_1234567890abcdef"
      }
    }
  ]
}

Changes

  • b819ba3108b3Revision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 73ad90aa5d19Revision changes
    • warning

      changed the pattern of the path request parameter id from "ordr"_[0-9a-zA-Z]+ to ordr_[0-9a-zA-Z_-]{1,21}

    • info

      the /////////// response's property pattern was changed from "clus"_[0-9a-zA-Z]+ to clus_[0-9a-zA-Z_-]{1,21} for the status

    • info

      the //////// response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status

    • info

      the /////// response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status