Subscribe Power Breach Enforcement

View as Markdown

DSX Flex Agent and ISVs subscribe to enforcement outcomes

Direction: Subscribe (receive)

Channel

grid/v1/infra/{infraAgentId}/powerbreach/enforcement

Infrastructure Management Agent publishes enforcement outcomes after applying or reverting shed hints at the hardware level via Redfish BMC.

MQTT QoS: 2

Parameters

ParameterDescription
infraAgentIdUnique identifier of the Infrastructure Management Agent.

Message: Power Breach Enforcement

Content Type: application/cloudevents+json

Infrastructure Management Agent publishes enforcement outcome.

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/dsx-flex-agent/maxlps - //grid/v1/infra/ima-prod
typeanyYesMust be grid.powerbreach.enforcement.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 DSX Flex 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 PowerBreachEnforcementDataYesWIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to PowerBreachEnforcementData schema (type: object).
1{
2 "specversion": "1.0.2",
3 "id": "550e8400-e29b-41d4-a716-446655440000",
4 "source": "string",
5 "type": "grid.powerbreach.enforcement.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}