Skip to content

Accept or revoke partition lending for one host; Owner/Admin only

POST
/apis/nodus.dev/v1/namespaces/{namespace}/pools/{name}/partitionsharing
curl --request POST \
--url https://example.com/apis/nodus.dev/v1/namespaces/example/pools/example/partitionsharing \
--header 'Content-Type: application/json' \
--data '{ "action": "example", "agreed": true, "generation": 1, "node": "example", "termsDigest": "example" }'
namespace
required
string

The project.

name
required
string

The object’s name.

dryRun
string
fieldValidation
string
fieldManager
string
Idempotency-Key
string
If-Match
string
Media type application/json

PoolPartitionSharingRequest accepts or revokes one enrolled host’s partition agreement.

object
action
required

Action is Accept or Revoke.

string
agreed

Agreed must be explicitly true for acceptance.

boolean
generation
required

Generation is the independent partition-sharing generation last displayed.

integer format: int64
node
required

Node is the exact enrolled Node identity.

string
termsDigest

TermsDigest must match the displayed partition terms for acceptance.

string
Example generated
{
"action": "example",
"agreed": true,
"generation": 1,
"node": "example",
"termsDigest": "example"
}

OK

Media type application/json

PoolPartitionSharing describes one host’s partition permission, independently of whole-host sharing. Permission alone does not establish available hardware or authorize execution.

object
accepting
required

Accepting is the owner’s current permission gate, not runtime readiness.

boolean
apiVersion
string
consent

PoolPartitionSharingConsent is an immutable partition agreement and its revocation record.

object
acceptedBy
required

AcceptedBy identifies the human who accepted.

string
acceptedTime
required

AcceptedTime is when acceptance committed.

string
id
required

ID identifies this explicit acceptance.

string
revokedTime

RevokedTime is when permission for new partition loans was withdrawn.

string
terms
required

PoolPartitionSharingTerms is an explicit agreement to lend individual MIG GPU instances. Whole-host sharing agreements do not grant this permission.

object
agreementURL
required

AgreementURL contains the full agreement shown before acceptance.

string
compensation
required

Compensation is Credits (noncash Nodus credit) or CashUSD (separate cash payable).

string
contract
required

Contract is MIGPartitionV1.

string
ownerShareBasisPoints
required

OwnerShareBasisPoints is the owner’s share of settled compute, excluding taxes and storage.

integer format: int32
partitionPricing
required

PoolPartitionSharingPricing is a published rate card for exact partition allocations.

object
shapes
required

Shapes lists the complete resource bundles available under this agreement.

Array<object>
nullable

PoolPartitionSharingPrice prices one exact allocation without whole-host or proportional fallback.

object
hourlyUSD
required

HourlyUSD is the fixed borrower charge for this bundle.

string
shape
required

PoolPartitionShape identifies one GPU instance and its reserved host resources.

object
accelerator
required

Accelerator is the canonical accelerator model.

string
cpuMillis
required

CPUMillis is the reserved host CPU capacity in millicores.

integer format: int64
gpuMemoryBytes
required

GPUMemoryBytes is the instance’s measured GPU memory capacity.

integer format: int64
memoryBytes
required

MemoryBytes is the enforced host memory reservation.

integer format: int64
profile
required

Profile is the exact MIG profile, such as 3g.20gb.

string
scratchBytes
required

ScratchBytes is the memory-backed scratch limit within MemoryBytes.

integer format: int64
version
required

Version identifies the accepted rate card.

string
reclaimNoticeSeconds
required

ReclaimNoticeSeconds is the maximum checkpoint notice before borrowed work is stopped.

integer format: int32
revision
required

Revision identifies the published agreement.

string
termsDigest
required

TermsDigest binds acceptance to these terms.

string
generation
required

Generation fences concurrent partition agreement changes.

integer format: int64
kind
string
node
required

Node is the enrolled Node identity.

string
terms

PoolPartitionSharingTerms is an explicit agreement to lend individual MIG GPU instances. Whole-host sharing agreements do not grant this permission.

object
agreementURL
required

AgreementURL contains the full agreement shown before acceptance.

string
compensation
required

Compensation is Credits (noncash Nodus credit) or CashUSD (separate cash payable).

string
contract
required

Contract is MIGPartitionV1.

string
ownerShareBasisPoints
required

OwnerShareBasisPoints is the owner’s share of settled compute, excluding taxes and storage.

integer format: int32
partitionPricing
required

PoolPartitionSharingPricing is a published rate card for exact partition allocations.

object
shapes
required

Shapes lists the complete resource bundles available under this agreement.

Array<object>
nullable

PoolPartitionSharingPrice prices one exact allocation without whole-host or proportional fallback.

object
hourlyUSD
required

HourlyUSD is the fixed borrower charge for this bundle.

string
shape
required

PoolPartitionShape identifies one GPU instance and its reserved host resources.

object
accelerator
required

Accelerator is the canonical accelerator model.

string
cpuMillis
required

CPUMillis is the reserved host CPU capacity in millicores.

integer format: int64
gpuMemoryBytes
required

GPUMemoryBytes is the instance’s measured GPU memory capacity.

integer format: int64
memoryBytes
required

MemoryBytes is the enforced host memory reservation.

integer format: int64
profile
required

Profile is the exact MIG profile, such as 3g.20gb.

string
scratchBytes
required

ScratchBytes is the memory-backed scratch limit within MemoryBytes.

integer format: int64
version
required

Version identifies the accepted rate card.

string
reclaimNoticeSeconds
required

ReclaimNoticeSeconds is the maximum checkpoint notice before borrowed work is stopped.

integer format: int32
revision
required

Revision identifies the published agreement.

string
termsDigest

TermsDigest binds acceptance to the displayed terms.

string
Example generated
{
"accepting": true,
"apiVersion": "example",
"consent": {
"acceptedBy": "example",
"acceptedTime": "example",
"id": "example",
"revokedTime": "example",
"terms": {
"agreementURL": "example",
"compensation": "example",
"contract": "example",
"ownerShareBasisPoints": 1,
"partitionPricing": {
"shapes": [
{
"hourlyUSD": "example",
"shape": {
"accelerator": "example",
"cpuMillis": 1,
"gpuMemoryBytes": 1,
"memoryBytes": 1,
"profile": "example",
"scratchBytes": 1
}
}
],
"version": "example"
},
"reclaimNoticeSeconds": 1,
"revision": "example"
},
"termsDigest": "example"
},
"generation": 1,
"kind": "example",
"node": "example",
"terms": {
"agreementURL": "example",
"compensation": "example",
"contract": "example",
"ownerShareBasisPoints": 1,
"partitionPricing": {
"shapes": [
{
"hourlyUSD": "example",
"shape": {
"accelerator": "example",
"cpuMillis": 1,
"gpuMemoryBytes": 1,
"memoryBytes": 1,
"profile": "example",
"scratchBytes": 1
}
}
],
"version": "example"
},
"reclaimNoticeSeconds": 1,
"revision": "example"
},
"termsDigest": "example"
}

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