For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.

Skip to navigation

API Reference

Tray

||View as Markdown|

This page is for NVIDIA Infra Controller.

Tray represents a component within a Rack.

Documentation REST API Reference

API Reference

Getting Started
Authentication and Authorization
Resource Overview
Example REST API Workflows
Deprecations
Service Account
Retrieve Service Account status for current org
Infrastructure Provider
Retrieve Infrastructure Provider for current Org
Retrieve Stats for current Infrastructure Provider
Tenant
Retrieve Tenant for current Org
Retrieve Stats for current Tenant
Retrieve VPC routing profiles for current Tenant
Retrieve per-tenant instance type allocation stats for a site
Tenant Account
Retrieve all Tenant Accounts
Create Tenant Account
Retrieve Tenant Account
Delete Tenant Account
Update Tenant Account
Site
Retrieve all Sites
Create Site
Retrieve Site
Delete Site
Update Site
Retrieve Site status history
Bmc Credential
Create Or Update BMC Credential
Uefi Credential
Create UEFI Credential
Measured Boot Trusted Machine
Retrieve All Measured Boot Trusted Machine Approvals
Create Measured Boot Trusted Machine Approval
Delete Measured Boot Trusted Machine Approval
Measured Boot Trusted Profile
Retrieve All Measured Boot Trusted Profile Approvals
Create Measured Boot Trusted Profile Approval
Delete Measured Boot Trusted Profile Approval
Credential Rotation
Get Credential Rotation Status
Rotate Credential
Site Explorer
Retrieve all Explored Endpoints
Trigger Site Explorer Endpoint Action
Allocation
Retrieve all Allocations
Create Allocation
Retrieve Allocation
Delete Allocation
Update Allocation
Update Allocation Constraint
IP Block
Retrieve all IP Blocks
Create IP Block
Retrieve IP Block
Delete IP Block
Update IP Block
Retrieve All Derived IP Blocks
VPC
Retrieve all VPCs
Create VPC
Retrieve a VPC
Delete a VPC
Update VPC
Retrieve VPC routing profile
Update VPC routing profile
Release inactive VPC VNI
Update VPC Virtualization
VPC Peering
Retrieve all VPC peerings
Create VPC peering
Retrieve a VPC peering
Delete a VPC peering
VPC Prefix
Retrieve all VPC Prefixes
Create VPC Prefix
Retrieve VPC Prefix
Delete VPC Prefix
Update VPC Prefix
Subnet
Retrieve all Subnets
Create Subnet
Retrieve Subnet
Delete Subnet
Update Subnet
Expected Machine
Retrieve all Expected Machines
Create Expected Machine
Replace all Expected Machines
Delete all Expected Machines
Retrieve Expected Machine label keys
Retrieve Expected Machine label values
Retrieve Expected Machine
Delete Expected Machine
Update Expected Machine
Batch Create Expected Machines
Batch Update Expected Machines
Expected Power Shelf
Retrieve all Expected Power Shelves
Create Expected Power Shelf
Replace all Expected Power Shelves
Delete all Expected Power Shelves
Retrieve Expected Power Shelf
Delete Expected Power Shelf
Update Expected Power Shelf
Expected Rack
Retrieve all Expected Racks
Create Expected Rack
Replace all Expected Racks
Replace all Expected Racks
Delete all Expected Racks
Retrieve Expected Rack
Delete Expected Rack
Update Expected Rack
Expected Rack Group
Retrieve all Expected Rack Groups
Create Expected Rack Group
Replace all Expected Rack Groups
Replace all Expected Rack Groups
Delete all Expected Rack Groups
Retrieve Expected Rack Group
Delete Expected Rack Group
Update Expected Rack Group
Expected Switch
Retrieve all Expected Switches
Create Expected Switch
Replace all Expected Switches
Delete all Expected Switches
Retrieve Expected Switch
Delete Expected Switch
Update Expected Switch
SKU
Retrieve all SKUs
Create SKU
Retrieve SKU
Delete SKU
Update SKU
Infini Band Partition
Retrieve all InfiniBand Partitions
Create InfiniBand Partition
Retrieve InfiniBand Partition
Delete InfiniBand Partition
Update InfiniBand Partition
Retrieve all InfiniBand Interfaces
Spectrum X Partition
Retrieve all SpectrumX Partitions
Create SpectrumX Partition
Retrieve SpectrumX Partition
Delete SpectrumX Partition
Nv Link Logical Partition
Retrieve all NVLink Logical Partitions
Create NVLink Logical Partition
Retrieve NVLink Logical Partition
Delete NVLink Logical Partition
Update NVLink Logical Partition
Retrieve all NVLink Interfaces
Instance Type
Retrieve all Instance Types
Create an Instance Type
Retrieve an Instance Type
Delete Instance Type
Update Instance Type
Retrieve all Machines/Instance Type associations
Create a Machine/Instance Type association
Delete a Machine/Instance Type association
Instance
Retrieve all Instances
Create an Instance
Batch Create Instances
Retrieve Instance
Delete Instance
Update Instance
Retrieve Instance status history
Retrieve all Interfaces
Retrieve all Instance InfiniBand Interfaces
Retrieve all Instance NVLink Interfaces
Operating System
Retrieve all Operating Systems
Create Operating System
Retrieve Operating System
Delete Operating System
Update Operating System
Machine
Retrieve all Machines
Retrieve Machine label keys
Retrieve Machine label values
Retrieve a Machine
Update Machine
Delete a Machine from a Site
Retrieve all Machine Capabilities
Machine power control
Reset Machine BMC
Reset Machine Chassis
Decommission a Machine
Retrieve DPU Machines attached to a host Machine
Reprovision Machine DPUs
Retrieve all Machine health reports
Create or update Machine health report
Delete Machine health report
Retrieve Machine status history
Retrieve Machine validation runs
Create an on-demand Machine validation run
Retrieve Machine validation results
Retrieve GPU stats for machines at a site
Retrieve machine instance type assignment summary for a site
Retrieve detailed per-instance-type machine stats for a site
Dpu Machine
Retrieve all DPU Machines
Retrieve a DPU Machine
Domain
Retrieve all NVLink Domains
Retrieve an NVLink Domain
Power control NVLink Domains
Power control an NVLink Domain
Firmware update NVLink Domains
Firmware update an NVLink Domain
Rack
Retrieve all Racks
Retrieve a Rack
Validate Racks
Retrieve all Rack health reports
Create or update Rack health report
Delete Rack health report
Validate a Rack
Power control Racks
Power control a Rack
Firmware update Racks
Firmware update a Rack
Bring up Racks
Bring up a Rack
Retrieve all Tasks for a Rack
Tray
Retrieve all Trays
Retrieve a Tray
Validate Trays
Retrieve all Tray health reports
Create or update Tray health report
Delete Tray health report
Validate a Tray
Power control Trays
Power control a Tray
Firmware update Trays
Firmware update a Tray
Retrieve all Tasks for a Tray
Rule
List Operation Rules
Create an Operation Rule
Retrieve an Operation Rule
Delete an Operation Rule
Update an Operation Rule
Task
Retrieve all Tasks
Retrieve a Task
Cancel a Task
Task Run
Retrieve all Task Runs
Create a Task Run
Retrieve a Task Run
Retrieve all Task Run Targets
Pause a Task Run
Resume a Task Run
Advance a Task Run to its next phase
Cancel a Task Run
I Pxe Template
Get all iPXE templates
Retrieve an iPXE template
Network Security Group
Retrieve all Network Security Groups
Create Network Security Group
Retrieve Network Security Group
Delete Network Security Group
Update Network Security Group
Dpu Extension Service
Retrieve all DPU Extension Services
Create DPU Extension Service
Retrieve DPU Extension Service
Delete DPU Extension Service
Update DPU Extension Service
Retrieve DPU Extension Service Version
Delete DPU Extension Service Version
SSH Key Group
Retrieve all SSH Key Groups
Create SSH Key Group
Retrieve an SSH Key Group
Delete an SSH Key Group
Update an SSH Key Group
SSH Key
Retrieve all SSH Keys
Create SSH Key
Retrieve an SSH key
Delete an SSH Key
Update an SSH Key
User
Retrieve Current User
Metadata
Retrieve metadata about the API server
Audit
Retrieve all Audit Log Entries
Retrieve Audit Log Entry
Host Firmware Config
Create or Update Host Firmware Config
Delete Host Firmware Config
Tenant Identity
Retrieve Tenant Identity Configuration for current Org
Create or Update Tenant Identity Configuration
Delete Tenant Identity Configuration
Retrieve Token Delegation for current Org
Create or Update Token Delegation
Delete Token Delegation
Reencrypt Tenant Identity Secrets
Retrieve OIDC JWKS for current Org
Retrieve OpenID Configuration for current Org
Retrieve SPIFFE JWKS for current Org

NVIDIA Infra Controller

Developer-friendly docs for your API