Get a single instance cluster

GET /admin/clusters/{cluster_id}

This feature was introduced in GitLab 13.2. Returns a single instance cluster.

Path parameters

  • cluster_id integer(int32) Required

    The cluster ID

Responses

  • 200 application/json

    Get a single instance cluster

    Hide response attributes Show response attributes object
    • id string
    • name string
    • created_at string
    • domain string
    • enabled string
    • managed string
    • provider_type string
    • platform_type string
    • environment_scope string
    • cluster_type string
    • namespace_per_environment string
    • user object
      Hide user attributes Show user attributes object
      • id integer(int32)
      • username string
      • name string
      • state string
      • avatar_url string
      • avatar_path string
      • custom_attributes array[object]
        Hide custom_attributes attributes Show custom_attributes attributes object
        • key string
        • value string
      • web_url string
      • email string
    • platform_kubernetes object
      Hide platform_kubernetes attributes Show platform_kubernetes attributes object
      • api_url string
      • namespace string
      • authorization_type string
      • ca_cert string
    • provider_gcp object
      Hide provider_gcp attributes Show provider_gcp attributes object
      • cluster_id string
      • status_name string
      • gcp_project_id string
      • zone string
      • machine_type string
      • num_nodes string
      • endpoint string
    • management_project object
      Hide management_project attributes Show management_project attributes object
      • id integer(int32)
      • description string
      • name string
      • name_with_namespace string
      • path string
      • path_with_namespace string
      • created_at string(date-time)
  • 403

    Forbidden

  • 404

    Not found

GET /admin/clusters/{cluster_id}
curl \
 --request GET 'https://www.gitlab.com/api/v4/admin/clusters/{cluster_id}' \
 --header "Private-Token: $API_KEY"
Response examples (200)
{
  "id": "string",
  "name": "string",
  "created_at": "string",
  "domain": "string",
  "enabled": "string",
  "managed": "string",
  "provider_type": "string",
  "platform_type": "string",
  "environment_scope": "string",
  "cluster_type": "string",
  "namespace_per_environment": "string",
  "user": {
    "id": 1,
    "username": "admin",
    "name": "Administrator",
    "state": "active",
    "avatar_url": "https://gravatar.com/avatar/1",
    "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png",
    "custom_attributes": [
      {
        "key": "foo",
        "value": "bar"
      }
    ],
    "web_url": "https://gitlab.example.com/root",
    "email": "string"
  },
  "platform_kubernetes": {
    "api_url": "string",
    "namespace": "string",
    "authorization_type": "string",
    "ca_cert": "string"
  },
  "provider_gcp": {
    "cluster_id": "string",
    "status_name": "string",
    "gcp_project_id": "string",
    "zone": "string",
    "machine_type": "string",
    "num_nodes": "string",
    "endpoint": "string"
  },
  "management_project": {
    "id": 1,
    "description": "desc",
    "name": "project1",
    "name_with_namespace": "John Doe / project1",
    "path": "project1",
    "path_with_namespace": "namespace1/project1",
    "created_at": "2020-05-07T04:27:17Z"
  }
}