SchemaPower ManagementOperations

Publish Power State Status

View as Markdown

Power Management Agent → ISVs (power state snapshot)

Direction: Publish (send)

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).
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}