> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/dsx-exchange/llms.txt.
> For full documentation content, see https://docs.nvidia.com/dsx-exchange/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/dsx-exchange/_mcp/server.

# Schemas

## PowerUnit

Power measurement with value and unit.

| Name    | Type            | Required | Description                                                 |
| ------- | --------------- | -------- | ----------------------------------------------------------- |
| `value` | number (double) | Yes      | Power value (must be >= 0).                                 |
| `unit`  | string          | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt` |

***

## Interval

Time window for load target scheduling.

| Name         | Type               | Required | Description                                                                 |
| ------------ | ------------------ | -------- | --------------------------------------------------------------------------- |
| `start_time` | string (date-time) | No       | ISO 8601 UTC start time. Defaults to now if omitted.                        |
| `end_time`   | string (date-time) | No       | ISO 8601 UTC end time. If omitted, target remains in effect until replaced. |

***

## Strategy

Load shedding strategy configuration.

| Name          | Type    | Required | Description                                                                                                                                                                                              |
| ------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `best_effort` | boolean | No       | If true, DPS sheds load non-disruptively by adjusting DPM-enabled jobs. If the constraint cannot be satisfied, DPS sheds as much as possible and leaves the feed in a non-compliant state until workl... |

***

## LoadConstraint

Power limit constraint.

| Name    | Type            | Required | Description                                                 |
| ------- | --------------- | -------- | ----------------------------------------------------------- |
| `value` | number (double) | Yes      | Target power limit (must be > 0).                           |
| `unit`  | string          | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt` |

***

## FeedTags

List of feed identifiers this target applies to (e.g., \["main-a"]).
If omitted or empty, the target applies to all feeds.

**Type:** array\&lt;string>

List of feed identifiers this target applies to (e.g., \["main-a"]).
If omitted or empty, the target applies to all feeds.

***

## ShedHint

Resource-level load shedding recommendation. Shed hints are non-binding
advisory suggestions. The Infrastructure Management Agent MAY override
or augment based on topology and operational criteria.

| Name                 | Type            | Required | Description                                                    |
| -------------------- | --------------- | -------- | -------------------------------------------------------------- |
| `resource_id`        | string          | Yes      | Identifier of the resource to throttle.                        |
| `resource_type`      | string          | Yes      | Type of resource. Values: `node`, `gpu`, `chassis`             |
| `action`             | string          | Yes      | Recommended action. Values: `power_cap`, `throttle`, `suspend` |
| `priority`           | integer         | Yes      | Shedding priority (1 = shed first, higher = shed later).       |
| `target_power`       | object          | No       | Power measurement with value and unit.                         |
| `target_power.value` | number (double) | Yes      | Power value (must be >= 0).                                    |
| `target_power.unit`  | string          | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`    |

***

## EnforcementResult

Per-resource enforcement outcome.

| Name                  | Type            | Required | Description                                                               |
| --------------------- | --------------- | -------- | ------------------------------------------------------------------------- |
| `resource_id`         | string          | Yes      | The resource identifier from the shed hint.                               |
| `resource_type`       | string          | Yes      | Type of resource. Values: `node`, `gpu`, `chassis`                        |
| `requested_action`    | string          | Yes      | The action that was requested. Values: `power_cap`, `throttle`, `suspend` |
| `code`                | string          | Yes      | Per-resource enforcement status. Values: `applied`, `failed`, `skipped`   |
| `message`             | string          | No       | Diagnostic message (e.g., "BMC unreachable after 3 retries").             |
| `applied_power`       | object          | No       | Power measurement with value and unit.                                    |
| `applied_power.value` | number (double) | Yes      | Power value (must be >= 0).                                               |
| `applied_power.unit`  | string          | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`               |

***

## FeedMetadata

Static feed configuration. Values don't change during a curtailment event.

| Name                       | Type            | Required | Description                                                 |
| -------------------------- | --------------- | -------- | ----------------------------------------------------------- |
| `power_minimum`            | object          | Yes      | Power measurement with value and unit.                      |
| `power_minimum.value`      | number (double) | Yes      | Power value (must be >= 0).                                 |
| `power_minimum.unit`       | string          | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt` |
| `power_maximum`            | object          | Yes      | Power measurement with value and unit.                      |
| `power_maximum.value`      | number (double) | Yes      | Power value (must be >= 0).                                 |
| `power_maximum.unit`       | string          | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt` |
| `default_constraint`       | object          | Yes      | Power measurement with value and unit.                      |
| `default_constraint.value` | number (double) | Yes      | Power value (must be >= 0).                                 |
| `default_constraint.unit`  | string          | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt` |

***

## FeedTarget

A load target for a feed — active or scheduled.

| Name                    | Type                                                                           | Required | Description                                                                                                                                                                                              |
| ----------------------- | ------------------------------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `active`                | boolean                                                                        | Yes      | true if this target is currently being enforced.                                                                                                                                                         |
| `load_constraint`       | [LoadConstraint](/dsx-exchange/schema/power-management/schemas#loadconstraint) | Yes      | Power limit constraint.                                                                                                                                                                                  |
| `load_constraint.value` | number (double)                                                                | Yes      | Target power limit (must be > 0).                                                                                                                                                                        |
| `load_constraint.unit`  | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                                                                                                                                              |
| `interval`              | [Interval](/dsx-exchange/schema/power-management/schemas#interval)             | Yes      | Time window for load target scheduling.                                                                                                                                                                  |
| `interval.start_time`   | string (date-time)                                                             | No       | ISO 8601 UTC start time. Defaults to now if omitted.                                                                                                                                                     |
| `interval.end_time`     | string (date-time)                                                             | No       | ISO 8601 UTC end time. If omitted, target remains in effect until replaced.                                                                                                                              |
| `strategy`              | [Strategy](/dsx-exchange/schema/power-management/schemas#strategy)             | Yes      | Load shedding strategy configuration.                                                                                                                                                                    |
| `strategy.best_effort`  | boolean                                                                        | No       | If true, DPS sheds load non-disruptively by adjusting DPM-enabled jobs. If the constraint cannot be satisfied, DPS sheds as much as possible and leaves the feed in a non-compliant state until workl... |
| `correlation_id`        | string (uuid)                                                                  | Yes      | The correlationid from the grid.loadtarget.set.v1 that created this target.                                                                                                                              |

***

## FeedState

Current power state for a single feed.

| Name                                | Type                                                                           | Required | Description                                                                                        |
| ----------------------------------- | ------------------------------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------- |
| `metadata`                          | [FeedMetadata](/dsx-exchange/schema/power-management/schemas#feedmetadata)     | Yes      | Static feed configuration. Values don't change during a curtailment event.                         |
| `metadata.power_minimum`            | object                                                                         | Yes      | Power measurement with value and unit.                                                             |
| `metadata.power_minimum.value`      | number (double)                                                                | Yes      | Power value (must be >= 0).                                                                        |
| `metadata.power_minimum.unit`       | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                                        |
| `metadata.power_maximum`            | object                                                                         | Yes      | Power measurement with value and unit.                                                             |
| `metadata.power_maximum.value`      | number (double)                                                                | Yes      | Power value (must be >= 0).                                                                        |
| `metadata.power_maximum.unit`       | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                                        |
| `metadata.default_constraint`       | object                                                                         | Yes      | Power measurement with value and unit.                                                             |
| `metadata.default_constraint.value` | number (double)                                                                | Yes      | Power value (must be >= 0).                                                                        |
| `metadata.default_constraint.unit`  | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                                        |
| `targets`                           | array\<[FeedTarget](/dsx-exchange/schema/power-management/schemas#feedtarget)> | Yes      | All load targets for this feed — active and scheduled. Empty array if no targets exist.            |
| `calculated_load`                   | object                                                                         | Yes      | Power measurement with value and unit.                                                             |
| `calculated_load.value`             | number (double)                                                                | Yes      | Power value (must be >= 0).                                                                        |
| `calculated_load.unit`              | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                                        |
| `in_flight`                         | boolean                                                                        | Yes      | true if the agent is actively transitioning between power levels.                                  |
| `power_event_start_time`            | string (date-time)                                                             | No       | ISO 8601 UTC timestamp when the current power event began. null if no event is active.             |
| `compliant`                         | boolean                                                                        | Yes      | true if the calculated load is within the active target constraint. true when no target is active. |

***

## BreachDetails

Breach identification and timing.

| Name          | Type               | Required | Description                                                                                                                     |
| ------------- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `breach_id`   | string (uuid)      | Yes      | Unique identifier for this breach instance (UUIDv4). Remains the same across active → escalated → resolved for the same breach. |
| `detected_at` | string (date-time) | Yes      | ISO 8601 UTC timestamp when the breach was first detected.                                                                      |
| `resolved_at` | string (date-time) | No       | ISO 8601 UTC timestamp when the breach was resolved. Present only when status is resolved.                                      |

***

## BreachTarget

The load target being breached.

| Name                    | Type                                                                           | Required | Description                                                                     |
| ----------------------- | ------------------------------------------------------------------------------ | -------- | ------------------------------------------------------------------------------- |
| `correlation_id`        | string (uuid)                                                                  | Yes      | The correlationid from the grid.loadtarget.set.v1 that established this target. |
| `load_constraint`       | [LoadConstraint](/dsx-exchange/schema/power-management/schemas#loadconstraint) | Yes      | Power limit constraint.                                                         |
| `load_constraint.value` | number (double)                                                                | Yes      | Target power limit (must be > 0).                                               |
| `load_constraint.unit`  | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                     |

***

## SetLoadTargetData

Payload for grid.loadtarget.set.v1.

| Name      | Type              | Required | Description                   |
| --------- | ----------------- | -------- | ----------------------------- |
| `targets` | array\&lt;object> | Yes      | List of load target requests. |

***

## PowerStateStatusData

Payload for grid.powerstate.status.v1.

| Name            | Type                                                                                  | Required | Description                                                                                                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `snapshot_time` | string (date-time)                                                                    | Yes      | ISO 8601 UTC timestamp of this snapshot.                                                                                                                                                                    |
| `event`         | string                                                                                | Yes      | The trigger that caused this status to be published: - target\_set — a grid.loadtarget.set.v1 was received and schedule updated - start\_ramp\_down — constraint applied or tightened, redistribution be... |
| `feeds`         | map\&lt;string, [FeedState](/dsx-exchange/schema/power-management/schemas#feedstate)> | Yes      | Map of feed\_tag to power state.                                                                                                                                                                            |

***

## PowerBreachAlertData

Payload for grid.powerbreach.alert.v1.

| Name                           | Type                                                                           | Required | Description                                                                                                                                               |
| ------------------------------ | ------------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `feed_tag`                     | string                                                                         | Yes      | The feed identifier where the breach was detected.                                                                                                        |
| `status`                       | string                                                                         | Yes      | Breach lifecycle state. Values: `active`, `escalated`, `resolved`                                                                                         |
| `severity`                     | string                                                                         | Yes      | Breach severity level: - warning — excess between threshold and 20% over target - critical — excess exceeds 20% over target Values: `warning`, `critical` |
| `breach`                       | [BreachDetails](/dsx-exchange/schema/power-management/schemas#breachdetails)   | Yes      | Breach identification and timing.                                                                                                                         |
| `breach.breach_id`             | string (uuid)                                                                  | Yes      | Unique identifier for this breach instance (UUIDv4). Remains the same across active → escalated → resolved for the same breach.                           |
| `breach.detected_at`           | string (date-time)                                                             | Yes      | ISO 8601 UTC timestamp when the breach was first detected.                                                                                                |
| `breach.resolved_at`           | string (date-time)                                                             | No       | ISO 8601 UTC timestamp when the breach was resolved. Present only when status is resolved.                                                                |
| `target`                       | [BreachTarget](/dsx-exchange/schema/power-management/schemas#breachtarget)     | Yes      | The load target being breached.                                                                                                                           |
| `target.correlation_id`        | string (uuid)                                                                  | Yes      | The correlationid from the grid.loadtarget.set.v1 that established this target.                                                                           |
| `target.load_constraint`       | [LoadConstraint](/dsx-exchange/schema/power-management/schemas#loadconstraint) | Yes      | Power limit constraint.                                                                                                                                   |
| `target.load_constraint.value` | number (double)                                                                | Yes      | Target power limit (must be > 0).                                                                                                                         |
| `target.load_constraint.unit`  | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                                                                                               |
| `measured_load`                | object                                                                         | Yes      | Power measurement with value and unit.                                                                                                                    |
| `measured_load.value`          | number (double)                                                                | Yes      | Power value (must be >= 0).                                                                                                                               |
| `measured_load.unit`           | string                                                                         | Yes      | Unit of measurement. Values: `watt`, `kilowatt`, `megawatt`                                                                                               |
| `shed_hints`                   | array\<[ShedHint](/dsx-exchange/schema/power-management/schemas#shedhint)>     | No       | Ordered list of load shedding recommendations. Present when status is active or escalated. Absent when resolved.                                          |
| `infrastructure_actions`       | array\&lt;string>                                                              | Yes      | Ordered list of escalating infrastructure-level actions. Empty array when status is resolved. Ordered from least to most disruptive.                      |

***

## PowerBreachEnforcementData

Payload for grid.powerbreach.enforcement.v1.

| Name        | Type                                                                                         | Required | Description                                                              |
| ----------- | -------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------ |
| `breach_id` | string (uuid)                                                                                | Yes      | The breach\_id from the originating grid.powerbreach.alert.v1 event.     |
| `feed_tag`  | string                                                                                       | Yes      | The feed identifier this enforcement applies to.                         |
| `action`    | string                                                                                       | Yes      | What phase of enforcement this represents. Values: `applied`, `reverted` |
| `code`      | string                                                                                       | Yes      | Overall enforcement outcome. Values: `success`, `partial`, `error`       |
| `diag_msg`  | string                                                                                       | No       | Human-readable diagnostic message.                                       |
| `results`   | array\<[EnforcementResult](/dsx-exchange/schema/power-management/schemas#enforcementresult)> | Yes      | Per-resource enforcement outcome.                                        |
| `timestamp` | string (date-time)                                                                           | Yes      | ISO 8601 UTC timestamp when enforcement completed.                       |

***

## JwsCompactSerialization

JWS Compact Serialization (RFC 7515) containing a signed payload.
This is the WIRE FORMAT for the "data" field in CloudEvents messages.

Structure: BASE64URL(JWS Header).BASE64URL(Payload).BASE64URL(Signature)

JWS Header (example):
\{
"alg": "ES256",
"kid": "\<signing-key-id>"
}

The payload, when verified, contains the JSON event data
as defined by the message type schema.

**Type:** string

JWS Compact Serialization (RFC 7515) containing a signed payload.
This is the WIRE FORMAT for the "data" field in CloudEvents messages.

Structure: BASE64URL(JWS Header).BASE64URL(Payload).BASE64URL(Signature)

JWS Header (example):
\{
"alg": "ES256",
"kid": "\<signing-key-id>"
}

The payload, when verified, contains the JSON event data
as defined by the message type schema.

***

## BaseCloudEvent

Common CloudEvents 1.0.2 attributes shared by all events.
Each event type extends this with a specific "data" field.

The "data" field is transmitted as a JWS compact serialization string.
The plaintext JSON payload is signed with JWS (RFC 7515).

| 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`            | string             | Yes      | Event type following grid.\<entity>.\<action>.v1 or grid.\<entity>.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.                                                                                 |

***

## LoadTargetSetEvent

Common CloudEvents 1.0.2 attributes shared by all events.
Each event type extends this with a specific "data" field.

The "data" field is transmitted as a JWS compact serialization string.
The plaintext JSON payload is signed with JWS (RFC 7515).

| 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.loadtarget.set.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](/dsx-exchange/schema/power-management/schemas#jwscompactserialization) or [SetLoadTargetData](/dsx-exchange/schema/power-management/schemas#setloadtargetdata) | Yes      | WIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to SetLoadTargetData schema (type: object).              |

***

## PowerStateStatusEvent

Common CloudEvents 1.0.2 attributes shared by all events.
Each event type extends this with a specific "data" field.

The "data" field is transmitted as a JWS compact serialization string.
The plaintext JSON payload is signed with JWS (RFC 7515).

| 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](/dsx-exchange/schema/power-management/schemas#jwscompactserialization) or [PowerStateStatusData](/dsx-exchange/schema/power-management/schemas#powerstatestatusdata) | Yes      | WIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to PowerStateStatusData schema (type: object).           |

***

## PowerBreachAlertEvent

Common CloudEvents 1.0.2 attributes shared by all events.
Each event type extends this with a specific "data" field.

The "data" field is transmitted as a JWS compact serialization string.
The plaintext JSON payload is signed with JWS (RFC 7515).

| 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.powerbreach.alert.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](/dsx-exchange/schema/power-management/schemas#jwscompactserialization) or [PowerBreachAlertData](/dsx-exchange/schema/power-management/schemas#powerbreachalertdata) | Yes      | WIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to PowerBreachAlertData schema (type: object).           |

***

## PowerBreachEnforcementEvent

Common CloudEvents 1.0.2 attributes shared by all events.
Each event type extends this with a specific "data" field.

The "data" field is transmitted as a JWS compact serialization string.
The plaintext JSON payload is signed with JWS (RFC 7515).

| 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.powerbreach.enforcement.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](/dsx-exchange/schema/power-management/schemas#jwscompactserialization) or [PowerBreachEnforcementData](/dsx-exchange/schema/power-management/schemas#powerbreachenforcementdata) | Yes      | WIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to PowerBreachEnforcementData schema (type: object).     |

***