Subscribe Power State Status

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

Parameter	Description
`identifier`	Unique 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

Name	Type	Required	Description
`specversion`	string	Yes	MUST be “1.0.2” — version of the CloudEvents specification. Must be `1.0.2`.
`id`	string (uuid)	Yes	MUST be a UUIDv4 — globally unique identifier for this event instance.
`source`	string	Yes	Stable 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
`type`	any	Yes	Must be `grid.powerstate.status.v1`.
`time`	string (date-time)	Yes	MUST be an ISO 8601 timestamp — time the event was created.
`datacontenttype`	string	Yes	MUST be “application/json” — media type of the data payload. Must be `application/json`.
`subject`	string	Yes	Resource subject identifying the domain object (e.g., loadtarget, powerstate, powerbreach).
`correlationid`	string (uuid)	No	CloudEvents 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.
`traceparent`	string	Yes	REQUIRED per W3C Trace Context and CloudEvents Distributed Tracing Extension. Format: version-traceid-parentid-flags.
`tracestate`	string	No	OPTIONAL per W3C Trace Context. Carries vendor-specific contextual information across tracing systems.
`data`	JwsCompactSerialization or PowerStateStatusData	Yes	WIRE 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 }