Enroll a capture agent with a one-use code
POST/api/v1/capture-agent/enroll
Consumes an unexpired enrollment code without a prior session and returns the new agent ID, configured lease duration, and narrow device credential once. Jiandu stores only credential digests.
Request
Responses
- 201
- 400
- 401
- 421
- 503
Agent enrolled; the narrow credential is returned only once
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request syntax, headers, body, or validated input is malformed or invalid
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The opaque credential is absent, ambiguous, malformed, expired, revoked, or invalid
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request authority or direct peer is outside the configured Jiandu ingress boundary
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
A required core dependency is unavailable; retry with bounded backoff
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.