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

# Subscribe Load Target Set

Power Management Agent subscribes to load target commands

**Direction:** Subscribe (receive)

## Channel

```text
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

| Parameter    | Description                                                         |
| ------------ | ------------------------------------------------------------------- |
| `identifier` | Unique 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

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

```json
{
  "specversion": "1.0.2",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "source": "string",
  "type": "grid.loadtarget.set.v1",
  "time": "2026-05-14T12:00:00Z",
  "datacontenttype": "application/json",
  "subject": "string",
  "correlationid": "550e8400-e29b-41d4-a716-446655440000",
  "traceparent": "string",
  "tracestate": "string",
  "data": "string"
}
```