For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • DSX Exchange
    • Architecture
    • Pre-Deployment
    • Deployment
    • Integrator Quickstart
    • Operations
    • Authentication
    • BMS Integration
    • Validated Capabilities
  • Schema
      • Overview
        • Publish Load Target Set
        • Publish Power Breach Alert
        • Publish Power Breach Enforcement
        • Publish Power State Status
        • Subscribe Load Target Set
        • Subscribe Power Breach Alert
        • Subscribe Power Breach Enforcement
        • Subscribe Power State Status
      • Messages
      • Schemas
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogo
On this page
  • Channel
  • Parameters
  • Message: Power State Status
  • Payload
SchemaPower ManagementOperations

Subscribe Power State Status

||View as Markdown|
Previous

Subscribe Power Breach Enforcement

Next

Messages

ISVs subscribe to power state status updates

Direction: Subscribe (receive)

Channel

grid/v1/poweragent/{identifier}/powerstate/status

Power Management Agent publishes full snapshots of current power state for all feeds. Includes compliance, ramp state, and active/scheduled targets. Published on state transitions and as periodic heartbeats.

MQTT QoS: 1

Parameters

ParameterDescription
identifierUnique identifier of the ISV, power agent, or infrastructure agent.

Message: Power State Status

Content Type: application/cloudevents+json

Power Management Agent publishes full power state snapshot.

Payload

NameTypeRequiredDescription
specversionstringYesMUST be “1.0.2” — version of the CloudEvents specification. Must be 1.0.2.
idstring (uuid)YesMUST be a UUIDv4 — globally unique identifier for this event instance.
sourcestringYesStable URI identifying the publisher. Format: //grid/v1/<role>/<identifier>. Examples: - //grid/v1/isv/acme-energy - //grid/v1/poweragent/dps-prod - //grid/v1/infra/ima-prod
typeanyYesMust be grid.powerstate.status.v1.
timestring (date-time)YesMUST be an ISO 8601 timestamp — time the event was created.
datacontenttypestringYesMUST be “application/json” — media type of the data payload. Must be application/json.
subjectstringYesResource subject identifying the domain object (e.g., loadtarget, powerstate, powerbreach).
correlationidstring (uuid)NoCloudEvents extension attribute. UUIDv4 correlation identifier. Generated by the ISV on grid.loadtarget.set.v1. Echoed by the Power Management Agent in status events for correlation.
traceparentstringYesREQUIRED per W3C Trace Context and CloudEvents Distributed Tracing Extension. Format: version-traceid-parentid-flags.
tracestatestringNoOPTIONAL per W3C Trace Context. Carries vendor-specific contextual information across tracing systems.
dataJwsCompactSerialization or PowerStateStatusDataYesWIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to PowerStateStatusData schema (type: object).
Example payload
1{
2 "specversion": "1.0.2",
3 "id": "550e8400-e29b-41d4-a716-446655440000",
4 "source": "string",
5 "type": "grid.powerstate.status.v1",
6 "time": "2026-05-14T12:00:00Z",
7 "datacontenttype": "application/json",
8 "subject": "string",
9 "correlationid": "550e8400-e29b-41d4-a716-446655440000",
10 "traceparent": "string",
11 "tracestate": "string",
12 "data": "string"
13}