Accept or revoke partition lending for one host; Owner/Admin only
const url = 'https://example.com/apis/nodus.dev/v1/namespaces/example/pools/example/partitionsharing';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"action":"example","agreed":true,"generation":1,"node":"example","termsDigest":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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" }'Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”The project.
The object’s name.
Query Parameters
Section titled “ Query Parameters ”Header Parameters
Section titled “ Header Parameters ”Request Bodyrequired
Section titled “ Request Bodyrequired ”PoolPartitionSharingRequest accepts or revokes one enrolled host’s partition agreement.
object
Action is Accept or Revoke.
Agreed must be explicitly true for acceptance.
Generation is the independent partition-sharing generation last displayed.
Node is the exact enrolled Node identity.
TermsDigest must match the displayed partition terms for acceptance.
Example generated
{ "action": "example", "agreed": true, "generation": 1, "node": "example", "termsDigest": "example"}Responses
Section titled “ Responses ”OK
PoolPartitionSharing describes one host’s partition permission, independently of whole-host sharing. Permission alone does not establish available hardware or authorize execution.
object
Accepting is the owner’s current permission gate, not runtime readiness.
PoolPartitionSharingConsent is an immutable partition agreement and its revocation record.
object
AcceptedBy identifies the human who accepted.
AcceptedTime is when acceptance committed.
ID identifies this explicit acceptance.
RevokedTime is when permission for new partition loans was withdrawn.
PoolPartitionSharingTerms is an explicit agreement to lend individual MIG GPU instances. Whole-host sharing agreements do not grant this permission.
object
AgreementURL contains the full agreement shown before acceptance.
Compensation is Credits (noncash Nodus credit) or CashUSD (separate cash payable).
Contract is MIGPartitionV1.
OwnerShareBasisPoints is the owner’s share of settled compute, excluding taxes and storage.
PoolPartitionSharingPricing is a published rate card for exact partition allocations.
object
Shapes lists the complete resource bundles available under this agreement.
PoolPartitionSharingPrice prices one exact allocation without whole-host or proportional fallback.
object
HourlyUSD is the fixed borrower charge for this bundle.
PoolPartitionShape identifies one GPU instance and its reserved host resources.
object
Accelerator is the canonical accelerator model.
CPUMillis is the reserved host CPU capacity in millicores.
GPUMemoryBytes is the instance’s measured GPU memory capacity.
MemoryBytes is the enforced host memory reservation.
Profile is the exact MIG profile, such as 3g.20gb.
ScratchBytes is the memory-backed scratch limit within MemoryBytes.
Version identifies the accepted rate card.
ReclaimNoticeSeconds is the maximum checkpoint notice before borrowed work is stopped.
Revision identifies the published agreement.
TermsDigest binds acceptance to these terms.
Generation fences concurrent partition agreement changes.
Node is the enrolled Node identity.
PoolPartitionSharingTerms is an explicit agreement to lend individual MIG GPU instances. Whole-host sharing agreements do not grant this permission.
object
AgreementURL contains the full agreement shown before acceptance.
Compensation is Credits (noncash Nodus credit) or CashUSD (separate cash payable).
Contract is MIGPartitionV1.
OwnerShareBasisPoints is the owner’s share of settled compute, excluding taxes and storage.
PoolPartitionSharingPricing is a published rate card for exact partition allocations.
object
Shapes lists the complete resource bundles available under this agreement.
PoolPartitionSharingPrice prices one exact allocation without whole-host or proportional fallback.
object
HourlyUSD is the fixed borrower charge for this bundle.
PoolPartitionShape identifies one GPU instance and its reserved host resources.
object
Accelerator is the canonical accelerator model.
CPUMillis is the reserved host CPU capacity in millicores.
GPUMemoryBytes is the instance’s measured GPU memory capacity.
MemoryBytes is the enforced host memory reservation.
Profile is the exact MIG profile, such as 3g.20gb.
ScratchBytes is the memory-backed scratch limit within MemoryBytes.
Version identifies the accepted rate card.
ReclaimNoticeSeconds is the maximum checkpoint notice before borrowed work is stopped.
Revision identifies the published agreement.
TermsDigest binds acceptance to the displayed terms.
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"}default
Section titled “ default ”An error: a metav1.Status whose reason is a registered code.
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
object
object
Docs is the URL of the code’s docs page.
Fix says what to do next, for example a CLI command or the field to change.
object
object
RequestID identifies the request in logs and support tickets.
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"}