Skip to content
Nodus

List or watch marketplacecontracts

GET
/apis/nodus.dev/v1/marketplacecontracts
 
curl --request GET \
  --url https://example.com/apis/nodus.dev/v1/marketplacecontracts

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “ Query Parameters ”
labelSelector
string
fieldSelector
string
limit
string
continue
string
watch
string
resourceVersion
string
allowWatchBookmarks
string
timeoutSeconds
string

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

OK

Media type application/json
object
apiVersion
string
items
required
Array<object>

MarketplaceContract is a versioned reservation proposal confirmed by both organizations. It records agreement on terms; it does not charge, provision, or execute an external legal document.

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

MarketplaceContractSpec freezes the parties, resource identity, dates and commercial terms.

object
buyerName
required

BuyerName is the reviewed buyer display name.

string
buyerOrg
required

BuyerOrg and SellerOrg are Nodus organization IDs, not infrastructure provider credentials.

string
capacityUSD
required

CapacityUSD is the fixed seller amount; the marketplace uses transparent fees.

string
costAllowanceUSD
required

CostAllowanceUSD is the variable-cost allowance used by the margin check.

string
endsAt
required

EndsAt is the exclusive reservation end.

string
expiresAt
required

ExpiresAt is the deadline for both confirmations.

string
hardware
required

Hardware, Region and Network describe the agreed configuration.

string
listing
required

Listing names the seller’s source entry.

string
listingGeneration
required

ListingGeneration pins the reviewed availability.

integer format: int64
listingUID
required

ListingUID pins the original listing, including across deletion and recreation.

string
memoryGiB
required

MemoryGiB is the memory per complete unit.

integer format: int32
network
required

Network is the agreed interconnect and connectivity.

string
quantity
required

Quantity is the number of complete configuration units reserved.

integer format: int32
region
required

Region is the agreed geographic region.

string
request
required

Request names the buyer’s source entry.

string
requestGeneration
required

RequestGeneration pins the reviewed requirements.

integer format: int64
requestUID
required

RequestUID pins the original demand across deletion and recreation.

string
sellerName
required

SellerName is the reviewed seller display name.

string
sellerOrg
required

SellerOrg identifies the counterparty authorized to confirm the supply side.

string
startsAt
required

StartsAt is the inclusive reservation start.

string
terms
required

Terms states delivery, support, cancellation, payment, and tax responsibilities.

string
totalUSD
required

TotalUSD is the fixed customer price, excluding any explicitly stated taxes.

string
status

MarketplaceContractStatus is the approval history of one immutable proposal.

object
buyerConfirmedAt

BuyerConfirmedAt records the buyer’s confirmation.

string
buyerConfirmedBy

BuyerConfirmedBy records the Nodus user ID for the confirmation.

string
declinedAt

DeclinedAt closes a proposal before both confirmations.

string
declinedBy

DeclinedBy records the Nodus user who closed the proposal.

string
sellerConfirmedAt

SellerConfirmedAt records the seller’s confirmation.

string
sellerConfirmedBy

SellerConfirmedBy records the Nodus user ID for the confirmation.

string
kind
string
metadata
object
continue
string
remainingItemCount
integer format: int64
resourceVersion
string
selfLink
string
shardInfo
object
selector
required
string
Example generated 
{
  "apiVersion": "example",
  "items": [
    {
      "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": {
        "buyerName": "example",
        "buyerOrg": "example",
        "capacityUSD": "example",
        "costAllowanceUSD": "example",
        "endsAt": "example",
        "expiresAt": "example",
        "hardware": "example",
        "listing": "example",
        "listingGeneration": 1,
        "listingUID": "example",
        "memoryGiB": 1,
        "network": "example",
        "quantity": 1,
        "region": "example",
        "request": "example",
        "requestGeneration": 1,
        "requestUID": "example",
        "sellerName": "example",
        "sellerOrg": "example",
        "startsAt": "example",
        "terms": "example",
        "totalUSD": "example"
      },
      "status": {
        "buyerConfirmedAt": "example",
        "buyerConfirmedBy": "example",
        "declinedAt": "example",
        "declinedBy": "example",
        "sellerConfirmedAt": "example",
        "sellerConfirmedBy": "example"
      }
    }
  ],
  "kind": "example",
  "metadata": {
    "continue": "example",
    "remainingItemCount": 1,
    "resourceVersion": "example",
    "selfLink": "example",
    "shardInfo": {
      "selector": "example"
    }
  }
}

default

Section titled “ default ”

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

Media type 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"
}