Queue a fixed-profile native grant or return; Owner/Admin only
const url = 'https://example.com/apis/nodus.dev/v1/nodes/example/native-access';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"action":"example","generation":1,"image":"example","requestID":"example","sshPublicKeys":["example"],"version":1}'};
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/nodes/example/native-access \ --header 'Content-Type: application/json' \ --data '{ "action": "example", "generation": 1, "image": "example", "requestID": "example", "sshPublicKeys": [ "example" ], "version": 1 }'Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”The object’s name.
Request Bodyrequired
Section titled “ Request Bodyrequired ”NativeAccessRequest begins one operator-authorized native lifecycle operation. Images are approved aliases; physical identity and reprovisioning policy are server-owned.
object
Action is begin-grant or begin-return; advancement belongs to the normal controller.
Generation is the exact current return generation or the advertised next grant generation.
Image is an approved alias for a grant, omitted on return.
RequestID is an immutable UUID; an identical retry reuses it.
SSHPublicKeys supplies at most 16 public keys for a grant, omitted on return.
Version is 1 for this fixed-profile operator contract.
Example generated
{ "action": "example", "generation": 1, "image": "example", "requestID": "example", "sshPublicKeys": [ "example" ], "version": 1}Responses
Section titled “ Responses ”Accepted
NativeAccessStatus contains no external provisioning identity or credential.
object
ApprovedImages contains sorted configured aliases, never image URLs or external identifiers.
CustomerAccessReady requires the exact current external association to be verified.
Generation is the stored customer generation, or zero before the first grant.
NextAction is a provider-free operator hint; it never authorizes an override.
NextGeneration is present when a new grant may be requested after normal retirement.
Node is the Nodus Node addressed by the operator.
Phase describes preparation, access, return, verification or quarantine.
ReturnedNode identifies the newly enrolled successor after verified return.
Version is 1 for this projection.
Example generated
{ "approvedImages": [ "example" ], "customerAccessReady": true, "generation": 1, "nextAction": "example", "nextGeneration": 1, "node": "example", "phase": "example", "returnedNode": "example", "version": 1}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"}