Replace a MarketplaceEntry

PUT

/apis/nodus.dev/v1/marketplaceentries/{name}

const url = 'https://example.com/apis/nodus.dev/v1/marketplaceentries/example';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: '{"apiVersion":"example","kind":"example","metadata":{"annotations":{"additionalProperty":"example"},"creationTimestamp":"example","deletionGracePeriodSeconds":1,"deletionTimestamp":"example","finalizers":["example"],"generateName":"example","generation":1,"labels":{"additionalProperty":"example"},"managedFields":[{"apiVersion":"example","fieldsType":"example","fieldsV1":{"additionalProperty":"example"},"manager":"example","operation":"example","subresource":"example","time":"example"}],"name":"example","namespace":"example","ownerReferences":[{"apiVersion":"example","blockOwnerDeletion":true,"controller":true,"kind":"example","name":"example","uid":"example"}],"resourceVersion":"example","selfLink":"example","uid":"example"},"spec":{"authorityConfirmed":true,"company":"example","contactEmail":"example","endsAt":"example","hardware":"example","intent":"example","memoryGiB":1,"minimumHours":1,"network":"example","notes":"example","publish":true,"quantity":1,"rateUSDPerUnitHour":"example","region":"example","startsAt":"example","state":"example","title":"example"},"status":{"costAllowanceUSDPerUnitHour":"example","customerRateUSDPerUnitHour":"example","lastReservation":"example","message":"example","observedGeneration":1,"review":"example","reviewedAt":"example","validUntil":"example"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://example.com/apis/nodus.dev/v1/marketplaceentries/example \
  --header 'Content-Type: application/json' \
  --data '{ "apiVersion": "example", "kind": "example", "metadata": { "annotations": { "additionalProperty": "example" }, "creationTimestamp": "example", "deletionGracePeriodSeconds": 1, "deletionTimestamp": "example", "finalizers": [ "example" ], "generateName": "example", "generation": 1, "labels": { "additionalProperty": "example" }, "managedFields": [ { "apiVersion": "example", "fieldsType": "example", "fieldsV1": { "additionalProperty": "example" }, "manager": "example", "operation": "example", "subresource": "example", "time": "example" } ], "name": "example", "namespace": "example", "ownerReferences": [ { "apiVersion": "example", "blockOwnerDeletion": true, "controller": true, "kind": "example", "name": "example", "uid": "example" } ], "resourceVersion": "example", "selfLink": "example", "uid": "example" }, "spec": { "authorityConfirmed": true, "company": "example", "contactEmail": "example", "endsAt": "example", "hardware": "example", "intent": "example", "memoryGiB": 1, "minimumHours": 1, "network": "example", "notes": "example", "publish": true, "quantity": 1, "rateUSDPerUnitHour": "example", "region": "example", "startsAt": "example", "state": "example", "title": "example" }, "status": { "costAllowanceUSDPerUnitHour": "example", "customerRateUSDPerUnitHour": "example", "lastReservation": "example", "message": "example", "observedGeneration": 1, "review": "example", "reviewedAt": "example", "validUntil": "example" } }'

Parameters

Path Parameters

name

required

string

The object’s name.

Query Parameters

dryRun

string

fieldValidation

string

fieldManager

string

Header Parameters

Idempotency-Key

string

If-Match

string

Request Body^required

application/json

MarketplaceEntry is a private capacity request or supply submission. It never reserves or starts compute.

object

apiVersion

string

kind

string

metadata

object

annotations

object

key

additional properties

string

creationTimestamp

string

deletionGracePeriodSeconds

integer format: int64

deletionTimestamp

string

finalizers

Array<string>

nullable

generateName

string

generation

integer format: int64

labels

object

key

additional properties

string

managedFields

Array<object>

nullable

object

apiVersion

string

fieldsType

string

fieldsV1

object

key

additional properties

manager

string

operation

string

subresource

string

time

string

name

string

namespace

string

ownerReferences

Array<object>

nullable

object

apiVersion

required

string

blockOwnerDeletion

boolean

controller

boolean

kind

required

string

name

required

string

uid

required

string

resourceVersion

string

selfLink

string

uid

string

spec

required

MarketplaceEntrySpec is a non-binding request or listing.

object

authorityConfirmed

AuthorityConfirmed attests authority to offer capacity; required for supply.

boolean

company

required

Company is the display name; published only with the owner’s explicit consent and operator review.

string

contactEmail

required

ContactEmail is private to the owning organization and Nodus operators.

string

endsAt

required

EndsAt is the exclusive end of that interval.

string

hardware

required

Hardware is a concrete model or CPU configuration.

string

intent

required

Intent is Demand or Supply; immutable.

string

memoryGiB

required

MemoryGiB is accelerator memory per unit, or system memory for CPU configurations.

integer format: int32

minimumHours

required

MinimumHours is the minimum billable duration per allocation, or a buyer’s intended duration.

integer format: int32

network

required

Network describes interconnect and connectivity requirements.

string

notes

Notes are private requirements and commercial context; never credentials.

string

publish

Publish permits an operator to publish the reviewed supply fields. Never valid on demand.

boolean

quantity

required

Quantity counts complete units of the configuration described in Hardware.

integer format: int32

rateUSDPerUnitHour

required

RateUSDPerUnitHour is a buyer’s ceiling or a seller’s asking rate, as a positive decimal string.

string

region

required

Region is the required or offered geographic region.

string

startsAt

required

StartsAt is the beginning of the requested or available UTC interval.

string

state

required

State is Open or Withdrawn. Withdrawal immediately removes catalog visibility.

string

title

required

Title describes the request or offered configuration.

string

status

MarketplaceEntryStatus records operator-reviewed details without exposing operator identity.

object

costAllowanceUSDPerUnitHour

CostAllowanceUSDPerUnitHour covers estimated variable costs beyond the asking rate.

string

customerRateUSDPerUnitHour

CustomerRateUSDPerUnitHour is an indicative reviewed customer rate, not a confirmed order.

string

lastReservation

LastReservation is the last confirmed proposal, serializing capacity claims.

string

message

Message is an operator-written update visible to the owner.

string

observedGeneration

ObservedGeneration is the exact spec generation reviewed. Any later edit needs another review.

integer format: int64

review

Review is the operator’s decision.

string

reviewedAt

ReviewedAt is the last review time.

string

validUntil

ValidUntil expires a published listing even when its available interval is longer.

string

Example ^generated

{
  "apiVersion": "example",
  "kind": "example",
  "metadata": {
    "annotations": {
      "additionalProperty": "example"
    },
    "creationTimestamp": "example",
    "deletionGracePeriodSeconds": 1,
    "deletionTimestamp": "example",
    "finalizers": [
      "example"
    ],
    "generateName": "example",
    "generation": 1,
    "labels": {
      "additionalProperty": "example"
    },
    "managedFields": [
      {
        "apiVersion": "example",
        "fieldsType": "example",
        "fieldsV1": {
          "additionalProperty": "example"
        },
        "manager": "example",
        "operation": "example",
        "subresource": "example",
        "time": "example"
      }
    ],
    "name": "example",
    "namespace": "example",
    "ownerReferences": [
      {
        "apiVersion": "example",
        "blockOwnerDeletion": true,
        "controller": true,
        "kind": "example",
        "name": "example",
        "uid": "example"
      }
    ],
    "resourceVersion": "example",
    "selfLink": "example",
    "uid": "example"
  },
  "spec": {
    "authorityConfirmed": true,
    "company": "example",
    "contactEmail": "example",
    "endsAt": "example",
    "hardware": "example",
    "intent": "example",
    "memoryGiB": 1,
    "minimumHours": 1,
    "network": "example",
    "notes": "example",
    "publish": true,
    "quantity": 1,
    "rateUSDPerUnitHour": "example",
    "region": "example",
    "startsAt": "example",
    "state": "example",
    "title": "example"
  },
  "status": {
    "costAllowanceUSDPerUnitHour": "example",
    "customerRateUSDPerUnitHour": "example",
    "lastReservation": "example",
    "message": "example",
    "observedGeneration": 1,
    "review": "example",
    "reviewedAt": "example",
    "validUntil": "example"
  }
}

Responses

200

application/json

MarketplaceEntry is a private capacity request or supply submission. It never reserves or starts compute.

object

apiVersion

string

kind

string

metadata

object

annotations

object

key

additional properties

string

creationTimestamp

string

deletionGracePeriodSeconds

integer format: int64

deletionTimestamp

string

finalizers

Array<string>

nullable

generateName

string

generation

integer format: int64

labels

object

key

additional properties

string

managedFields

Array<object>

nullable

object

apiVersion

string

fieldsType

string

fieldsV1

object

key

additional properties

manager

string

operation

string

subresource

string

time

string

name

string

namespace

string

ownerReferences

Array<object>

nullable

object

apiVersion

required

string

blockOwnerDeletion

boolean

controller

boolean

kind

required

string

name

required

string

uid

required

string

resourceVersion

string

selfLink

string

uid

string

spec

required

MarketplaceEntrySpec is a non-binding request or listing.

object

authorityConfirmed

AuthorityConfirmed attests authority to offer capacity; required for supply.

boolean

company

required

Company is the display name; published only with the owner’s explicit consent and operator review.

string

contactEmail

required

ContactEmail is private to the owning organization and Nodus operators.

string

endsAt

required

EndsAt is the exclusive end of that interval.

string

hardware

required

Hardware is a concrete model or CPU configuration.

string

intent

required

Intent is Demand or Supply; immutable.

string

memoryGiB

required

MemoryGiB is accelerator memory per unit, or system memory for CPU configurations.

integer format: int32

minimumHours

required

MinimumHours is the minimum billable duration per allocation, or a buyer’s intended duration.

integer format: int32

network

required

Network describes interconnect and connectivity requirements.

string

notes

Notes are private requirements and commercial context; never credentials.

string

publish

Publish permits an operator to publish the reviewed supply fields. Never valid on demand.

boolean

quantity

required

Quantity counts complete units of the configuration described in Hardware.

integer format: int32

rateUSDPerUnitHour

required

RateUSDPerUnitHour is a buyer’s ceiling or a seller’s asking rate, as a positive decimal string.

string

region

required

Region is the required or offered geographic region.

string

startsAt

required

StartsAt is the beginning of the requested or available UTC interval.

string

state

required

State is Open or Withdrawn. Withdrawal immediately removes catalog visibility.

string

title

required

Title describes the request or offered configuration.

string

status

MarketplaceEntryStatus records operator-reviewed details without exposing operator identity.

object

costAllowanceUSDPerUnitHour

CostAllowanceUSDPerUnitHour covers estimated variable costs beyond the asking rate.

string

customerRateUSDPerUnitHour

CustomerRateUSDPerUnitHour is an indicative reviewed customer rate, not a confirmed order.

string

lastReservation

LastReservation is the last confirmed proposal, serializing capacity claims.

string

message

Message is an operator-written update visible to the owner.

string

observedGeneration

ObservedGeneration is the exact spec generation reviewed. Any later edit needs another review.

integer format: int64

review

Review is the operator’s decision.

string

reviewedAt

ReviewedAt is the last review time.

string

validUntil

ValidUntil expires a published listing even when its available interval is longer.

string

Example ^generated

{
  "apiVersion": "example",
  "kind": "example",
  "metadata": {
    "annotations": {
      "additionalProperty": "example"
    },
    "creationTimestamp": "example",
    "deletionGracePeriodSeconds": 1,
    "deletionTimestamp": "example",
    "finalizers": [
      "example"
    ],
    "generateName": "example",
    "generation": 1,
    "labels": {
      "additionalProperty": "example"
    },
    "managedFields": [
      {
        "apiVersion": "example",
        "fieldsType": "example",
        "fieldsV1": {
          "additionalProperty": "example"
        },
        "manager": "example",
        "operation": "example",
        "subresource": "example",
        "time": "example"
      }
    ],
    "name": "example",
    "namespace": "example",
    "ownerReferences": [
      {
        "apiVersion": "example",
        "blockOwnerDeletion": true,
        "controller": true,
        "kind": "example",
        "name": "example",
        "uid": "example"
      }
    ],
    "resourceVersion": "example",
    "selfLink": "example",
    "uid": "example"
  },
  "spec": {
    "authorityConfirmed": true,
    "company": "example",
    "contactEmail": "example",
    "endsAt": "example",
    "hardware": "example",
    "intent": "example",
    "memoryGiB": 1,
    "minimumHours": 1,
    "network": "example",
    "notes": "example",
    "publish": true,
    "quantity": 1,
    "rateUSDPerUnitHour": "example",
    "region": "example",
    "startsAt": "example",
    "state": "example",
    "title": "example"
  },
  "status": {
    "costAllowanceUSDPerUnitHour": "example",
    "customerRateUSDPerUnitHour": "example",
    "lastReservation": "example",
    "message": "example",
    "observedGeneration": 1,
    "review": "example",
    "reviewedAt": "example",
    "validUntil": "example"
  }
}

default

An error: a metav1.Status whose reason is a registered code.

application/json

Status is the error body of every API response: a Kubernetes metav1.Status (so kubectl and client-go understand it) plus three top-level extensions that those clients ignore (ADR-028).

object

apiVersion

string

code

integer format: int32

details

object

causes

Array<object>

nullable

object

field

string

message

string

reason

string

group

string

kind

string

name

string

retryAfterSeconds

integer format: int32

uid

string

docs

Docs is the URL of the code’s docs page.

string

fix

Fix says what to do next, for example a CLI command or the field to change.

string

kind

string

message

string

metadata

object

continue

string

remainingItemCount

integer format: int64

resourceVersion

string

selfLink

string

shardInfo

object

selector

required

string

reason

string

requestId

RequestID identifies the request in logs and support tickets.

string

status

string

Example ^generated

{
  "apiVersion": "example",
  "code": 1,
  "details": {
    "causes": [
      {
        "field": "example",
        "message": "example",
        "reason": "example"
      }
    ],
    "group": "example",
    "kind": "example",
    "name": "example",
    "retryAfterSeconds": 1,
    "uid": "example"
  },
  "docs": "example",
  "fix": "example",
  "kind": "example",
  "message": "example",
  "metadata": {
    "continue": "example",
    "remainingItemCount": 1,
    "resourceVersion": "example",
    "selfLink": "example",
    "shardInfo": {
      "selector": "example"
    }
  },
  "reason": "example",
  "requestId": "example",
  "status": "example"
}

Replace a MarketplaceEntry

Parameters

Path Parameters

Query Parameters

Header Parameters

Request Bodyrequired

Example generated

Responses

200

Example generated

default

Example generated

Request Body^required

Example ^generated

Example ^generated

Example ^generated