SchemaPower ManagementOperations

Subscribe Load Target Set

View as Markdown

Power Management Agent subscribes to load target commands

Direction: Subscribe (receive)

Channel

grid/v1/isv/{identifier}/loadtarget/set

ISV publishes load target commands. Fire-and-forget pattern — the ISV does not wait for a response. Confirmation comes via grid.powerstate.status.v1.

MQTT QoS: 1

Parameters

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

Message: Set Load Target

Content Type: application/cloudevents+json

ISV publishes load target command to the event bus.

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.loadtarget.set.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 SetLoadTargetDataYesWIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to SetLoadTargetData schema (type: object).
1{
2  "specversion": "1.0.2",
3  "id": "550e8400-e29b-41d4-a716-446655440000",
4  "source": "string",
5  "type": "grid.loadtarget.set.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}