Package

Update Package

Update an existing Package

A Package is a named bundle of software that is bundled (and identified) in the format of a specific PackageSystem.

A PackageSystem is an identifier of a packaging ecosystem.

Packages can use one of the following PackageSystems:

helm for Helm charts
kube for raw YAML manifests or Kustomize overlays that install one or more resources

A Package is identified by a globally-unique ID field which is a UUID string prefixed with the string ‘pkg_’, for example ‘pkg_c42014e7-baf5-4ec6-a502-858f98dca7c8’.

A Package may be associated with one or more Projects and zero or more ProjectComponents.

A Package may have one or more links associated with it. There are two types of links that hold special significance to a package: ‘package.archive’ and ‘package.source’. The ‘package.archive’ link is used to indicate the location of the package’s archive, which is the file that contains the package’s contents. The ‘package.source’ link is used to indicate a location on the web where the package may be observed in an un-archived format. For example, the cert-manager helm chart package can have the following links

‘package.archive’: https:charts.jetstack.io/cert-manager
‘package.source’: https:github.com/cert-manager/cert-manager/tree/master/deploy/charts/cert-manager

A Package may have zero or more aliases associated with it in the ‘Aliases’ field. An alias for a Package is a human readable string that uniquely identifies the Package.

A Package may be associated with one or more ProjectComponents. Packages with PackageSystem helm or kube are associated with ProjectComponents via the Package’s collection of PackageComponents. A PackageComponent, which corresponds to a specific Resource of Kind Deployment, DaemonSet or StatefulSet, may reference one or more Docker Images. Those Docker Images correspond to a ProjectComponent for one or more Projects.

PUT

packages

{package}

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

Response

created_by

string

required

user who created the record.

created_on

string<date-time>

required

timestamp of when the record was created.

string

required

unique identifier for the Package record.

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.

system

enum<string>

required

System is the PackageSystem for the Package.

Available options:

helm,

kustomize,

kube

title

string

required

Display name for the Package.

$schema

string<uri>

A URL to the JSON Schema for this object.

aliases

string[] | null

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

description

string

Optional long-form description of the Package.

versioning

object

An optional object containing information about the Package'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

Delete PackageDelete a Package A Package is a named bundle of software that is bundled (and identified) in the format of a specific PackageSystem. A PackageSystem is an identifier of a packaging ecosystem. Packages can use one of the following PackageSystems: * helm for Helm charts * kube for raw YAML manifests or Kustomize overlays that install one or more resources A Package is identified by a globally-unique ID field which is a UUID string prefixed with the string 'pkg_', for example 'pkg_c42014e7-baf5-4ec6-a502-858f98dca7c8'. A Package may be associated with one or more Projects and zero or more ProjectComponents. A Package may have one or more links associated with it. There are two types of links that hold special significance to a package: 'package.archive' and 'package.source'. The 'package.archive' link is used to indicate the location of the package's archive, which is the file that contains the package's contents. The 'package.source' link is used to indicate a location on the web where the package may be observed in an un-archived format. For example, the cert-manager helm chart package can have the following links - 'package.archive': https:charts.jetstack.io/cert-manager - 'package.source': https:github.com/cert-manager/cert-manager/tree/master/deploy/charts/cert-manager A Package may have zero or more aliases associated with it in the 'Aliases' field. An alias for a Package is a human readable string that uniquely identifies the Package. A Package may be associated with one or more ProjectComponents. Packages with PackageSystem helm or kube are associated with ProjectComponents via the Package's collection of PackageComponents. A PackageComponent, which corresponds to a specific Resource of Kind Deployment, DaemonSet or StatefulSet, may reference one or more Docker Images. Those Docker Images correspond to a ProjectComponent for one or more Projects.

⌘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",
  "system": "helm",
  "title": "<string>",
  "$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

Update Package

Response