> 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. # Messages ## Set Load Target **Content Type:** `application/cloudevents+json` ISV publishes load target command to the event bus. ### 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/\/\. 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). | *** ## 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/\/\. 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). | *** ## Power Breach Alert **Content Type:** `application/cloudevents+json` Power Management Agent publishes breach alert with shed hints. ### 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/\/\. 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). | *** ## Power Breach Enforcement **Content Type:** `application/cloudevents+json` Infrastructure Management Agent publishes enforcement outcome. ### 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/\/\. 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). | ***