Project

Create Project

Create a new Project

A Project is software that provides some functionality.

Projects are uniquely identified by a UUID, prefixed with the string proj_, for example proj_c42014e7-baf5-4ec6-a502-858f98dca7c8

Projects can have zero or more Aliases. Aliases are completely free-form. They can be a URL, like github.com/kubernetes/kubernetes or a short string like k8s or kube.

Each Project has a ProjectType. Valid ProjectTypes include:

platform: The Project represents a software platform, such as the Project itself.
kube-addon: The Project represents a Cloud Native Project, which is defined as some software that extends the functionality of the cluster and its API.
kube-operator: The Project represents a Kubernetes [Operator][operator], which is defined as software written specifically against the API and is responsible for installing and managing the lifecycle of a Kubernetes Addon or Application Service.
kube-control-plane-provider: The Project represents a Kubernetes control plane service, such as RKE, GKE or EKS.
application-service: The Project represents application code that provides essential services to the rest of the application stack.
application: The Project represents customer-specific or internal code.

A Project is not the packaging of that software. Packaging of Projects is described by the Package model.

POST

projects

{
  "created_by": "<string>",
  "created_on": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "last_modified_by": "<string>",
  "last_modified_on": "2023-11-07T05:31:56Z",
  "title": "<string>",
  "type": "kube-addon",
  "$schema": "<string>",
  "aliases": [
    "<string>"
  ],
  "description": "<string>",
  "versioning": {
    "release_cycle": "none",
    "scheme": "unknown",
    "support_model": "none",
    "release_interval_days": 1
  }
}

Response

Created

created_by

string

required

user who created the record.

created_on

string<date-time>

required

timestamp of when the record was created.

string

required

ID is the unique identifier for the Project

last_modified_by

string

required

user who last modified the record.

last_modified_on

string<date-time>

required

timestamp of when the record was last modified.

title

string

required

Display name for the Project.

type

enum<string>

required

Type is the type of Project.

Available options:

kube-addon,

kube-operator,

kube-control-plane-provider,

application-service,

platform,

application

$schema

string<uri>

A URL to the JSON Schema for this object.

aliases

string[] | null

Optional set of string aliases for the Project. Must be globally unique.

description

string

Optional long-form description of the Project.

versioning

object

An optional object containing information about the Project's versioning and release model.

Show child attributes

versioning.release_cycle

enum<string>

default:none

required

Release cycle the Project or Package uses.

Available options:

none,

regular,

adhoc

versioning.scheme

enum<string>

default:unknown

required

Versioning scheme the Project or Package uses.

Available options:

semantic,

year-with-number,

calver,

unknown

versioning.support_model

enum<string>

default:none

required

The support model the Project or Package follows regarding releases.

Available options:

rolling,

none

versioning.release_interval_days

integer<int64>

When ReleaseCycle is 'regular', indicates the interval in days that the Project or Package or Project or Package intends to cut new releases.

Required range: x >= 0

Get ProjectGets a single Project A Project is software that provides some functionality. Projects are uniquely identified by a UUID, prefixed with the string proj_, for example proj_c42014e7-baf5-4ec6-a502-858f98dca7c8 Projects can have zero or more Aliases. Aliases are completely free-form. They can be a URL, like github.com/kubernetes/kubernetes or a short string like k8s or kube. Each Project has a ProjectType. Valid ProjectTypes include: * platform: The Project represents a software platform, such as the Project itself. * kube-addon: The Project represents a Cloud Native Project, which is defined as some software that extends the functionality of the cluster and its API. * kube-operator: The Project represents a Kubernetes [Operator][operator], which is defined as software written specifically against the API and is responsible for installing and managing the lifecycle of a Kubernetes Addon or Application Service. * kube-control-plane-provider: The Project represents a Kubernetes control plane service, such as RKE, GKE or EKS. * application-service: The Project represents application code that provides essential services to the rest of the application stack. * application: The Project represents customer-specific or internal code. A Project is not the packaging of that software. Packaging of Projects is described by the Package model.

⌘I

{
  "created_by": "<string>",
  "created_on": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "last_modified_by": "<string>",
  "last_modified_on": "2023-11-07T05:31:56Z",
  "title": "<string>",
  "type": "kube-addon",
  "$schema": "<string>",
  "aliases": [
    "<string>"
  ],
  "description": "<string>",
  "versioning": {
    "release_cycle": "none",
    "scheme": "unknown",
    "support_model": "none",
    "release_interval_days": 1
  }
}

API Reference

Login

Risk

Account

KubeCluster

KubePlatform

OCI

Organization

Package

Project

Create Project

Response